Man page - getent(1)

Packages contains this manual

Available languages:

en fr da ja ru ro de

Manual

GETENT

名 前
書 式
説 明
オ プ シ ョ ン
終 了 ス テ ー タ ス
関 連 項 目
こ の 文 書 に つ い て

名 前

getent - 名 前 サ ー ビ ス 切 り 替 え ラ イ ブ ラ リ か ら エ ン ト リ ー を 取 得 す る

書 式

getent [ option ]... database key ...

説 明

getent コ マ ン ド は 、 名 前 サ ー ビ ス 切 り 替 え ラ イ ブ ラ リ で サ ポ ー ト さ れ て い る デ ー タ ベ ー ス の エ ン ト リ ー を 表 示 す る 。 名 前 サ ー ビ ス 切 り 替 え ラ イ ブ ラ リ の 設 定 は /etc/nsswitch.conf で 行 う 。 一 つ 以 上 の key 引 数 が 指 定 さ れ る と 、 指 定 さ れ た キ ー に マ ッ チ す る エ ン ト リ ー だ け が 表 示 さ れ る 。 key が 指 定 さ れ な か っ た 場 合 、 す べ て の エ ン ト リ ー が 表 示 さ れ る (デ ー タ ベ ー ス で 列 挙 (enumeration) が サ ポ ー ト さ れ て い な い 場 合 を 除 く )。

database に は GNU C ラ イ ブ ラ リ で サ ポ ー ト さ れ て い る デ ー タ ベ ー ス の い ず れ か を 指 定 で き る 。 以 下 に そ の リ ス ト を 示 す 。

ahosts

key が 指 定 さ れ な か っ た 場 合 、 sethostent (3), gethostent (3), endhostent (3) を 使 用 し て hosts デ ー タ ベ ー ス を 列 挙 す る 。 こ れ は hosts を 使 う の と 全 く 同 じ で あ る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て ア ド レ ス フ ァ ミ リ ー AF_UNSPEC で getaddrinfo (3) を 呼 び 出 し 、 返 さ れ た 各 々 の ソ ケ ッ ト ア ド レ ス 構 造 体 を 列 挙 す る 。

ahostsv4

ahosts を 同 じ だ が 、 ア ド レ ス フ ァ ミ リ ー と し て AF_INET を 使 用 す る 。

ahostsv6

ahosts を 同 じ だ が 、 ア ド レ ス フ ァ ミ リ ー と し て AF_INET6 を 使 用 す る 。 こ の 場 合 の getaddrinfo (3) の 呼 び 出 し で は AI_V4MAPPED も 指 定 さ れ る 。

aliases

