GETNETENT(3)

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 et 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é.

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 fonction endnetent() 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   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, POSIX.1-2001.

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

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 28 octobre 1996 et révisée le 17 juillet 2008.

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 getnetent ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.