home | help
SNOBOL4STAT(3)			 CSNOBOL4 Manual		  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 char-
		    acter  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

CSNOBOL4B 2.3.1 		 March 31, 2022 		  SNOBOL4STAT(3)

home | help