summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/sys/stat.232
1 files changed, 32 insertions, 0 deletions
diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2
index a21d95c..cb6a767 100644
--- a/lib/libc/sys/stat.2
+++ b/lib/libc/sys/stat.2
@@ -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:
OpenPOWER on IntegriCloud