getnameinfo(3) | Library Functions Manual | getnameinfo(3) |
getnameinfo - Traduction d'adresse en nom de façon indépendante du protocole
Bibliothèque C standard (libc, -lc)
#include <sys/socket.h> #include <netdb.h>
int getnameinfo(const struct sockaddr *restrict addr, socklen_t addrlen, char host[_Nullable restrict .hostlen], socklen_t hostlen, char serv[_Nullable restrict .servlen], socklen_t servlen, int flags);
getnameinfo():
Since glibc 2.22:
_POSIX_C_SOURCE >= 200112L
glibc 2.21 and earlier:
_POSIX_C_SOURCE
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.
The addr argument is a pointer to a generic socket address structure (of type sockaddr_in or sockaddr_in6) of size addrlen that holds the input IP address and port number. The arguments host and serv are pointers to caller-allocated buffers (of size hostlen and servlen respectively) into which getnameinfo() places null-terminated strings containing the host and service names respectively.
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 :
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 :
On success, 0 is returned, and node and service names, if requested, are filled with null-terminated strings, possibly truncated to fit the specified buffer lengths. On error, one of the following nonzero error codes is returned:
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.
/etc/hosts
/etc/nsswitch.conf
/etc/resolv.conf
getnameinfo() is provided since glibc 2.1.
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
Interface | Attribut | Valeur |
getnameinfo() | Sécurité des threads | MT-Safe env locale |
POSIX.1-2001, POSIX.1-2008, RFC 2553.
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
Since glibc 2.8, these definitions are exposed only if suitable feature test macros are defined, namely: _GNU_SOURCE, _DEFAULT_SOURCE (since glibc 2.19), or (in glibc versions up to and including 2.19) _BSD_SOURCE or _SVID_SOURCE.
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 ».
Before glibc 2.2, the hostlen and servlen arguments were typed as size_t.
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 *addr; /* input */ socklen_t addrlen; /* input */ char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV]; if (getnameinfo(addr, addrlen, 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 *addr; /* input */ socklen_t addrlen; /* input */ char hbuf[NI_MAXHOST]; if (getnameinfo(addr, addrlen, 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).
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 and W. Stevens, Basic Socket Interface Extensions for IPv6, RFC 2553, March 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.
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.
5 février 2023 | Pages du manuel de Linux 6.03 |