Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
A
ansible
Overview
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
OpenEdx
ansible
Commits
268122d7
Commit
268122d7
authored
Mar 23, 2014
by
Brian Coca
Committed by
Michael DeHaan
Aug 08, 2014
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
added control to fail or not on missing key
made split 'smarter' but still overridable
parent
27bf4d8e
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
28 additions
and
9 deletions
+28
-9
library/system/getent
+28
-9
No files found.
library/system/getent
View file @
268122d7
...
...
@@ -25,23 +25,33 @@ DOCUMENTATION = '''
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
- Runs getent against one of it's various databases and returns information into
the host's facts
version_added: "1.6"
options:
database:
required: True
description:
- the name of a getent database supported by the target system (passwd, group, hosts, etc).
- the name of a getent database supported by the target system (passwd, group,
hosts, etc).
key:
required: False
default: ''
description:
- key from which to return values from the specified database, otherwise the full contents are returned.
- key from which to return values from the specified database, otherwise the
full contents are returned.
split:
required: False
default: None
description:
- character used to override the split the database values into lists/arrays, i.e ':' or '
\t
'.
- character used to override the split the database values into lists/arrays,
i.e ':' or '
\t
'. Otherwise split tries to be 'smart' depending on DB.
fail_key:
required: False
default: True
description:
- If a supplied key is missing this will make the task fail if True
notes: [ Not all databases support enumeration, check system documentation for details ]
requirements: [ ]
author: Brian Coca
...
...
@@ -49,7 +59,7 @@ author: Brian Coca
EXAMPLES
=
'''
# get root user info
- getent: database=passwd key=root
split=':'
- getent: database=passwd key=root
# get all groups
- getent: database=group split=':'
...
...
@@ -57,8 +67,8 @@ EXAMPLES = '''
# get all hosts, split by tab
- getent: database=hosts
# get http service info
- getent: database=services key=http
# get http service info
, no error if missing
- getent: database=services key=http
fail_key=False
# get user password hash (requires sudo/root)
- getent: database=shadow key=www-data split=:
...
...
@@ -71,13 +81,17 @@ def main():
database
=
dict
(
required
=
True
),
key
=
dict
(
required
=
False
,
default
=
None
),
split
=
dict
(
required
=
False
,
default
=
None
),
fail_key
=
dict
(
required
=
False
,
default
=
True
),
),
supports_check_mode
=
True
,
)
colon
=
[
'passwd'
,
'shadow'
,
'group'
,
'gshadow'
]
database
=
module
.
params
[
'database'
]
key
=
module
.
params
.
get
(
'key'
)
split
=
module
.
params
.
get
(
'split'
)
fail_key
=
module
.
params
.
get
(
'fail_key'
)
getent_bin
=
module
.
get_bin_path
(
'getent'
,
True
)
...
...
@@ -86,6 +100,9 @@ def main():
else
:
cmd
=
[
getent_bin
,
database
]
if
split
is
None
and
database
in
colon
:
split
=
':'
try
:
rc
,
out
,
err
=
module
.
run_command
(
cmd
)
except
Exception
,
e
:
...
...
@@ -105,8 +122,10 @@ def main():
elif
rc
==
1
:
msg
=
"Missing arguments, or database unknown."
elif
rc
==
2
:
results
[
dbtree
][
key
]
=
None
module
.
exit_json
(
ansible_facts
=
results
,
msg
=
"One or more supplied key could not be found in the database."
)
msg
=
"One or more supplied key could not be found in the database."
if
not
fail_key
:
results
[
dbtree
][
key
]
=
None
module
.
exit_json
(
ansible_facts
=
results
,
msg
=
msg
)
elif
rc
==
3
:
msg
=
"Enumeration not supported on this database."
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment