doc: clarify that '%a' stat format outputs mode bits

* src/stat.c (usage): Mention permission bits rather than
"access" so there is no confusion with ACLs etc.
Also indicate we output the file type with '%A'.
* doc/coreutils.texi (stat invocation): Likewise.
Also indicate '%A' is similar to `ls -ld` output.
Addresses https://bugs.gnu.org/39613
This commit is contained in:
Pádraig Brady committed 2020-02-15 11:24:15 +00:00
1 parent 3150f4a82e
commit 61c49d3693
2 files changed
+4 -4

No files matched your search

+2 -2
View File
@@ -12438,8 +12438,8 @@ The valid @var{format} directives for files with @option{--format} and
@option{--printf} are:
@itemize @bullet
@item %a - Access rights in octal (note @samp{#} and @samp{0} printf flags)
@item %A - Access rights in human readable form
@item %a - Permission bits in octal (note @samp{#} and @samp{0} printf flags)
@item %A - Permission bits in symbolic form (similar to @command{ls -ld})
@item %b - Number of blocks allocated (see @samp{%B})
@item %B - The size in bytes of each block reported by @samp{%b}
@item %C - The SELinux security context of a file, if available
+2 -2
View File
@@ -1714,8 +1714,8 @@ The --cached MODE argument can be; always, never, or default.\n\
fputs (_("\n\
The valid format sequences for files (without --file-system):\n\
\n\
%a access rights in octal (note '#' and '0' printf flags)\n\
%A access rights in human readable form\n\
%a permission bits in octal (note '#' and '0' printf flags)\n\
%A permission bits and file type in human readable form\n\
%b number of blocks allocated (see %B)\n\
%B the size in bytes of each block reported by %b\n\
%C SELinux security context string\n\