SftpFileAttributes (Maverick Legacy - Server Assembly 1.7.61 API)

java.lang.Object
- com.maverick.sshd.SftpFileAttributes

```
public class SftpFileAttributes
extends Object
```
This class represents the ATTRS structure defined in the draft-ietf-secsh-filexfer-02.txt which is used by the protocol to store file attribute information.

Author:

Lee David Painter

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`S_IFBLK` Permissions flag: Identifies the file as a block special file
`static int`	`S_IFCHR` Permissions flag: Identifies the file as a character device
`static int`	`S_IFDIR` Permissions flag: Identifies the file as a directory
`static int`	`S_IFIFO` Permissions flag: Identifies the file as a pipe
`static int`	`S_IFLNK` Permissions flag: Identifies the file as a symbolic link
`static int`	`S_IFMT` Permissions flag: Format mask constant can be used to mask off a file type from the mode.
`static int`	`S_IFREG` Permissions flag: Identifies the file as a regular file
`static int`	`S_IFSOCK` Permissions flag: Identifies the file as a socket
`static int`	`S_IRGRP` Permissions flag: Permits a file's group to read the file.
`static int`	`S_IROTH` Permissions flag: Permits others to read the file.
`static int`	`S_IRUSR` Permissions flag: Permits the owner of a file to read the file.
`static int`	`S_ISGID` Permissions flag: Bit to determine whether a file is executed as the group owner
`static int`	`S_ISUID` Permissions flag: Bit to determine whether a file is executed as the owner
`static int`	`S_IWGRP` Permissions flag: Permits a file's group to write to the file.
`static int`	`S_IWOTH` Permissions flag: Permits others to write to the file.
`static int`	`S_IWUSR` Permissions flag: Permits the owner of a file to write to the file.
`static int`	`S_IXGRP` Permissions flag: Permits a file's group to execute the file or to search the file's directory.
`static int`	`S_IXOTH` Permissions flag: Permits others to execute the file or to search the file's directory.
`static int`	`S_IXUSR` Permissions flag: Permits the owner of a file to execute the file or to search the file's directory.
`static int`	`S_MODE_MASK`
`static int`	`SSH_FILEXFER_TYPE_BLOCK_DEVICE`
`static int`	`SSH_FILEXFER_TYPE_CHAR_DEVICE`
`static int`	`SSH_FILEXFER_TYPE_DIRECTORY`
`static int`	`SSH_FILEXFER_TYPE_FIFO`
`static int`	`SSH_FILEXFER_TYPE_REGULAR`
`static int`	`SSH_FILEXFER_TYPE_SOCKET`
`static int`	`SSH_FILEXFER_TYPE_SPECIAL`
`static int`	`SSH_FILEXFER_TYPE_SYMLINK`
`static int`	`SSH_FILEXFER_TYPE_UNKNOWN`

Constructor Summary

