1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-07-25 18:19:00 +02:00

doc: clarify stat the meaning of --format="%t %T"

* src/stat.c (usage): Mention that the values are only
defined for character and block special files.
* doc/coreutils.texi (stat invocation): Likewise.
Also mention st_rdev.
Reported in http://bugs.gnu.org/13927
This commit is contained in:
Pádraig Brady
2013-03-12 13:43:08 +00:00
parent 2c2d0b3644
commit 3324282665
2 changed files with 9 additions and 4 deletions
+7 -2
View File
@@ -11631,8 +11631,8 @@ The valid @var{format} directives for files with @option{--format} and
@item %N - Quoted file name with dereference if symbolic link
@item %o - Optimal I/O transfer size hint
@item %s - Total size, in bytes
@item %t - Major device type in hex
@item %T - Minor device type in hex
@item %t - Major device type in hex (see below)
@item %T - Minor device type in hex (see below)
@item %u - User ID of owner
@item %U - User name of owner
@item %w - Time of file birth, or @samp{-} if unknown
@@ -11645,6 +11645,11 @@ The valid @var{format} directives for files with @option{--format} and
@item %Z - Time of last change as seconds since Epoch
@end itemize
The @samp{%t} and @samp{%T} formats operate on the st_rdev member of
the stat(2) structure, and are only defined for character and block
special files. On some systems or file types, st_rdev may be used to
represent other quantities.
The @samp{%W}, @samp{%X}, @samp{%Y}, and @samp{%Z} formats accept a
precision preceded by a period to specify the number of digits to
print after the decimal point. For example, @samp{%.3X} outputs the
+2 -2
View File
@@ -1393,8 +1393,8 @@ The valid format sequences for files (without --file-system):\n\
%N quoted file name with dereference if symbolic link\n\
%o optimal I/O transfer size hint\n\
%s total size, in bytes\n\
%t major device type in hex\n\
%T minor device type in hex\n\
%t major device type in hex, for character/block device special files\n\
%T minor device type in hex, for character/block device special files\n\
"), stdout);
fputs (_("\
%u user ID of owner\n\