inet_ntop(3) Library Functions Manual inet_ntop(3)
NOM
inet_ntop - Convertir des adresses IPv4 et IPv6 sous forme binaire en
forme texte
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <arpa/inet.h>
const char *inet_ntop(int af, const void *restrict src,
char dst[restrict .size], socklen_t size);
DESCRIPTION
Cette fonction convertit une structure d'adresse réseau src de la fa-
mille d'adresse af en une chaîne de caractères. La chaîne résultante,
qui est copiée dans le tampon dst, doit être un pointeur non NULL.
L'appelant indique le nombre d'octets de la chaîne avec l'argument
size.
inet_ntop() é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(). Les familles d'adresses
suivantes sont supportées dès à présent :
AF_INET
src doit pointer sur une structure struct in_addr (octets sto-
cké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 sto-
cké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
Si elle réussit, inet_ntop() renvoie un pointeur non NULL vers dst. Si
une erreur se produit, la fonction renvoie NULL, et errno contient le
code d'erreur.
ERREURS
EAFNOSUPPORT
af n'était pas une famille d'adresses valable.
ENOSPC La chaîne d'adresse convertie devrait être supérieure à la
taille donnée par size.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌──────────────────────────────┬──────────────────────┬────────────────┐
│Interface │ Attribut │ Valeur │
├──────────────────────────────┼──────────────────────┼────────────────┤
│inet_ntop() │ Sécurité des threads │ MT-Safe locale │
└──────────────────────────────┴──────────────────────┴────────────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008. Notez que la RFC 2553 définit un prototype
où le dernier paramètre, size, est de type size_t. Beaucoup de systèmes
suivent cette RFC 2553. Les glibc 2.0 et 2.1 utilisent size_t mais 2.2
et suivantes utilisent socklen_t.
BOGUES
AF_INET6 convertit les adresses IPv4 projetées dans l'espace IPv6 en
employant le format IPv6.
EXEMPLES
Consultez inet_pton(3).
VOIR AUSSI
getnameinfo(3), inet(3), inet_pton(3)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org> et David Prévot <david@tilapin.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 5 février 2023 inet_ntop(3)
Generated by dwww version 1.15 on Sat Jun 29 01:39:12 CEST 2024.