stat.5 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

stat(5) stat(5)

S_IWUSR 0000200

write access permission for owner

S_IXUSR 0000100

execute/search access permission for owner

S_IRWXG 0000070

group’s ﬁle access permission bits

S_IRGRP 0000040

read access permission for group

S_IWGRP 0000020

write access permission for group

S_IXGRP 0000010

execute/search access permission for group

S_IRWXO 0000007

others’ access permission bits

S_IROTH 0000004

read access permission for others

S_IWOTH 0000002

write access permission for others

S_IXOTH 0000001

execute/search access permission for others

File mode bits: obsolete permission names

S_IREAD 0000400 read access permission for owner

S_IWRITE 0000200

write access permission for owner

S_IEXEC 0000100 execute/search access permission for owner

The bits deﬁned by

S_IRUSR

, S_IWUSR, S_IXUSR, S_IRGRP, S_IWGRP, S_IXGRP, S_IROTH,

S_IWOTH, S_IXOTH, S_ISUID, S_ISGlD

and S_ISVTX are unique. S_IRWXU is the bitwise OR of

S_IRUSR, S_IWUSR, and S_IXUSR. S_IRWXG

is the bitwise OR of S_IRGRP, S_IWGRP, and

S_IXGRP. S_IRWXO is the bitwise OR of

S_IROTH, S_IWOTH, and S_IXOTH.

Implementations may OR other implementation-dependent bits into

S_IRWXU, S_IRWXG, and

S_IRWXO, but they will not overlap any of the other bits deﬁned in this document. The ﬁle permission

bits are deﬁned to be those corresponding to the bitwise inclusive OR of

S_IRWXU, S_IRWXG, and

S_IRWXO.

The following macros will test whether a ﬁle is of the speciﬁed type. The value m supplied to the macros

is the value of

st_mode from a stat structure. The macro evaluates to a non-zero value if the test is

true, 0 if the test is false.

S_ISBLK( m) Test for a block special ﬁle.

S_ISCHR( m) Test for a character special ﬁle.

S_ISDIR( m) Test for a directory.

S_ISFIFO( m) Test for a pipe or FIFO special ﬁle.

S_ISREG( m) Test for a regular ﬁle.

S_ISLNK( m) Test for a symbolic link.

S_ISCDF( m) Test for a context-dependent ﬁle

S_ISNWK( m) Test for a network special

S_ISSOCK( m) Test for a socket

The following are declared as functions and may also be deﬁned as macros:

int chmod(const char *path, mode_t mode);

int lstat(const char *path, struct stat *buf);

int mkdir(const char *path, mode_t mode);

int mkfifo(const char *path, mode_t mode);

int mknod(const char *path, mode_t mode, dev_t dev);

int stat(const char *path, struct stat *buf);

mode_t umask(mode_t cmask);

Use of the macros is recommended for determining the type of a ﬁle.

WARNINGS

For 32-bit applications,

st_ino will be truncated to its least signiﬁcant 32-bits for ﬁle systems that use

64-bit values.