On success, an object representing the stat values. On failure,
nil
is returned together with a second value.
Indicates the errno value returned by the system call. This second value is returned only in the case of failure.
file-stat
is an object representing the stat values, as would be returned by the system call
stat
(for a filename) or the system call
fstat
(for an fd).
The values in
file-stat
are the raw data, and it is the responsibility of the user to interpret them when needed. See the UNIX manual entry for
stat
for details.
The values can be read from file-stat by these readers:
The id of the device where the file is.
The user id of the owner of the file.
The group id of the file's group.
The size of the file in bytes.
The number of 512-bytes blocks used by the file.
The protection value of the file.
The time of the last access to the file in seconds from 1 January 1970.
The time of the last change in the data of the file in seconds from 1 January 1970.
The time of the last modification of the file status in seconds from 1 January 1970.