Provided by: manpages-ja_0.5.0.0.20161015+dfsg-1_all bug

名前

       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/ に書かれている。