ansible.builtin.getent (v2.7.7) — module

Install Ansible via pip

Install with pip install ansible==2.7.7

Description

Runs getent against one of it's various databases and returns information into the host's facts, in a getent_<database> prefixed variable.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# get root user info
- getent:
    database: passwd
    key: root

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- debug:
    var: getent_passwd

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# get all groups
- getent:
    database: group
    split: ':'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- debug:
    var: getent_group

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# get all hosts, split by tab
- getent:
    database: hosts

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- debug:
    var: getent_hosts

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# get http service info, no error if missing
- getent:
    database: services
    key: http
    fail_key: False

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- debug:
    var: getent_services

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# get user password hash (requires sudo/root)
- getent:
    database: shadow
    key: www-data
    split: ':'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- debug:
    var: getent_shadow

Inputs

    
key:
    default: ''
    description:
    - Key from which to return values from the specified database, otherwise the full
      contents are returned.

split:
    description:
    - "Character used to split the database values into lists/arrays such as ':' or '\t\
      ', otherwise  it will try to pick one depending on the database."

database:
    description:
    - The name of a getent database supported by the target system (passwd, group, hosts,
      etc).
    required: true

fail_key:
    default: 'yes'
    description:
    - If a supplied key is missing this will make the task fail if C(yes).
    type: bool