[Acl-devel] [PATCH] getfattr.1: by default only user namespace attributes are dumped

[Simon Ruderich]

---
Hello,

When trying to dump the capabilities of a file I was confused
that getfattr doesn't list them by default. It's only mentioned
for the -m option but I think it's better if the user doesn't
have to read the whole man page.

This patch clarifies that in the man page and also removes the
(to me) confusing part of -d's description which says "all
extended attributes" which I assumed means _all_ extended
attributes including caps.

Regards
Simon

 man/man1/getfattr.1 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/man/man1/getfattr.1 b/man/man1/getfattr.1
index 08aa374..443117f 100644
--- a/man/man1/getfattr.1
+++ b/man/man1/getfattr.1
@@ -35,7 +35,8 @@ For each file,
 .B getfattr
 displays the file name,
 and the set of extended attribute names (and optionally values) which
-are associated with that file.
+are associated with that file. Per default only attributes in the user
+namespace are displayed, see \f3\-m\f1.
 .PP
 The output format of
 .B "getfattr \-d"
@@ -65,8 +66,7 @@ pairs associated with the specified file.
 Dump the value of the named extended attribute.
 .TP
 .BR \-d ", " \-\-dump
-Dump the values of all extended attributes associated with
-.IR pathname .
+Dump the values of all matched extended attributes.
 .TP
 .BR \-e " \f2en\f1, " \-\-encoding "=\f2en\f1"
 Encode values after retrieving them.
-- 
2.13.2

-- 
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

signature.asc
Description: PGP signature