Loading

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);

       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.23 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

       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> ».