cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Some minor doc updates for the acl module.

Browse source
This commit is contained in:
Michael DeHaan 2013-10-14 11:36:48 -04:00
parent 658b7d1f47
commit de3731a14e
1 changed files with 15 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
library/files/acl
View file

@ -17,51 +17,50 @@
DOCUMENTATION = ''' DOCUMENTATION = '''
--- ---
module: acl module: acl
version_added: "1.3" version_added: "1.4"
short_description: set and retrieve file acl short_description: Sets and retrieves file ACL information.
description: description:
- Sets and retrivies acl for a file - Sets and retrieves file ACL information.
options: options:
name: name:
required: true required: true
default: None default: None
description: description:
- The full path of the file/object to get the facts of - The full path of the file or object.
aliases: ['path'] aliases: ['path']
entry: entry:
required: false required: false
default: None default: None
description: description:
- The acl to set/remove. MUST always quote! In form of '<type>:<qualifier>:<perms>', qualifier may be empty for some types but type and perms are always requried. '-' can be used as placeholder when you don't care about permissions. - The acl to set or remove. This must always be quoted in the form of '<type>:<qualifier>:<perms>'. The qualifier may be empty for some types, but the type and perms are always requried. '-' can be used as placeholder when you do not care about permissions.
state: state:
required: false required: false
default: query default: query
choices: [ 'query', 'present', 'absent' ] choices: [ 'query', 'present', 'absent' ]
description: description:
- defines which operation you want to do. C(query) get the current acl C(present) sets/changes the acl, requires permissions field C(absent) deletes the acl, requires permissions field - defines whether the ACL should be present or not. The C(query) state gets the current acl C(present) without changing it, for use in 'register' operations.
follow: follow:
required: false required: false
default: yes default: yes
choices: [ 'yes', 'no' ] choices: [ 'yes', 'no' ]
description: description:
- if yes, dereferences symlinks and sets/gets attributes on symlink target, otherwise acts on symlink itself. - whether to follow symlinks on the path if a symlink is encountered.
author: Brian Coca author: Brian Coca
notes: notes:
- The "acl" module requires that acl is enabled on the target filesystem and that the setfacl and getfacl binaries are installed. - The "acl" module requires that acls are enabled on the target filesystem and that the setfacl and getfacl binaries are installed.
author: Brian Coca
notes:
- The "acl" module requires the acl command line utilities be installed on the target machine and that acl is enabled on the target filesystem.
''' '''
EXAMPLES = ''' EXAMPLES = '''
# Obtain the acl of /etc/foo.conf # Grant user Joe read access to a file
- acl: name=/etc/foo.conf
# Grants joe read access to foo
- acl: name=/etc/foo.conf entry="user:joe:r" state=present - acl: name=/etc/foo.conf entry="user:joe:r" state=present
# Removes the acl for joe # Removes the acl for Joe on a specific file
- acl: name=/etc/foo.conf entry="user:joe:-" state=absent - acl: name=/etc/foo.conf entry="user:joe:-" state=absent
# Obtain the acl for a specific file
- acl: name=/etc/foo.conf
register: acl_info
''' '''
def get_acl(module,path,entry,follow): def get_acl(module,path,entry,follow):