OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man5 / nsswitch.conf.5
index eadb5b9..22a5524 100644 (file)
@@ -1,5 +1,7 @@
-.\" Copyright (c) 1998 Thorsten Kukuk (kukuk@vt.uni-paderborn.de)
+.\" Copyright (c) 1998, 1999 Thorsten Kukuk (kukuk@vt.uni-paderborn.de)
+.\" Copyright (c) 2011, Mark R. Bannister <cambridge@users.sourceforge.net>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.\" This manual page based on the GNU C Library info pages.
-.\" FIXME ? The use of quotes on this page is inconsistent with the
-.\" rest of man-pages.
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
 .\" Translated Wed Apr 29 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
 .\" Updated & Modified Sat Aug 21 1999
 .\"       by NAKANO Takeo <nakano@apm.seikei.ac.jp>
 .\" Updated Fri Oct 12 JST 2001 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2012-05-06, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
 .\"
-.\" WORD:      lookup          ±ÜÍ÷(¤¹¤ë)
-.\"
-.TH NSSWITCH.CONF 5 1999-01-17 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.\"O nsswitch.conf \- System Databases and Name Service Switch configuration file
-.SH Ì¾Á°
-nsswitch.conf \- ¥·¥¹¥Æ¥à¥Ç¡¼¥¿¥Ù¡¼¥¹¤È¥Í¡¼¥à¥µ¡¼¥Ó¥¹¥¹¥¤¥Ã¥Á¤ÎÀßÄê¥Õ¥¡¥¤¥ë
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O Various functions in the C Library need to be configured to work
-.\"O correctly in the local environment.
-.\"O Traditionally, this was done by
-.\"O using files (e.g., \fI/etc/passwd\fP), but other nameservices (like the
-.\"O Network Information Service (NIS) and the Domain Name Service (DNS))
-.\"O became popular, and were hacked into the C library, usually with a fixed
-.\"O search order.
-C ¥é¥¤¥Ö¥é¥ê¤Îµ¡Ç½¤ÎÃæ¤Ë¤Ï¡¢¥í¡¼¥«¥ë¤Ê´Ä¶­¤ÇÀµ¤·¤¯Æ°ºî¤µ¤»¤ë¤Ë¤ÏÀßÄ꤬
-ɬÍפʤâ¤Î¤¬Â¿¿ô¸ºß¤¹¤ë¡£ÅÁÅýŪ¤Ë¤³¤ì¤Ï¥Õ¥¡¥¤¥ë (Î㤨¤Ð \fI/etc/passwd\fP) ¤ò
-ÍѤ¤¤ë¤³¤È¤Ç¼Â¸½¤µ¤ì¤Æ¤­¤¿¡£¤·¤«¤·Â¾¤Î¥Í¡¼¥à¥µ¡¼¥Ó¥¹ (Network
-Information Service (NIS) ¤ä Domain Name Service (DNS)) ¤¬°ìÈÌŪ¤Ë¤Ê¤ê¡¢
-¤³¤ì¤é¤¬ C ¥é¥¤¥Ö¥é¥ê¤Ë¼è¤ê¹þ¤Þ¤ì¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤Ã¤¿¡£¤¿¤À¤·Ä̾¸¡
-º÷¤Î½ç½ø¤Ï¸ÇÄꤵ¤ì¤Æ¤¤¤¿¡£
+.TH NSSWITCH.CONF 5 2013\-02\-12 Linux "Linux Programmer's Manual"
+.SH 名前
+nsswitch.conf \- ネームサービススイッチの設定ファイル
+.SH 説明
+ネームサービススイッチ (Name Service Switch; NSS) の設定ファイル
+\fI/etc/nsswitch.conf\fP は、 GNU C ライブラリが
+いろいろなカテゴリの名前サービス情報を、どの情報源から
+どの順序で取得するかを判断するのに使用される
+(情報の各カテゴリはデータベース名で識別される)。
 .LP
-.\"O The Linux libc5 with NYS support and the GNU C Library 2.x (libc.so.6)
-.\"O contain a cleaner solution of this problem.
-.\"O It is designed after a method
-.\"O used by Sun Microsystems in the C library of Solaris 2.
-.\"O We follow their
-.\"O name and call this scheme "Name Service Switch" (NSS).
-.\"O The sources for
-.\"O the "databases" and their lookup order are specified in the
-.\"O .I /etc/nsswitch.conf
-.\"O file.
-NYS ¤ò¥µ¥Ý¡¼¥È¤·¤¿ Linux libc5 ¤ä GNU C Linrary 2.x (libc.so.6) ¤Ç¤Ï¡¢
-¤³¤ÎÌäÂê¤Ï¤è¤ê¸«Ä̤·Îɤ¯²ò·è¤Ç¤­¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¡£¤³¤ì¤é¤Ï Sun
-Microsystems ¤¬ Solaris 2 ¤Î C ¥é¥¤¥Ö¥é¥ê¤ÇÍѤ¤¤¿ÊýË¡¤Ë¤Ê¤é¤Ã¤Æ¤¤¤ë¡£
-°Ê²¼¤Ç¤Ï¤³¤Î»ÅÁȤߤò "Name Service Switch" (NSS) ¤È¸Æ¤Ö¡£¥Ç¡¼¥¿¥Ù¡¼¥¹
-¤Î¾ðÊ󸻤ȡ¢¤½¤ì¤é¤ò±ÜÍ÷¤¹¤ë½ç½ø¤ò»ØÄꤷ¤¿¤Î¤¬
-.I /etc/nsswitch.conf
-¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
+設定ファイルは通常の ASCII テキストで、列はスペースかタブ文字で
+区切られる。最初の列はデータベース名を示す。
+残りの列は、情報を問い合わせる情報源の順序と、
+検索結果に対して実行するアクションを規定する。
 .LP
