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