Manpages

名 前

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

書 式

getent 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_UNSPECgetaddrinfo(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 を 指 定 す る と 、 そ の keysetnetgrent(3) に 渡 し 、 getnetgrent(3) を 使 っ て 結 果 の 3 つ 組 の 文 字 列 (hostname, username, domainname) を 表 示 す る 。 代 わ り に 、 3 個 の key を 指 定 す る こ と も で き る 。 3 個 の keyhostname, 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) を 呼 び 出 し 、 結 果 を 表 示 す る 。

終 了 ス テ ー タ ス

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

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

1 引 き 数 が 不 足 し て い る か 、 知 ら な い

database が 指 定 さ れ た 。

2 指 定 さ れ た

keydatabase で 見 つ か ら な か っ た 。

3 こ の

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

関 連 項 目

nsswitch.conf(5)

こ の 文 書 に つ い て

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