-.\"O The following databases are available in the NSS:
-NSS(¥Í¡¼¥à¥µ¡¼¥Ó¥¹¥¹¥£¥Ã¥Á) ¤Ç¤Ï°Ê²¼¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤ò°·¤¦¤³¤È¤¬¤Ç¤­¤ë¡£
-.TP
-.B aliases
-.\"O Mail aliases, used by
-.\"O .BR sendmail (8).
-.\"O Presently ignored.
-.BR sendmail (8)
-¤ÇÍѤ¤¤é¤ì¤ë¥á¡¼¥ë¥¨¥¤¥ê¥¢¥¹¡£
-¸½ºß¤Ï̵»ë¤µ¤ì¤ë¡£
-.TP
-.B ethers
-.\"O Ethernet numbers.
-¥¤¡¼¥µ¡¼¥Í¥Ã¥ÈÈֹ档
-.TP
-.B group
-.\"O Groups of users, used by
-.\"O .BR getgrent (3)
-.\"O functions.
-¥æ¡¼¥¶¡¼¤Î¥°¥ë¡¼¥×¡£
-.BR getgrent (3)
-´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B hosts
-.\"O Host names and numbers, used by
-.\"O .BR gethostbyname (3)
-.\"O and similar functions.
-¥Û¥¹¥È̾¤È¥Û¥¹¥ÈÈֹ档
-.BR gethostbyname (3)
-¤Ê¤É¤Î´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B netgroup
-.\"O Network wide list of hosts and users, used for access rules.
-.\"O C libraries before glibc 2.1 only support netgroups over NIS.
-¥Í¥Ã¥È¥ï¡¼¥¯¥ï¥¤¥É¤ËÍѤ¤¤é¤ì¤ë¥Û¥¹¥È¤ä¥æ¡¼¥¶¡¼¤Î¥ê¥¹¥È¡£¥¢¥¯¥»¥¹À©¸Â¤Ë
-ÍøÍѤµ¤ì¤ë¡£ glibc 2.1 °ÊÁ°¤Î C ¥é¥¤¥Ö¥é¥ê¤Ï¡¢ NIS ¾å¤Ç¤À¤±
-netgroup ¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¡£
-.TP
-.B networks
-.\"O Network names and numbers, used by
-.\"O .BR getnetent (3)
-.\"O functions.
-¥Í¥Ã¥È¥ï¡¼¥¯Ì¾¤ÈÈֹ档
-.BR getnetent (3)
-´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B passwd
-.\"O User passwords, used by
-.\"O .BR getpwent (3)
-.\"O functions.
-¥æ¡¼¥¶¡¼¥Ñ¥¹¥ï¡¼¥É¡£
-.BR getpwent (3)
-´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B protocols
-.\"O Network protocols, used by
-.\"O .BR getprotoent (3)
-.\"O functions.
-¥Í¥Ã¥È¥ï¡¼¥¯¥×¥í¥È¥³¥ë¡£
-.BR getprotoent (3)
-´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B publickey
-.\"O Public and secret keys for secure_rpc used by NIS+ and NFS.
-NIS+ ¤È NFS ¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë secure_rpc ¤Î¸ø³«¸°¤ÈÈëÌ©¸°¡£
-.TP
-.B rpc
-.\"O Remote procedure call names and numbers, used by
-.\"O .BR getrpcbyname (3)
-.\"O and similar functions.
-¥ê¥â¡¼¥È¥×¥í¥·¥¸¥ã¡¼¥³¡¼¥ë (remote procedure call) ¤Î̾Á°¤ÈÈֹ档
-.BR getrpcbyname (3)
-¤Ê¤É¤Î´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B services
-.\"O Network services, used by
-.\"O .BR getservent (3)
-.\"O functions.
-¥Í¥Ã¥È¥ï¡¼¥¯¥µ¡¼¥Ó¥¹¡£
-.BR getservent (3)
-´Ø¿ô¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B shadow
-.\"O Shadow user passwords, used by
-.\"O .BR getspnam (3).
-¥·¥ã¥É¥¦¥æ¡¼¥¶¡¼¥Ñ¥¹¥ï¡¼¥É¡£
-.BR getspnam (3)
-¤Ë¤è¤Ã¤ÆÍѤ¤¤é¤ì¤ë¡£
+GNU C ライブラリでは以下のデータベースを扱うことができる。
+.TP  12
+\fBaliases\fP
+メールのエイリアス。 \fBgetaliasent\fP(3) や関連する関数が使用する。
+.TP 
+\fBethers\fP
+イーサーネット番号。
+.TP 
+\fBgroup\fP
+ユーザーのグループ。 \fBgetgrent\fP(3) や関連する関数が使用する。
+.TP 
+\fBhosts\fP
+ホスト名とホスト番号。 \fBgethostbyname\fP(3) や関連する関数が使用する。
+.TP 
+\fBinitgroups\fP
+補助グループアクセスリスト。 \fBgetgrouplist\fP(3) 関数が使用する。
+.TP 
+\fBnetgroup\fP
+ネットワークワイドに用いられるホストやユーザーのリスト。アクセス制限に利用
+される。 glibc 2.1 より前の C ライブラリは、 NIS による netgroup のみを
+サポートしていた。
+.TP 
+\fBnetworks\fP
+ネットワーク名と番号。 \fBgetnetent\fP(3) と関連する関数が使用する。
+.TP 
+\fBpasswd\fP
+ユーザーパスワード。 \fBgetpwent\fP(3) や関連する関数が使用する。
+.TP 
+\fBprotocols\fP
+ネットワークプロトコル。 \fBgetprotoent\fP(3) や関連する関数が使用する。
+.TP 
+\fBpublickey\fP
+NIS+ と NFS によって用いられる secure_rpc の公開鍵と秘密鍵。
+.TP 
+\fBrpc\fP
+リモート手続き呼び出し (remote procedure call) の名前と番号。
+\fBgetrpcbyname\fP(3) と関連する関数が使用する。
+.TP 
+\fBservices\fP
+ネットワークサービス。 \fBgetservent\fP(3) や関連する関数が使用する。
+.TP 
+\fBshadow\fP
+シャドウユーザーパスワード。 \fBgetspnam\fP(3) や関連する関数が使用する。
 .LP
