Provided by: manpages-fr-dev_3.57d1p1-1_all bug

NOM

       getnameinfo - Traduction d'adresse en nom de façon indépendante du protocole

SYNOPSIS

       #include <sys/socket.h>
       #include <netdb.h>

       int getnameinfo(const struct sockaddr *sa, socklen_t salen,
                       char *host, size_t hostlen,
                       char *serv, size_t servlen, int flags);

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

       getnameinfo() : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

DESCRIPTION

       La  fonction  getnameinfo() est la réciproque de getaddrinfo(3) : elle convertit une adresse de socket en
       un  hôte  et  un  service  correspondants,  de  façon  indépendante  du  protocole.  Elle   combine   les
       fonctionnalités de gethostbyaddr(3) et getservbyport(3) mais contrairement à ces fonctions, getnameinfo()
       est réentrante et permet aux programmes de supprimer les dépendances IPv4/IPv6.

       Le paramètre sa est un pointeur vers l'adresse d'une structure de socket générique (de  type  sockaddr_in
       ou  sockaddr_in6) de taille salen qui contient l'adresse IP d'entrée et le numéro de port. Les paramètres
       host et serv sont des pointeurs vers des tampons alloués par l'appelant (de tailles  respectives  hostlen
       et  servlen)  dans  lesquels  getnameinfo()  place des chaînes de caractères, terminées par un octet nul,
       contenant respectivement les noms d'hôte et de service.

       L'appelant peut préciser qu'aucun nom d'hôte (ou qu'aucun nom de service) n'est nécessaire en fournissant
       NULL  comme  paramètre  host  (ou serv) ou bien en passant un paramètre hostlen (ou servlen) valant zéro.
       Quoi qu'il en soit, au moins un nom d'hôte ou un nom de service doit être demandé.

       Le paramètre flags modifie le comportement de getnameinfo() comme indiqué ci-dessous :

       NI_NAMEREQD
              S'il est défini, une erreur se produira si le nom de l'hôte n'a pas pu être déterminé.

       NI_DGRAM
              Indique que le service est plutôt basé sur des datagrammes (UDP) que sur un flux  connecté  (TCP).
              Ce  drapeau est nécessaire pour les quelques ports (512-514) qui ont des services différents selon
              le protocole utilisé : UDP ou TCP.

       NI_NOFQDN
              renvoie seulement la partie nom de l'hôte du FQDN (Fully-Qualified Domain  Name)  pour  les  hôtes
              locaux.

       NI_NUMERICHOST
              La  forme  numérique  du  nom  de  l'hôte  est  renvoyée. (Même si ce drapeau n'est pas levé, cela
              arrivera également lorsque le nom du nœud ne pourra pas être déterminé.)

       NI_NUMERICSERV
              Si cet attribut est défini, la forme numérique du service est renvoyée. (S'il  n'est  pas  défini,
              cela arrivera également si le nom du service n'a pas pu être déterminé.)

   Extensions de getnameinfo() pour les noms de domaines internationalisés
       Depuis  la glibc 2.3.4, getnameinfo() a été modifié pour sélectivement permettre que les noms de domaines
       soient convertis vers ou depuis le format des noms de  domaines  internationalisés  (IDN).  Consultez  la
       RFC 3490,  Internationalizing  Domain  Names  in  Applications  (IDNA).Trois  nouveaux  attributs ont été
       ajoutés :

       NI_IDN Si cet attribut est utilisé, alors le nom trouvé lors de  la  résolution  des  noms  est  converti
              depuis le format IDN vers la locale du système si nécessaire. Les noms au format ASCII ne sont pas
              affectés par cette conversion, ce qui permet d'utiliser cet attribut dans des  programmes  et  des
              environnements existants.

       NI_IDN_ALLOW_UNASSIGNED, NI_IDN_USE_STD3_ASCII_RULES
              Utiliser  ces  attributs  permet  d'activer respectivement les attributs « IDNA_ALLOW_UNASSIGNED »
              (permettre des caractères Unicode non  assignés)  et  « IDNA_USE_STD3_ASCII_RULES »  (vérifier  la
              sortie pour être sûr que le nom d'hôte est conforme à STD3) utilisés dans la gestion de l'IDNA.

VALEUR RENVOYÉE

       En  cas  de succès, 0 est renvoyé et les noms du nœud et du service, s'ils sont demandés, sont renseignés
       sous forme de chaînes terminées par un caractère nul, éventuellement  tronquées  afin  de  s'adapter  aux
       tailles des tampons indiqués. En cas d'erreur, un des codes d'erreur suivants est renvoyé :

       EAI_AGAIN
              Le nom ne peut être résolu à cet instant. Réessayer plus tard.

       EAI_BADFLAGS
              Le paramètre flags n'est pas valable.

       EAI_FAIL
              Une erreur irrécupérable est survenue.

       EAI_FAMILY
              La famille d'adresse n'a pas été reconnue, ou bien la taille de l'adresse était incorrecte pour la
              famille indiquée.

       EAI_MEMORY
              Plus de mémoire disponible.

       EAI_NONAME
              Le nom ne peut être résolu avec les paramètres fournis. NI_NAMEREQD  est  indiqué  et  le  nom  de
              l'hôte ne peut être localisé, ou ni un nom d'hôte ni un nom de service n’a été demandé.

       EAI_OVERFLOW
              Le tampon pointé par host ou serv est trop petit.

       EAI_SYSTEM
              Une erreur système a eu lieu. Le code d'erreur peut être lu dans errno.

       La  fonction  gai_strerror(3)  traduit  ces  codes  d'erreur  en une chaîne de caractères compréhensible,
       utilisable pour rendre compte du problème.

FICHIERS

       /etc/hosts
       /etc/nsswitch.conf
       /etc/resolv.conf

VERSIONS

       getnameinfo() est fournie par la glibc depuis la version 2.1.

CONFORMITÉ

       RFC 2553, POSIX.1-2001.

NOTES

       Afin d'aider les programmeurs à choisir des tailles raisonnables  pour  les  tampons  fournis,  <netdb.h>
       définit les constantes

           #define NI_MAXHOST      1025
           #define NI_MAXSERV      32

       Depuis  la  glibc  2.8,  ces  définitions  sont  exposées  seulement  si  l'une  des  macros  de  test de
       fonctionnalités _BSD_SOURCE, _SVID_SOURCE, ou _GNU_SOURCE est définie.

       La première est la  constante  MAXDNAME  présente  dans  les  versions  récentes  du  fichier  d'en-têtes
       <arpa/nameser.h>  de  BIND.  La deuxième est déterminée en se basant sur les services répertoriés dans la
       RFC « Assigned numbers ».

EXEMPLE

       Le code suivant essaie d'obtenir le nom de l'hôte ainsi que le nom du service sous  forme  numérique,  et
       ce,  pour  une  adresse de socket donnée. Remarquez qu'il n'y a aucune référence à une quelconque famille
       d'adresse codée en dur.

           struct sockaddr *sa;    /* input */
           socklen_t len;         /* input */
           char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV];

           if (getnameinfo(sa, len, hbuf, sizeof(hbuf), sbuf,
                       sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV) == 0)
               printf("host=%s, serv=%s\n", hbuf, sbuf);

       La version suivante vérifie si l'adresse de la socket peut se voir associer un nom.

           struct sockaddr *sa;    /* input */
           socklen_t len;         /* input */
           char hbuf[NI_MAXHOST];

           if (getnameinfo(sa, len, hbuf, sizeof(hbuf),
                       NULL, 0, NI_NAMEREQD))
               printf("could not resolve hostname");
           else
               printf("host=%s\n", hbuf);

       Un programme d'exemple utilisant getnameinfo()  peut être trouvé dans getaddrinfo(3).

VOIR AUSSI

       accept(2), getpeername(2),  getsockname(2),  recvfrom(2),  socket(2),  getaddrinfo(3),  gethostbyaddr(3),
       getservbyname(3), getservbyport(3), inet_ntop(3), hosts(5), services(5), hostname(7), named(8)

       R.  Gilligan,  S.  Thomson, J. Bound et W. Stevens, Basic Socket Interface Extensions for IPv6, RFC 2553,
       mars 1999.

       Tatsuya Jinmei et Atsushi Onoe, An Extension of Format for IPv6 Scoped Addresses, internet draft, travail
       en cours ⟨ftp://ftp.ietf.org/internet-drafts/draft-ietf-ipngwg-scopedaddr-format-02.txt⟩.

       Craig  Metz,  Protocol  Independence  Using  the  Sockets API, compte rendu du sujet freenix : conférence
       technique annuelle USENIX 2000, juin 2000 ⟨http://www.usenix.org/publications/library/proceedings
       /usenix2000/freenix/metzprotocol.html⟩.

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

       Stéphan Rafin (2002), Alain Portal <http://manpagesfr.free.fr/> (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> ».