INET_PTON

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
CONFORMITÉ À
VOIR AUSSI
BOGUES
TRADUCTION

NOM

inet_pton - Créer une structure d'adresse réseau

SYNOPSIS

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

int inet_pton(int af, const char *src, void *dst);

DESCRIPTION

Cette fonction convertit la chaîne de caractères src en une structure d'adresse réseau de la famille af, puis copie cette structure dans dst.
La fonction inet_pton(3) étend les possibilités de la fonction inet_addr(3) pour supporter de multiples familles d'adresses. L'utilisation de inet_addr(3) est désormais déconseillée, au profit de la fonction inet_pton(3). Les familles d'adresses suivantes sont dès à présent supportées :

AF_INET: src pointe sur une chaîne de caractères contenant une adresse réseau IPv4 au format décimal pointé, « ddd.ddd.ddd.ddd ». L'adresse est convertie en une structure struct in_addr et copiée dans dst, qui doit donc contenir au minimum sizeof(struct in_addr) octets.
AF_INET6: src pointe sur une chaîne de caractères contenant une adresse réseau IPv6 dans tout format IPv6 autorisé. L'adresse est convertie en une structure struct in6_addr et copiée dans dst, qui doit donc contenir au moins sizeof(struct in6_addr) octets.

Certains formats hexadécimaux ou octaux légitimes pour les adresses AF_INET ne sont pas supportés par inet_pton(), qui les rejettera.

VALEUR RENVOYÉE

inet_pton renvoie une valeur négative et définit errno à EAFNOSUPPORT si af ne contient pas une famille d'adresse valide. Elle renvoie une valeur nulle si src ne contient pas une chaîne de caractères représentant une adresse réseau valable pour la famille indiquée. Une valeur positive est renvoyée si la conversion a eu lieu avec succès.

CONFORMITÉ À

POSIX.1-2001.

VOIR AUSSI

inet_ntop(3)

BOGUES

AF_INET6 ne reconnaît pas les adresses IPv4. Il faut dans ce cas fournir dans src une adresse IPv4 projetée dans l'espace IPv6

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007