ANSIBLE.XATTR(3)                ANSIBLE MODULES               ANSIBLE.XATTR(3)



NAME
       xattr - set/retrieve extended attributes

DESCRIPTION
       Manages filesystem user defined extended attributes, requires that they
       are enabled on the target filesystem and that the setfattr/getfattr
       utilities are present.

OPTIONS
       follow if yes, dereferences symlinks and sets/gets attributes on
              symlink target, otherwise acts on symlink itself.  Choices:
              yes,no. (default: yes

       key    The name of a specific Extended attribute key to set/retrieve
              (default: None)

       name   The full path of the file/object to get the facts of(required)
              (default: None)

       state  defines which state you want to do. read retrieves the current
              value for a key (default) present sets name to value, default if
              value is set all dumps all data keys retrieves all keys absent
              deletes the key Choices: read,present,all,keys,absent. (default:
              get)

       value  The value to set the named name/key to, it automatically sets
              the state to 'set' (default: None).

EXAMPLES
       # Obtain the extended attributes  of /etc/foo.conf
       - xattr: name=/etc/foo.conf

       # Sets the key 'foo' to value 'bar'
       - xattr: path=/etc/foo.conf key=user.foo value=bar

       # Removes the key 'foo'
       - xattr: name=/etc/foo.conf key=user.foo state=absent



AUTHOR
       Brian Coca

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#xattr



1.4.5                             2014-02-12                  ANSIBLE.XATTR(3)
