summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBernhard Voelker <mail@bernhard-voelker.de>2014-10-04 17:09:59 +0200
committerBernhard Voelker <mail@bernhard-voelker.de>2014-10-04 17:12:58 +0200
commitb020002b4bfae55d5bbcf66bd7ce787a4e6da689 (patch)
tree42f49f2a64b66da4eb876796183117de91ca03b8
parent2d3ba46e580cbc9e81edc4e8dd759f9fb0775161 (diff)
downloadcoreutils-b020002b4bfae55d5bbcf66bd7ce787a4e6da689.tar.xz
doc: document stat's output with the --terse option
* doc/coreutils.texi (stat invocation): Add a paragraph documenting stat's output format when the --terse option is specified, both in normal and in --file-system mode. Reported by Dan Jacobson <jidanni@jidanni.org> in http://bugs.gnu.org/18624
-rw-r--r--doc/coreutils.texi14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 03bb710e9..aece931f2 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11885,6 +11885,20 @@ $ stat --printf='%d:%i\n' / /usr
@cindex terse output
Print the information in terse form, suitable for parsing by other programs.
+The output of the following commands are identical and the @option{--format}
+also identifies the items printed (in fuller form) in the default format.
+Note the format string would include another @samp{%C} at the end with an
+active SELinux security context.
+@example
+$ stat --format="%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o" ...
+$ stat --terse ...
+@end example
+
+The same illustrating terse output in @option{--file-system} mode:
+@example
+$ stat -f --format="%n %i %l %t %s %S %b %f %a %c %d" ...
+$ stat -f --terse ...
+@end example
@end table
The valid @var{format} directives for files with @option{--format} and