cpython/Doc/lib/libnis.tex

47 lines
1.5 KiB
TeX
Raw Normal View History

1999-06-27 12:01:08 -03:00
\section{\module{nis} ---
1999-07-06 12:43:55 -03:00
Interface to Sun's NIS (Yellow Pages)}
1999-06-27 12:01:08 -03:00
\declaremodule{extension}{nis}
\platform{UNIX}
\moduleauthor{Fred Gansevles}{Fred.Gansevles@cs.utwente.nl}
\sectionauthor{Moshe Zadka}{mzadka@geocities.com}
\modulesynopsis{Interface to Sun's NIS (a.k.a. Yellow Pages) library.}
1999-06-27 12:01:08 -03:00
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}
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 (i.e., may contain \code{NULL}
1999-06-27 12:01:08 -03:00
and other joys).
Note that \var{mapname} is first checked if it is an alias to another name.
\end{funcdesc}
\begin{funcdesc}{cat}{mapname}
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
1999-06-27 12:01:08 -03:00
arrays of bytes.
Note that \var{mapname} is first checked if it is an alias to another name.
\end{funcdesc}
\begin{funcdesc}{maps}{}
Return a list of all valid maps.
\end{funcdesc}
The \module{nis} module defines the following exception:
\begin{excdesc}{error}
An error raised when a NIS function returns an error code.
\end{excdesc}