ansible.builtin.getent – A wrapper to the unix getent utility¶
Note
This module is part of ansible-base
and included in all Ansible
installations. In most cases, you can use the short module name
getent even without specifying the collections:
keyword.
Despite that, we recommend you use the FQCN for easy linking to the module
documentation and to avoid conflicting with other collections that may have
the same module name.
New in version 1.8: of ansible.builtin
Synopsis¶
Runs getent against one of it’s various databases and returns information into the host’s facts, in a getent_<database> prefixed variable.
Parameters¶
Examples¶
- name: Get root user info
getent:
database: passwd
key: root
- debug:
var: getent_passwd
- name: Get all groups
getent:
database: group
split: ':'
- debug:
var: getent_group
- name: Get all hosts, split by tab
getent:
database: hosts
- debug:
var: getent_hosts
- name: Get http service info, no error if missing
getent:
database: services
key: http
fail_key: False
- debug:
var: getent_services
- name: Get user password hash (requires sudo/root)
getent:
database: shadow
key: www-data
split: ':'
- debug:
var: getent_shadow
Authors¶
Brian Coca (@bcoca)