nis —- Sun 的 NIS (黄页) 接口

从版本 3.11 开始标记为过时,将在版本 3.13 中移除。: nis 模块已被弃用(请参阅 PEP 594 了解详情)。


nis 模块提供了对 NIS 库的轻量级包装,适用于多个主机的集中管理。

因为 NIS 仅存在于 Unix 系统,此模块仅在 Unix 上可用。

Availability: not Emscripten, not WASI.

This module does not work or is not available on WebAssembly platforms wasm32-emscripten and wasm32-wasi. See WebAssembly platforms for more information.

nis 模块定义了以下函数:

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

返回 key 在映射 mapname 中的匹配结果,如无结果则会引发错误 (nis.error)。 两个参数都应为字符串,key 定长 8 个比特。 返回值为任意字节数组(可包含 NULL 和其他特殊值)。

请注意如果 mapname 是另一名称的别名则会先检查别名。

domain 参数可允许重载用于查找的 NIS 域。 如果未指定,则会在默认 NIS 域中查找。

nis.cat(mapname, domain=default_domain)

返回一个字典,其元素为 keyvalue 的映射使得 match(key, mapname)==value。 请注意字典的键和值均为任意字节数组。

请注意如果 mapname 是另一名称的别名则会先检查别名。

domain 参数可允许重载用于查找的 NIS 域。 如果未指定,则会在默认 NIS 域中查找。

nis.maps(domain=default_domain)

返回全部可用映射的列表。

domain 参数可允许重载用于查找的 NIS 域。 如果未指定,则会在默认 NIS 域中查找。

nis.get_default_domain()

返回系统默认的 NIS 域。

nis 模块定义了以下异常:

exception nis.error

当 NIS 函数返回一个错误码时引发的异常。