Sous-routine yp_bind

Objectif

Utilisé dans les programmes pour appeler le démon Ypbind directement pour les processus qui utilisent des stratégies de sauvegarde lorsque Services d'information de réseau (NIS) n'est pas disponible.

Bibliothèque

Bibliothèque C (libc.a)

Syntaxe

#include <rpcsvc/ypclnt.h>
#include <rpcsvc/yp_prot.h>

yp_bind ( indomain) char *indomain;

Descriptif

Pour utiliser NIS, le processus client doit être lié à un serveur NIS qui sert le domaine approprié. C'est-à-dire que le client doit être associé à un serveur NIS spécifique qui fournit des informations sur les demandes du client pour les informations NIS . Les processus de recherche NIS utilisent automatiquement le démon Ypbind pour lier le client, mais le sous-programme Li_de_commande peut être utilisé dans les programmes pour appeler le démon directement pour les processus utilisant des stratégies de sauvegarde (par exemple, un fichier local) lorsque NIS n'est pas disponible.

Chaque liaison NIS alloue, ou utilise un descripteur de socket de processus client, et chaque domaine lié utilise un descripteur de socket. Plusieurs demandes adressées au même domaine utilisent le même descripteur.

Remarque: Si un statut d'échec RPC (Remote Procedure Call) renvoie de l'utilisation de la sous-routine Li_de_commande , le domaine n'est pas lié automatiquement. Lorsque cela se produit, le client NIS tente de terminer l'opération si le démon Ypbind est en cours d'exécution et que l'une des opérations suivantes est vraie:

Le processus client ne peut pas lier un serveur pour le domaine approprié.
Les RCP sur le serveur échouent.

Paramètres

Article	Descriptif
Indomain	Pointe vers le nom du domaine pour lequel la tentative de liaison est effectuée.

Valeurs renvoyées

Le client NIS renvoie le contrôle à l'utilisateur avec une erreur ou un code de réussite si l'une des suivantes se produit:

L'erreur n'est pas liée au RPC.
Le démon Ypbind n'est pas en cours d'exécution.
Le démon Ypserv renvoie la réponse.