d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document more fields of struct stat.

Browse Source 
Note to mdoc(7) police:
The document date has already been touched today.
This commit is contained in:
yar 2004-11-15 14:16:31 +00:00
parent 956c47074f
commit 07e57c11e7
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
lib/libc/sys/stat.2
View File

@ -87,6 +87,24 @@ as defined by
.In sys/stat.h
and into which information is placed concerning the file.
.Pp
The fields of
.Vt "struct stat"
related to the file system are as follows:
.Bl -tag -width ".Va st_nlink"
.It Va st_dev
The numeric ID of the device containing the file.
.It Va st_ino
The file's inode number.
.It Va st_nlink
The number of hard links to the file.
.El
.Pp
The
.Va st_dev
and
.Va st_ino
fields together identify the file uniquely within the system.
.Pp
The time-related fields of
.Vt "struct stat"
are as follows:
@ -151,6 +169,8 @@ The size-related fields of the
.Vt "struct stat"
are as follows:
.Bl -tag -width ".Va st_blksize"
.It Va st_size
The file size in bytes.
.It Va st_blksize
The optimal I/O block size for the file.
.It Va st_blocks
@ -159,6 +179,18 @@ As short symbolic links are stored in the inode, this number may
be zero.
.El
.Pp
The access-related fields of
.Vt "struct stat"
are as follows:
.Bl -tag -width ".Va st_mode"
.It Va st_uid
The user ID of the file's owner.
.It Va st_gid
The group ID of the file.
.It Va st_mode
Status of the file (see below).
.El
.Pp
The status information word
.Fa st_mode
has the following bits: