2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
:mod:`nis` --- Interface to Sun's NIS (Yellow Pages)
|
|
|
|
====================================================
|
|
|
|
|
|
|
|
.. module:: nis
|
|
|
|
:platform: Unix
|
|
|
|
:synopsis: Interface to Sun's NIS (Yellow Pages) library.
|
2022-03-21 20:16:37 -03:00
|
|
|
:deprecated:
|
2016-06-11 16:02:54 -03:00
|
|
|
|
2007-08-15 11:28:22 -03:00
|
|
|
.. moduleauthor:: Fred Gansevles <Fred.Gansevles@cs.utwente.nl>
|
|
|
|
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
|
|
|
|
|
2022-05-20 18:47:51 -03:00
|
|
|
.. deprecated-removed:: 3.11 3.13
|
2022-05-13 16:54:12 -03:00
|
|
|
The :mod:`nis` module is deprecated
|
|
|
|
(see :pep:`PEP 594 <594#nis>` for details).
|
2022-03-21 20:16:37 -03:00
|
|
|
|
2016-06-11 16:02:54 -03:00
|
|
|
--------------
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
The :mod:`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.
|
|
|
|
|
2022-08-02 16:00:41 -03:00
|
|
|
.. include:: ../includes/wasm-notavail.rst
|
|
|
|
|
2007-08-15 11:28:22 -03:00
|
|
|
The :mod:`nis` module defines the following functions:
|
|
|
|
|
|
|
|
|
2012-05-21 06:01:54 -03:00
|
|
|
.. function:: match(key, mapname, domain=default_domain)
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
Return the match for *key* in map *mapname*, or raise an error
|
|
|
|
(:exc:`nis.error`) if there is none. Both should be strings, *key* is 8-bit
|
|
|
|
clean. Return value is an arbitrary array of bytes (may contain ``NULL`` and
|
|
|
|
other joys).
|
|
|
|
|
|
|
|
Note that *mapname* is first checked if it is an alias to another name.
|
|
|
|
|
2016-02-10 01:44:01 -04:00
|
|
|
The *domain* argument allows overriding the NIS domain used for the lookup. If
|
2007-09-01 10:51:09 -03:00
|
|
|
unspecified, lookup is in the default NIS domain.
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
|
2012-05-21 06:01:54 -03:00
|
|
|
.. function:: cat(mapname, domain=default_domain)
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
Return a dictionary mapping *key* to *value* such that ``match(key,
|
|
|
|
mapname)==value``. Note that both keys and values of the dictionary are
|
|
|
|
arbitrary arrays of bytes.
|
|
|
|
|
|
|
|
Note that *mapname* is first checked if it is an alias to another name.
|
|
|
|
|
2016-02-10 01:44:01 -04:00
|
|
|
The *domain* argument allows overriding the NIS domain used for the lookup. If
|
2007-09-01 10:51:09 -03:00
|
|
|
unspecified, lookup is in the default NIS domain.
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
|
2012-05-21 06:01:54 -03:00
|
|
|
.. function:: maps(domain=default_domain)
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
Return a list of all valid maps.
|
|
|
|
|
2016-02-10 01:44:01 -04:00
|
|
|
The *domain* argument allows overriding the NIS domain used for the lookup. If
|
2007-09-01 10:51:09 -03:00
|
|
|
unspecified, lookup is in the default NIS domain.
|
2007-08-15 11:28:22 -03:00
|
|
|
|
|
|
|
|
|
|
|
.. function:: get_default_domain()
|
|
|
|
|
|
|
|
Return the system default NIS domain.
|
|
|
|
|
|
|
|
|
|
|
|
The :mod:`nis` module defines the following exception:
|
|
|
|
|
|
|
|
.. exception:: error
|
|
|
|
|
|
|
|
An error raised when a NIS function returns an error code.
|
|
|
|
|