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

GNU                                               19 août 2008                                      GETNETENT(3)