getfattr - get extended attributes of filesystem objects
SYNOPSIS
getfattr [-hRLP] -n name [-e en] pathname...
getfattr [-hRLP] -d [-e en] [-m pattern] pathname...
DESCRIPTION
For each file, getfattr displays the file name, and the
set of extended attribute names (and optionally values)
which are associated with that file.
The output format of getfattr -d is as follows:
1: # file: somedir/
2: user.name0="value0"
3: user.name1="value1"
4: user.name2="value2"
5: ...
Line 1 identifies the file name for which the following
lines are being reported. The remaining lines (lines 2 to
4 above) show the name and value pairs associated with the
specified file.
OPTIONS
-n name, --name=name
Dump the value of the named extended attribute
extended attribute.
-d, --dump
Dump the values of all extended attributes associated
with pathname.
-e en, --encoding=en
Encode values after retrieving them. Valid values of
en are "text", "hex", and "base64". Values encoded as
text strings are enclosed in double quotes ("), while
strings encoded as hexidecimal and base64 are prefixed
with 0x and 0s, respectively.
-h, --no-dereference
Do not follow symlinks. If pathname is a symbolic
link, the symbolic link itself is examined, rather
than the file the link refers to.
-m pattern, --match=pattern
Only include attributes with names matching the regu
lar expression pattern. The default value for pattern
is "^user\\.", -m which includes all the attributes in
the user namespace. Refer to attr(5) for a more
detailed discussion on namespaces.
--absolute-names
Do not strip leading slash characters ('/'). The
ters.
--only-values
Dump out the extended attribute value(s) only.
-R, --recursive
List the attributes of all files and directories
recursively.
-L, --logical
Logical walk, follow symbolic links. The default
behaviour is to follow symbolic link arguments, and to
skip symbolic links encountered in subdirectories.
-P, --physical
Physical walk, skip all symbolic links. This also
skips symbolic link arguments.
--version
Print the version of getfattr and exit.
--help
Print help explaining the command line options.
-- End of command line options. All remaining parameters
are interpreted as file names, even if they start with
a dash character.
AUTHOR
Andreas Gruenbacher, <a.gruenbacher@computer.org> and the
SGI XFS development team, <linux-xfs@oss.sgi.com>.
Please send your bug reports or comments to these
addresses.
SEE ALSO
setfattr(1), and attr(5).
Man(1) output converted with
man2html