getfattr - Manpage - Tux24 Net - Linux Unix Network
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z




NAME
    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  path-
   name.

    -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 sym-
   bolic link itself is examined, rather than the file the link refers
   to.

    -m pattern, --match=pattern
   Only include attributes with names matching the regular 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 default behaviour
   is to strip leading slash characters.

    --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 encoun-
   tered 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 inter-
   preted 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), andattr(5).