Provides read access to the C stat structure which describes files.
system
get-file-stat filename-or-fd => file-stat, errno
| filename-or-fd⇩ |
A string denoting a file, or a file descriptor. |
| file-stat⇩ |
On success, an object representing the stat values, otherwise nil. |
| errno⇩ |
On failure, indicates the errno value returned by the system call. |
The function get-file-stat returns an object representing the stat values associated with filename-or-fd, as would be returned by the system call stat (for a filename) or the system call fstat (for an fd). It is not applicable on Microsoft Windows.
The values in file-stat are the raw data, and it is the responsibility of the user to interpret them when needed. See the POSIX manual entry for stat for details.
On failure, nil is returned as the first value file-stat and the second value errno is the errno from the system call.
The values can be read from file-stat by these readers:
| The inode of the file. | |
| 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. | |
| The number of hard links to the file. | |
| The device type (sometimes called Rdev). | |
LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:31:02