GETFATTR(1)			File Utilities			  GETFATTR(1)



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 hexideci-
	   mal 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,    and	the  SGI  XFS
       development team, .

       Please send your bug reports or comments to these addresses.

SEE ALSO
       setfattr(1), and attr(5).



Dec 2001		     Extended Attributes		  GETFATTR(1)

UNIX/Linux commands referenced on this page:

1. which
2. as
3. file
4. strings
5. link
6. more
7. strip
8. links