snobol4stat - file status interface for SNOBOL4
STAT(path) returns file status for path, following
symbolic links. LSTAT(path) returns file status for
path, returning information on symbolic links.
FSTAT(fd) returns file status for the open file
descriptor fd. All three return a DATA() object with the
following members:
- ST_DEV
- The device number containing the file.
- ST_INO
- The file number within the device.
- ST_TYPE_STR
- Is a STRING identifiying the file type: '-' for a regular
file, 'b' for a block special file (device), 'c' for a
character special file (device), 'd' for a directory, 'l'
for a symbolic link, 'p' for a named pipe (FIFO), 's' for a
local (Unix) domain socket, 'w' for a whiteout, '?' for none
of the above. (new in CSNOBOL4 2.1)
- ST_TYPE
- Is an INTEGER identifiying the file type (ordinal value of
ST_TYPE_STR result, for backwards compatibility).
- ST_MODE
- File "mode" (protection and type) bits.
- ST_NLINK
- The number of (hard) links to the file.
- ST_UID
- The owner of the file.
- ST_GID
- The group of the file.
- ST_RDEV
- Device id for special file.
- ST_SIZE
- Size in bytes.
- ST_BLOCKS
- Size in blocks.
- ST_BLKSIZE
- Preferred block size for file I/O.
- ST_ATIME
- Access time in seconds since January 1st, 1970.
- ST_ATIMENSEC
- fractional access time in nanoseconds.
- ST_MTIME
- Data modification time in seconds since January 1st, 1970.
- ST_MTIMENSEC
- Fractional modification time in nanoseconds.
- ST_CTIME
- Metadata change time in seconds since January 1st, 1970.
- ST_CTIMENSEC
- Fractional change time in nanoseconds.
Values will be the empty string if the data is not available.
snobol4(1), stat(2), lstat(2), fstat(2)