get entries from administrative database
|database [key ...]
getent program retrieves and displays entries from
the administrative database specified by database. The
order in which entries are looked up is defined by the specific database (for
example, the lookup order for the “hosts” database is determined
by resolv.conf(5)). The display format
for a given database is as per the
“traditional” file format for that database.
database may be one of:
||address name [alias ...]
||name protocol [alias ...]
||name number [alias ...]
||name port/protocol [alias ...]
If one or more key arguments are provided,
they will be looked up in database using the
appropriate function. For example,
passwd supports a
numeric UID or user name;
hosts supports an IPv4
address, IPv6 address, or host name; and
supports a service name, service name/protocol name, numeric port, or
numeric port/protocol name.
If no key is provided and
database supports enumeration, all entries for
database will be retrieved using the appropriate
enumeration function and printed.
getent utility exits with one of the following
- There was an error in the command syntax.
- One of the specified key names was not found in
- There is no support for enumeration on
getent command first appeared in
OpenBSD 3.9. It was based on the command of the same
name in Solaris and Linux.