V04::Attributes
A class representing the attributes of a file or directory on the server. It may be used to specify new attributes, or to query existing attributes. This particular class is specific to versions 6 and higher of the SFTP protocol.
To specify new attributes, just pass a hash as the argument to the constructor. The following keys are supported:
:type |
the type of the item (integer, one of the T_ constants) |
:size |
the size of the item (integer) |
the actual number of bytes that the item uses on disk (integer) |
:uid |
the user-id that owns the file (integer) |
:gid |
the group-id that owns the file (integer) |
:owner |
the name of the user that owns the file (string) |
:group |
the name of the group that owns the file (string) |
:permissions |
the permissions on the file (integer, e.g. 0755) |
:atime |
the access time of the file (integer, seconds since epoch) |
:atime_nseconds |
the nanosecond component of atime (integer) |
:createtime |
the time at which the file was created (integer, seconds since epoch) |
:createtime_nseconds |
the nanosecond component of createtime (integer) |
:mtime |
the modification time of the file (integer, seconds since epoch) |
:mtime_nseconds |
the nanosecond component of mtime (integer) |
:ctime |
the time that the file's attributes were last changed (integer) |
the nanosecond component of ctime (integer) |
:acl |
an array of ACL entries for the item |
other attributes of the file or directory (as a bit field) (integer) |
a mask describing which bits in attrib_bits are valid (integer) |
whether the file may or may not contain textual data (integer) |
the mime type of the file (string) |
the hard link count of the file (integer) |
the value of the filename before filename translation was attempted (string) |
:extended |
a hash of name/value pairs identifying extended info |
Likewise, when the server sends an Attributes object, all of the above attributes are exposed as methods (though not all will be set with non-nil values from the server).
Generated with the Darkfish Rdoc Generator 2.