source: trunk/essentials/dev-lang/python/Doc/lib/libnis.tex@ 3951

\section{\module{nis} ---
         Interface to Sun's NIS (Yellow Pages)}

\declaremodule{extension}{nis}
  \platform{UNIX}
\moduleauthor{Fred Gansevles}{[email protected]}
\sectionauthor{Moshe Zadka}{[email protected]}
\modulesynopsis{Interface to Sun's NIS (Yellow Pages) library.}

The \module{nis} module gives a thin wrapper around the NIS library, useful
for central administration of several hosts.

Because NIS exists only on \UNIX{} systems, this module is
only available for \UNIX.

The \module{nis} module defines the following functions:

\begin{funcdesc}{match}{key, mapname[, domain=default_domain]}
Return the match for \var{key} in map \var{mapname}, or raise an
error (\exception{nis.error}) if there is none.
Both should be strings, \var{key} is 8-bit clean.
Return value is an arbitrary array of bytes (may contain \code{NULL}
and other joys).

Note that \var{mapname} is first checked if it is an alias to another
name.

\versionchanged[The \var{domain} argument allows to override
the NIS domain used for the lookup. If unspecified, lookup is in the
default NIS domain]{2.5}
\end{funcdesc}

\begin{funcdesc}{cat}{mapname[, domain=default_domain]}
Return a dictionary mapping \var{key} to \var{value} such that
\code{match(\var{key}, \var{mapname})==\var{value}}.
Note that both keys and values of the dictionary are arbitrary
arrays of bytes.

Note that \var{mapname} is first checked if it is an alias to another
name.

\versionchanged[The \var{domain} argument allows to override
the NIS domain used for the lookup. If unspecified, lookup is in the
default NIS domain]{2.5}