acl

Collection: posix

Full Name: parallax.posix.acl

Aliases: ansible.posix.acl, acl

Synopsis

Manage acl

Parameters

NameTypeRequiredDefaultDescription
pathstringyesThe full path of the file or object
entitystringThe actual user or group that the ACL applies to (e.g. joe, wheel)
etypestringThe entity type of the ACL to apply Choices: user, group, mask, other
permissionsstringThe permissions to apply/remove (e.g. rw, rwx, r)
statestringqueryDefine whether the ACL should be present or absent, or query the current ACLs Choices: query, present, absent
defaultboolfalseIf the target is a directory, setting this to true will make it a default ACL for new files/dirs
recursiveboolfalseRecursively set the specified ACL on the directory tree
recalc_maskbooltrueWhether to recalculate the effective rights mask
followbooltrueWhether to follow symlinks on the path
use_nfsv4_aclsboolfalseUse NFSv4 ACLs instead of POSIX ACLs

Example

- name: Example acl task
  acl:
    path: <your_path>