com.trilead.ssh2

Class SFTPv3FileAttributes


public class SFTPv3FileAttributes
extends java.lang.Object

A SFTPv3FileAttributes object represents detail information about a file on the server. Not all fields may/must be present.

Field Summary

Integer
atime
The ATIME attribute.
Integer
gid
The GID attribute.
Integer
mtime
The MTIME attribute.
Integer
permissions
The POSIX permissions.
Long
size
The SIZE attribute.
Integer
uid
The UID attribute.

Method Summary

String
getOctalPermissions()
Turn the POSIX permissions into a 7 digit octal representation.
boolean
isDirectory()
Checks if this entry is a directory.
boolean
isRegularFile()
Checks if this entry is a regular file.
boolean
isSymlink()
Checks if this entry is a a symlink.

Field Details

atime

public Integer atime
The ATIME attribute. Represented as seconds from Jan 1, 1970 in UTC. NULL if not present.

gid

public Integer gid
The GID attribute. NULL if not present.

mtime

public Integer mtime
The MTIME attribute. Represented as seconds from Jan 1, 1970 in UTC. NULL if not present.

permissions

public Integer permissions
The POSIX permissions. NULL if not present.

Here is a list:

Note: these numbers are all OCTAL.
  
  S_IFMT     0170000   bitmask for the file type bitfields
  S_IFSOCK   0140000   socket
  S_IFLNK    0120000   symbolic link
  S_IFREG    0100000   regular file
  S_IFBLK    0060000   block device
  S_IFDIR    0040000   directory
  S_IFCHR    0020000   character device
  S_IFIFO    0010000   fifo 
  S_ISUID    0004000   set UID bit
  S_ISGID    0002000   set GID bit 
  S_ISVTX    0001000   sticky bit
  
  S_IRWXU    00700     mask for file owner permissions
  S_IRUSR    00400     owner has read permission
  S_IWUSR    00200     owner has write permission
  S_IXUSR    00100     owner has execute permission
  S_IRWXG    00070     mask for group permissions
  S_IRGRP    00040     group has read permission
  S_IWGRP    00020     group has write permission
  S_IXGRP    00010     group has execute permission
  S_IRWXO    00007     mask for permissions for others (not in group)
  S_IROTH    00004     others have read permission
  S_IWOTH    00002     others have write permisson
  S_IXOTH    00001     others have execute permission
 

size

public Long size
The SIZE attribute. NULL if not present.

uid

public Integer uid
The UID attribute. NULL if not present.

Method Details

getOctalPermissions

public String getOctalPermissions()
Turn the POSIX permissions into a 7 digit octal representation. Note: the returned value is first masked with 0177777.
Returns:
NULL if permissions are not available.

isDirectory

public boolean isDirectory()
Checks if this entry is a directory.
Returns:
Returns true if permissions are available and they indicate that this entry represents a directory.

isRegularFile

public boolean isRegularFile()
Checks if this entry is a regular file.
Returns:
Returns true if permissions are available and they indicate that this entry represents a regular file.

isSymlink

public boolean isSymlink()
Checks if this entry is a a symlink.
Returns:
Returns true if permissions are available and they indicate that this entry represents a symlink.