GETPROTOENT(3)

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 10 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.