-.\"O An example
-.\"O .I /etc/nsswitch.conf
-.\"O (namely, the default used when
-.\"O .I /etc/nsswitch.conf
-.\"O is missing):
-.I /etc/nsswitch.conf
-¥Õ¥¡¥¤¥ë¤Î°ìÎã¤ò°Ê²¼¤Ë¼¨¤¹ (¤³¤³¤Ë¼¨¤¹ÆâÍƤÏ
-.I /etc/nsswitch.conf
-¥Õ¥¡¥¤¥ë¤¬¤Ê¤¤¾ì¹ç¤Î¥Ç¥Õ¥©¥ë¥È¤ÈƱ¤¸¤Ç¤¢¤ë)¡£
-.sp 1n
+以下は \fI/etc/nsswitch.conf\fP ファイルの例である。
+.LP
+.RS 4
 .PD 0
-.TP 16
+.TP  16
 passwd:
 compat
-.TP
+.TP 
 group:
 compat
-.TP
+.TP 
 shadow:
 compat
 .sp 1n
-.TP
+.TP 
 hosts:
 dns [!UNAVAIL=return] files
-.TP
+.TP 
 networks:
 nis [NOTFOUND=return] files
-.TP
+.TP 
 ethers:
 nis [NOTFOUND=return] files
-.TP
+.TP 
 protocols:
 nis [NOTFOUND=return] files
-.TP
+.TP 
 rpc:
 nis [NOTFOUND=return] files
-.TP
+.TP 
 services:
 nis [NOTFOUND=return] files
 .PD
+.RE
 .LP
-.\"O XXX: The first column is the database.
-.\"O XXX: The rest of the line specifies how the lookup process works.
-.\"O You can specify the way it works for each database individually.
-ºÇ½é¤Î¥«¥é¥à¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹Ì¾¤Ç¤¢¤ë¡£
-¹Ô¤Î»Ä¤ê¤Ç¤Ï±ÜÍ÷¥×¥í¥»¥¹¤ÎÆ°ºî¤ò»ØÄꤷ¤Æ¤¤¤ë¡£
-¤½¤ì¤¾¤ì¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤ËÂФ·¤Æ¡¢±ÜÍ÷ÊýË¡¤ÏÆÈΩ¤ËÀßÄê¤Ç¤­¤ë¡£
+最初の列はデータベース名である。
+残りの列で以下を指定する。
+.IP * 3
+1 個以上のサービス指定 (例: "files", "db", "nis")。この行に記載された
+サービスの順序で、結果が得られるまで、指定されたサービスに対する
+問い合わせが順番に行われる。
+.IP *
+特定の結果が直前のサービスで得られた場合に実行されるアクション
+(例: "[NOTFOUND=return]")。アクションは省略可能である。
 .LP
