SNOBOL4STAT(3)

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
    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.

SEE ALSO
snobol4(1), stat(2), lstat(2), fstat(2)

AUTHOR
Philip L. Budne