GETRPCENT

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 23 décembre 2007
Index Menu principal  

NOM

getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - Lire une entrée RPC  

SYNOPSIS

#include <netdb.h>

struct rpcent *getrpcent(void);

struct rpcent *getrpcbyname(char *nom);

struct rpcent *getrpcbynumber(int nombre);

void setrpcent(int stayopen);

void endrpcent(void);
 

DESCRIPTION

getrpcent(), getrpcbyname() et getrpcbynumber() renvoient chacune un pointeur sur un objet ayant la structure suivante et contenant les champs d'une entrée de la base de données /etc/rpc des programmes RPC.


struct rpcent {
    char  *r_name;     /* nom du serveur pour ce programme RPC */
    char **r_aliases;  /* liste d'alias */
    long   r_number;   /* numéro de programme RPC */
};

Les membres de cette structure sont :

r_name
Le nom du serveur pour ce programme RPC.
r_aliases
Une liste d'alias (alias pour le programme RPC) terminée par un zéro.
r_number
Le numéro de programme RPC pour ce service.

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

setrpcent() ouvre le fichier et se place au début. Si le drapeau stayopen est n'est pas nul, la base de données restera ouverte entre les appels getrpcent() (directs, ou indirects par l'un des autres appels « getrpc »).

endrpcent() ferme le fichier.

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

VALEUR RENVOYÉE

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

FICHIERS

/etc/rpc  

CONFORMITÉ

Absente de POSIX.1-2001. Présente sur les systèmes BSD, Solaris et beaucoup d'autres.  

BOGUES

Toutes les informations sont stockées dans une zone statique et doivent donc être copiées si on désire les conserver.  

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 1999 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getrpcent ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
FICHIERS
CONFORMITÉ
BOGUES
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 17 juillet 2008