\section{\module{nis} ---
         Sun の NIS (Yellow Pages) へのインタフェース}

\declaremodule{extension}{nis}
  \platform{UNIX}
\moduleauthor{Fred Gansevles}{Fred.Gansevles@cs.utwente.nl}
\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
\modulesynopsis{Sun の NIS (Yellow Pages) ライブラリへのインタフェース。}

\module{nis} モジュールは複数のホストを集中管理する上で便利な NIS 
ライブラリを薄くラップします。

NIS は \UNIX{} システム上にしかないので、このモジュールは
\UNIX でしか利用できません。

\module{nis} モジュールでは以下の関数を定義しています:

\begin{funcdesc}{match}{key, mapname\optional{, domain=default_domain}}
\var{mapname} 中で \var{key} に一致するものを返すか、見つからない
場合にはエラー (\exception{nis.error}) を送出します。
両方の引数とも文字列で、 \var{key} は 8 ビットクリーンです。
返される値は (\code{NULL} その他を含む可能性のある) 任意のバイト列
です。

\var{mapname} は他の名前の別名になっていないか最初にチェックされます。

\versionchanged[ \var{domain} 引数で参照するNISドメインをオーバーライ
  ドできます。設定されない場合にはデフォルトのNISドメインを参照します。]{2.5}
\end{funcdesc}

\begin{funcdesc}{cat}{mapname\optional{, domain=default_domain}}
\code{match(\var{key}, \var{mapname})==\var{value}} となる 
\var{key} を \var{value} に対応付ける辞書を返します。
辞書内のキーと値は共に任意のバイト列なので注意してください。

\var{mapname} は他の名前の別名になっていないか最初にチェックされます。

\versionchanged[ \var{domain} 引数で参照するNISドメインをオーバーライ
  ドできます。設定されない場合にはデフォルトのNISドメインを参照します。]{2.5}
\end{funcdesc}

\begin{funcdesc}{maps}{}
有効なマップのリストを返します。
\end{funcdesc}

\begin{funcdesc}{get_default_domain}{}
システムのデフォルトNISドメインをかえします。 \versionadded{2.5}
\end{funcdesc}
\module{nis} モジュールは以下の例外を定義しています:

\begin{excdesc}{error}
NIS 関数がエラーコードを返した場合に送出されます。
\end{excdesc}


