GETNETENT(3)

NOM
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - Lire les informations reseau.

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 differents 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 reseau name dans le fichier /etc/networks.

La fonction getnetbyaddr() renvoie une structure netent pour la ligne correspondant au reseau de numero net et au type indique dans le fichier /etc/networks/.

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

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

La structure netent est definie dans <netdb.h> ainsi :

    struct netent {
       char             *n_name;     /* Nom officiel  du reseau */
       char            **n_aliases;  /* Liste d'alias           */
       int               n_addrtype; /* Type d'adresse reseau   */
       unsigned long int n_net;      /* Adresse du reseau       */
    }

Les membres de la structures netent sont :

n_name
    Le nom officiel du reseau.

n_aliases
    Une liste, terminee par zero, d'alternatives au nom du reseau.

n_addrtype
    Le type d'adresse du reseau, actuellement il vaut toujours AF_INET.

n_net
    L'adresse du reseau, utilisant l'ordre des octets de l'hote.

VALEUR RENVOYEE
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 donnees des reseaux.

CONFORME A
BSD 4.3

VOIR AUSSI
getprotoent(3), getservent(3), networks(5)