# 36.14. `nis` — Interface à Sun’s NIS (pages jaunes)

Le module `nis` est une simple abstraction de la librairie NIS, utile pour l’administration centralisée de plusieurs hôtes.

Du fait que NIS existe seulement sur les systèmes Unix, ce module est seulement disponible pour Unix.

Le module `nis` définit les instructions suivantes :

`nis.``match`(key, mapname[, domain=default_domain])

  Renvoie la valeur correspondante à key dans carte mapname, ou lève une erreur (`nis.error`) s’il n’y en a pas. Toutes les deux doivent être des chaînes, key doit être une chaîne ASCII. La valeur renvoyée est un dictionnaire arbitraire d’octets (pourrait contenir `NULL` et autres joyeusetés).

  Notez que mapname est vérifié la première fois si c’est un alias d’un autre nom.

  Modifié dans la version 2.5: L’argument domain permet de passer outre le domaine NIS utilisé pour les recherches. Lorsqu’il n’est pas spécifié, recherche est dans le domaine NIS défaut.

`nis.``cat`(mapname[, domain=default_domain])

  Renvoie un dictionnaire qui associe key à value tel que `match(key, mapname)==value`. Notez que les clés comme les valeurs peuvent contenir des séquences arbitraires d’octets.

  Notez que mapname est vérifié la première fois si c’est un alias d’un autre nom.

  Modifié dans la version 2.5: L’argument domain permet de passer outre le domaine NIS utilisé pour les recherches. Lorsqu’il n’est pas spécifié, recherche est dans le domaine NIS défaut.

`nis.``maps`([domain=default_domain])

  Renvoie la liste de toutes les correspondances valides.

  Modifié dans la version 2.5: L’argument domain permet de passer outre le domaine NIS utilisé pour les recherches. Lorsqu’il n’est pas spécifié, recherche est dans le domaine NIS défaut.

`nis.``get_default_domain`()

  Renvoie le domaine NIS par défaut du système.

  Nouveau dans la version 2.5.

Le module `nis` définit les exceptions suivantes :

exception `nis.``error`

  Une erreur apparaît quand une fonction NIS renvoie un code d’erreur.