summaryrefslogtreecommitdiff
path: root/usr.bin/stat
diff options
context:
space:
mode:
authorMarc Espie <espie@cvs.openbsd.org>2007-11-05 16:58:35 +0000
committerMarc Espie <espie@cvs.openbsd.org>2007-11-05 16:58:35 +0000
commitbdaf82fba4460d5275ea2c20bccec30accd23f1f (patch)
tree460d219a3d9b138c1112b2d63500cfc87ab3a91a /usr.bin/stat
parent6cc4736b554ad6efc06e020965a97a1e3bfc294e (diff)
relate fields to stat(2).
with help from jmc@ for wording and nroff magic
Diffstat (limited to 'usr.bin/stat')
-rw-r--r--usr.bin/stat/stat.155
1 files changed, 42 insertions, 13 deletions
diff --git a/usr.bin/stat/stat.1 b/usr.bin/stat/stat.1
index 53f160ac872..938971e6692 100644
--- a/usr.bin/stat/stat.1
+++ b/usr.bin/stat/stat.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: stat.1,v 1.13 2007/11/05 14:49:59 jmc Exp $
+.\" $OpenBSD: stat.1,v 1.14 2007/11/05 16:58:34 espie Exp $
.\" $NetBSD: stat.1,v 1.11 2003/05/08 13:07:10 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
@@ -65,6 +65,23 @@ displays information about the file descriptor for standard input.
The information displayed is obtained by calling
.Xr lstat 2
with the given argument and evaluating the returned structure.
+The default format displays the
+.Fa st_dev ,
+.Fa st_ino ,
+.Fa st_mode ,
+.Fa st_nlink ,
+.Fa st_uid ,
+.Fa st_gid ,
+.Fa st_rdev ,
+.Fa st_size ,
+.Fa st_atime ,
+.Fa st_mtime ,
+.Fa st_ctime ,
+.Fa st_blksize ,
+.Fa st_blocks ,
+and
+.Fa st_flags
+fields, in that order.
.Pp
The options are as follows:
.Bl -tag -width Ds
@@ -279,41 +296,53 @@ A required field specifier, being one of the following:
.It Cm d
Device upon which
.Ar file
-resides.
+resides
+.Pq Fa st_dev .
.It Cm i
.Ar file Ns 's
-inode number.
+inode number
+.Pq Fa st_ino .
.It Cm p
-File type and permissions.
+File type and permissions
+.Pq Fa st_mode .
.It Cm l
Number of hard links to
-.Ar file .
+.Ar file
+.Pq Fa st_nlink .
.It Cm u , g
User-id and group-id of
.Ar file Ns 's
-owner.
+owner
+.Pq Fa st_uid , st_gid .
.It Cm r
-Device number for character and block device special files.
+Device number for character and block device special files
+.Pq Fa st_rdev .
.It Cm a , m , c , B
The time
.Ar file
was last accessed or modified, or when the inode was last changed, or
-the birth time of the inode.
+the birth time of the inode
+.Pq Fa st_atimespec , st_mtimespec , st_ctimespec .
If the file system does not support birth time, the value is undefined.
.It Cm z
The size of
.Ar file
-in bytes.
+in bytes
+.Pq Fa st_size .
.It Cm b
Number of blocks allocated for
-.Ar file .
+.Ar file
+.Pq Fa st_blocks .
.It Cm k
-Optimal file system I/O operation block size.
+Optimal file system I/O operation block size
+.Pq Fa st_blksize .
.It Cm f
User defined flags for
-.Ar file .
+.Ar file
+.Pq Fa st_flags .
.It Cm v
-Inode generation number.
+Inode generation number
+.Pq Fa st_gen .
.El
.Pp
The following four field specifiers are not drawn directly from the