Nom

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - Lire les informations réseau.

Résumé

.nf #include <netdb.h> struct netent *getnetent (void); struct netent *getnetbyname (const char * name ); struct netent *getnetbyaddr (long net , int type ); void setnetent (int stayopen ); void endnetent (void); .fi

Description

La fonction getnetent() lit la ligne suivante du fichier /etc/networks, renvoie un pointeur sur une structure netent contenant les différents champs de la ligne. Le fichier /etc/networks est ouvert en lecture si besoin est.

La fonction getnetbyname() renvoie une structure netent concernant la ligne correspondant au nom de réseau name dans le fichier /etc/networks.

La fonction getnetbyaddr() renvoie une structure netent pour la ligne correspondant au réseau de numéro net et au type indiqué dans le fichier /etc/networks/.

La fonction setnetent() ouvre, ou revient au début, du fichier /etc/networks. Si stayopen est vrai (vaut 1), alors le fichier ne sera pas refermé entre deux appels à getnetbyname() ou à getnetbyaddr().

La fonctions endservent() referme le fichier /etc/networks.

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

.nf .ne 6 .ta 8n 16n 34n struct netent { char *n_name; /* Nom officiel du réseau */ char **n_aliases; /* Liste d'alias */ int n_addrtype; /* Type d'adresse réseau */ unsigned long int n_net; /* Adresse du réseau */ } .ta .fi

Les membres de la structures netent sont :
n_name

Le nom officiel du réseau.

n_aliases

Une liste, terminée par zéro, d'alternatives au nom du réseau.

n_addrtype

Le type d'adresse du réseau, actuellement il vaut toujours AF_INET.

n_net

L'adresse du réseau, utilisant l'ordre des octets de l'hôte.

Valeur renvoyée

Les fonctions getnetent(), getnetbyname() et getnetbyaddr() renvoient une structure netent ou un pointeur NULL si une erreur se produit, ou si la fin du fichier est atteinte.

Fichiers

/etc/networks

Base de données des réseaux.

Conformité

BSD 4.3

Voir aussi

getprotoent (3), getservent (3), networks (5), br RFC 1101 .

Traduction

Christophe Blaess, 1996-2003.