Mr.X

# -*- coding: utf-8 -*-

# Copyright: (c) 2014, Brian Coca <brian.coca+dev@gmail.com>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

from __future__ import absolute_import, division, print_function
__metaclass__ = type


DOCUMENTATION = r'''
---
module: getent
short_description: A wrapper to the unix getent utility
description:
     - Runs getent against one of its various databases and returns information into
       the host's facts, in a getent_<database> prefixed variable.
version_added: "1.8"
options:
    database:
        description:
            - The name of a getent database supported by the target system (passwd, group,
              hosts, etc).
        type: str
        required: True
    key:
        description:
            - Key from which to return values from the specified database, otherwise the
              full contents are returned.
        type: str
        default: ''
    service:
        description:
            - Override all databases with the specified service
            - The underlying system must support the service flag which is not always available.
        type: str
        version_added: "2.9"
    split:
        description:
            - Character used to split the database values into lists/arrays such as C(:) or C(\t),
              otherwise it will try to pick one depending on the database.
        type: str
    fail_key:
        description:
            - If a supplied key is missing this will make the task fail if C(true).
        type: bool
        default: 'yes'
extends_documentation_fragment:
  - action_common_attributes
  - action_common_attributes.facts
attributes:
    check_mode:
        support: full
    diff_mode:
        support: none
    facts:
        support: full
    platform:
        platforms: posix
notes:
   - Not all databases support enumeration, check system documentation for details.
author:
- Brian Coca (@bcoca)
'''

EXAMPLES = '''
- name: Get root user info
  ansible.builtin.getent:
    database: passwd
    key: root
- ansible.builtin.debug:
    var: ansible_facts.getent_passwd

- name: Get all groups
  ansible.builtin.getent:
    database: group
    split: ':'
- ansible.builtin.debug:
    var: ansible_facts.getent_group

- name: Get all hosts, split by tab
  ansible.builtin.getent:
    database: hosts
- ansible.builtin.debug:
    var: ansible_facts.getent_hosts

- name: Get http service info, no error if missing
  ansible.builtin.getent:
    database: services
    key: http
    fail_key: False
- ansible.builtin.debug:
    var: ansible_facts.getent_services

- name: Get user password hash (requires sudo/root)
  ansible.builtin.getent:
    database: shadow
    key: www-data
    split: ':'
- ansible.builtin.debug:
    var: ansible_facts.getent_shadow

'''

RETURN = '''
ansible_facts:
  description: Facts to add to ansible_facts.
  returned: always
  type: dict
  contains:
    getent_<database>:
      description:
        - A list of results or a single result as a list of the fields the db provides
        - The list elements depend on the database queried, see getent man page for the structure
        - Starting at 2.11 it now returns multiple duplicate entries, previouslly it only returned the last one
      returned: always
      type: list
'''

import traceback

from ansible.module_utils.basic import AnsibleModule
from ansible.module_utils._text import to_native


