summaryrefslogtreecommitdiff
path: root/lib/libc/sys/stat.2
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-12-04 22:16:40 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-12-04 22:16:40 +0000
commitfc87c119bf5626ebd4f3b71eac56fc7db8ca426e (patch)
tree9c83db9e7b99d936ec833dc913513cf32be89e07 /lib/libc/sys/stat.2
parentdaf87f59e9e395845d19dd3e98db2edc0a632a1d (diff)
Formatting fixes, suggested by ericj@
Diffstat (limited to 'lib/libc/sys/stat.2')
-rw-r--r--lib/libc/sys/stat.263
1 files changed, 32 insertions, 31 deletions
diff --git a/lib/libc/sys/stat.2 b/lib/libc/sys/stat.2
index 47ba2850cd4..2643b3a700f 100644
--- a/lib/libc/sys/stat.2
+++ b/lib/libc/sys/stat.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: stat.2,v 1.10 1999/07/05 06:08:05 aaron Exp $
+.\" $OpenBSD: stat.2,v 1.11 1999/12/04 22:16:39 aaron Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -75,7 +75,8 @@ Instead, these attributes are taken from the directory that
contains the link.
The only attributes returned from an
.Fn lstat
-that refer to the symbolic link itself are the file type (S_IFLNK),
+that refer to the symbolic link itself are the file type
+.Pq Dv S_IFLNK ,
size, blocks, and link count (always 1).
.Pp
The
@@ -117,7 +118,7 @@ The time-related fields of
.Li struct stat
are as follows:
.Bl -tag -width XXXst_mtime
-.It st_atime
+.It Fa st_atime
Time when file data was last accessed.
Changed by the
.Xr mknod 2 ,
@@ -125,7 +126,7 @@ Changed by the
and
.Xr read 2
system calls.
-.It st_mtime
+.It Fa st_mtime
Time when file data was last modified.
Changed by the
.Xr mknod 2 ,
@@ -133,7 +134,7 @@ Changed by the
and
.Xr write 2
system calls.
-.It st_ctime
+.It Fa st_ctime
Time when file status was last changed (inode data modification).
Changed by the
.Xr chmod 2 ,
@@ -152,9 +153,9 @@ The size-related fields of the
.Li struct stat
are as follows:
.Bl -tag -width XXXst_blksize
-.It st_blksize
+.It Fa st_blksize
The optimal I/O block size for the file.
-.It st_blocks
+.It Fa st_blocks
The actual number of blocks allocated for the file in 512-byte units.
As short symbolic links are stored in the inode, this number may
be zero.
@@ -164,21 +165,21 @@ The status information word
.Fa st_mode
has the following bits:
.Bd -literal
-#define S_IFMT 0170000 /* type of file */
-#define S_IFIFO 0010000 /* named pipe (fifo) */
-#define S_IFCHR 0020000 /* character special */
-#define S_IFDIR 0040000 /* directory */
-#define S_IFBLK 0060000 /* block special */
-#define S_IFREG 0100000 /* regular */
-#define S_IFLNK 0120000 /* symbolic link */
-#define S_IFSOCK 0140000 /* socket */
-#define S_IFWHT 0160000 /* whiteout */
-#define S_ISUID 0004000 /* set user id on execution */
-#define S_ISGID 0002000 /* set group id on execution */
-#define S_ISVTX 0001000 /* save swapped text even after use */
-#define S_IRUSR 0000400 /* read permission, owner */
-#define S_IWUSR 0000200 /* write permission, owner */
-#define S_IXUSR 0000100 /* execute/search permission, owner */
+#define S_IFMT 0170000 /* type of file */
+#define S_IFIFO 0010000 /* named pipe (fifo) */
+#define S_IFCHR 0020000 /* character special */
+#define S_IFDIR 0040000 /* directory */
+#define S_IFBLK 0060000 /* block special */
+#define S_IFREG 0100000 /* regular */
+#define S_IFLNK 0120000 /* symbolic link */
+#define S_IFSOCK 0140000 /* socket */
+#define S_IFWHT 0160000 /* whiteout */
+#define S_ISUID 0004000 /* set user id on execution */
+#define S_ISGID 0002000 /* set group id on execution */
+#define S_ISVTX 0001000 /* save swapped text even after use */
+#define S_IRUSR 0000400 /* read permission, owner */
+#define S_IWUSR 0000200 /* write permission, owner */
+#define S_IXUSR 0000100 /* execute/search permission, owner */
.Ed
.Pp
For a list of access modes, see
@@ -193,14 +194,14 @@ Otherwise, a value of \-1 is returned and
is set to indicate the error.
.Sh COMPATIBILITY
Previous versions of the system used different types for the
-.Li st_dev ,
-.Li st_uid ,
-.Li st_gid ,
-.Li st_rdev ,
-.Li st_size ,
-.Li st_blksize
+.Fa st_dev ,
+.Fa st_uid ,
+.Fa st_gid ,
+.Fa st_rdev ,
+.Fa st_size ,
+.Fa st_blksize
and
-.Li st_blocks
+.Fa st_blocks
fields.
.Sh ERRORS
.Fn stat
@@ -212,9 +213,9 @@ will fail if:
A component of the path prefix is not a directory.
.It Bq Er ENAMETOOLONG
A component of a pathname exceeded
-.Dv {NAME_MAX}
+.Dv NAME_MAX
characters, or an entire path name exceeded
-.Dv {PATH_MAX}
+.Dv PATH_MAX
characters.
.It Bq Er ENOENT
The named file does not exist.