release/man5/nsswitch.conf.5

   1 .\" Copyright (c) 1998, 1999 Thorsten Kukuk (kukuk@vt.uni-paderborn.de)
   2 .\" Copyright (c) 2011, Mark R. Bannister <cambridge@users.sourceforge.net>
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
   5 .\" This is free documentation; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of
   8 .\" the License, or (at your option) any later version.
   9 .\"
  10 .\" The GNU General Public License's references to "object code"
  11 .\" and "executables" are to be interpreted as the output of any
  12 .\" document formatting or typesetting system, including
  13 .\" intermediate and printed output.
  14 .\"
  15 .\" This manual is distributed in the hope that it will be useful,
  16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 .\" GNU General Public License for more details.
  19 .\"
  20 .\" You should have received a copy of the GNU General Public
  21 .\" License along with this manual; if not, see
  22 .\" <http://www.gnu.org/licenses/>.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\"*******************************************************************
  26 .\"
  27 .\" This file was generated with po4a. Translate the source file.
  28 .\"
  29 .\"*******************************************************************
  30 .\"
  31 .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
  32 .\" Translated Wed Apr 29 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  33 .\" Updated & Modified Sat Aug 21 1999
  34 .\"       by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  35 .\" Updated Fri Oct 12 JST 2001 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  36 .\" Updated 2012-05-06, Akihiro MOTOKI <amotoki@gmail.com>
  37 .\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
  38 .\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
  39 .\"
  40 .TH NSSWITCH.CONF 5 2013\-02\-12 Linux "Linux Programmer's Manual"
  41 .SH 名前
  42 nsswitch.conf \- ネームサービススイッチの設定ファイル
  43 .SH 説明
  44 ネームサービススイッチ (Name Service Switch; NSS) の設定ファイル
  45 \fI/etc/nsswitch.conf\fP は、 GNU C ライブラリが
  46 いろいろなカテゴリーの名前サービス情報を、どの情報源から
  47 どの順序で取得するかを判断するのに使用される
  48 (情報の各カテゴリーはデータベース名で識別される)。
  49 .LP
  50 設定ファイルは通常の ASCII テキストで、列はスペースかタブ文字で
  51 区切られる。最初の列はデータベース名を示す。
  52 残りの列は、情報を問い合わせる情報源の順序と、
  53 検索結果に対して実行するアクションを規定する。
  54 .LP
  55 GNU C ライブラリでは以下のデータベースを扱うことができる。
  56 .TP  12
  57 \fBaliases\fP
  58 メールのエイリアス。 \fBgetaliasent\fP(3) や関連する関数が使用する。
  59 .TP
  60 \fBethers\fP
  61 イーサーネット番号。
  62 .TP
  63 \fBgroup\fP
  64 ユーザーのグループ。 \fBgetgrent\fP(3) や関連する関数が使用する。
  65 .TP
  66 \fBhosts\fP
  67 ホスト名とホスト番号。 \fBgethostbyname\fP(3) や関連する関数が使用する。
  68 .TP
  69 \fBinitgroups\fP
  70 補助グループアクセスリスト。 \fBgetgrouplist\fP(3) 関数が使用する。
  71 .TP
  72 \fBnetgroup\fP
  73 ネットワークワイドに用いられるホストやユーザーのリスト。アクセス制限に利用
  74 される。 glibc 2.1 より前の C ライブラリは、 NIS による netgroup のみを
  75 サポートしていた。
  76 .TP
  77 \fBnetworks\fP
  78 ネットワーク名と番号。 \fBgetnetent\fP(3) と関連する関数が使用する。
  79 .TP
  80 \fBpasswd\fP
  81 ユーザーパスワード。 \fBgetpwent\fP(3) や関連する関数が使用する。
  82 .TP
  83 \fBprotocols\fP
  84 ネットワークプロトコル。 \fBgetprotoent\fP(3) や関連する関数が使用する。
  85 .TP
  86 \fBpublickey\fP
  87 NIS+ と NFS によって用いられる secure_rpc の公開鍵と秘密鍵。
  88 .TP
  89 \fBrpc\fP
  90 リモート手続き呼び出し (remote procedure call) の名前と番号。
  91 \fBgetrpcbyname\fP(3) と関連する関数が使用する。
  92 .TP
  93 \fBservices\fP
  94 ネットワークサービス。 \fBgetservent\fP(3) や関連する関数が使用する。
  95 .TP
  96 \fBshadow\fP
  97 シャドウユーザーパスワード。 \fBgetspnam\fP(3) や関連する関数が使用する。
  98 .LP
  99 以下は \fI/etc/nsswitch.conf\fP ファイルの例である。
 100 .LP
 101 .RS 4
 102 .PD 0
 103 .TP  16
 104 passwd:
 105 compat
 106 .TP
 107 group:
 108 compat
 109 .TP
 110 shadow:
 111 compat
 112 .sp 1n
 113 .TP
 114 hosts:
 115 dns [!UNAVAIL=return] files
 116 .TP
 117 networks:
 118 nis [NOTFOUND=return] files
 119 .TP
 120 ethers:
 121 nis [NOTFOUND=return] files
 122 .TP
 123 protocols:
 124 nis [NOTFOUND=return] files
 125 .TP
 126 rpc:
 127 nis [NOTFOUND=return] files
 128 .TP
 129 services:
 130 nis [NOTFOUND=return] files
 131 .PD
 132 .RE
 133 .LP
 134 最初の列はデータベース名である。
 135 残りの列で以下を指定する。
 136 .IP * 3
 137 1 個以上のサービス指定 (例: "files", "db", "nis")。この行に記載された
 138 サービスの順序で、結果が得られるまで、指定されたサービスに対する
 139 問い合わせが順番に行われる。
 140 .IP *
 141 特定の結果が直前のサービスで得られた場合に実行されるアクション
 142 (例: "[NOTFOUND=return]")。アクションは省略可能である。
 143 .LP
 144 利用しているシステムでどのサービス指定が利用できるかは、共有ライブラリ
 145 があるかどうかに依存しており、そのためサービス指定は拡張できるように
 146 なっている。\fI/lib/libnss_SERVICE.so.\fP\fBX\fP という名前のライブラリが
 147 \fISERVICE\fP という名前のサービスを提供する。標準のインストールを行った
 148 場合、"files", "db", "nis", "nisplus" が利用できる。
 149 データベース \fBhosts\fP の場合には、追加で "dns" も指定できる。
 150 データベース \fBpasswd\fP, \fBgroup\fP, \fBshadow\fP の場合には、追加で
 151 "compat" (下記の \fB互換モード\fP を参照)。バージョン番号 \fBX\fP は、
 152 glibc 2.0 の場合は 1、glibc 2.1 の場合は 2 で、それ以降も同様である。
 153 追加のライブラリがインストールされているシステムでは、"hesiod",
 154 "ldap", "winbind", "wins" などの追加のサービスが利用できる。
 155 .LP
 156 サービス指定の次にアクションを指定することもできる。アクションを
 157 使うと、直前のデータ源から結果が得られた後の動作を変更できる。
 158 アクション指定は、一般的には以下の形式となる。
 159 .LP
 160 .RS 4
 161 [\fISTATUS\fP=\fIACTION\fP]
 162 .br
 163 [!\fISTATUS\fP=\fIACTION\fP]
 164 .RE
 165 .LP
 166 STATUS と ACTION はそれぞれ以下の値を取る。
 167 .LP
 168 .RS 4
 169 \fISTATUS\fP => \fBsuccess\fP | \fBnotfound\fP | \fBunavail\fP | \fBtryagain\fP
 170 .br
 171 \fIACTION\fP => \fBreturn\fP | \fBcontinue\fP
 172 .RE
 173 .LP
 174 ! はテスト結果を反転させる。
 175 つまり、指定された以外の全ての結果にマッチする。
 176 キーワードの大文字、小文字は無視される。
 177 .LP
 178 \fISTATUS\fP は、直前のサービス指定で呼び出しされた検索処理の結果に
 179 対して照合が行われる。 \fISTATUS\fP には以下のいずれかを指定できる。
 180 .RS 4
 181 .TP  12
 182 \fBsuccess\fP
 183 エラーは発生せず、要求されたエントリーが返された。
 184 この場合のデフォルトのアクションは "return" である。
 185 .TP
 186 \fBnotfound\fP
 187 検索は成功したが、要求されたエントリーが見つからなかった。
 188 この場合のデフォルトのアクションは "continue" である。
 189 .TP
 190 \fBunavail\fP
 191 サービスが永続的に利用できない。
 192 必要なファイルを読み込むことができない、
 193 ネットワークサービスの場合には、サーバが利用できないとか、
 194 サーバが問い合わせを許可していない、などが考えられる。
 195 この場合のデフォルトのアクションは "continue" である。
 196 .TP
 197 \fBtryagain\fP
 198 サービスが一時的に利用できない。
 199 ファイルがロックされている、サーバがこれ以上接続を受け付けることができない、
 200 などが考えられる。デフォル トのアクションは "continue" である。
 201 .RE
 202 .LP
 203 \fIACTION\fP には以下のいずれかを指定できる。
 204 .RS 4
 205 .TP  12
 206 \fBreturn\fP
 207 結果をすぐに返す。 これ以上検索処理は呼び出されない。 ただし、互換性のため、 選択されたアクションが \fBgroup\fP データベースに対するもので、
 208 ステータスが \fBnotfound\fP であった場合で、 設定ファイルに \fBinitgroups\fP
 209 の行が含まれていない場合には、次の検索処理は常に呼び出される (検索結果への影響はない)。
 210 .TP
 211 \fBcontinue\fP
 212 次の検索処理を呼び出す。
 213 .RE
 214 .SS "互換モード (compat)"
 215 NSS "compat" サービスは "files" と似ているが、システムにアクセスできる
 216 ユーザーやネットグループ (netgroup) のメンバの指定に \fI/etc/passwd\fP で
 217 特別なエントリーを追加で使うことができる点が異なる。
 218 このモードでは、以下のエントリーを使うことができる。
 219 .RS 4
 220 .TP  12
 221 \fB+\fP\fIuser\fP
 222 NIS パスワードマップの指定された \fIuser\fP を含める。
 223 .TP
 224 \fB+@\fP\fInetgroup\fP
 225 指定された \fInetgroup\fP の全ユーザーを含める。
 226 .TP
 227 \fB\-\fP\fIuser\fP
 228 NIS パスワードマップの指定された \fIuser\fP を除外する。
 229 .TP
 230 \fB\-@\fP\fInetgroup\fP
 231 指定された \fInetgroup\fP の全ユーザーを除外する。
 232 .TP
 233 \fB+\fP
 234 NIS パスワードマップのユーザーのうち、
 235 それまでに除外されていない全てのユーザーを含める。
 236 .RE
 237 .LP
 238 デフォルトでは、データ源は "nis" だが、
 239 擬似データベース \fBpasswd_compat\fP, \fBgroup_compat\fP, \fBshadow_compat\fP
 240 ではデータ源として "nisplus" を指定することもできる。
 241 .SH ファイル
 242 \fISERVICE\fP という名前のサービスは \fIlibnss_SERVICE.so.\fP\fBX\fP という
 243 名前の共有オブジェクトライブラリで実装されている。
 244 これは \fI/lib\fP に置かれる。
 245 .RS 4
 246 .TP  25
 247 .PD 0
 248 \fI/etc/nsswitch.conf\fP
 249 NSS の設定ファイル。
 250 .TP
 251 \fI/lib/libnss_compat.so.\fP\fBX\fP
 252 "compat" ソースを実装したもの。
 253 .TP
 254 \fI/lib/libnss_db.so.\fP\fBX\fP
 255 "db" ソースを実装したもの。
 256 .TP
 257 \fI/lib/libnss_dns.so.\fP\fBX\fP
 258 "dns" ソースを実装したもの。
 259 .TP
 260 \fI/lib/libnss_files.so.\fP\fBX\fP
 261 "files" ソースを実装したもの。
 262 .TP
 263 \fI/lib/libnss_hesiod.so.\fP\fBX\fP
 264 "hesoid" ソースを実装したもの。
 265 .TP
 266 \fI/lib/libnss_nis.so.\fP\fBX\fP
 267 "nis" ソースを実装したもの。
 268 .TP
 269 \fI/lib/libnss_nisplus.so.\fP\fBX\fP
 270 "nisplus" ソースを実装したもの。
 271 .PD
 272 .RE
 273 .SH 注意
 274 \fInsswitch.conf\fP を利用するプロセスは、ファイルは一度しか読み込まない。
 275 その後で nsswitch.conf が書き換えられても、そのプロセスは古い設定のままで
 276 動作を継続する。
 277 .LP
 278 伝統的には、サービス情報の情報源は一つだけであり、
 279 その設定ファイルの形式も一つであった (例えば \fI/etc/passwd\fP)。
 280 一方で、 Network Information Service (NIS) や Domain Name Service
 281 (DNS) などの他の名前サービスが一般的になるに連れて、C ライブラリに埋め
 282 込まれた固定順序ではなく、検索順序を柔軟に指定する方法が必要になった。
 283 ネームサービススイッチ機構は、この問題に対するよりきれいな解決方法と
 284 なっている。ネームサービススイッチ機構は、 Sun Microsystems が
 285 Solaris 2 の C ライブラリで使った機構が基になっている。
 286 .SH 関連項目
 287 \fBgetent\fP(1), \fBnss\fP(5)
 288 .SH この文書について
 289 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 290 である。プロジェクトの説明とバグ報告に関する情報は
 291 http://www.kernel.org/doc/man\-pages/ に書かれている。