.\" t .\" Copyright (C) 2014 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH INET_NET_PTON 3 "14 avril 2014" Linux "Manuel du programmeur Linux" .SH NOM inet_net_pton, inet_net_ntop \- Conversion d'adresse réseau Internet .SH SYNOPSIS .nf \fB#include \fP \fBint inet_net_pton(int \fP\fIaf\fP\fB, const char *\fP\fIpres\fP\fB,\fP \fB void *\fP\fInetp\fP\fB, size_t \fP\fInsize\fP\fB);\fP \fBchar *inet_net_ntop(int \fP\fIaf\fP\fB, const void *\fP\fInetp\fP\fB, int \fP\fIbits\fP\fB,\fP \fB char *\fP\fIpres\fP\fB, size_t \fP\fIpsize\fP\fB);\fP .fi .sp Effectuez l'édition des liens avec l'option \fI\-lresolv\fP. .sp .in -4n Exigences de macros de test de fonctionnalités pour la glibc (consultez \fBfeature_test_macros\fP(7))\ : .in .sp \fBinet_net_pton\fP(), \fBinet_net_ntop\fP()\ : .ad l .RS 4 .PD 0 .TP 4 Depuis la glibc 2.20\ : _DEFAULT_SOURCE .TP 4 Avant la glibc 2.20\ : _BSD_SOURCE || _SVID_SOURCE .PD .RE .ad b .SH DESCRIPTION Ces fonctions convertissent les adresses de réseau entre leur format de représentation (c\-à\-d. textuelle) et leur format binaire pour le réseau. Dans le cas des deux fonctions, \fIaf\fP indique la famille d'adresse à utiliser lors de la conversion. Seule la valeur \fBAF_INET\fP est prise en charge. .SS inet_net_pton() La fonction \fBinet_net_pton\fP() convertit \fIpres\fP, une chaîne terminée par un caractère nul et contenant la représentation d'une adresse réseau vers le format réseau. Le résultat de la conversion, dans l'ordre du réseau, est placé dans le tampon pointé par \fInet\fP. (Le paramètre \fInetp\fP pointe typiquement vers une structure \fIin_addr\fP.) Le paramètre \fInsize\fP indique le nombre d'octets disponibles dans \fInetp\fP. En cas de réussite, \fBinet_net_pton\fP() renvoie le nombre de bits dans le champ de numéro de réseau du résultat placé dans \fInetp\fP. Pour une discussion sur le format de présentation de l’entrée et la valeur de retour, consultez \fBNOTES\fP. \fIRemarque\fP\ : le tampon pointé par \fInetp\fP devrait être mis à zéro avant d’appeler \fBinet_net_pton\fP() puisque l’appel n’écrit que le nombre d’octets nécessaire pour le numéro de réseau (ou qu’explicitement indiqué par \fIpres\fP), ce qui pourrait être moins que le nombre d’octets dans une adresse de réseau complète. .SS inet_net_ntop() La fonction \fBinet_net_ntop\fP() convertit le numéro de réseau dans le tampon pointé par \fInetp\fP au format de présentation\ ; \fI*netp\fP est interprété comme une valeur dans l’ordre d’octets du réseau. L’argument \fIbits\fP indique le nombre de bits dans le numéro de réseau \fI*netp\fP. La chaîne au format de présentation terminée par NULL est placée dans le tampon pointé par \fIpres\fP. L’argument \fIpsize\fP indique le nombre d’octets disponibles dans \fIpres\fP. La chaîne de présentation est au format CIDR\ : notation décimale pointée représentant l’adresse réseau, suivie par une barre oblique et la taille du numéro de réseau en bit. .SH "VALEUR RENVOYÉE" Si elle réussit, \fBinet_net_pton\fP() renvoie le nombre de bits de l'adresse réseau. En cas d'erreur, \-1 est renvoyé, et \fIerrno\fP contient le code d'erreur. Si elle réussit, \fBinet_net_ntop\fP() renvoie \fIpres\fP. En cas d'erreur, elle renvoie NULL et \fIerrno\fP contient le code d'erreur. .SH ERREURS .TP \fBEAFNOSUPPORT\fP \fIaf\fP indique une valeur différente de \fBAF_INET\fP. .TP \fBEMSGSIZE\fP La taille du tampon de sortie est insuffisante. .TP \fBENOENT\fP (\fBinet_net_pton\fP()) \fIpres\fP n’était pas dans un format de présentation correct. .SH CONFORMITÉ Les fonctions \fBinet_net_pton\fP() et \fBinet_net_ntop\fP() ne sont pas standard, mais sont largement répandues. .SH NOTES .SS "Format de présentation en entrée pour inet_net_pton()" L'adresse réseau peut être indiquée sous forme de valeur hexadécimale ou de notation décimale pointée. .\" If the hexadecimal string is short, the remaining nibbles are zeroed. Les valeurs hexadécimales sont indiquées en préfixant par "0x" ou "0X". Les symboles hexadécimaux remplissent les nibbles (semioctets) de l'adresse réseau de gauche à droite dans l'ordre du réseau. Dans la notation décimale pointée, jusqu'à quatre octets sont indiqués sous la forme de nombres décimaux séparées par des points. Ainsi, n'importe laquelle des formes suivantes est acceptée\ : a.b.c.d a.b.c a.b a .\" Reading other man pages, some other implementations treat .\" 'c' in a.b.c as a 16-bit number that populates right-most two bytes .\" 'b' in a.b as a 24-bit number that populates right-most three bytes Chaque partie est un nombre dans l'intervalle 0 à 255 remplissant un octet de l'adresse réseau, de gauche à droite, dans l'ordre des octets du réseau (gros\-boutisme). Si une partie est omise, l'octet correspondant dans l'adresse réseau vaut zéro. Pour la notation hexadécimale comme la notation décimale pointée, l'adresse réseau peut être suivie d'une barre oblique et d'un nombre compris entre 0 et 32, définissant la taille de l'adresse réseau en bits. .SS "Valeur de retour de inet_net_pton()" La valeur de retour de \fBinet_net_pton\fP() est le nombre de bits dans le champ de numéro de réseau. Si la chaîne de présentation se termine par une barre oblique et une valeur de taille explicite, alors cette taille devient la valeur de retour de \fBinet_net_pton\fP(). Sinon, la valeur de retour, \fBbits\fP, est supposée comme suit. .IP * 3 Si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 240, alors \fIbits\fP vaut 32. .IP * 3 Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 224, alors \fIbits\fP vaut 4. .IP * 3 Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 192, alors \fIbits\fP vaut 24. .IP * 3 Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 128, alors \fIbits\fP vaut 16. .IP * Sinon \fIbits\fP vaut 8. .PP Si la valeur de \fIbits\fP résultant des étapes précédentes est au moins égale à 8, mais que le nombre d’octets indiqué dans le numéro de réseau dépasse \fIbits/8\fP, alors \fIbits\fP est défini à huit fois le nombre d’octets vraiment indiqué. .SH EXEMPLE Le programme suivant montre l’utilisation de \fBinet_net_pton\fP() et \fBinet_net_ntop\fP(). Il utilise \fBinet_net_pton\fP() pour convertir une adresse réseau au format de présentation fourni en premier argument de ligne de commande vers sa forme binaire et affiche la valeur renvoyée par \fBinet_net_pton\fP(). Il utilise ensuite \fBinet_net_ntop\fP() pour reconvertir la forme binaire au format de présentation, et affiche la chaîne résultante. De façon à démontrer que \fBinet_net_pton\fP() peut ne pas écrire sur tous les octets de son argument \fInetp\fP, le programme permet un deuxième argument de ligne de commande\ : un nombre utilisé pour initialiser le tampon avant d’appeler \fBinet_net_pton\fP(). Comme en dernière ligne de sa sortie, le programme affiche tous les octets du tampon renvoyé par \fBinet_net_pton\fP(), cela permet à l’utilisateur de voir les octets qui n’ont pas été modifiés par \fBinet_net_pton\fP(). Un exemple où \fBinet_net_pton\fP() déduit le nombre de bits de l'adresse réseau\ : .in +4n .nf $ \fB./a.out 193.168\fP inet_net_pton() a renvoyé\ : 24 inet_net_ntop() a produit\ : 193.168.0/24 Adresse brute\ : c1a80000 .fi .in Démontrer que \fBinet_net_pton\fP() ne met pas à zéro les octets inutilisés du tampon de résultat\ : .in +4n .nf $ \fB./a.out 193.168 0xffffffff\fP inet_net_pton() a renvoyé\ : 24 inet_net_ntop() a produit\ : 193.168.0/24 Adresse brute\ : c1a800ff .fi .in Démontrer que \fBinet_net_pton\fP() élargira la taille supposée du numéro de réseau si le nombre d’octets fournis dans la chaîne de présentation dépasse la valeur supposée\ : .in +4n .nf $ \fB./a.out 193.168.1.128\fP inet_net_pton() a renvoyé\ : 32 inet_net_ntop() a produit\ : 193.168.1.128/32 Adresse brute\ : c1a80180 .fi .in Définir explicitement la taille de l'adresse réseau outrepasse toute déduction au sujet de sa taille (mais tous les octets en trop explicitement définis seront tout de même utilisés par \fBinet_net_pton\fP() pour remplir le tampon de résultat). .in +4n .nf $ \fB./a.out 193.168.1.128/24\fP inet_net_pton() a renvoyé\ : 24 inet_net_ntop() a produit\ : 193.168.1/24 Adresse brute\ : c1a80180 .fi .in .SS "Source du programme" .nf /* Effectuer l'édition des liens avec \-lresolv */ #include #include #include #define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e } while (0) int main(int argc, char *argv[]) { char buf[100]; struct in_addr addr; int bits; if (argc < 2) { fprintf(stderr, "Utilisation\ : %s forme\-présentation [val\-adr\-init]\en", argv[0]); exit(EXIT_FAILURE); } /* Si argv[2] est fourni (une valeur numérique), l'utiliser pour initialiser le tampon de sortie fourni à inet_net_pton(), afin de montrer que inet_net_pton() n'initialise que les octets nécessaires pour stocker l'adresse réseau. Si argv[2] n'est pas fourni, alors initialiser le tampon à zéro (ce qui est une bonne pratique). */ addr.s_addr = (argc > 2) ? strtod(argv[2], NULL) : 0; /* Convertir le numéro de réseau sous forme de présentation argv[1] sous forme binaire */ bits = inet_net_pton(AF_INET, argv[1], &addr, sizeof(addr)); if (bits == \-1) errExit("inet_net_ntop"); printf("inet_net_pton() a renvoyé\ : %d\en", bits); /* Reconvertir de la forme binaire au format de présentation, en utilisant «\ bits\ » renvoyé par inet_net_pton() */ if (inet_net_ntop(AF_INET, &addr, bits, buf, sizeof(buf)) == NULL) errExit("inet_net_ntop"); printf("inet_net_ntop() a produit\ : %s\en", buf); /* Afficher «\ aqaddr\ » sous forme brute (en ordre d’octets du réseau), pour permettre de voir les octets non affichés par inet_net_ntop()\ ; certains de ces octets pourraient ne pas avoir été modifiés par inet_net_ntop(), et avoir toujours la valeur initiale qui était indiquée argv[2]. */ printf("Adresse brute\ : %x\en", htonl(addr.s_addr)); exit(EXIT_SUCCESS); } .fi .SH "VOIR AUSSI" \fBinet\fP(3), \fBnetworks\fP(5) .SH COLOPHON Cette page fait partie de la publication 3.65 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%http://www.kernel.org/doc/man\-pages/. .SH TRADUCTION Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a par l'équipe de traduction francophone au sein du projet perkamon . .PP .PP Veuillez signaler toute erreur de traduction en écrivant à ou par un rapport de bogue sur le paquet \fBmanpages\-fr\fR. .PP Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande «\ \fBman\ \-L C\fR \fI
\fR\ \fI\fR\ ».