Scroll to navigation

GETNETENT_R(3) Manuel du programmeur Linux GETNETENT_R(3)

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


getnetent_r(), getnetbyname_r(),
    getnetbyaddr_r():
  

   Since glibc 2.19:
  

   _DEFAULT_SOURCE
  

   Glibc 2.19 and earlier:
  

   _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



  

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

  

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








ATTRIBUTS


Pour une explication des termes utilisés dans cette
    section, consulter attributes(7).



  

    Interface
    Attribut
    Valeur
  

  

    getnetent_r(), getnetbyname_r(),
      getnetbyaddr_r()
    Sécurité des threads
    MT-Safe locale
  








CONFORMITÉ


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






VOIR AUSSI


getnetent(3), networks(5)






COLOPHON


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






TRADUCTION


La traduction française de cette page de manuel a
    été créée par Christophe Blaess
    <https://www.blaess.fr/christophe/>, Stéphan Rafin
    <stephan.rafin@laposte.net>, Thierry Vignaud
    <tvignaud@mandriva.com>, François Micaux, Alain Portal
    <aportal@univ-montp2.fr>, Jean-Philippe Guérard
    <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh)
    <jean-luc.coulon@wanadoo.fr>, Julien Cristau
    <jcristau@debian.org>, Thomas Huriaux
    <thomas.huriaux@gmail.com>, Nicolas François
    <nicolas.francois@centraliens.net>, Florentin Duneau
    <fduneau@gmail.com>, Simon Paillard
    <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier
    <barbier@debian.org> et David Prévot
  <david@tilapin.org>


Cette traduction est une documentation libre ; veuillez
    vous reporter à la
    GNU General
    Public License version 3 concernant les conditions de copie et de
    distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.


Si vous découvrez un bogue dans la traduction de cette page
    de manuel, veuillez envoyer un message à
    debian-l10n-french@lists.debian.org.







  

    15 septembre 2017
    GNU