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