getprotoent

Table des matières
Retour à l'index

 

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 à


 

Index

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
FICHIERS
ATTRIBUTS
STANDARDS
HISTORIQUE
VOIR AUSSI
TRADUCTION

This document was created by man2html, using the manual pages.
Time: 05:06:15 GMT, September 19, 2025