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(uint32_t net, int type);

       void setnetent(int stayopen);

       void endnetent(void);

DESCRIPTION

       La  fonction getnetent() lit l'entrée suivante de la base de données réseau, et renvoie un
       pointeur sur une structure  netent  contenant  les  différents  champs  de  l'entrée.  Une
       connexion vers la base de données est créée si nécessaire.

       La  fonction getnetbyname() renvoie une structure netent de l'entrée de la base de données
       qui correspond au nom de réseau name.

       La fonction getnetbyaddr() renvoie une structure netent de l'entrée de la base de  données
       qui correspond au numéro de réseau net de type type. L'argument net doit être dans l'ordre
       des octets de l'hôte.

       La fonction setnetent() ouvre un connexion à une base  données  et  définit  la  prochaine
       entrée  à  l'entrée  suivante. Si stayopen est non nul, alors la connexion à la base de ne
       sera pas fermée entre deux appels aux fonctions getnet*().

       La fonction endnetent()ferme la connexion à la base de données.

       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 */
               uint32_t   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 NULL, d'alternatives au nom du réseau.

       n_addrtype
              Le type d'adresse du réseau ; 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 un pointeur vers une
       structure  netent allouée statiquement 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.

NOTES

       Pour les glibc antérieurs à la version 2.2, l'argument net de getnetbyaddr() était de type
       long.

VOIR AUSSI

       getnetent_r(3), getprotoent(3), getservent(3)
       RFC 1101

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin  Duneau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».