Пакет: attr

SETFATTR(1)			File Utilities			   SETFATTR(1)



NAME
       setfattr - set extended attributes of filesystem objects

SYNOPSIS
       setfattr [-h] -n name [-v value] pathname...
       setfattr [-h] -x name pathname...
       setfattr [-h] --restore=file

DESCRIPTION
       The  setfattr command associates a new value with an extended attribute
       name for each specified file.

OPTIONS
       -n name, --name=name
	   Specifies the name of the extended attribute to set.

       -v value, --value=value
	   Specifies the new value of the extended attribute. There are	 three
	   methods  available  for encoding the value.	If the given string is
	   enclosed in double quotes, the inner string is treated as text.  In
	   that	 case, backslashes and double quotes have special meanings and
	   need to be escaped by a preceding backslash. Any control characters
	   can be encoded as a backslash followed by three digits as its ASCII
	   code in octal. If the given string begins with 0x  or  0X,  it  ex‐
	   presses a hexadecimal number. If the given string begins with 0s or
	   0S, base64 encoding is expected.  Also see the --encoding option of
	   getfattr(1).

       -x name, --remove=name
	   Remove the named extended attribute entirely.

       -h, --no-dereference
	   Do  not follow symlinks.  If pathname is a symbolic link, it is not
	   followed, but is instead itself the inode being modified.

       --restore=file
	   Restores extended attributes from file.  The file must  be  in  the
	   format  generated  by  the getfattr command with the --dump option.
	   If a dash (-) is given as the file name, setfattr reads from	 stan‐
	   dard input.

       --raw
	   Do  not  decode  the attribute value. Can be used to set values ob‐
	   tained with getfattr --only-values.

       --version
	   Print the version of setfattr 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.

EXAMPLES
       Add extended attribute to user namespace:

       $ setfattr -n user.foo -v bar file.txt

       To add md5sum of the file as an extended attribute:

       # setfattr -n trusted.md5sum -v d41d8cd98f00b204e00998ecf8427e file.txt

AUTHOR
       Andreas	Gruenbacher,  <andreas.gruenbacher@gmail.com>  and the SGI XFS
       development team, <linux-xfs@oss.sgi.com>.

       Please  send  your  bug	reports	  or   comments	  to   <https://savan‐
       nah.nongnu.org/bugs/?group=attr> or <acl-devel@nongnu.org>.

SEE ALSO
       getfattr(1), xattr(7)



Dec 2001		      Extended Attributes		   SETFATTR(1)

ATTR(1)			     XFS Compatibility API		       ATTR(1)



NAME
       attr - extended attributes on XFS filesystem objects

SYNOPSIS
       attr [ -LRSq ] -s attrname [ -V attrvalue ] pathname

       attr [ -LRSq ] -g attrname pathname

       attr [ -LRSq ] -r attrname pathname

       attr [ -LRSq ] -l pathname


OVERVIEW
       Extended	 attributes  implement	the  ability  for  a  user  to	attach
       name:value pairs to objects within the XFS filesystem.

       This document describes the attr command, which	is  mostly  compatible
       with  the IRIX command of the same name.	 It is thus aimed specifically
       at users of the XFS filesystem - for  filesystem	 independent  extended
       attribute  manipulation,	 consult the getfattr(1) and setfattr(1) docu‐
       mentation.

       Extended attributes can be used to  store  meta-information  about  the
       file.   For example "character-set=kanji" could tell a document browser
       to use the Kanji	 character  set	 when  displaying  that	 document  and
       "thumbnail=..."	could  provide a reduced resolution overview of a high
       resolution graphic image.

       In the XFS filesystem, the names can be up to 256 bytes in length, ter‐
       minated	by  the	 first	0  byte.  The intent is that they be printable
       ASCII (or other character set) names for the attribute.	The values can
       be up to 64KB of arbitrary binary data.

       Attributes  can	be attached to all types of XFS inodes: regular files,
       directories, symbolic links, device nodes, etc.

       XFS uses	 2  disjoint  attribute	 name  spaces  associated  with	 every
       filesystem  object.   They  are	the root and user address spaces.  The
       root address space is accessible only to the superuser, and  then  only
       by  specifying  a flag argument to the function call.  Other users will
       not see or be able to modify attributes in the root address space.  The
       user  address  space is protected by the normal file permissions mecha‐
       nism, so the owner of the file can decide who is	 able  to  see	and/or
       modify the value of attributes on any particular file.

