"nis" --- Sun NIS (Yellow Pages) 介面
*************************************

Deprecated since version 3.11, will be removed in version 3.13: "nis"
模組 (module) 即將被棄用（詳見 **PEP 594**）。

======================================================================

The "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.

Availability: not Emscripten, not WASI.

此模組在 WebAssembly 平台 "wasm32-emscripten" 和 "wasm32-wasi" 上無法
作用或無法使用。有關更多資訊，請參閱 WebAssembly 平台。

The "nis" module defines the following functions:

nis.match(key, mapname, domain=default_domain)

   Return the match for *key* in map *mapname*, or raise an error
   ("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.

   The *domain* argument allows overriding the NIS domain used for the
   lookup. If unspecified, lookup is in the default NIS domain.

nis.cat(mapname, domain=default_domain)

   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.

   The *domain* argument allows overriding the NIS domain used for the
   lookup. If unspecified, lookup is in the default NIS domain.

nis.maps(domain=default_domain)

   Return a list of all valid maps.

   The *domain* argument allows overriding the NIS domain used for the
   lookup. If unspecified, lookup is in the default NIS domain.

nis.get_default_domain()

   Return the system default NIS domain.

The "nis" module defines the following exception:

exception nis.error

   An error raised when a NIS function returns an error code.
