GETNETENT

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 15 mai 1993
Index Menu principal

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.

Dernière mise à jour : 17 juillet 2008