Linux Certif

Toute la documentation sur la certification Linux LPI

getnetent

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 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 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, POSIX.1-2001.

VOIR AUSSI

getprotoent(3), getservent(3), networks(5), br 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 14 août 2006.

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.