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    (consultez
   feature_test_macros(7)) :

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

DESCRIPTION

       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 indiqué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 renvoient zéro.  En  cas  d'erreur,  une  valeur  d'erreur
       positive listée dans ERREURS 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.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/>.

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