-.\"O The configuration specification for each database can contain two
-.\"O different items:
-³Æ¡¹¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎÀßÄê¤Ë¤Ï°Ê²¼¤Î 2 ¼ïÎà¤ÎÆâÍƤò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-.PD 0
-.TP
-.\"O * The service specification like `files', `db', or `nis'.
-* ¥µ¡¼¥Ó¥¹¤Î»ØÄê¡£ `files', `db', `nis' ¤Ê¤É¡£
-.TP
-.\"O * The reaction on lookup result like `[NOTFOUND=return]'.
-* ±ÜÍ÷·ë²Ì¤ËÂФ¹¤ë¥ê¥¢¥¯¥·¥ç¥ó¡£ `[NOTFOUND=return]' ¤Ê¤É¡£
-.PD
+利用しているシステムでどのサービス指定が利用できるかは、共有ライブラリ
+があるかどうかに依存しており、そのためサービス指定は拡張できるように
+なっている。\fI/lib/libnss_SERVICE.so.\fP\fBX\fP という名前のライブラリが
+\fISERVICE\fP という名前のサービスを提供する。標準のインストールを行った
+場合、"files", "db", "nis", "nisplus" が利用できる。
+データベース \fBhosts\fP の場合には、追加で "dns" も指定できる。
+データベース \fBpasswd\fP, \fBgroup\fP, \fBshadow\fP の場合には、追加で
+"compat" (下記の \fB互換モード\fP を参照)。バージョン番号 \fBX\fP は、
+glibc 2.0 の場合は 1、glibc 2.1 の場合は 2 で、それ以降も同様である。
+追加のライブラリがインストールされているシステムでは、"hesiod",
+"ldap", "winbind", "wins" などの追加のサービスが利用できる。
 .LP
-.\"O For libc5 with NYS, the allowed service specifications are `files', `nis',
-.\"O and `nisplus'.
-.\"O For hosts, you could specify `dns' as extra service, for
-.\"O passwd and group `compat', but not for shadow.
-NYS µ¡Ç½¤òÁȤ߹þ¤ó¤À libc5 ¤Ç¤Ï¡¢»ØÄê¤Ç¤­¤ë¥µ¡¼¥Ó¥¹¤Ï `files'¡¢ `nis'¡¢
-`nisplus' ¤Î¤¤¤º¤ì¤«¤Ç¤¢¤ë¡£ hosts ¤ËÂФ·¤Æ¤Ï `dns' ¤â»ØÄê¤Ç¤­¤ë¡£¤Þ¤¿
-passwd ¤È group ¤ËÂФ·¤Æ¤Ï `compat' ¤â»ØÄê¤Ç¤­¤ë¡£ shadow ¤Ë¤Ï
-`compat' ¤Î»ØÄê¤Ï¤Ç¤­¤Ê¤¤¡£
+サービス指定の次にアクションを指定することもできる。アクションを
+使うと、直前のデータ源から結果が得られた後の動作を変更できる。
+アクション指定は、一般的には以下の形式となる。
 .LP
-.\"O For glibc, you must have a file called
-.\"O .BI /lib/libnss_SERVICE.so. X
-.\"O for every SERVICE you are using.
-.\"O On a standard installation, you could use
-.\"O `files', `db', `nis', and `nisplus'.
-.\"O For hosts, you could specify `dns' as
-.\"O extra service, for passwd, group, and shadow `compat'.
-.\"O These services will not
-.\"O be used by libc5 with NYS.
-.\"O The version number
-.\"O .I X
-.\"O is 1 for glibc 2.0 and 2 for glibc 2.1.
-glibc ¤Ç¤Ï¡¢ÍøÍѤ·¤è¤¦¤È¤¹¤ë¥µ¡¼¥Ó¥¹ SERVICE ¤½¤ì¤¾¤ì¤ËÂФ·
-¤Æ
-.BI /lib/libnss_SERVICE.so. X
-¤È¤¤¤¦¥Õ¥¡¥¤¥ë¤¬É¬Íפˤʤ롣ɸ½àŪ¤Ê¥¤¥ó¥¹¥È¡¼¥ë¤Ç¤Ï `files'¡¢ `db'¡¢
-`nis'¡¢ `nisplus' ¤¬ÍøÍѤǤ­¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¤³¤È¤¬Â¿¤¤¡£ hosts ¤ËÂÐ
-¤·¤Æ¤Ï `dns' ¤â»ØÄê¤Ç¤­¡¢ passwd¡¢ group¡¢ shadow ¤ËÂФ·¤Æ¤Ï `compat'
-¤â»ØÄê¤Ç¤­¤ë¡£
-¤³¤ì¤é¤Î¥µ¡¼¥Ó¥¹¤Ï libc5+NYS ¤Î´Ä¶­¤Ç¤ÏÍøÍѤǤ­¤Ê¤¤¡£
-¥Ð¡¼¥¸¥ç¥óÈÖ¹æ
-.I X
-¤Ï¡¢ glibc 2.0 ÍѤʤé 1¡¢ glibc 2.1 ÍѤʤé 2 ¤Ç¤¢¤ë¡£
+.RS 4
+[\fISTATUS\fP=\fIACTION\fP]
+.br
+[!\fISTATUS\fP=\fIACTION\fP]
+.RE
 .LP
