# 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