inet_ntop - Convertir des adresses IPv4 et IPv6 sous forme binaire en forme
texte
Bibliothèque C standard (
libc,
-lc)
#include <arpa/inet.h>
const char *inet_ntop(int af, const void *restrict src,
char dst[restrict .size], socklen_t size);
Cette fonction convertit une structure d'adresse réseau
src de la
famille d'adresse
af en une chaîne de caractères. La
chaîne résultante, qui est copiée dans le tampon
dst, doit être un pointeur non NULL. L'appelant indique le
nombre d'octets de la chaîne avec l'argument
size.
inet_ntop() étend les possibilités de la fonction
inet_ntoa(3) pour gérer plusieurs familles d'adresses.
L'utilisation de
inet_ntoa(3) est à présent
déconseillée au profit de
inet_ntop(). Les familles
d'adresses suivantes sont supportées dès à
présent :
- AF_INET
-
src doit pointer sur une structure struct
in_addr (octets stockés dans l'ordre du réseau) qui est
convertie en une adresse réseau IPv4 dans le format décimal
pointé " ddd.ddd.ddd.ddd". Le tampon dst
doit mesurer au minimum INET_ADDRSTRLEN octets.
- AF_INET6
-
src doit pointer sur une structure struct
in6_addr (octets stockés dans l'ordre du réseau) qui est
convertie dans la représentation la plus appropriée de
l'adresse IPv6. Le tampon dst doit mesurer au minimum
INET6_ADDRSTRLEN octets.
Si elle réussit,
inet_ntop() renvoie un pointeur non NULL vers
dst. Si une erreur se produit, la fonction renvoie NULL, et
errno contient le code d'erreur.
- EAFNOSUPPORT
-
af n'était pas une famille d'adresses
valable.
- ENOSPC
- La chaîne d'adresse convertie devrait être
supérieure à la taille donnée par size.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
inet_ntop() |
Sécurité des threads |
MT-Safe locale |
POSIX.1-2001, POSIX.1-2008. Notez que la RFC 2553 définit un
prototype où le dernier paramètre,
size, est de type
size_t. Beaucoup de systèmes suivent cette RFC 2553. Les
glibc 2.0 et 2.1 utilisent
size_t mais 2.2 et suivantes utilisent
socklen_t.
AF_INET6 convertit les adresses IPv4 projetées dans l'espace IPv6
en employant le format IPv6.
Consultez
inet_pton(3).
getnameinfo(3),
inet(3),
inet_pton(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]> et David Prévot <
[email protected]>
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 à
[email protected]