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_name:
      - damian
      - homer
    - perms: rwx

Ensure a Linux ACL list does not exist

root:
  acl.list_absent:
    - name: /root
    - acl_type: user
    - acl_name:
      - damian
      - homer
    - perms: rwx

salt.states.linux_acl.absent(name, acl_type, acl_name=u'', perms=u'', 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_names

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=u'', 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=u'', perms=u'', 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