corrected and made better docs for getent

pull/18777/head
Brian Coca 10 years ago committed by Matt Clay
parent 5faecb76ae
commit ff66d56d4a

@ -26,7 +26,7 @@ module: getent
short_description: a wrapper to the unix getent utility short_description: a wrapper to the unix getent utility
description: description:
- Runs getent against one of it's various databases and returns information into - Runs getent against one of it's various databases and returns information into
the host's facts the host's facts, in a getent_<database> prefixed variable
version_added: "1.8" version_added: "1.8"
options: options:
database: database:
@ -51,7 +51,7 @@ options:
description: description:
- If a supplied key is missing this will make the task fail if True - If a supplied key is missing this will make the task fail if True
notes: notes:
- "Not all databases support enumeration, check system documentation for details" - "Not all databases support enumeration, check system documentation for details"
requirements: [ ] requirements: [ ]
author: Brian Coca author: Brian Coca
@ -60,23 +60,23 @@ author: Brian Coca
EXAMPLES = ''' EXAMPLES = '''
# get root user info # get root user info
- getent: database=passwd key=root - getent: database=passwd key=root
register: root_info - debug: var=getent_passwd
# get all groups # get all groups
- getent: database=group split=':' - getent: database=group split=':'
register: groups - debug: var=getent_group
# get all hosts, split by tab # get all hosts, split by tab
- getent: database=hosts - getent: database=hosts
register: hosts - debug: var=getent_hosts
# get http service info, no error if missing # get http service info, no error if missing
- getent: database=services key=http fail_key=False - getent: database=services key=http fail_key=False
register: http_info - debug: var=getent_services
# get user password hash (requires sudo/root) # get user password hash (requires sudo/root)
- getent: database=shadow key=www-data split=: - getent: database=shadow key=www-data split=:
register: pw_hash - debug: var=getent_shadow
''' '''

Loading…
Cancel
Save