def main():
    module = AnsibleModule(
        argument_spec=dict(
            database=dict(type='str', required=True),
            key=dict(type='str', no_log=False),
            service=dict(type='str'),
            split=dict(type='str'),
            fail_key=dict(type='bool', 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')
    service = module.params.get('service')
    fail_key = module.params.get('fail_key')

    getent_bin = module.get_bin_path('getent', True)

    if key is not None:
        cmd = [getent_bin, database, key]
    else:
        cmd = [getent_bin, database]

    if service is not None:
        cmd.extend(['-s', service])

    if split is None and database in colon:
        split = ':'

    try:
        rc, out, err = module.run_command(cmd)
    except Exception as e:
        module.fail_json(msg=to_native(e), exception=traceback.format_exc())

    msg = "Unexpected failure!"
    dbtree = 'getent_%s' % database
    results = {dbtree: {}}

    if rc == 0:
        seen = {}
        for line in out.splitlines():
            record = line.split(split)

            if record[0] in seen:
                # more than one result for same key, ensure we store in a list
                if seen[record[0]] == 1:
                    results[dbtree][record[0]] = [results[dbtree][record[0]]]

                results[dbtree][record[0]].append(record[1:])
                seen[record[0]] += 1
            else:
                # new key/value, just assign
                results[dbtree][record[0]] = record[1:]
                seen[record[0]] = 1

        module.exit_json(ansible_facts=results)

    elif rc == 1:
        msg = "Missing arguments, or database unknown."
    elif rc == 2:
        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."

    module.fail_json(msg=msg)


if __name__ == '__main__':
    main()

Name	Type	Size	Permission
__pycache__	Folder		0755
__init__.py	File	0 B	0644
_include.py	File	3.06 KB	0644
add_host.py	File	3.82 KB	0644
apt.py	File	57.4 KB	0644
apt_key.py	File	17.45 KB	0644
apt_repository.py	File	28.39 KB	0644
assemble.py	File	8.76 KB	0644
assert.py	File	2.75 KB	0644
async_status.py	File	4.29 KB	0644
async_wrapper.py	File	11.43 KB	0644
blockinfile.py	File	13.29 KB	0644
command.py	File	12.64 KB	0644
copy.py	File	34.75 KB	0644
cron.py	File	25.57 KB	0644
debconf.py	File	7.55 KB	0644
debug.py	File	2.89 KB	0644
dnf.py	File	58.16 KB	0644
dpkg_selections.py	File	2.35 KB	0644
expect.py	File	8.33 KB	0644
fail.py	File	1.67 KB	0644
fetch.py	File	4.17 KB	0644
file.py	File	39.93 KB	0644
find.py	File	18.73 KB	0644
gather_facts.py	File	2.5 KB	0644
get_url.py	File	26.22 KB	0644
getent.py	File	5.56 KB	0644
git.py	File	55.22 KB	0644
group.py	File	19.57 KB	0644
group_by.py	File	2.41 KB	0644
hostname.py	File	28.12 KB	0644
import_playbook.py	File	2.06 KB	0644
import_role.py	File	3.27 KB	0644
import_tasks.py	File	2.14 KB	0644
include_role.py	File	4.15 KB	0644
include_tasks.py	File	2.64 KB	0644
include_vars.py	File	6.45 KB	0644
iptables.py	File	32.27 KB	0644
known_hosts.py	File	13.5 KB	0644
lineinfile.py	File	23.39 KB	0644
meta.py	File	5.84 KB	0644
package.py	File	3.33 KB	0644
package_facts.py	File	17.71 KB	0644
pause.py	File	3.44 KB	0644
ping.py	File	2.32 KB	0644
pip.py	File	30 KB	0644
raw.py	File	3.57 KB	0644
reboot.py	File	4.64 KB	0644
replace.py	File	11.19 KB	0644
rpm_key.py	File	8.48 KB	0644
script.py	File	4.03 KB	0644
service.py	File	63.85 KB	0644
service_facts.py	File	16.73 KB	0644
set_fact.py	File	5.62 KB	0644
set_stats.py	File	2.6 KB	0644
setup.py	File	10.79 KB	0644
shell.py	File	6.57 KB	0644
slurp.py	File	3.19 KB	0644
stat.py	File	19.62 KB	0644
subversion.py	File	13.22 KB	0644
systemd.py	File	22.82 KB	0644
systemd_service.py	File	22.82 KB	0644
sysvinit.py	File	13.47 KB	0644
tempfile.py	File	3.42 KB	0644
template.py	File	3.1 KB	0644
unarchive.py	File	42.79 KB	0644
uri.py	File	27.78 KB	0644
user.py	File	114.18 KB	0644
validate_argument_spec.py	File	2.99 KB	0644
wait_for.py	File	25.91 KB	0644
wait_for_connection.py	File	3.38 KB	0644
yum.py	File	72.05 KB	0644
yum_repository.py	File	24.82 KB	0644

Upload:

Command:

Filemanager

Server Info

System Info