INET_NTOP
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 18 juin 2008
Index
Menu principal
NOM
inet_ntop - Convertir des adresses IPv4 et IPv6 sous forme binaire en texte
SYNOPSIS
#include <arpa/inet.h>
const char *inet_ntop(int af, const void *src,
char *dst, socklen_t cnt);
DESCRIPTION
Cette fonction convertit une adresse réseau représentée par la structure
src
de la famille
af,
en une chaîne de caractères copiée dans le tampon
dst,
long de
cnt
octets.
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.
VALEUR RENVOYÉE
Si elle réussit,
inet_ntop()
renvoie un pointeur sur
dst.
Si une erreur se produit, la fonction renvoie NULL, et
errno
contient le code d'erreur.
EXEMPLE
Voir
inet_pton(3).
ERREURS
- EAFNOSUPPORT
-
af
n'était pas une famille d'adresses valide.
- ENOSPC
-
L'adresse convertie a une taille supérieure à
cnt.
CONFORMITÉ
POSIX.1-2001.
Notez que la RFC 2553 définit un prototype où le dernier paramètre
cnt
est de type
size_t.
Beaucoup de systèmes suivent la RFC 2553.
Les glibc 2.0 et 2.1 ont
size_t,
mais la glibc 2.2 et suivantes ont
socklen_t.
BOGUES
AF_INET6
convertit les adresses IPv4 projetées dans l'espace IPv6
en employant le format IPv6.
VOIR AUSSI
getnameinfo(3),
inet(3),
inet_pton(3)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 31 août 2000
et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 3 inet_ntop ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- EXEMPLE
-
- ERREURS
-
- CONFORMITÉ
-
- BOGUES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008