DESCRIPTION
       The attr utility allows the manipulation of extended attributes associ‐
       ated with filesystem objects from within shell scripts.

       There are four main operations that attr can perform:

       GET    The -g attrname option tells attr to search the named object and
	      print (to stdout) the value associated with that attribute name.
	      With the -q flag, stdout will be exactly and only the  value  of
	      the attribute, suitable for storage directly into a file or pro‐
	      cessing via a piped command.

       LIST   The -l option tells attr to list the names of all the attributes
	      that  are associated with the object, and the number of bytes in
	      the value of each of those attributes.  With the -q flag, stdout
	      will be a simple list of only the attribute names, one per line,
	      suitable for input into a script.

       REMOVE The -r attrname option tells attr to remove  an  attribute  with
	      the  given  name from the object if the attribute exists.	 There
	      is no output on successful completion.

       SET/CREATE
	      The -s attrname option tells attr to set the named attribute  of
	      the  object  to the value read from stdin.  If an attribute with
	      that name already exists, its value will be replaced  with  this
	      one.  If an attribute with that name does not already exist, one
	      will be created with this value.	With the  -V  attrvalue	 flag,
	      the attribute will be set to have a value of attrvalue and stdin
	      will not be read.	 With the -q flag, stdout will	not  be	 used.
	      Without  the  -q	flag, a message showing the attribute name and
	      the entire value will be printed.

       When the -L option is given and the named object is  a  symbolic	 link,
       operate	on  the	 attributes  of	 the object referenced by the symbolic
       link.  Without this option, operate on the attributes of	 the  symbolic
       link itself.

       When the -R option is given and the process has appropriate privileges,
       operate in the root attribute namespace rather that the USER  attribute
       namespace.

       The  -S	option is similar, except it specifies use of the security at‐
       tribute namespace.

       When the -q option is given attr will try to keep quiet.	 It will  out‐
       put  error  messages (to stderr) but will not print status messages (to
       stdout).

NOTES
       The standard file interchange/archive programs tar(1), and cpio(1) will
       not  archive  or restore extended attributes, while the xfsdump(8) pro‐
       gram will.

CAVEATS
       The list option present in the IRIX version of this command is not sup‐
       ported.	getfattr provides a mechanism to retrieve all of the attribute
       names.

AUTHOR
       Andreas Gruenbacher, <andreas.gruenbacher@gmail.com> and	 the  SGI  XFS
       development team, <linux-xfs@oss.sgi.com>.

       Please	send   your   bug   reports  or	 comments  to  <https://savan‐
       nah.nongnu.org/bugs/?group=attr> or <acl-devel@nongnu.org>.

SEE ALSO
       getfattr(1),  setfattr(1),  attr_get(3),	 attr_set(3),	attr_multi(3),
       attr_remove(3), xattr(7), xfsdump(8)



Dec 2001		      Extended Attributes		       ATTR(1)

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.  Per default only attributes in the user namespace are displayed,
       see -m.

       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.

       -d, --dump
	   Dump the values of all matched extended attributes.

       -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 hexadecimal
	   and base64 are prefixed with 0x and 0s, respectively.

       -h, --no-dereference
	   Do  not  dereference symlinks. Instead of the file a symlink refers
	   to, the symlink itself is examined.	Unless doing  a	 logical  (-L)
	   traversal, do not traverse symlinks to directories.

       -m pattern, --match=pattern
	   Only	 include attributes with names matching the regular expression
	   pattern.  The default value for pattern is  "^user\\.",  which  in‐
	   cludes  all	the  attributes in the user namespace. Specify "-" for
	   including all attributes.  Refer to xattr(7) for  a	more  detailed
	   discussion of namespaces.

       --absolute-names
	   Do not strip leading slash characters ('/').	 The default behaviour
	   is to strip leading slash characters.

       --only-values
	   Dump out the raw extended attribute value(s) without encoding them.

       -R, --recursive
	   List the attributes of all files and directories recursively.

       -L, --logical
	   Logical walk, follow symbolic links to  directories.	  The  default
	   behaviour is to follow symbolic link arguments unless --no-derefer‐
	   ence is given, and to skip symbolic links encountered in  subdirec‐
	   tories.  Only effective in combination with -R.

       -P, --physical
	   Physical  walk,  do not follow symbolic links to directories.  This
	   also skips symbolic link arguments.	Only effective in  combination
	   with -R.

       --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, <andreas.gruenbacher@gmail.com> and	 the  SGI  XFS
       development team, <linux-xfs@oss.sgi.com>.

       Please	send   your   bug   reports  or	 comments  to  <https://savan‐
       nah.nongnu.org/bugs/?group=attr> or <acl-devel@nongnu.org>.

SEE ALSO
       setfattr(1), xattr(7)



Dec 2001		      Extended Attributes		   GETFATTR(1)