stat(5P) INTERACTIVE UNIX System (POSIX) stat(5P)
NAME
stat - data returned by stat system call
SYNOPSIS
#include <sys/types.h>
#include <sys/stat.h>
DESCRIPTION
The system calls stat and fstat return data whose structure
is defined by this include file. The encoding of the field
st_mode is defined in this file also.
Structure of the result of stat:
struct stat
{
dev_t st_dev;
ino_t st_ino;
mode_t st_mode;
nlink_t st_nlink;
uid_t st_uid;
gid_t st_gid;
dev_t st_rdev;
off_t st_size;
time_t st_atime;
time_t st_mtime;
time_t st_ctime;
};
#define S_IFMT 0170000 /* type of file */
#define S_IFDIR 0040000 /* directory */
#define S_IFCHR 0020000 /* character special */
#define S_IFBLK 0060000 /* block special */
#define S_IFREG 0100000 /* regular */
#define S_IFIFO 0010000 /* fifo */
#define S_ISUID 04000 /* set user id on execution */
#define S_ISGID 02000 /* set group id on execution */
#define S_ISVTX 01000 /* save swapped text even after use */
#define S_IREAD 00400 /* read permission, owner */
#define S_IWRITE 00200 /* write permission, owner */
#define S_IEXEC 00100 /* execute/search permission, owner */
#define S_ENFMT S_ISGID /* record locking enforcement flag */
#define S_IRWXU 00700 /* read, write, execute: owner */
#define S_IRUSR 00400 /* read permission: owner */
#define S_IWUSR 00200 /* write permission: owner */
#define S_IXUSR 00100 /* execute permission: owner */
#define S_IRWXG 00070 /* read, write, execute: group */
#define S_IRGRP 00040 /* read permission: group */
#define S_IWGRP 00020 /* write permission: group */
#define S_IXGRP 00010 /* execute permission: group */
#define S_IRWXO 00007 /* read, write, execute: other */
#define S_IROTH 00004 /* read permission: other */
Rev. 1.1 Page 1
stat(5P) INTERACTIVE UNIX System (POSIX) stat(5P)
#define S_IWOTH 00002 /* write permission: other */
#define S_IXOTH 00001 /* execute permission: other */
The following macros test whether a file is of the specified
type. The argument is the value of st_mode from a stat
structure. The result is nonzero if the test is true, zero
if the test is false.
S_ISDIR(m)
Test for directory file.
S_ISCHR(m)
Test for character special file.
S_ISBLK(m)
Test for block special file.
S_ISREG(m)
Test for regular file.
S_ISFIFO(m)
Test for pipe or FIFO special file.
SEE ALSO
stat(2), types(5P).
Rev. 1.1 Page 2