Constructors
Constructor and Description
`SftpFileAttributes(int version, String charset, ByteArrayReader bar)`
`SftpFileAttributes(String charset)` Creates a new FileAttributes object.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`UnsignedInteger64`	`getAccessedTime()` Get the last accessed time.
`UnsignedInteger64`	`getCreateTime()` Get the file create time.
`byte[]`	`getExtendedAttribute(String attrName)`
`Map<String,byte[]>`	`getExtendedAttributes()` Get the extended attributes.
`UnsignedInteger32`	`getGID()` Get the GID of this file.
`String`	`getGroup()`
`String`	`getMaskString()` Return the UNIX style mode mask
`int`	`getModeType()`
`UnsignedInteger64`	`getModifiedTime()` Get the last modified time.
`UnsignedInteger32`	`getPermissions()` Get the current permissions value.
`String`	`getPermissionsString()` Returns a formatted permissions string.
`UnsignedInteger64`	`getSize()` Get the size of the file.
`UnsignedInteger32`	`getUID()` Get the UID of the owner.
`String`	`getUsername()`
`boolean`	`hasAccessedTime()` Get if the file has a last accessed time.
`boolean`	`hasCreateTime()` Get if the file has a create time.
`boolean`	`hasExtendedAttribute(String attrName)`
`boolean`	`hasGID()`
`boolean`	`hasGroup()` Get if this file has a group associated with it.
`boolean`	`hasModifiedTime()` Get if the file has a last modified time.
`boolean`	`hasPermissions()`
`boolean`	`hasSize()`
`boolean`	`hasUID()`
`boolean`	`hasUsername()` Get if this file has a username associated with it.
`boolean`	`isBlock()` Determine whether these attributes refer to a block special file.
`boolean`	`isCharacter()` Determine whether these attributes refer to a character device.
`boolean`	`isDirectory()` Determine whether these attributes refer to a directory
`boolean`	`isFifo()` Determine whether these attributes refer to a pipe.
`boolean`	`isFile()` Determine whether these attributes refer to a file.
`boolean`	`isFlagSet(long flag)` Determine if a permissions flag is set.
`boolean`	`isLink()` Determine whether these attributes refer to a symbolic link.
`boolean`	`isSocket()` Determine whether these attributes refer to a socket.
`void`	`removeExtendedAttribute(String attrName)` Set a single extended attribute value.
`void`	`setExtendedAttribute(String attrName, byte[] attrValue)` Set a single extended attribute value.
`void`	`setExtendedAttributes(Map<String,byte[]> attributes)` Set all the extended attributes.
`void`	`setGID(UnsignedInteger32 gid)` Set the GID of this file.
`void`	`setGID(UnsignedInteger32 gid, String group)`
`void`	`setPermissions(String newPermissions)` Set the permissions from a string in the format "rwxr-xr-x"
`void`	`setPermissions(UnsignedInteger32 permissions)` Set the permissions of the file.
`void`	`setPermissionsFromMaskString(String mask)` Set permissions given a UNIX style mask, for example '0644'
`void`	`setPermissionsFromUmaskString(String umask)` Set the permissions given a UNIX style umask, for example '0022' will result in 0022 ^ 0777.
`void`	`setSize(UnsignedInteger64 size)` Set the size of the file.
`void`	`setTimes(UnsignedInteger64 atime, UnsignedInteger64 mtime)` Set the last access and last modified times.
`void`	`setTimes(UnsignedInteger64 atime, UnsignedInteger64 mtime, UnsignedInteger64 ctime)` Set the last access, last modified and create times.
`void`	`setType(int type)`
`void`	`setUID(UnsignedInteger32 uid)` Set the UID of the owner.
`void`	`setUID(UnsignedInteger32 uid, String username)`
`byte[]`	`toByteArray(int version)` Returns a formatted byte array suitable for encoding into SFTP subsystem messages.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SSH_FILEXFER_TYPE_REGULAR
```
public static final int SSH_FILEXFER_TYPE_REGULAR
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_DIRECTORY
```
public static final int SSH_FILEXFER_TYPE_DIRECTORY
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_SYMLINK
```
public static final int SSH_FILEXFER_TYPE_SYMLINK
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_SPECIAL
```
public static final int SSH_FILEXFER_TYPE_SPECIAL
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_UNKNOWN
```
public static final int SSH_FILEXFER_TYPE_UNKNOWN
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_SOCKET
```
public static final int SSH_FILEXFER_TYPE_SOCKET
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_CHAR_DEVICE
```
public static final int SSH_FILEXFER_TYPE_CHAR_DEVICE
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_BLOCK_DEVICE
```
public static final int SSH_FILEXFER_TYPE_BLOCK_DEVICE
```
    See Also:
    
    Constant Field Values
  - SSH_FILEXFER_TYPE_FIFO
```
public static final int SSH_FILEXFER_TYPE_FIFO
```
    See Also:
    
    Constant Field Values
  - S_IFMT
```
public static final int S_IFMT
```
    Permissions flag: Format mask constant can be used to mask off a file type from the mode.
    
    See Also:
    
    Constant Field Values
  - S_MODE_MASK
```
public static final int S_MODE_MASK
```
    See Also:
    
    Constant Field Values
  - S_IFSOCK
```
public static final int S_IFSOCK
```
    Permissions flag: Identifies the file as a socket
    
    See Also:
    
    Constant Field Values
  - S_IFLNK
```
public static final int S_IFLNK
```
    Permissions flag: Identifies the file as a symbolic link
    
    See Also:
    
    Constant Field Values
  - S_IFREG
```
public static final int S_IFREG
```
    Permissions flag: Identifies the file as a regular file
    
    See Also:
    
    Constant Field Values
  - S_IFBLK
```
public static final int S_IFBLK
```
    Permissions flag: Identifies the file as a block special file
    
    See Also:
    
    Constant Field Values
  - S_IFDIR
```
public static final int S_IFDIR
```
    Permissions flag: Identifies the file as a directory
    
    See Also:
    
    Constant Field Values
  - S_IFCHR
```
public static final int S_IFCHR
```
    Permissions flag: Identifies the file as a character device
    
    See Also:
    
    Constant Field Values
  - S_IFIFO
```
public static final int S_IFIFO
```
    Permissions flag: Identifies the file as a pipe
    
    See Also:
    
    Constant Field Values
  - S_ISUID
```
public static final int S_ISUID
```
    Permissions flag: Bit to determine whether a file is executed as the owner
    
    See Also:
    
    Constant Field Values
  - S_ISGID
```
public static final int S_ISGID
```
    Permissions flag: Bit to determine whether a file is executed as the group owner
    
    See Also:
    
    Constant Field Values
  - S_IRUSR
```
public static final int S_IRUSR
```
    Permissions flag: Permits the owner of a file to read the file.
    
    See Also:
    
    Constant Field Values
  - S_IWUSR
```
public static final int S_IWUSR
```
    Permissions flag: Permits the owner of a file to write to the file.
    
    See Also:
    
    Constant Field Values
  - S_IXUSR
```
public static final int S_IXUSR
```
    Permissions flag: Permits the owner of a file to execute the file or to search the file's directory.
    
    See Also:
    
    Constant Field Values
  - S_IRGRP
```
public static final int S_IRGRP
```
    Permissions flag: Permits a file's group to read the file.
    
    See Also:
    
    Constant Field Values
  - S_IWGRP
```
public static final int S_IWGRP
```
    Permissions flag: Permits a file's group to write to the file.
    
    See Also:
    
    Constant Field Values
  - S_IXGRP
```
public static final int S_IXGRP
```
    Permissions flag: Permits a file's group to execute the file or to search the file's directory.
    
    See Also:
    
    Constant Field Values
  - S_IROTH
```
public static final int S_IROTH
```
    Permissions flag: Permits others to read the file.
    
    See Also:
    
    Constant Field Values
  - S_IWOTH
```
public static final int S_IWOTH
```
    Permissions flag: Permits others to write to the file.
    
    See Also:
    
    Constant Field Values
  - S_IXOTH
```
public static final int S_IXOTH
```
    Permissions flag: Permits others to execute the file or to search the file's directory.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - SftpFileAttributes
```
public SftpFileAttributes(String charset)
```
    Creates a new FileAttributes object.
  - SftpFileAttributes
```
public SftpFileAttributes(int version,
                          String charset,
                          ByteArrayReader bar)
                   throws IOException
