Rechercher une page de manuel
inet_pton
Langue: fr
Version: 18 décembre 2000 (fedora - 16/08/07)
Section: 3 (Bibliothèques de fonctions)
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 doit pointer sur une chaîne de caractère contenant une adresse réseau IPv4 au format décimal pointé "ddd.ddd.ddd.ddd". L'adresse est alors 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 un 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 remplit errno avec la valeur EAFNOSUPPORT si af ne contient pas une famille d'adresse valide. Elle renvoie une valeur nulle si src ne contient pas une adresse réseau valide pour la famille indiquée. Enfin, 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 reconnait pas les adresses IPv4. Il faut dans ce cas fournir dans src une adresse IPv4 projetée dans l'espace IPv6TRADUCTION
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_pton ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre