diff options
author | dougb <dougb@FreeBSD.org> | 2010-12-05 22:41:58 +0000 |
---|---|---|
committer | dougb <dougb@FreeBSD.org> | 2010-12-05 22:41:58 +0000 |
commit | 0758a1dee9d38ddc5f360845c2e6901da3d0d322 (patch) | |
tree | 8f52211c482fee666ff89c77b5325a17a0919ff9 /usr.bin/stat | |
parent | 91e61ea9fc5a14b27d49a05b90e2732126f1a86c (diff) | |
download | FreeBSD-src-0758a1dee9d38ddc5f360845c2e6901da3d0d322.zip FreeBSD-src-0758a1dee9d38ddc5f360845c2e6901da3d0d322.tar.gz |
Bring in the following changes from NetBSD:
1.21
"Document the flags displayed by the default format, and mention their short
names. From espie@openbsd via jmc@openbsd."
1.24
"Fix three variable names.
From Todd T. Fries via Jason McIntyre."
Obtained from: wiz@NetBSD.org (previous 2)
1.25
"Be consistent: document the birthtime field of struct stat for
the "B" field specifier."
Obtained from: reed@NetBSD.org
1.26
"Drop trailing space."
Obtained from: wiz@NetBSD.org
1.27
"Since we have st_birthtime in struct stat, it is in default display."
Obtained from: enami@NetBSD.org
Purposely skipping the following revisions:
1.22 NetBSD-specific change
1.23 Removal of license clauses 3 and 4, already handled by imp
in our r203971
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 2c800e7..4b51431 100644 --- a/usr.bin/stat/stat.1 +++ b/usr.bin/stat/stat.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: stat.1,v 1.19 2006/10/07 10:41:50 elad Exp $ +.\" $NetBSD: stat.1,v 1.27 2010/03/11 21:37:01 enami Exp $ .\" .\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -68,7 +68,7 @@ will print nothing and exit with an error. If the .Fl f option is specified, the output is canonicalized by following every symlink -in every component of the given path recursively. +in every component of the given path recursively. .Nm readlink will resolve both absolute and relative paths, and return the absolute pathname corresponding to @@ -78,6 +78,24 @@ In this case, the argument does not need to be a symbolic link. 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_birthtime , +.Fa st_blksize , +.Fa st_blocks , +and +.Fa st_flags +fields, in that order. .Pp The options are as follows: .Bl -tag -width indent @@ -354,40 +372,51 @@ 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_atime , st_mtime , st_ctime , st_birthtime . .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 . .It Cm v -Inode generation number. +Inode generation number +.Pq Fa st_gen . .El .Pp The following five field specifiers are not drawn directly from the |