```
    Throws:
    
    IOException
- Method Detail
  - setExtendedAttributes
```
public void setExtendedAttributes(Map<String,byte[]> attributes)
```
    Set all the extended attributes. The keys should be of type String, as should the values.
    
    Parameters:
    
    attributes - map of all extended attributes
  - setExtendedAttribute
```
public void setExtendedAttribute(String attrName,
                                 byte[] attrValue)
```
    Set a single extended attribute value.
    
    Parameters:
    
    attrName - attribute name
    
    attrValue - attribute value
  - removeExtendedAttribute
```
public void removeExtendedAttribute(String attrName)
```
    Set a single extended attribute value.
    
    Parameters:
    
    attrName - attribute name to remove
  - getExtendedAttributes
```
public Map<String,byte[]> getExtendedAttributes()
```
    Get the extended attributes. The key is of type String, as is the value.
    
    Returns:
    
    attribute values
  - hasExtendedAttribute
```
public boolean hasExtendedAttribute(String attrName)
```
  - getExtendedAttribute
```
public byte[] getExtendedAttribute(String attrName)
```
  - getUID
```
public UnsignedInteger32 getUID()
```
    Get the UID of the owner.
    
    Returns:
    
    UnsignedInteger32
  - hasUsername
```
public boolean hasUsername()
```
    Get if this file has a username associated with it.
    
    Returns:
    
    has username
  - hasUID
```
public boolean hasUID()
```
  - hasGID
```
public boolean hasGID()
```
  - hasGroup
```
public boolean hasGroup()
```
    Get if this file has a group associated with it.
    
    Returns:
    
    has group
  - setUID
```
public void setUID(UnsignedInteger32 uid)
```
    Set the UID of the owner.
    
    Parameters:
    
    uid -
  - setUID
```
public void setUID(UnsignedInteger32 uid,
                   String username)
