inet_ntop

Autres langues

Langue: fr

Version: 18 décembre 2000 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NOM

inet_ntop - Manipuler les adresses réseau

SYNOPSIS

 #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);
 

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(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.

VALEUR RENVOYÉE

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.

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

BOGUES

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

VOIR AUSSI

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 19 novembre 2007.

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.