35.12. "nis" --- Interface para NIS da Sun (Yellow Pages)
*********************************************************

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

O módulo "nis" fornece um invólucro fino em torno da biblioteca NIS,
útil para administração central de vários hosts.

Como o NIS existe apenas em sistemas Unix, este módulo está disponível
apenas para Unix.

O módulo "nis" define as seguintes funções:

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

   Retorna a correspondência para *key* no mapa *mapname* ou levanta
   um erro ("nis.error") se não houver nenhum. Ambos devem ser
   strings, *key* está limpo em 8 bits. O valor de retorno é uma
   matriz arbitrária de bytes (pode conter "NULL" e outras alegrias).

   Observe que *mapname* é verificado primeiro se for um alias para
   outro nome.

   O argumento *domain* permite substituir o domínio NIS usado para a
   pesquisa. Se não especificado, a pesquisa está no domínio NIS
   padrão.

nis.cat(mapname, domain=default_domain)

   Retorna um mapeamento de dicionário de *key* para *value* de modo
   que "match(key, mapname)==value". Observe que as chaves e os
   valores do dicionário são matrizes arbitrárias de bytes.

   Observe que *mapname* é verificado primeiro se for um alias para
   outro nome.

   O argumento *domain* permite substituir o domínio NIS usado para a
   pesquisa. Se não especificado, a pesquisa está no domínio NIS
   padrão.

nis.maps(domain=default_domain)

   Retorna uma lista de todos os mapas válidos.

   O argumento *domain* permite substituir o domínio NIS usado para a
   pesquisa. Se não especificado, a pesquisa está no domínio NIS
   padrão.

nis.get_default_domain()

   Retorna o domínio NIS padrão do sistema.

O módulo "nis" define a exceção padrão:

exception nis.error

   Um erro levantado quando uma função NIS retorna um códio de erro.
