draft/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 .TH NSSWITCH.CONF 5 2013\-02\-12 Linux "Linux Programmer's Manual"
  31 .SH 名前
  32 nsswitch.conf \- ネームサービススイッチの設定ファイル
  33 .SH 説明
  34 ネームサービススイッチ (Name Service Switch; NSS) の設定ファイル
  35 \fI/etc/nsswitch.conf\fP は、 GNU C ライブラリが
  36 いろいろなカテゴリの名前サービス情報を、どの情報源から
  37 どの順序で取得するかを判断するのに使用される
  38 (情報の各カテゴリはデータベース名で識別される)。
  39 .LP
  40 設定ファイルは通常の ASCII テキストで、列はスペースかタブ文字で
  41 区切られる。最初の列はデータベース名を示す。
  42 残りの列は、情報を問い合わせる情報源の順序と、
  43 検索結果に対して実行するアクションを規定する。
  44 .LP
  45 GNU C ライブラリでは以下のデータベースを扱うことができる。
  46 .TP  12
  47 \fBaliases\fP
  48 メールのエイリアス。 \fBgetaliasent\fP(3) や関連する関数が使用する。
  49 .TP
  50 \fBethers\fP
  51 イーサーネット番号。
  52 .TP
  53 \fBgroup\fP
  54 ユーザーのグループ。 \fBgetgrent\fP(3) や関連する関数が使用する。
  55 .TP
  56 \fBhosts\fP
  57 ホスト名とホスト番号。 \fBgethostbyname\fP(3) や関連する関数が使用する。
  58 .TP
  59 \fBinitgroups\fP
  60 補助グループアクセスリスト。 \fBgetgrouplist\fP(3) 関数が使用する。
  61 .TP
  62 \fBnetgroup\fP
  63 ネットワークワイドに用いられるホストやユーザーのリスト。アクセス制限に利用
  64 される。 glibc 2.1 より前の C ライブラリは、 NIS による netgroup のみを
  65 サポートしていた。
  66 .TP
  67 \fBnetworks\fP
  68 ネットワーク名と番号。 \fBgetnetent\fP(3) と関連する関数が使用する。
  69 .TP
  70 \fBpasswd\fP
  71 ユーザーパスワード。 \fBgetpwent\fP(3) や関連する関数が使用する。
  72 .TP
  73 \fBprotocols\fP
  74 ネットワークプロトコル。 \fBgetprotoent\fP(3) や関連する関数が使用する。
  75 .TP
  76 \fBpublickey\fP
  77 NIS+ と NFS によって用いられる secure_rpc の公開鍵と秘密鍵。
  78 .TP
  79 \fBrpc\fP
  80 リモート手続き呼び出し (remote procedure call) の名前と番号。
  81 \fBgetrpcbyname\fP(3) と関連する関数が使用する。
  82 .TP
  83 \fBservices\fP
  84 ネットワークサービス。 \fBgetservent\fP(3) や関連する関数が使用する。
  85 .TP
  86 \fBshadow\fP
  87 シャドウユーザーパスワード。 \fBgetspnam\fP(3) や関連する関数が使用する。
  88 .LP
  89 以下は \fI/etc/nsswitch.conf\fP ファイルの例である。
  90 .LP
  91 .RS 4
  92 .PD 0
  93 .TP  16
  94 passwd:
  95 compat
  96 .TP
  97 group:
  98 compat
  99 .TP
 100 shadow:
 101 compat
 102 .sp 1n
 103 .TP
 104 hosts:
 105 dns [!UNAVAIL=return] files
 106 .TP
 107 networks:
 108 nis [NOTFOUND=return] files
 109 .TP
 110 ethers:
 111 nis [NOTFOUND=return] files
 112 .TP
 113 protocols:
 114 nis [NOTFOUND=return] files
 115 .TP
 116 rpc:
 117 nis [NOTFOUND=return] files
 118 .TP
 119 services:
 120 nis [NOTFOUND=return] files
 121 .PD
 122 .RE
 123 .LP
 124 最初の列はデータベース名である。
 125 残りの列で以下を指定する。
 126 .IP * 3
 127 1 個以上のサービス指定 (例: "files", "db", "nis")。この行に記載された
 128 サービスの順序で、結果が得られるまで、指定されたサービスに対する
 129 問い合わせが順番に行われる。
 130 .IP *
 131 特定の結果が直前のサービスで得られた場合に実行されるアクション
 132 (例: "[NOTFOUND=return]")。アクションは省略可能である。
 133 .LP
 134 利用しているシステムでどのサービス指定が利用できるかは、共有ライブラリ
 135 があるかどうかに依存しており、そのためサービス指定は拡張できるように
 136 なっている。\fI/lib/libnss_SERVICE.so.\fP\fBX\fP という名前のライブラリが
 137 \fISERVICE\fP という名前のサービスを提供する。標準のインストールを行った
 138 場合、"files", "db", "nis", "nisplus" が利用できる。
 139 データベース \fBhosts\fP の場合には、追加で "dns" も指定できる。
 140 データベース \fBpasswd\fP, \fBgroup\fP, \fBshadow\fP の場合には、追加で
 141 "compat" (下記の \fB互換モード\fP を参照)。バージョン番号 \fBX\fP は、
 142 glibc 2.0 の場合は 1、glibc 2.1 の場合は 2 で、それ以降も同様である。
 143 追加のライブラリがインストールされているシステムでは、"hesiod",
 144 "ldap", "winbind", "wins" などの追加のサービスが利用できる。
 145 .LP
 146 サービス指定の次にアクションを指定することもできる。アクションを
 147 使うと、直前のデータ源から結果が得られた後の動作を変更できる。
 148 アクション指定は、一般的には以下の形式となる。
 149 .LP
 150 .RS 4
 151 [\fISTATUS\fP=\fIACTION\fP]
 152 .br
 153 [!\fISTATUS\fP=\fIACTION\fP]
 154 .RE
 155 .LP
 156 STATUS と ACTION はそれぞれ以下の値を取る。
 157 .LP
 158 .RS 4
 159 \fISTATUS\fP => \fBsuccess\fP | \fBnotfound\fP | \fBunavail\fP | \fBtryagain\fP
 160 .br
 161 \fIACTION\fP => \fBreturn\fP | \fBcontinue\fP
 162 .RE
 163 .LP
 164 ! はテスト結果を反転させる。
 165 つまり、指定された以外の全ての結果にマッチする。
 166 キーワードの大文字、小文字は無視される。
 167 .LP
 168 \fISTATUS\fP は、直前のサービス指定で呼び出しされた検索処理の結果に
 169 対して照合が行われる。 \fISTATUS\fP には以下のいずれかを指定できる。
 170 .RS 4
 171 .TP  12
 172 \fBsuccess\fP
 173 エラーは発生せず、要求されたエントリが返された。
 174 この場合のデフォルトのアクションは "return" である。
 175 .TP
 176 \fBnotfound\fP
 177 検索は成功したが、要求されたエントリが見つからなかった。
 178 この場合のデフォルトのアクションは "continue" である。
 179 .TP
 180 \fBunavail\fP
 181 サービスが永続的に利用できない。
 182 必要なファイルを読み込むことができない、
 183 ネットワークサービスの場合には、サーバが利用できないとか、
 184 サーバが問い合わせを許可していない、などが考えられる。
 185 この場合のデフォルトのアクションは "continue" である。
 186 .TP
 187 \fBtryagain\fP
 188 サービスが一時的に利用できない。
 189 ファイルがロックされている、サーバがこれ以上接続を受け付けることができない、
 190 などが考えられる。デフォル トのアクションは "continue" である。
 191 .RE
 192 .LP
 193 \fIACTION\fP には以下のいずれかを指定できる。
 194 .RS 4
 195 .TP  12
 196 \fBreturn\fP
 197 結果をすぐに返す。 これ以上検索処理は呼び出されない。 ただし、互換性のため、 選択されたアクションが \fBgroup\fP データベースに対するもので、
 198 ステータスが \fBnotfound\fP であった場合で、 設定ファイルに \fBinitgroups\fP
 199 の行が含まれていない場合には、次の検索処理は常に呼び出される (検索結果への影響はない)。
 200 .TP
 201 \fBcontinue\fP
 202 次の検索処理を呼び出す。
 203 .RE
 204 .SS "互換モード (compat)"
 205 NSS "compat" サービスは "files" と似ているが、システムにアクセスできる
 206 ユーザやネットグループ (netgroup) のメンバの指定に \fI/etc/passwd\fP で
 207 特別なエントリを追加で使うことができる点が異なる。
 208 このモードでは、以下のエントリを使うことができる。
 209 .RS 4
 210 .TP  12
 211 \fB+\fP\fIuser\fP
 212 NIS パスワードマップの指定された \fIuser\fP を含める。
 213 .TP
 214 \fB+@\fP\fInetgroup\fP
 215 指定された \fInetgroup\fP の全ユーザを含める。
 216 .TP
 217 \fB\-\fP\fIuser\fP
 218 NIS パスワードマップの指定された \fIuser\fP を除外する。
 219 .TP
 220 \fB\-@\fP\fInetgroup\fP
 221 指定された \fInetgroup\fP の全ユーザを除外する。
 222 .TP
 223 \fB+\fP
 224 NIS パスワードマップのユーザのうち、
 225 それまでに除外されていない全てのユーザを含める。
 226 .RE
 227 .LP
 228 デフォルトでは、データ源は "nis" だが、
 229 擬似データベース \fBpasswd_compat\fP, \fBgroup_compat\fP, \fBshadow_compat\fP
 230 ではデータ源として "nisplus" を指定することもできる。
 231 .SH ファイル
 232 \fISERVICE\fP という名前のサービスは \fIlibnss_SERVICE.so.\fP\fBX\fP という
 233 名前の共有オブジェクトライブラリで実装されている。
 234 これは \fI/lib\fP に置かれる。
 235 .RS 4
 236 .TP  25
 237 .PD 0
 238 \fI/etc/nsswitch.conf\fP
 239 NSS の設定ファイル。
 240 .TP
 241 \fI/lib/libnss_compat.so.\fP\fBX\fP
 242 "compat" ソースを実装したもの。
 243 .TP
 244 \fI/lib/libnss_db.so.\fP\fBX\fP
 245 "db" ソースを実装したもの。
 246 .TP
 247 \fI/lib/libnss_dns.so.\fP\fBX\fP
 248 "dns" ソースを実装したもの。
 249 .TP
 250 \fI/lib/libnss_files.so.\fP\fBX\fP
 251 "files" ソースを実装したもの。
 252 .TP
 253 \fI/lib/libnss_hesiod.so.\fP\fBX\fP
 254 "hesoid" ソースを実装したもの。
 255 .TP
 256 \fI/lib/libnss_nis.so.\fP\fBX\fP
 257 "nis" ソースを実装したもの。
 258 .TP
 259 \fI/lib/libnss_nisplus.so.\fP\fBX\fP
 260 "nisplus" ソースを実装したもの。
 261 .PD
 262 .RE
 263 .SH 注意
 264 \fInsswitch.conf\fP を利用するプロセスは、ファイルは一度しか読み込まない。
 265 その後で nsswitch.conf が書き換えられても、そのプロセスは古い設定のままで
 266 動作を継続する。
 267 .LP
 268 伝統的には、サービス情報の情報源は一つだけであり、
 269 その設定ファイルの形式も一つであった (例えば \fI/etc/passwd\fP)。
 270 一方で、 Network Information Service (NIS) や Domain Name Service
 271 (DNS) などの他の名前サービスが一般的になるに連れて、C ライブラリに埋め
 272 込まれた固定順序ではなく、検索順序を柔軟に指定する方法が必要になった。
 273 ネームサービススイッチ機構は、この問題に対するよりきれいな解決方法と
 274 なっている。ネームサービススイッチ機構は、 Sun Microsystems が
 275 Solaris 2 の C ライブラリで使った機構が基になっている。
 276 .SH 関連項目
 277 \fBgetent\fP(1), \fBnss\fP(5)
 278 .SH この文書について
 279 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 280 である。プロジェクトの説明とバグ報告に関する情報は
 281 http://www.kernel.org/doc/man\-pages/ に書かれている。