Loading

NOM

       getnetent_r,  getnetbyname_r,  getnetbyaddr_r   - Lire les informations
       réseau (versions ré-entrantes)

SYNOPSIS

       #include <netdb.h>

       int getnetent_r(struct netent *result_buf, char *buf,
                       size_t buflen, struct netent **result,
                       int *h_errnop);

       int getnetbyname_r(const char *name,
                       struct netent *result_buf, char *buf,
                       size_t buflen, struct netent **result,
                       int *h_errnop);

       int getnetbyaddr_r(uint32_t net, int type,
                       struct netent *result_buf, char *buf,
                       size_t buflen, struct netent **result,
                       int *h_errnop);

   Exigences de  macros  de  test  de  fonctionnalités  pour  la  glibc  (voir
   feature_test_macros(7)) :

       getnetent_r(), getnetbyname_r(), getnetbyaddr_r() : _BSD_SOURCE ||
       _SVID_SOURCE

       Les fonctions getnetent_r(), getnetbyname_r(), et getnetbyaddr_r() sont
       respectivement    les    versions    ré-entrantes,   de   getnetent(3),
       getnetbyname(3), et getnetbyaddr(3). Elles diffèrent dans le sens où la
       structure  netent  est renvoyée dans la signature de l’appel et dans la
       valeur de retour.

       Au lieu de renvoyé un pointeur sur une  structure  netent  statiquement
       allouée,  ces  fonctions  copient  la structure à l’adresse pointée par
       result_buf.

       Le tableau buf est utilisé pour sauvegarder les  champs  de  la  chaîne
       pointés   par   la   structure   netent  renvoyée  (les  fonctions  non
       ré-entrantes allouent ces chaînes de  façon  statique).  La  taille  du
       tableau  est  spécifiée  avec  buflen.  Si  buf est trop petit, l’appel
       échoue avec l’erreur ERANGE, et l’appelant doit essayer de nouveau avec
       un  tableau  plus  grand  (un  tableau  de  1024  octets est en général
       suffisant).

       Si la fonction obtient  un  enregistrement  de  réseau,  alors  *result
       pointe vers result_buf sinon *result est défini à NULL.

       Le  tampon  pointé  par h_errnop est utilisé pour renvoyé la valeur qui
       doit  être  sauvegardée  dans  la  variable  globale  h_errno  lors  de
       l’utilisation des versions non ré-entrantes de ces fonctions.

VALEUR RENVOYÉE

       En  cas  de  succès,  ces fonctions ré-entrantes renvoient zéro. En cas
       d’échec, une valeur d’erreur positive est renvoyée.

       Dans le cas des erreurs, enregistrement non  trouvé  (getnetbyname_r(),
       getnetbyaddr_r()),  ou  fin  de  l’entrée  (getnetent_r()),  result est
       défini à NULL.

ERREURS

       ENOENT (getnetent_r()) Plus d’enregistrement dans la base de données.

       ERANGE buf est trop petit. Ré-essayer avec un  tampon  plus  grand  (et
              augmentez buflen).

CONFORMITÉ

       Ces  fonctions  sont  des  extensions  GNU. Des fonctions avec des noms
       similaires existent sur d’autres systèmes, bien que en général avec des
       signatures d’appels différent.

VOIR AUSSI

       getnetent(3), networks(5)

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  est  maintenue  par  Florentin
       Duneau <fduneau AT gmail DOT 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> ».