```
  - getUsername
```
public String getUsername()
```
  - setGID
```
public void setGID(UnsignedInteger32 gid)
```
    Set the GID of this file.
    
    Parameters:
    
    gid -
  - setGID
```
public void setGID(UnsignedInteger32 gid,
                   String group)
```
  - getGroup
```
public String getGroup()
```
  - getGID
```
public UnsignedInteger32 getGID()
```
    Get the GID of this file.
    
    Returns:
    
    UnsignedInteger32
  - setSize
```
public void setSize(UnsignedInteger64 size)
```
    Set the size of the file.
    
    Parameters:
    
    size -
  - getSize
```
public UnsignedInteger64 getSize()
```
    Get the size of the file.
    
    Returns:
    
    UnsignedInteger64
  - hasSize
```
public boolean hasSize()
```
  - setPermissions
```
public void setPermissions(UnsignedInteger32 permissions)
```
    Set the permissions of the file. This value should be a valid mask of the permissions flags defined within this class.
  - setPermissionsFromMaskString
```
public void setPermissionsFromMaskString(String mask)
```
    Set permissions given a UNIX style mask, for example '0644'
    
    Parameters:
    
    mask - mask
    
    Throws:
    
    IllegalArgumentException - if badly formatted string
  - setPermissionsFromUmaskString
```
public void setPermissionsFromUmaskString(String umask)
```
    Set the permissions given a UNIX style umask, for example '0022' will result in 0022 ^ 0777.
    
    Parameters:
    
    umask -
  - setPermissions
```
public void setPermissions(String newPermissions)
```
    Set the permissions from a string in the format "rwxr-xr-x"
    
    Parameters:
    
    newPermissions -
  - getPermissions
```
public UnsignedInteger32 getPermissions()
```
    Get the current permissions value.
    
    Returns:
    
    UnsignedInteger32
  - setTimes
```
public void setTimes(UnsignedInteger64 atime,
                     UnsignedInteger64 mtime)
```
    Set the last access and last modified times. These times are represented by integers containing the number of seconds from Jan 1, 1970 UTC. NOTE: You should divide any value returned from Java's System.currentTimeMillis() method by 1000 to set the correct times as this returns the time in milliseconds from Jan 1, 1970 UTC.
    
    Parameters:
    
    atime -
    
    mtime -
  - setTimes
```
public void setTimes(UnsignedInteger64 atime,
                     UnsignedInteger64 mtime,
                     UnsignedInteger64 ctime)
```
    Set the last access, last modified and create times. These times are represented by integers containing the number of seconds from Jan 1, 1970 UTC. NOTE: You should divide any value returned from Java's System.currentTimeMillis() method by 1000 to set the correct times as this returns the time in milliseconds from Jan 1, 1970 UTC.
    
    Parameters:
    
    atime -
    
    mtime -
    
    ctime -
  - getAccessedTime
```
public UnsignedInteger64 getAccessedTime()
```
    Get the last accessed time. This integer value represents the number of seconds from Jan 1, 1970 UTC. When using with Java Date/Time classes you should multiply this value by 1000 as Java uses the time in milliseconds rather than seconds.
    
    Returns:
    
    UnsignedInteger32
  - hasAccessedTime
```
public boolean hasAccessedTime()
```
    Get if the file has a last accessed time.
    
    Returns:
    
    UnsignedInteger32
    
    See Also:
    
    getAccessedTime()
  - getModifiedTime
```
public UnsignedInteger64 getModifiedTime()
```
    Get the last modified time. This integer value represents the number of seconds from Jan 1, 1970 UTC. When using with Java Date/Time classes you should multiply this value by 1000 as Java uses the time in milliseconds rather than seconds.
    
    Returns:
    
    UnsignedInteger32
  - hasModifiedTime
```
public boolean hasModifiedTime()
```
    Get if the file has a last modified time.
    
    Returns:
    
    UnsignedInteger32
    
    See Also:
    
    getModifiedTime()
  - getCreateTime
```
public UnsignedInteger64 getCreateTime()
```
    Get the file create time. This integer value represents the number of seconds from Jan 1, 1970 UTC. When using with Java Date/Time classes you should multiply this value by 1000 as Java uses the time in milliseconds rather than seconds.
    
    Returns:
    
    UnsignedInteger32
  - hasCreateTime
```
public boolean hasCreateTime()
```
    Get if the file has a create time.
    
    Returns:
    
    UnsignedInteger32
    
    See Also:
    
    getModifiedTime()
  - isFlagSet
```
public boolean isFlagSet(long flag)
```
    Determine if a permissions flag is set.
    
    Parameters:
    
    flag -
    
    Returns:
    
    boolean
  - toByteArray
```
public byte[] toByteArray(int version)
                   throws IOException
