getrpcent, getrpcbynom, getrpcbynombre − Récupèrer une entrée RPC.

#include <netdb.h>

struct rpcent *getrpcent()

struct rpcent *getrpcbynom(nom)
char *nom;

struct rpcent *getrpcbynombre(nombre)
int nombre;

setrpcent (stayopen)
int stayopen;

endrpcent ()

getrpcent(), getrpcbynom(), et getrpcbynombre() retournent chacune un pointeuur sur un objet ayant la structure suivante et contenant les champs d’une ligne de la base de données des programmes RPC /etc/rpc.

struct

rpcent {

char

*r_nom;

/* nom du serveur pour ce programme RPC */

char

**r_aliases;

/* liste d’alias */

long

r_nombre;

/* numéro de programme RPC */

};

Les membres de cette structure sont:

r_nom

Le nom du serveur pour ce programme RPC.

r_aliases

Une liste d’alias (noms alternatifs pour le programme RPC) terminé par un zéro.

r_nombre

Le numéro de programme RPC pour ce service.

getrpcent() lit la ligne suivante du fichier, l’ouvrait si nécessaire.

getrpcent() ouvre le fichier. Si le drapeau stayopen n’est pas zéro, la base de données du réseau ne sera pas fermée après chaque appel à getrpcent() (soit directement, ou indirectement par l’un des autres appels “getrpc”).

endrpcent ferme le fichier.

getrpcbynom() et getrpcbynombre() recherchent séquentiellement depuis le début du fichier jusqu’à ce qu’un nom ou un numéro de programme RPC faisant l’affaire est trouvé ou jusqu’à la fin du fichier.

/etc/rpc

rpc(5), rpcinfo(8C), ypserv(8)

Un pointeur NULL est retourné à la fin du fichier (EOF) ou en cas d’erreur.

Toutes les informations sont stockées dans une zone statique et doivent donc être copiées si elles n’ont pas été sauvées.

Thierry Vignaud <tvignaud@mandrakesoft.com>, 1999