NOM
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - Lire
une entrée RPC.
SYNOPSIS
#include <netdb.h>
struct rpcent *getrpcent(void);
struct rpcent *getrpcbyname(char *name);
struct rpcent *getrpcbynumber(int number);
void setrpcent(int stayopen);
void endrpcent(void);
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 d’un programme 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 The name of the server for this RPC program.
r_aliases Une liste, terminée par NULL, d’alternatives pour le
programme RPC.
r_number Le numéro de programme RPC pour ce service.
getrpcent() lit l’entrée suivante de la base. Une connexion est créée
si nécessaire.
La fonction setrpcent() ouvre une connexion à une base de données et
définit l’entrée suivante avec la première entrée. Si stayopen est non
nul, alors la connexion à la base n’est pas fermée entre deux appels
aux fonctions getrpc*().
endrpcent() ferme la connexion à la base..
getrpcbyname() et getrpcbynumber() recherchent séquentiellement depuis
le début du fichier un nom ou un numéro de programme RPC correspondant
jusqu’à la fin du fichier.
VALEUR RENVOYÉE
En cas de succès, getrpcent(), getrpcbyname() et getrpcbynumber()
renvoient un pointeur vers une structure statiquement allouée rpcent.
Un pointeur NULL est renvoyé si une erreur se produit ou si la fin de
fichier est atteinte.
FICHIERS
/etc/rpc
Base de données des numéros de programme RPC.
CONFORMITÉ
Absent de POSIX.1-2001. Présent 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
getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite par Thierry Vignaud <tvignaud AT
mandriva DOT com> en 2002, puis a été mise à jour par Alain Portal
<aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à disposition
sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
19 août 2008