stat(5)

Synopsis

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

Description

   dev_t    st_dev;			/ ID of device containing a directory /
   				/ entry for this file /
   ino_t    st_ino; +		 	/ Inode number /
   mode_t   st_mode;			/ File mode [see mknod)] /
   nlink_t  st_nlink;			/ Number of links /
   uid_t    st_uid;			/ User ID of the file's owner /
   gid_t    st_gid;			/ Group ID of the file's group /
   dev_t    st_rdev;			/ ID of device. This entry is defined only /
   				/ for char special or block special files /
   off_t    st_size; +		/ File size in bytes /
   time_t   st_atime;			/ Time of last access /
   time_t   st_mtime;			/ Time of last data modification /
   time_t   st_ctime;			/ Time of last file status change /
   				/ Times measured in seconds since /
   				/ 00:00:00 UTC, Jan. 1, 1970 /
   long     st_blksize;		/ Preferred I/O block size /
   blkcnt_t st_blocks; +		/ Number of 512 blocks allocated /
                           		/A files residing on an s5 filesystem /
                           		/reports number of blocks allocated /
                           		/assuming no holes in the file /
   char     st_fstype[_ST_FSTYPSZ];	/ name of filesystem type /
   int      st_aclcnt;		/ number of ACL entries (default is 4)/
   level_t  st_level;			/ unused /
   unsigned long  st_flags;		/ contains MOUNTED flag/

   int	st_aclcnt;	/ Number of ACL entries /
   lid_t	st_level;	/ unused /
   ulong   st_flags;	/ contains MOUNTED flag /

+

This data type is a 32 bit/64 bit switchable data type. See ``Large File Support'' on intro(2) for information on Large File Support (LFS).

st_dev

This field uniquely identifies the file system that contains the file. Its value may be used as input to the ustat(2) system call to determine more information about this file system. No other meaning is associated with this value.

st_ino

This field uniquely identifies the file in a given file system. The pair st_ino and st_dev uniquely identify regular files.

st_mode

The mode of the file as described in mknod(1M). In addition to the modes described in mknod(1M), the mode of a file may also be S_IFLNK if the file is a symbolic link. (Note that S_IFLNK may only be returned by lstat.)

st_nlink

This field should be used only by administrative commands.

st_uid

The user ID of the file's owner.

st_gid

The group ID of the file's group.

st_rdev

This field should be used only by administrative commands. It is valid only for block special or character special files and only has meaning on the system where the file was configured.

st_size

For regular files, this is the address of the end of the file. Defined for block devices, although the size may be zero if the device size is unknown. See also pipe(2).

st_atime

Time when file data was last accessed. Changed by the following system calls: creat(2), mknod(2), pipe, utime(2), and read(2).

st_mtime

Time when data was last modified. Changed by the following system calls: creat, mknod, pipe, utime, and write(2).

st_ctime

Time when file status was last changed. Changed by the following system calls: chmod(2), chown(2), creat, link(2), mknod(2), pipe, unlink, utime(2), and write.

st_blksize

A hint as to the ``best'' unit size for I/O operations. This field is not defined for block-special or character-special files.

st_blocks

The total number of physical blocks of size 512 bytes actually allocated on disk. This field is not defined for block-special or character-special files. A file residing on an s5 filesystem reports number of blocks allocated assuming no holes in the file.

st_fstype

The name of the filesystem type.

st_aclcnt

The total number of entries in the file's Access Control List. This includes the 4 basic entries (owner, group, class, other) as well as extended ACL entries.

st_level

Currently unused.

st_aclcnt

The number of ACL entries (the default is 4).

st_level

Currently unused.

st_flags

_S_ISMOUNTED indicates that path is a block or character special file that contains a mounted file system. This flag is reserved for use by administrative commands and is not intended for general application use.

The constants used in the st_mode field are also defined in this file:

   #define	S_IFMT	/* type of file */
   #define	S_IAMB	/* access mode bits */
   #define	S_IFIFO	/* fifo */
   #define	S_IFCHR	/* character special */
   #define	S_IFDIR	/* directory */
   #define	S_IFNAM	/* obsolete XENIX special named file */
   #define	S_INSEM	/* obsolete XENIX semaphore subtype of IFNAM */
   #define	S_INSHD	/* obsolete XENIX shared data subtype of IFNAM */
   #define	S_IFBLK	/* block special */
   #define	S_IFREG	/* regular */
   #define	S_IFLNK	/* symbolic link */
   #define	S_ISUID	/* set user id on execution */
   #define	S_ISGID	/* set group id on execution */
   #define	S_ISVTX	/* save swapped text even after use */
   #define	S_IREAD	/* read permission, owner */
   #define	S_IWRITE	/* write permission, owner */
   #define	S_IEXEC	/* execute/search permission, owner */
   #define	S_ENFMT	/* record locking enforcement flag */
   #define	S_IRWXU	/* read, write, execute: owner */
   #define	S_IRUSR	/* read permission: owner */
   #define	S_IWUSR	/* write permission: owner */
   #define	S_IXUSR	/* execute permission: owner */
   #define	S_IRWXG	/* read, write, execute: group */
   #define	S_IRGRP	/* read permission: group */
   #define	S_IWGRP	/* write permission: group */
   #define	S_IXGRP	/* execute permission: group */
   #define	S_IRWXO	/* read, write, execute: other */
   #define	S_IROTH	/* read permission: other */
   #define	S_IWOTH	/* write permission: other */
   #define	S_IXOTH	/* execute permission: other */

The following macros are for POSIX conformance:

   #define   S_ISBLK(mode)	/* block special file */
   #define   S_ISCHR(mode)	/* character special file */
   #define   S_ISDIR(mode)	/* directory file */
   #define   S_ISFIFO(mode)	/* pipe or fifo file */
   #define   S_ISREG(mode)	/* regular file */

References