# `nis` — Interfaz a Sun’s NIS (Páginas amarillas)

Obsoleto desde la versión 3.11, se eliminará en la versión 3.13: El módulo `nis` está obsoleto (consulte PEP 594 para obtener más información).

El módulo `nis` proporciona un envoltorio ligero para la biblioteca NIS, que resulta útil para la administración centralizada de varios hosts.

Debido a que NIS sólo existe en sistemas Unix, este módulo sólo está disponible para Unix.

Availability: not Emscripten, not WASI.

Este módulo no funciona o no está disponible en las plataformas WebAssembly `wasm32-emscripten` y `wasm32-wasi`. Consulte Plataformas WebAssembly para obtener más información.

El módulo `nis` define las siguientes funciones:

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

  Retorna la coincidencia para key en el mapa mapname, o genera un error (`nis.error`) si es none. Ambas deben ser cadenas, key es de 8 bits limpios. El valor de retorno es un array arbitrario de bytes (puede contener `NULL` y otras sutilezas).

  Tenga en cuenta que mapname se comprueba primero si es un alias de otro nombre.

  El argumento domain permite anular el dominio NIS utilizado para la búsqueda. Si no se especifica, la búsqueda se realiza en el dominio NIS por defecto.

nis.cat(mapname, domain=default_domain)

  Retorna un diccionario de mapeo de key a value de tal manera que `match(key, mapname)==value`. Tenga en cuenta que tanto las claves como los valores del diccionario son arreglos arbitrarios de bytes.

  Tenga en cuenta que mapname se comprueba primero si es un alias de otro nombre.

  El argumento domain permite anular el dominio NIS utilizado para la búsqueda. Si no se especifica, la búsqueda se realiza en el dominio NIS por defecto.

nis.maps(domain=default_domain)

  Retorna una lista de todos los mapas válidos.

  El argumento domain permite anular el dominio NIS utilizado para la búsqueda. Si no se especifica, la búsqueda se realiza en el dominio NIS por defecto.

nis.get_default_domain()

  Retorna el dominio NIS predeterminado del sistema.

El módulo `nis` define la siguiente excepción:

exception nis.error

  Un error que se produce cuando una función NIS retorna un código de error.