Section: User Commands (1)
更新日期： 2020-04-11

名称

getent-从名称服务交换库获取条目

语法

getent [选项] ...数据库密钥...

说明

getent命令显示名称服务交换机库支持的数据库中的条目，这些数据库在/etc/nsswitch.conf中进行配置。如果提供一个或多个键自变量，则仅显示与提供的键匹配的条目。否则，如果未提供键，则将显示所有条目(除非数据库不支持枚举)。

该数据库可以是下面列出的GNU C库支持的任何数据库：

ahosts

ahosts如果未提供任何密钥，请使用sethostent(3)，gethostent(3)和endhostent(3)枚举hosts数据库。这与使用主机相同。提供一个或多个键参数时，将每个键与地址系列AF_UNSPEC依次传递到getaddrinfo(3)，枚举返回的每个套接字地址结构。

ahostsv4

与主机相同，但使用地址族AF_INET。

ahostsv6

与主机相同，但使用地址族AF_INET6。在这种情况下，对getaddrinfo(3)的调用包括AI_V4MAPPED标志。

aliases

如果未提供密钥，请使用setaliasent(3)，getaliasent(3)和endaliasent(3)枚举别名数据库。提供一个或多个键参数时，请将每个键连续传递给getaliasbyname(3)并显示结果。

ethers

提供一个或多个键自变量后，将每个键连续传递到ether_aton(3)和ether_hostton(3)直到获得结果，然后显示结果。以太网不支持枚举，因此必须提供密钥。

group

如果未提供任何密钥，请使用setgrent(3)，getgrent(3)和endgrent(3)枚举组数据库。提供一个或多个键参数时，将每个数字键传递给getgrgid(3)，将每个非数字键传递给getgrnam(3)并显示结果。

gshadow

如果未提供密钥，请使用setsgent(3)，getsgent(3)和endsgent(3)枚举gshadow数据库。当提供一个或多个键参数时，将每个键连续传递到getsgnam(3)并显示结果。

hosts

如果未提供任何密钥，请使用sethostent(3)，gethostent(3)和endhostent(3)枚举hosts数据库。提供一个或多个键参数时，根据对inet_pton(3)的调用是否表明该键是IPv6或IPv4地址，将每个键传递给gethostbyaddr(3)或gethostbyname2(3)，并显示结果。

initgroups

提供一个或多个键参数时，将每个键连续传递到getgrouplist(3)并显示结果。初始化组不支持枚举，因此必须提供一个密钥。

netgroup

提供一个密钥后，将该密钥传递给setnetgrent(3)，然后使用getnetgrent(3)显示生成的字符串三元组(主机名，用户名，域名)。或者，可以提供三个键，它们被解释为主机名，用户名和域名，以通过innetgr(3)匹配到网络组名。 netgroup不支持枚举，因此必须提供一个或三个密钥。

networks

如果未提供任何密钥，请使用setnetent(3)，getnetent(3)和endnetent(3)枚举网络数据库。提供一个或多个键参数时，将每个数字键传递给getnetbyaddr(3)，将每个非数字键传递给getnetbyname(3)并显示结果。

passwd

如果未提供任何密钥，请使用setpwent(3)，getpwent(3)和endpwent(3)枚举passwd数据库。提供一个或多个键参数时，将每个数字键传递给getpwuid(3)，将每个非数字键传递给getpwnam(3)并显示结果。

protocols

如果未提供密钥，请使用setprotoent(3)，getprotoent(3)和endprotoent(3)枚举协议数据库。提供一个或多个键参数时，将每个数字键传递给getprotobynumber(3)，将每个非数字键传递给getprotobyname(3)并显示结果。

rpc

如果未提供任何密钥，请使用setrpcent(3)，getrpcent(3)和endrpcent(3)枚举rpc数据库。提供一个或多个键参数时，将每个数字键传递给getrpcbynumber(3)，将每个非数字键传递给getrpcbyname(3)并显示结果。

services

如果未提供任何密钥，请使用setservent(3)，getservent(3)和endservent(3)枚举服务数据库。提供一个或多个键参数时，将每个数字键传递给getservbynumber(3)，将每个非数字键传递给getservbyname(3)并显示结果。

shadow

如果未提供任何键，请使用setspent(3)，getspent(3)和endsend(3)枚举影子数据库。提供一个或多个键参数时，将每个键连续传递到getspnam(3)并显示结果。

选项

-s service, --service service

用指定的服务覆盖所有数据库。 (从glibc 2.2.5开始。)

-s database:service, --service database:service

仅使用指定的服务覆盖指定的数据库。该选项可以多次使用，但是仅使用每个数据库的最后一个服务。 (从glibc 2.4开始。)

-i, --no-idn

在对ahosts / getaddrinfo(3)的查找中禁用IDN编码(自glibc-2.13起。)

-?, --help

打印使用情况摘要并退出。

--usage

打印简短的使用情况摘要并退出。

-V, --version

打印版本号，许可证和保修声明。

退出状态

getent可以返回以下退出值之一：

0

0命令成功完成。

1

参数丢失或数据库未知。

2

在数据库中找不到一个或多个提供的密钥。

3

此数据库不支持枚举。

另外参见

nsswitch.conf(5)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。