GETPROTOENT(3)     Manuel du programmeur Linux     GETPROTOENT(3)


NOM
       getprotoent,   getprotobyname,  getprotobynumber,  setpro­
       toent, endprotoent - Accéder aux protocoles.

SYNOPSIS
       #include <netdb.h>

       struct protoent *getprotoent (void);

       struct protoent *getprotobyname (const char *name);

       struct protoent *getprotobynumber (int proto);

       void setprotoent (int stayopen);

       void endprotoent (void);

DESCRIPTION
       La fonction getprotoent() lit la ligne suivante du fichier
       /etc/protocols et renvoie une structure protoent contenant
       la division des divers champs de  la  ligne.   Le  fichier
       /etc/protocols est ouvert si nécessaire.

       La  fonction  getprotobyname()  renvoie une structure pro­
       toent correspondant à la ligne du  fichier  /etc/protocols
       qui concerne le protocole appelé name.

       La  fonction getprotobynumber() renvoie une structure pro­
       toent pour la ligne correspondant au protocole numéro num­
       ber.

       La  fonction setprotoent() ouvre le fichier /etc/protocols
       et ramène le pointeur  au  début.  Si  stayopen  est  vrai
       (valant 1), alors le fichier ne sera pas refermé entre les
       appels successifs  à  getprotobyname()  ou  getprotobynum­
       ber().

       La  fonction  endprotoent() referme le fichier /etc/proto­
       cols.

       La structure protoent est définie dans <netdb.h> ainsi :

              struct protoent {
                char   *p_name;    /* Nom officiel du protocole */
                char  **p_aliases; /* Liste d'alias             */
                int     p_proto;   /* Numéro du protocole       */
              }

       Les membres de la structure protoent sont :

       p_name Le nom officiel du protocole.

       p_aliases
              Une liste, terminée par zéro, d'autres noms pour le



BSD                      3 Novembre 1996                        1





GETPROTOENT(3)     Manuel du programmeur Linux     GETPROTOENT(3)


              protocole.

       p_proto
              Le numéro du protocole.

VALEUR RENVOYÉE
       Les fonctions getprotoent(), getprotobyname() et getproto­
       bynumber() renvoient une structure protoent, ou  un  poin­
       teur  NULL  si  une  erreur  se  produit,  ou si la fin du
       fichier est atteinte.

FICHIERS
       /etc/protocols
              Base de donnée des protocoles

CONFORMITÉ
       BSD 4.3

VOIR AUSSI
       getservent(3), getnetent(3), protocols(5)


TRADUCTION
       Christophe Blaess, 1997.

































BSD                      3 Novembre 1996                        2