key が 指 定 さ れ な か っ た 場 合 、 setaliasent (3), getaliasent (3), endaliasent (3) を 使 用 し て aliases デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て getaliasbyname (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

ethers

key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 、 結 果 が 得 ら れ る ま で 、 そ れ ぞ れ の key に つ い て ether_aton (3) と ether_hostton (3) を 順 に 呼 び 出 し 、 結 果 を 表 示 す る 。 ethers で は 列 挙 は サ ポ ー ト さ れ て い な い 。 し た が っ て 、 key は 指 定 し な け れ ば な ら な い 。

group

key が 指 定 さ れ な か っ た 場 合 、 setgrent (3), getgrent (3), endgrent (3) を 使 用 し て group デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getgrgid (3) を 、 数 値 以 外 で あ れ ば getgrnam (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

gshadow

key が 指 定 さ れ な か っ た 場 合 、 setsgent (3), getsgent (3), endsgent (3) を 使 用 し て gshadow デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て getsgnam (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

hosts

key が 指 定 さ れ な か っ た 場 合 、 sethostent (3), gethostent (3), endhostent (3) を 使 用 し て hosts デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て gethostbyaddr (3) か gethostbyname2 (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。 gethostbyaddr (3) か gethostbyname2 (3) の ど ち ら を 呼 び 出 す か は 、 inet_pton (3) の 呼 び 出 し で 、 key が IPv6 や IPv4 ア ド レ ス か 、 そ う で な い か 、 判 定 さ れ 、 そ の 結 果 に よ っ て 決 ま る 。

initgroups

key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 、 結 果 が 得 ら れ る ま で 、 そ れ ぞ れ の key に つ い て getgrouplist (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。 initgroups で は 列 挙 は サ ポ ー ト さ れ て い な い 。 し た が っ て 、 key は 指 定 し な け れ ば な ら な い 。

netgroup

1 個 の key を 指 定 す る と 、 そ の key を setnetgrent (3) に 渡 し 、 getnetgrent (3) を 使 っ て 結 果 の 3 つ 組 の 文 字 列 ( hostname , username , domainname ) を 表 示 す る 。 代 わ り に 、 3 個 の key を 指 定 す る こ と も で き る 。 3 個 の key は hostname , username , domainname と 解 釈 さ れ 、 innetgr (3) を 使 っ て 対 応 す る netgroup が あ る か 照 合 さ れ る 。 netgroup で は 列 挙 は サ ポ ー ト さ れ て い な い 。 し た が っ て 、 1 個 か 3 個 の い ず れ か の key を 指 定 し な け れ ば な ら な い 。

networks

key が 指 定 さ れ な か っ た 場 合 、 setnetent (3), getnetent (3), endnetent (3) を 使 用 し て networks デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getnetbyaddr (3) を 、 数 値 以 外 で あ れ ば getnetbyname (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

passwd

key が 指 定 さ れ な か っ た 場 合 、 setpwent (3), getpwent (3), endpwent (3) を 使 用 し て passwd デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getpwgid (3) を 、 数 値 以 外 で あ れ ば getpwnam (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

protocols

key が 指 定 さ れ な か っ た 場 合 、 setprotoent (3), getprotoent (3), endprotoent (3) を 使 用 し て protocols デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getprotobynumber (3) を 、 数 値 以 外 で あ れ ば getprotobyname (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

rpc

key が 指 定 さ れ な か っ た 場 合 、 setrpcent (3), getrpcent (3), endrpcent (3) を 使 用 し て rpc デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getrpcbynumber (3) を 、 数 値 以 外 で あ れ ば getrpcbyname (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

services

key が 指 定 さ れ な か っ た 場 合 、 setservent (3), getservent (3), endservent (3) を 使 用 し て services デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て 、 数 値 で あ れ ば getservbynumber (3) を 、 数 値 以 外 で あ れ ば getservbyname (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

shadow

key が 指 定 さ れ な か っ た 場 合 、 setspent (3), getspent (3), endspent (3) を 使 用 し て shadow デ ー タ ベ ー ス を 列 挙 す る 。 key 引 数 が 一 つ 以 上 指 定 さ れ た 場 合 は 、 そ れ ぞ れ の key に つ い て getspnam (3) を 呼 び 出 し 、 結 果 を 表 示 す る 。

オ プ シ ョ ン

-s service , --service service

Override all databases with the specified service. (Since glibc 2.2.5.)

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

Override only specified databases with the specified service. The option may be used multiple times, but only the last service for each database will be used. (Since glibc 2.4.)

-i , --no-idn

Disables IDN encoding in lookups for ahosts / getaddrinfo (3) (Since glibc-2.13.)

-? , --help

Print a usage summary and exit.

--usage

Print a short usage summary and exit.

-V , --version

Print the version number, license, and disclaimer of warranty for getent .

終 了 ス テ ー タ ス

getent は 以 下 の い ず れ か の 終 了 ス テ ー タ ス を 返 す 。

0

コ マ ン ド が 正 常 に 完 了 し た 。

1

引 数 が 不 足 し て い る か 、 知 ら な い database が 指 定 さ れ た 。

2

指 定 さ れ た key が database で 見 つ か ら な か っ た 。

3

こ の database で は 列 挙 は サ ポ ー ト さ れ て い な い 。

関 連 項 目

nsswitch.conf (5)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。