summaryrefslogtreecommitdiff
path: root/files/acl.py
diff options
context:
space:
mode:
Diffstat (limited to 'files/acl.py')
-rw-r--r--files/acl.py29
1 files changed, 24 insertions, 5 deletions
diff --git a/files/acl.py b/files/acl.py
index 2b898452..4974b6bb 100644
--- a/files/acl.py
+++ b/files/acl.py
@@ -97,19 +97,38 @@ notes:
EXAMPLES = '''
# Grant user Joe read access to a file
-- acl: name=/etc/foo.conf entity=joe etype=user permissions="r" state=present
+- acl:
+ name: /etc/foo.conf
+ entity: joe
+ etype: user
+ permissions: r
+ state: present
# Removes the acl for Joe on a specific file
-- acl: name=/etc/foo.conf entity=joe etype=user state=absent
+- acl:
+ name: /etc/foo.conf
+ entity: joe
+ etype: user
+ state: absent
# Sets default acl for joe on foo.d
-- acl: name=/etc/foo.d entity=joe etype=user permissions=rw default=yes state=present
+- acl:
+ name: /etc/foo.d
+ entity: joe
+ etype: user
+ permissions: rw
+ default: yes
+ state: present
# Same as previous but using entry shorthand
-- acl: name=/etc/foo.d entry="default:user:joe:rw-" state=present
+- acl:
+ name: /etc/foo.d
+ entry: "default:user:joe:rw-"
+ state: present
# Obtain the acl for a specific file
-- acl: name=/etc/foo.conf
+- acl:
+ name: /etc/foo.conf
register: acl_info
'''