svn commit: r216218 - head/usr.bin/stat
Doug Barton
dougb at FreeBSD.org
Sun Dec 5 22:41:58 UTC 2010
Author: dougb
Date: Sun Dec 5 22:41:58 2010
New Revision: 216218
URL: http://svn.freebsd.org/changeset/base/216218
Log:
Bring in the following changes from NetBSD:
1.21
"Document the flags displayed by the default format, and mention their short
names. From espie at openbsd via jmc at openbsd."
1.24
"Fix three variable names.
From Todd T. Fries via Jason McIntyre."
Obtained from: wiz at NetBSD.org (previous 2)
1.25
"Be consistent: document the birthtime field of struct stat for
the "B" field specifier."
Obtained from: reed at NetBSD.org
1.26
"Drop trailing space."
Obtained from: wiz at NetBSD.org
1.27
"Since we have st_birthtime in struct stat, it is in default display."
Obtained from: enami at 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
Modified:
head/usr.bin/stat/stat.1
Modified: head/usr.bin/stat/stat.1
==============================================================================
--- head/usr.bin/stat/stat.1 Sun Dec 5 22:37:01 2010 (r216217)
+++ head/usr.bin/stat/stat.1 Sun Dec 5 22:41:58 2010 (r216218)
@@ -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 erro
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
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
.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
More information about the svn-src-all
mailing list