SNOBOL4STAT(3) | CSNOBOL4B 2.2.1 | December 18, 2020

NAME

snobol4stat – file status interface for SNOBOL4

SYNOPSYS

-INCLUDE 'stat.sno'

DESCRIPTION

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
time of last access (data read) 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 (NOT file creation time!) in seconds since January 1st, 1970.

ST_CTIMENSEC
Fractional change time in nanoseconds. (*)

ST_BTIME
File birth (creation) time in seconds since January 1st, 1970. (*)

ST_BTIMENSEC
Fractional birth time in nanoseconds. (*)

(*) Not available on all platforms. Values will be the empty string if the data is not available.

SEE ALSO

snobol4(1), stat(2), lstat(2), fstat(2), snobol4time(3)

AUTHOR

Philip L. Budne