summaryrefslogtreecommitdiff
path: root/system/getent.py
diff options
context:
space:
mode:
authorBrian Coca <brian.coca+git@gmail.com>2014-10-04 10:20:35 -0400
committerBrian Coca <brian.coca+git@gmail.com>2014-10-04 10:21:26 -0400
commitb0d5733fd0a72e200fb04115ff9320bd175ac3c7 (patch)
treeedd40f2b3de2f4774c29424c7b567156c608613a /system/getent.py
parent8a4f07eecd2bb877f51b7b04b5352efa6076cce5 (diff)
downloadansible-modules-extras-b0d5733fd0a72e200fb04115ff9320bd175ac3c7.tar.gz
corrected and made better docs for getent
Diffstat (limited to 'system/getent.py')
-rw-r--r--system/getent.py14
1 files changed, 7 insertions, 7 deletions
diff --git a/system/getent.py b/system/getent.py
index 0173618f..7da1be45 100644
--- a/system/getent.py
+++ b/system/getent.py
@@ -26,7 +26,7 @@ module: getent
short_description: a wrapper to the unix getent utility
description:
- 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"
options:
database:
@@ -51,7 +51,7 @@ options:
description:
- 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"
requirements: [ ]
author: Brian Coca
@@ -60,23 +60,23 @@ author: Brian Coca
EXAMPLES = '''
# get root user info
- getent: database=passwd key=root
- register: root_info
+- debug: var=getent_passwd
# get all groups
- getent: database=group split=':'
- register: groups
+- debug: var=getent_group
# get all hosts, split by tab
- getent: database=hosts
- register: hosts
+- debug: var=getent_hosts
# get http service info, no error if missing
- getent: database=services key=http fail_key=False
- register: http_info
+- debug: var=getent_services
# get user password hash (requires sudo/root)
- getent: database=shadow key=www-data split=:
- register: pw_hash
+- debug: var=getent_shadow
'''