GETNETENT

Section: Manuel du programmeur Linux (3)
Updated: 21 juillet 2003
Index


NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
FICHIERS
CONFORMITÉ
VOIR AUSSI
TRADUCTION

NOM

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - 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/networks.
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 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.