ANSIBLE.ACL(3)                  ANSIBLE MODULES                 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



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