Provided by: manpages-fr-dev_3.17.1-1_all bug

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);

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 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 setservent() 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.17  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                     GETRPCENT(3)