# SNOBOL4STAT(3) | CSNOBOL4B 2.3.2 | Janurary 1, 2024

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