ANSIBLE.ACL(3)

NAME
acl - Sets and retrieves file ACL information.

DESCRIPTION

Sets and retrieves file ACL information.

OPTIONS

entry
    The acl to set or remove. This must always be quoted in the form of '<type>:<qualifier>:<perms>'. The qualifier may be empty for some types, but the type and perms are always requried. '-' can be used as placeholder when you do not care about permissions. (default: None)

follow
    whether to follow symlinks on the path if a symlink is encountered. Choices: yes,no. (default: yes

name
    The full path of the file or object.(required) (default: None)

state
    defines whether the ACL should be present or not. The query state gets the current acl present without changing it, for use in 'register' operations. Choices: query,present,absent. (default: query).

NOTES

The "acl" module requires that acls are enabled on the target filesystem and that the setfacl and getfacl binaries are installed.

EXAMPLES
# Grant user Joe read access to a file
- acl: name=/etc/foo.conf entry="user:joe:r" state=present
# Removes the acl for Joe on a specific file
- acl: name=/etc/foo.conf entry="user:joe:-" state=absent
# Obtain the acl for a specific file
- acl: name=/etc/foo.conf
  register: acl_info

AUTHOR
Brian Coca

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