diff options
author | Marc Espie <espie@cvs.openbsd.org> | 2007-11-05 16:58:35 +0000 |
---|---|---|
committer | Marc Espie <espie@cvs.openbsd.org> | 2007-11-05 16:58:35 +0000 |
commit | bdaf82fba4460d5275ea2c20bccec30accd23f1f (patch) | |
tree | 460d219a3d9b138c1112b2d63500cfc87ab3a91a /usr.bin/stat | |
parent | 6cc4736b554ad6efc06e020965a97a1e3bfc294e (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.1 | 55 |
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 |