salt.states.linux_acl

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

name
The acl path
acl_type
The type of the acl is used for, it can be 'user' or 'group'
acl_name
The user or group
perms
Remove the permissions eg.: rwx
recurse
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

name
The acl path
acl_type
The type of the acl is used for, it can be 'user' or 'group'
acl_names
The list of users or groups
perms
Remove the permissions eg.: rwx
recurse
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

name
The acl path
acl_type
The type of the acl is used for it can be 'user' or 'group'
acl_names
The list of users or groups
perms
Set the permissions eg.: rwx
recurse
Set the permissions recursive in the path
force
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

name
The acl path
acl_type
The type of the acl is used for it can be 'user' or 'group'
acl_name
The user or group
perms
Set the permissions eg.: rwx
recurse
Set the permissions recursive in the path
force
Wipe out old permissions and ensure only the new permissions are set

Docs for previous releases are available on readthedocs.org.

Latest Salt release: latest_release

Previous topic

salt.states.libcloud_storage module

Next topic

salt.states.locale