```
    Returns a formatted byte array suitable for encoding into SFTP subsystem messages.
    
    Returns:
    
    byte[]
    
    Throws:
    
    IOException
  - getModeType
```
public int getModeType()
```
  - getPermissionsString
```
public String getPermissionsString()
```
    Returns a formatted permissions string.
    
    Returns:
    
    String
  - getMaskString
```
public String getMaskString()
```
    Return the UNIX style mode mask
    
    Returns:
    
    mask
  - isDirectory
```
public boolean isDirectory()
```
    Determine whether these attributes refer to a directory
    
    Returns:
    
    boolean
  - isFile
```
public boolean isFile()
```
    Determine whether these attributes refer to a file.
    
    Returns:
    
    boolean
  - isLink
```
public boolean isLink()
```
    Determine whether these attributes refer to a symbolic link.
    
    Returns:
    
    boolean
  - isFifo
```
public boolean isFifo()
```
    Determine whether these attributes refer to a pipe.
    
    Returns:
    
    boolean
  - isBlock
```
public boolean isBlock()
```
    Determine whether these attributes refer to a block special file.
    
    Returns:
    
    boolean
  - isCharacter
```
public boolean isCharacter()
```
    Determine whether these attributes refer to a character device.
    
    Returns:
    
    boolean
  - isSocket
```
public boolean isSocket()
```
    Determine whether these attributes refer to a socket.
    
    Returns:
    
    boolean
  - setType
```
public void setType(int type)
```
  - hasPermissions
```
public boolean hasPermissions()
```

Class SftpFileAttributes

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SSH_FILEXFER_TYPE_REGULAR

SSH_FILEXFER_TYPE_DIRECTORY

SSH_FILEXFER_TYPE_SYMLINK

SSH_FILEXFER_TYPE_SPECIAL

SSH_FILEXFER_TYPE_UNKNOWN

SSH_FILEXFER_TYPE_SOCKET

SSH_FILEXFER_TYPE_CHAR_DEVICE

SSH_FILEXFER_TYPE_BLOCK_DEVICE

SSH_FILEXFER_TYPE_FIFO

S_IFMT

S_MODE_MASK

S_IFSOCK

S_IFLNK

S_IFREG

S_IFBLK

S_IFDIR

S_IFCHR

S_IFIFO

S_ISUID

S_ISGID

S_IRUSR

S_IWUSR

S_IXUSR

S_IRGRP

S_IWGRP

S_IXGRP

S_IROTH

S_IWOTH

S_IXOTH

Constructor Detail

SftpFileAttributes

SftpFileAttributes

Method Detail

setExtendedAttributes

setExtendedAttribute

removeExtendedAttribute

getExtendedAttributes

hasExtendedAttribute

getExtendedAttribute

getUID

hasUsername

hasUID

hasGID

hasGroup

setUID

setUID

getUsername

setGID

setGID

getGroup

getGID

setSize

getSize

hasSize

setPermissions

setPermissionsFromMaskString

setPermissionsFromUmaskString

setPermissions

getPermissions

setTimes

setTimes

getAccessedTime

hasAccessedTime

getModifiedTime

hasModifiedTime

getCreateTime

hasCreateTime

isFlagSet

toByteArray

getModeType

getPermissionsString

getMaskString

isDirectory

isFile