INET_NTOP(3)

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.