Provided by: manpages-fr-dev_4.27.0-1_all bug

NOM

       getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent — Accéder aux protocoles internet

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <netdb.h>

       struct protoent *getprotoent(void);

       struct protoent *getprotobyname(const char *nom);
       struct protoent *getprotobynumber(int num_proto);

       void setprotoent(int rester_ouverte);
       void endprotoent(void);

DESCRIPTION

       La  fonction  getprotoent()  lit  l'entrée  suivante  de  la  base  de  données des protocoles (consultez
       protocols(5)) et renvoie une structure protoent contenant les champs extraits de l'entrée. Une  connexion
       à la base de données est ouverte si nécessaire.

       La  fonction  getprotobyname()  renvoie  une  structure  protoent pour l'entrée de la base de données qui
       correspond au protocole nom. Une connexion à la base de données est ouverte si nécessaire.

       La fonction getprotobynumber() renvoie une structure protoent pour l'entrée de la  base  de  données  qui
       correspond  au  numéro  de  protocole  num_proto.  Une  connexion  à  la  base  de données est ouverte si
       nécessaire.

       La fonction setprotoent() ouvre une connexion à la base de données et  définit  l'entrée  suivante  à  la
       première  entrée.  Si rester_ouverte est différent de zéro, la connexion à la base de données ne sera pas
       fermée entre deux appels aux fonctions getproto*().

       La fonction endprotoent() ferme la connexion à la base de données.

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

           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 NULL, d'autres noms pour le protocole.

       p_proto
              Le numéro du protocole.

VALEUR RENVOYÉE

       Les fonctions getprotoent(),  getprotobyname()  et  getprotobynumber()  renvoient  un  pointeur  sur  une
       structure  protoent  allouée  statiquement,  ou un pointeur NULL si une erreur se produit ou si la fin du
       fichier est atteinte.

FICHIERS

       /etc/protocols
              Base de données des protocoles

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────┬──────────────────────┬─────────────────────────────────────────────────┐
       │ InterfaceAttributValeur                                          │
       ├──────────────────────────────┼──────────────────────┼─────────────────────────────────────────────────┤
       │ getprotoent()                │ Sécurité des threads │ MT-Unsafe race:protoent race:protoentbuf locale │
       ├──────────────────────────────┼──────────────────────┼─────────────────────────────────────────────────┤
       │ getprotobyname()             │ Sécurité des threads │ MT-Unsafe race:protobyname locale               │
       ├──────────────────────────────┼──────────────────────┼─────────────────────────────────────────────────┤
       │ getprotobynumber()           │ Sécurité des threads │ MT-Unsafe race:protobynumber locale             │
       ├──────────────────────────────┼──────────────────────┼─────────────────────────────────────────────────┤
       │ setprotoent(), endprotoent() │ Sécurité des threads │ MT-Unsafe race:protoent locale                  │
       └──────────────────────────────┴──────────────────────┴─────────────────────────────────────────────────┘

       Dans la table ci-dessus, protoent dans race:protoent signifie que si  une  des  fonctions  setprotoent(),
       getprotoent()  ou  endprotoent()  est  utilisée  en parallèle dans différents threads d'un programme, des
       compétitions de données pourraient se produire.

STANDARDS

       POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, 4.3BSD.

VOIR AUSSI

       getnetent(3), getprotoent_r(3), getservent(3), protocols(5)

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>, François Micaux, Alain Portal  <aportal@univ-montp2.fr>,  Jean-Philippe  Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,     Thomas     Huriaux      <thomas.huriaux@gmail.com>,      Nicolas      François
       <nicolas.francois@centraliens.net>,     Florentin     Duneau    <fduneau@gmail.com>,    Simon    Paillard
       <simon.paillard@resel.enst-bretagne.fr>,    Denis    Barbier    <barbier@debian.org>,    David     Prévot
       <david@tilapin.org> et Lucien Gentis <lucien.gentis@waika9.com>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                     getprotoent(3)