fstat(3f) [bsd man page]

STAT(3F)																  STAT(3F)

NAME

       stat, lstat, fstat - get file status

SYNOPSIS

       integer function stat (name, statb)
       character*(*) name
       integer statb(12)

       integer function lstat (name, statb)
       character*(*) name
       integer statb(12)

       integer function fstat (lunit, statb)
       integer statb(12)

DESCRIPTION

       These  routines	return	detailed  information  about a file.  Stat and lstat return information about file name; fstat returns information
       about the file associated with fortran logical unit lunit.  The order and meaning  of  the  information	returned  in  array  statb  is	as
       described for the structure stat under stat(2).	The ``spare'' values are not included.

       The value of either function will be zero if successful; an error code otherwise.

FILES

       /usr/lib/libU77.a

SEE ALSO

       stat(2), access(3F), perror(3F), time(3F)

BUGS

       Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>.

4.2 Berkeley Distribution					   May 15, 1985 							  STAT(3F)

STAT(2) 							System Calls Manual							   STAT(2)

NAME

       stat, fstat - get file status

SYNOPSIS

       #include <sys/types.h>
       #include <sys/stat.h>

       stat(name, buf)
       char *name;
       struct stat *buf;

       fstat(fildes, buf)
       struct stat *buf;

DESCRIPTION

       Stat  obtains  detailed information about a named file.	Fstat obtains the same information about an open file known by the file descriptor
       from a successful open, creat, dup or pipe(2) call.

       Name points to a null-terminated string naming a file; buf is the address of a buffer into which information is placed concerning the file.
       It is unnecessary to have any permissions at all with respect to the file, but all directories leading to the file must be searchable.  The
       layout of the structure pointed to by buf as defined in <stat.h> is given below.  St_mode is encoded according to the `#define' statements.

       The mode bits 0000070 and 0000007 encode group and others permissions (see chmod(2)).  The defined types, ino_t, off_t, time_t, name  vari-
       ous  width integer values; dev_t encodes major and minor device numbers; their exact definitions are in the include file <sys/types.h> (see
       types(5).

       When fildes is associated with a pipe, fstat reports an ordinary file with restricted permissions.  The size is the number of bytes  queued
       in the pipe.

       st_atime  is  the  file	was last read.	For reasons of efficiency, it is not set when a directory is searched, although this would be more
       logical.  st_mtime is the time the file was last written or created.  It is not set by changes  of  owner,  group,  link  count,  or  mode.
       st_ctime is set both both by writing and changing the i-node.

SEE ALSO

       ls(1), filsys(5)

DIAGNOSTICS

       Zero is returned if a status is available; -1 if the file cannot be found.

ASSEMBLER

       (stat = 18.)
       sys stat; name; buf

       (fstat = 28.)
       (file descriptor in r0)
       sys fstat; buf

																	   STAT(2)