inet_ntop − Manipuler les adresses réseau.

#include <sys/types.h>
#include <sys/socket.h>
#include <arpa/inet.h>

const char *inet_ntop(int af, const void * src,
                        char * dst, size_t cnt);

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(3) é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(3). 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.

inet_ntop() renvoie un pointeur sur buf. Si une erreur se produit, la fonction renvoie NULL, et errno contient EAFNOSUPPORT si af ne représente pas une famille d’adresses valide, ou ENOSPC si l’adresse convertie ne tient pas dans le tampon dst, dont la taille est indiquée par l’argument cnt.

inet_pton(3)

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ème suivent la RFC 2553. glibc 2.0 et 2.1 ont size_t, mais 2.2 a socklen_t.

AF_INET6 convertit les adresse IPv4 projetées dans l’espace IPv6 en employant le format IPv6.

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 14 août 2006.

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.