1 \section{\module{nis
} ---
2 Interface to Sun's NIS (Yellow Pages)
}
4 \declaremodule{extension
}{nis
}
6 \moduleauthor{Fred Gansevles
}{Fred.Gansevles@cs.utwente.nl
}
7 \sectionauthor{Moshe Zadka
}{moshez@zadka.site.co.il
}
8 \modulesynopsis{Interface to Sun's NIS (Yellow Pages) library.
}
10 The
\module{nis
} module gives a thin wrapper around the NIS library, useful
11 for central administration of several hosts.
13 Because NIS exists only on
\UNIX{} systems, this module is
14 only available for
\UNIX.
16 The
\module{nis
} module defines the following functions:
18 \begin{funcdesc
}{match
}{key, mapname
}
19 Return the match for
\var{key
} in map
\var{mapname
}, or raise an
20 error (
\exception{nis.error
}) if there is none.
21 Both should be strings,
\var{key
} is
8-bit clean.
22 Return value is an arbitrary array of bytes (may contain
\code{NULL
}
25 Note that
\var{mapname
} is first checked if it is an alias to another
29 \begin{funcdesc
}{cat
}{mapname
}
30 Return a dictionary mapping
\var{key
} to
\var{value
} such that
31 \code{match(
\var{key
},
\var{mapname
})==
\var{value
}}.
32 Note that both keys and values of the dictionary are arbitrary
35 Note that
\var{mapname
} is first checked if it is an alias to another
39 \begin{funcdesc
}{maps
}{}
40 Return a list of all valid maps.
44 The
\module{nis
} module defines the following exception:
46 \begin{excdesc
}{error
}
47 An error raised when a NIS function returns an error code.