stat(3f)                                                              stat(3f)

       stat, lstat, fstat - returns file status

       integer stat, err, statb(13)
       character*len name
       external stat
       err = stat ( name, statb )

       integer lstat, err, statb(13)
       character*len name
       external lstat
       err = lstat ( name, statb )

       integer fstat, err, lunit, statb(13)
       external fstat
       err = fstat ( lunit, statb )

       These routines return detailed information about a file.  The stat
       function returns information about the specified file name.

       The lstat function is like stat except when a named file is a symbolic
       link.  In this case, lstat returns information about the link; stat
       returns information about the file that is referenced by the link.

       The fstat function returns information about the file associated with
       logical unit lunit.

       The meaning of the information returned in array statb is as described
       for the structure stat in stat(2).  The order is shown below:

            statb(1)   device inode resides on
            statb(2)   this inode's number
            statb(3)   protection
            statb(4)   number of hard links to the file
            statb(5)   user-id of owner
            statb(6)   group-id of owner
            statb(7)   the device type, for inode that is device
            statb(8)   total size of file
            statb(9)   file last access time
            statb(10)  file last modify time
            statb(11)  file last status change time
            statb(12)  optimal blocksize for file system i/o ops
            statb(13)  actual number of blocks allocated

       Pathnames cannot be longer than MAXPATHLEN (as defined in sys/param.h

Return Values
       If the stat function is successful, a zero is returned; otherwise, an
       error code is returned.


See Also
       stat(2), access(3f), time(3f)

       The values returned in statb(12) and statb(13) are incorrect on
       machines running IRIX.