GETPROTOENT

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 24 avril 1993
Index Menu principal

NOM

getprotoent, getprotobyname, getprotobynumber, setprotoent, 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 protoent correspondant à la ligne du fichier /etc/protocols qui concerne le protocole appelé name.

La fonction getprotobynumber() renvoie une structure protoent pour la ligne correspondant au protocole numéro number.

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 getprotobynumber().

La fonction endprotoent() referme le fichier /etc/protocols.

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 protocole.
p_proto: Le numéro du protocole.

VALEUR RENVOYÉE

Les fonctions getprotoent(), getprotobyname() et getprotobynumber() renvoient une structure protoent , ou un pointeur 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, POSIX.1-2001.

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 3 novembre 1996 et révisée le 29 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getprotoent ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008