GETNETENT(3) Manuel du programmeur Linux GETNETENT(3)
NOM
getnetent, getnetbyname, getnetbyaddr, setnetent, endne
tent - Lire les informations réseau.
SYNOPSIS
#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);
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/net
works.
La structure netent est définie dans <netdb.h> ainsi :
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 */
}
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
BSD 14 Décembre 1998 1
GETNETENT(3) Manuel du programmeur Linux GETNETENT(3)
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 getnet
byaddr() 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), RFC 1101.
TRADUCTION
Christophe Blaess, 1997.
BSD 14 Décembre 1998 2