This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

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

Obsoleto desde la versión 3.11: The `nis` module is deprecated (see PEP 594 for details).

El modulo `nis` da una envoltura alrededor de la biblioteca NIS, útil para la administración central de varios hosts.

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

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 retorna un error (`nis.error`) si es none. Ambas deben ser cadenas, key es 8 bits limpios. El valor de retorno es un array arbitrario de bytes (puede contener `NULL` y otros placeres).

  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 por defecto 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.