Linux File Access Control Lists
The Linux ACL state module requires the getfacl and setfacl binaries.
Ensure a Linux ACL is present
root:
acl.present:
- name: /root
- acl_type: user
- acl_name: damian
- perms: rwx
Ensure a Linux ACL does not exist
root:
acl.absent:
- name: /root
- acl_type: user
- acl_name: damian
- perms: rwx
Ensure a Linux ACL list is present
root:
acl.list_present:
- name: /root
- acl_type: user
- acl_names:
- damian
- homer
- perms: rwx
Ensure a Linux ACL list does not exist
root:
acl.list_absent:
- name: /root
- acl_type: user
- acl_names:
- damian
- homer
- perms: rwx
salt.states.linux_acl.
absent
(name, acl_type, acl_name='', perms='', recurse=False)¶Ensure a Linux ACL does not exist
The acl path
The type of the acl is used for, it can be 'user' or 'group'
The user or group
Remove the permissions eg.: rwx
Set the permissions recursive in the path
salt.states.linux_acl.
list_absent
(name, acl_type, acl_names=None, recurse=False)¶Ensure a Linux ACL list does not exist
Takes a list of acl names and remove them from the given path
The acl path
The type of the acl is used for, it can be 'user' or 'group'
The list of users or groups
Remove the permissions eg.: rwx
Set the permissions recursive in the path
salt.states.linux_acl.
list_present
(name, acl_type, acl_names=None, perms='', recurse=False, force=False)¶Ensure a Linux ACL list is present
Takes a list of acl names and add them to the given path
The acl path
The type of the acl is used for it can be 'user' or 'group'
The list of users or groups
Set the permissions eg.: rwx
Set the permissions recursive in the path
Wipe out old permissions and ensure only the new permissions are set
salt.states.linux_acl.
present
(name, acl_type, acl_name='', perms='', recurse=False, force=False)¶Ensure a Linux ACL is present
The acl path
The type of the acl is used for it can be 'user' or 'group'
The user or group
Set the permissions eg.: rwx
Set the permissions recursive in the path
Wipe out old permissions and ensure only the new permissions are set