Linux

CentOS 4.8

inet_ntop(3)


INET_NTOP

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 buffer 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 buffer 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 buffer 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 buffer dst, dont la taille est indiquée par l’argument cnt.

VOIR AUSSI

inet_pton(3)

BOGUES

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

TRADUCTION

Christophe Blaess, 2000.


inet_ntop(3)