stat(5)
stat --
data returned by stat and stat64 system call
Synopsis
#include <sys/types.h>
#include <sys/stat.h>
Description
The stat.h header
defines the stat structure and the
stat64 structure, in which
the system calls
stat(2),
stat64(2),
lstat(2),
lstat64(2),
fstat(2),
and
fstat64(2)
return data.
They include the following members:
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
stat(2),
stat64(2),
types(5)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004