summaryrefslogtreecommitdiffstats
path: root/usr.bin/stat
diff options
context:
space:
mode:
authordougb <dougb@FreeBSD.org>2010-12-05 22:41:58 +0000
committerdougb <dougb@FreeBSD.org>2010-12-05 22:41:58 +0000
commit0758a1dee9d38ddc5f360845c2e6901da3d0d322 (patch)
tree8f52211c482fee666ff89c77b5325a17a0919ff9 /usr.bin/stat
parent91e61ea9fc5a14b27d49a05b90e2732126f1a86c (diff)
downloadFreeBSD-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.155
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
OpenPOWER on IntegriCloud