Return to fstat CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / MULTI

Annotation of coherent/a/usr/man/MULTI/fstat, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: fstat()                  General Function                 fstat()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Find file attributes
        !             9: 
        !            10: #include <sys/stat.h>
        !            11: ffssttaatt(_d_e_s_c_r_i_p_t_o_r, _s_t_a_t_p_t_r) iinntt _d_e_s_c_r_i_p_t_o_r; ssttrruucctt ssttaatt *_s_t_a_t_p_t_r;
        !            12: 
        !            13: fstat returns a structure  that contains the attributes of a file
        !            14: including  protection  information,  file  type, and  file  size.
        !            15: descriptor is the file  descriptor for the open file, and statptr
        !            16: points to a  structure of the type stat, which  is defined in the
        !            17: header file stat.h.
        !            18: 
        !            19: The following summarizes  the structure stat and defines the per-
        !            20: mission and file type bits.
        !            21: 
        !            22: 
        !            23: struct stat {
        !            24:     dev_t st_dev;
        !            25:     ino_t st_ino;
        !            26:     unsigned short st_mode;
        !            27:     short st_nlink;
        !            28:     short st_uid;
        !            29:     short st_gid;
        !            30:     dev_t st_rdev;
        !            31:     size_t st_size;
        !            32:     time_t st_atime;
        !            33:     time_t st_mtime;
        !            34:     time_t st_ctime;
        !            35: };
        !            36: 
        !            37: 
        !            38: 
        !            39: #define S_IFMT 0170000 /* file types */
        !            40: #define S_IFREG 0100000/* ordinary file */
        !            41: #define S_IFDIR 0040000/* directory */
        !            42: #define S_IFCHR 0020000/* character special */
        !            43: #define S_IFBLK 0060000/* block special */
        !            44: #define S_ISUID 0004000/* set user id */
        !            45: #define S_ISGID 0002000/* set group id */
        !            46: #define S_ISVTX 0001000/* save text bit */
        !            47: #define S_IREAD 0000400/* owner read permission */
        !            48: #define S_IWRITE 000200/* owner write permission */
        !            49: #define S_IEXEC 0000100/* owner execute permission */
        !            50: 
        !            51: 
        !            52: The entries st_dev  and st_ino together form a unique description
        !            53: of the file.  The former is  the device on which the file and its
        !            54: i-node  reside, whereas  the latter  is the  index number  of the
        !            55: file.  The  entry st_mode gives the  permission bits, as outlined
        !            56: above.  The entry st_nlink gives the number of links to the file.
        !            57: The user  id and  group id  of the owner  are st_uid  and st_gid,
        !            58: respectively.  The  entry st_rdev, valid only  for special files,
        !            59: holds the major and minor numbers for the file.
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: fstat()                  General Function                 fstat()
        !            70: 
        !            71: 
        !            72: 
        !            73: The entry  st_size gives the size  of the file, in  bytes.  For a
        !            74: pipe, the size is the number of bytes waiting to be read from the
        !            75: pipe.
        !            76: 
        !            77: Three entries for each  file give the last occurrences of various
        !            78: events in  the file's history.  st_atime gives  time the file was
        !            79: last read  or written  to.  st_mtime gives  the time of  the last
        !            80: modification, write for  files, create or delete entry for direc-
        !            81: tories.  st_ctime  gives the last  change to the  attributes, not
        !            82: including times and size.
        !            83: 
        !            84: ***** Example *****
        !            85: 
        !            86: For an  example of how  to use this  function, see the  entry for
        !            87: pipe.
        !            88: 
        !            89: ***** Files *****
        !            90: 
        !            91: <sys/stat.h>
        !            92: 
        !            93: ***** See Also *****
        !            94: 
        !            95: chmod(), chown(), COHERENT system calls, ls, open(), stat()
        !            96: 
        !            97: ***** Notes *****
        !            98: 
        !            99: fstat differs  from the related  function stat mainly  in that it
        !           100: accesses the file through its descriptor, which was returned by a
        !           101: successful call to open,  whereas stat takes the file's path name
        !           102: and opens it itself before checking its status.
        !           103: 
        !           104: ***** Diagnostics *****
        !           105: 
        !           106: fstat returns  -1 if the file  is not found or  if statptr is in-
        !           107: valid.
        !           108: 
        !           109: 
        !           110: 
        !           111: 
        !           112: 
        !           113: 
        !           114: 
        !           115: 
        !           116: 
        !           117: 
        !           118: 
        !           119: 
        !           120: 
        !           121: 
        !           122: 
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.