-.\"O The second item in the specification gives the user much finer
-.\"O control on the lookup process.
-.\"O Action items are placed between two
-.\"O service names and are written within brackets.
-.\"O The general form is
-Æó¤Ä¤á¤Î»ØÄêÊýË¡¤Ï±ÜÍ÷¥×¥í¥»¥¹¤ò¤è¤ê¾ÜºÙ¤ËÀ©¸æ¤¹¤ë¤¿¤á¤Î¤â¤Î¤Ç¤¢¤ë¡£¥¢
-¥¯¥·¥ç¥ó»ØÄê (action item) ¤Ï¥µ¡¼¥Ó¥¹Ì¾¤Î´Ö¤Ë¡¢³Ñ¤«¤Ã¤³ [] ¤Ç³ç¤é¤ì¤Æ
-µ­½Ò¤µ¤ì¤ë¡£°ìÈÌŪ¤Ê½ñ¼°¤Ï°Ê²¼¤ÎÄ̤ꡣ
+STATUS と ACTION はそれぞれ以下の値を取る。
 .LP
-`[' ( `!'? STATUS `=' ACTION )+ `]'
+.RS 4
+\fISTATUS\fP => \fBsuccess\fP | \fBnotfound\fP | \fBunavail\fP | \fBtryagain\fP
+.br
+\fIACTION\fP => \fBreturn\fP | \fBcontinue\fP
+.RE
 .LP
-.\"O where
-¤³¤³¤Ç¤½¤ì¤¾¤ì
-.sp 1n
-.PD 0
-.TP
-STATUS => success | notfound | unavail | tryagain
-.TP
-ACTION => return | continue
-.PD
-¤Ç¤¢¤ë¡£
+! はテスト結果を反転させる。
+つまり、指定された以外の全ての結果にマッチする。
+キーワードの大文字、小文字は無視される。
+.LP
+\fISTATUS\fP は、直前のサービス指定で呼び出しされた検索処理の結果に
+対して照合が行われる。 \fISTATUS\fP には以下のいずれかを指定できる。
+.RS 4
+.TP  12
+\fBsuccess\fP
+エラーは発生せず、要求されたエントリが返された。
+この場合のデフォルトのアクションは "return" である。
+.TP 
+\fBnotfound\fP
+検索は成功したが、要求されたエントリが見つからなかった。
+この場合のデフォルトのアクションは "continue" である。
+.TP 
+\fBunavail\fP
+サービスが永続的に利用できない。
+必要なファイルを読み込むことができない、
+ネットワークサービスの場合には、サーバが利用できないとか、
+サーバが問い合わせを許可していない、などが考えられる。
+この場合のデフォルトのアクションは "continue" である。
+.TP 
+\fBtryagain\fP
+サービスが一時的に利用できない。
+ファイルがロックされている、サーバがこれ以上接続を受け付けることができない、
+などが考えられる。デフォル トのアクションは "continue" である。
+.RE
+.LP
+\fIACTION\fP には以下のいずれかを指定できる。
+.RS 4
+.TP  12
+\fBreturn\fP
+結果をすぐに返す。 これ以上検索処理は呼び出されない。 ただし、互換性のため、 選択されたアクションが \fBgroup\fP データベースに対するもので、
+ステータスが \fBnotfound\fP であった場合で、 設定ファイルに \fBinitgroups\fP
+の行が含まれていない場合には、次の検索処理は常に呼び出される (検索結果への影響はない)。
+.TP 
+\fBcontinue\fP
+次の検索処理を呼び出す。
+.RE
+.SS "互換モード (compat)"
+NSS "compat" サービスは "files" と似ているが、システムにアクセスできる
+ユーザやネットグループ (netgroup) のメンバの指定に \fI/etc/passwd\fP で
+特別なエントリを追加で使うことができる点が異なる。
+このモードでは、以下のエントリを使うことができる。
+.RS 4
+.TP  12
+\fB+\fP\fIuser\fP
+NIS パスワードマップの指定された \fIuser\fP を含める。
+.TP 
+\fB+@\fP\fInetgroup\fP
+指定された \fInetgroup\fP の全ユーザを含める。
+.TP 
+\fB\-\fP\fIuser\fP
+NIS パスワードマップの指定された \fIuser\fP を除外する。
+.TP 
+\fB\-@\fP\fInetgroup\fP
+指定された \fInetgroup\fP の全ユーザを除外する。
+.TP 
+\fB+\fP
+NIS パスワードマップのユーザのうち、
+それまでに除外されていない全てのユーザを含める。
+.RE
 .LP
-.\"O The case of the keywords is insignificant.
-.\"O The STATUS values are
-.\"O the results of a call to a lookup function of a specific service.
-.\"O They mean:
-¥­¡¼¥ï¡¼¥É¤ÎÂçʸ»ú¾®Ê¸»ú¤Ï¶èÊ̤µ¤ì¤Ê¤¤¡£ STATUS ¤ÎÃͤÏÆÃÄê¤Îµ¡Ç½¤ËÂФ·
-¤Æ±ÜÍ÷¤ò¹Ô¤Ã¤¿·ë²Ì¤Ç¤¢¤ë¡£¤½¤ì¤¾¤ì¤Î°ÕÌ£¤Ï°Ê²¼¤ÎÄ̤ꡣ
-.TP
-.B success
-.\"O No error occurred and the wanted entry is returned.
-.\"O The default
-.\"O action for this is `return'.
-¥¨¥é¡¼¤Ïµ¯¤³¤é¤º¡¢É¬Íפʥ¨¥ó¥È¥ê¤¬ÊÖ¤µ¤ì¤¿¡£¤³¤Î·ë²Ì¤ËÂФ¹¤ë¥Ç¥Õ¥©¥ë¥È
-¤Î¥¢¥¯¥·¥ç¥ó¤Ï `return' ¤Ç¤¢¤ë¡£
-.TP
-.B notfound
-.\"O The lookup process succeeded, but the needed value was not found.
-.\"O The default action is `continue'.
-±ÜÍ÷¥×¥í¥»¥¹¤ÏÀ®¸ù¤·¤¿¤¬¡¢É¬ÍפÊÃͤ¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¡£¥Ç¥Õ¥©¥ë¥È¤Î
-¥¢¥¯¥·¥ç¥ó¤Ï `continue'¡£
-.TP
-.B unavail
-.\"O The service is permanently unavailable.
-.\"O This can either mean the
-.\"O needed file is not available, or, for DNS, the server is not
-.\"O available or does not allow queries.
-.\"O The default action is
-.\"O `continue'.
-¥µ¡¼¥Ó¥¹¤¬¡Ê±Ê³Ū¤Ë¡ËÍøÍѤǤ­¤Ê¤¤¡£É¬Íפʥե¡¥¤¥ë¤¬Â¸ºß¤·¤Ê¤¤¡¢DNS ¤Î
-¾ì¹ç¤Ë¤Ï¥µ¡¼¥Ð¤ËÂФ¹¤ëÌ䤤¹ç¤ï¤»¤¬µö²Ä¤µ¤ì¤Æ¤¤¤Ê¤¤¡¢¤Ê¤É¤¬¤¢¤ê¤¦¤ë¡£
-¥Ç¥Õ¥©¥ë¥È¤Î¥¢¥¯¥·¥ç¥ó¤Ï `continue'¡£
-.TP
-.B tryagain
-.\"O The service is temporarily unavailable.
-.\"O This could mean a file is
-.\"O locked or a server currently cannot accept more connections.
-.\"O The default action is `continue'.
-¥µ¡¼¥Ó¥¹¤¬°ì»þŪ¤ËÍøÍѤǤ­¤Ê¤¤¡£¥Õ¥¡¥¤¥ë¤¬¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤ë¡¢¥µ¡¼¥Ð¤ÎÀÜ
-³¿ô¤¬¥ê¥ß¥Ã¥È¤ò±Û¤¨¤Æ¤¤¤Æ¸½ºßÍøÍѤǤ­¤Ê¤¤¡¢¤Ê¤É¤¬¹Í¤¨¤é¤ì¤ë¡£¥Ç¥Õ¥©¥ë
-¥È¤Î¥¢¥¯¥·¥ç¥ó¤Ï `continue'¡£
-.\"O .SS Interaction with +/\- syntax (compat mode)
-.SS +/\- ½ñ¼°¤È¤Î´Ø·¸ (compat ¥â¡¼¥É)
-.\"O Linux libc5 without NYS does not has the name service switch but does
-.\"O allow the user some policy control.
-.\"O In
-.\"O .I /etc/passwd
-.\"O you could have entries of the form +user or +@netgroup
-.\"O (include the specified user from the NIS passwd map),
-.\"O \-user or \-@netgroup (exclude the specified user),
-.\"O and + (include every user, except the excluded ones, from the NIS
-.\"O passwd map).
-.\"O Since most people only put a + at the end of
-.\"O .I /etc/passwd
-.\"O to include everything from NIS, the switch provides a faster
-.\"O alternative for this case (`passwd: files nis') which doesn't
-.\"O require the single + entry in
-.\"O .IR /etc/passwd ,
-.\"O .I /etc/group ,
-.\"O and
-.\"O .IR /etc/shadow .
-NYS µ¡Ç½¤òÁȤ߹þ¤ó¤Ç¤¤¤Ê¤¤ libc5 ¤Ï¡¢¥Í¡¼¥à¥µ¡¼¥Ó¥¹¥¹¥¤¥Ã¥Á¤Îµ¡Ç½¤ò»ý¤Ã
-¤Æ¤¤¤Ê¤¤¡£¤·¤«¤·¤¢¤ëÄøÅ٤Υݥꥷ¡¼À©¸æ¤Ï¹Ô¤¦¤³¤È¤¬¤Ç¤­¤ë¡£
-.I /etc/passwd
-¤Ç¤Ï +user ¤ä +@netgroup (NIS ¤Î passwd ¥Þ¥Ã¥×¤«¤é»ØÄꤷ¤¿¥æ¡¼¥¶¤ò¼è¤ê¹þ
-¤à)¡¢ \-user ¤ä \-@netgroup (»ØÄꤷ¤¿¥æ¡¼¥¶¤ò½ü³°¤¹¤ë)¡¢ + (NIS ¤Î
-passwd ¥Þ¥Ã¥×¤«¤é¡¢½ü³°¤µ¤ì¤¿¥æ¡¼¥¶°Ê³°¤ÎÁ´¤Æ¤Î¥¨¥ó¥È¥ê¤ò¼è¤ê¹þ¤à) ¤Ê
-¤É¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-¤Û¤È¤ó¤É¤Î¾ì¹ç¤Ï
-.I /etc/passwd
-¤ÎºÇ¸å¤Ë + ¤òÉÕ¤±¤Æ NIS ¤Î¤¹¤Ù¤Æ¤ò¼è¤ê¹þ¤ó¤Ç¤¤¤ë¤À¤±¤Ê¤Î¤Ç¡¢
-¥Í¡¼¥à¥µ¡¼¥Ó¥¹¥¹¥¤¥Ã¥Á¤òÍѤ¤¤Æ
-(`passwd: files nis') ¤Î¤è¤¦¤Ë¤¹¤ì¤Ð¤è¤ê¹â®¤ÊÆ°ºî¤¬´üÂԤǤ­¡¢
-¤Þ¤¿
-.IR /etc/passwd ", " /etc/group ", " /etc/shadow
-¤Ë + ¤À¤±¤Î¥¨¥ó¥È¥ê¤ò½ñ¤«¤Ê¤¯¤Æ¤¹¤à¡£
-.\"O If this is not sufficient, the NSS `compat' service provides full
-.\"O +/\- semantics.
-.\"O By default, the source is `nis', but this may be
-.\"O overridden by specifying `nisplus' as source for the pseudo-databases
-.\"O .BR passwd_compat ,
-.\"O .B group_compat
-.\"O and
-.\"O .BR shadow_compat .
-.\"O These pseudo-databases are only available in GNU C Library.
-¤è¤êºÙ¤«¤ÊÀ©¸æ¤ò¹Ô¤¤¤¿¤¤¾ì¹ç¤Ï¡¢ NSS ¤Î `compat' ¥µ¡¼¥Ó¥¹¤òÍѤ¤¤ì¤Ð
-+/\- ½ñ¼°¤ò¥Õ¥ë¤ËÍѤ¤¤ë¤³¤È¤¬¤Ç¤­¤ë¡£¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï¥½¡¼¥¹¤Ï `nis' ¤Ë¤Ê¤Ã
-¤Æ¤¤¤ë¤¬¡¢¤³¤ì¤Ïµ¼»÷¥Ç¡¼¥¿¥Ù¡¼¥¹
-.BR passwd_compat , group_compat , shadow_compat
-¤Ê¤É¤Ë `nisplus' ¤ò»ØÄꤹ¤ë¤³¤È¤Ç¾å½ñ¤­¤Ç¤­¤ë¡£
-¤³¤ì¤é¤Îµ¼»÷¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ï GNU C ¥é¥¤¥Ö¥é¥ê¤Ç¤·¤«ÍøÍѤǤ­¤Ê¤¤¡£
-.\"O .SH FILES
-.SH ¥Õ¥¡¥¤¥ë
-.\"O A service named SERVICE is implemented by a shared object library
-.\"O named libnss_SERVICE.so.1 that resides in /lib.
-SERVICE ¤È¤¤¤¦Ì¾Á°¤Î¥µ¡¼¥Ó¥¹¤Ï libnss_SERVICE.so.1 ¤È¤¤¤¦Ì¾Á°¤Î¶¦Í­¥ª
-¥Ö¥¸¥§¥¯¥È¥é¥¤¥Ö¥é¥ê¤Ç¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£¤³¤ì¤Ï /lib ¤ËÃÖ¤«¤ì¤ë¡£
-.TP 25
+デフォルトでは、データ源は "nis" だが、
+擬似データベース \fBpasswd_compat\fP, \fBgroup_compat\fP, \fBshadow_compat\fP
+ではデータ源として "nisplus" を指定することもできる。
+.SH ファイル
+\fISERVICE\fP という名前のサービスは \fIlibnss_SERVICE.so.\fP\fBX\fP という
+名前の共有オブジェクトライブラリで実装されている。
+これは \fI/lib\fP に置かれる。
+.RS 4
+.TP  25
 .PD 0
-.I /etc/nsswitch.conf
-.\"O configuration file
-ÀßÄê¥Õ¥¡¥¤¥ë¡£
-.TP
-.BI /lib/libnss_compat.so. X
-.\"O implements `compat' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `compat' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_db.so. X
-.\"O implements `db' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `db' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_dns.so. X
-.\"O implements `dns' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `dns' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_files.so. X
-.\"O implements `files' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `files' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_hesoid.so. X
-.\"O implements `hesoid' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `hesoid' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_nis.so. X
-.\"O implements `nis' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `nis' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.BI /lib/libnss_nisplus.so. X
-.\"O implements `nisplus' source for glibc2
-glibc2 ¤ËÂФ·¤Æ `nisplus' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
-.TP
-.I /lib/libnss_nisplus.so.2
-.\"O implements `nisplus' source for glibc 2.1
-glibc 2.1 ¤ËÂФ·¤Æ `nisplus' ¥½¡¼¥¹¤ò¼ÂÁõ¤·¤¿¤â¤Î¡£
+\fI/etc/nsswitch.conf\fP
+NSS の設定ファイル。
+.TP 
+\fI/lib/libnss_compat.so.\fP\fBX\fP
+"compat" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_db.so.\fP\fBX\fP
+"db" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_dns.so.\fP\fBX\fP
+"dns" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_files.so.\fP\fBX\fP
+"files" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_hesiod.so.\fP\fBX\fP
+"hesoid" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_nis.so.\fP\fBX\fP
+"nis" ソースを実装したもの。
+.TP 
+\fI/lib/libnss_nisplus.so.\fP\fBX\fP
+"nisplus" ソースを実装したもの。
 .PD
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O Within each process that uses
-.\"O .BR nsswitch.conf ,
-.\"O the entire file is read only once; if the file is later changed, the
-.\"O process will continue using the old configuration.
-.I nsswitch.conf
-¤òÍøÍѤ¹¤ë¤½¤ì¤¾¤ì¤Î¥×¥í¥»¥¹¤Ç¤Ï¡¢¥Õ¥¡¥¤¥ë¤Ï°ìÅÙ¤·¤«Æɤ߹þ¤Þ¤ì¤Ê¤¤¡£
-¤â¤· nsswitch.conf ¤¬¤¢¤È¤Ç½ñ¤­´¹¤¨¤é¤ì¤Æ¤â¡¢
-¤½¤Î¥×¥í¥»¥¹¤Ï¸Å¤¤ÀßÄê¤Î¤Þ¤Þ¤ÇÆ°ºî¤ò·Ñ³¤¹¤ë¡£
+.RE
+.SH 注意
+\fInsswitch.conf\fP を利用するプロセスは、ファイルは一度しか読み込まない。
+その後で nsswitch.conf が書き換えられても、そのプロセスは古い設定のままで
+動作を継続する。
 .LP
-.\"O With Solaris, it isn't possible to link programs using the NSS Service
-.\"O statically.
-.\"O With Linux, this is no problem.
-Solaris ¤Ç¤Ï NSS ¥µ¡¼¥Ó¥¹¤òÍѤ¤¤¿¥×¥í¥°¥é¥à¤ò¥¹¥¿¥Æ¥£¥Ã¥¯¤Ë¥ê¥ó¥¯¤¹¤ë
-¤³¤È¤Ï¤Ç¤­¤Ê¤¤¡£ Linux ¤Ç¤ÏÌäÂê¤Ê¤¯¥¹¥¿¥Æ¥£¥Ã¥¯¥ê¥ó¥¯¤Ç¤­¤ë¡£
+伝統的には、サービス情報の情報源は一つだけであり、
+その設定ファイルの形式も一つであった (例えば \fI/etc/passwd\fP)。
+一方で、 Network Information Service (NIS) や Domain Name Service
+(DNS) などの他の名前サービスが一般的になるに連れて、C ライブラリに埋め
+込まれた固定順序ではなく、検索順序を柔軟に指定する方法が必要になった。
+ネームサービススイッチ機構は、この問題に対するよりきれいな解決方法と
+なっている。ネームサービススイッチ機構は、 Sun Microsystems が
+Solaris 2 の C ライブラリで使った機構が基になっている。
+.SH 関連項目
+\fBgetent\fP(1), \fBnss\fP(5)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。