inet_net_pton()¶

La fonction inet_net_pton() convertit pres, 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 net. (Le paramètre netp pointe typiquement vers une structure in_addr.) Le paramètre nsize indique le nombre d'octets disponibles dans netp.

En cas de réussite, inet_net_pton() renvoie le nombre de bits dans le champ de numéro de réseau du résultat placé dans netp. Pour une discussion sur le format de présentation de l’entrée et la valeur de retour, consultez NOTES.

Remarque : le tampon pointé par netp devrait être mis à zéro avant d’appeler inet_net_pton() puisque l’appel n’écrit que le nombre d’octets nécessaire pour le numéro de réseau (ou qu’explicitement indiqué par pres), ce qui pourrait être moins que le nombre d’octets dans une adresse de réseau complète.

inet_net_ntop()¶

La fonction inet_net_ntop() convertit le numéro de réseau dans le tampon pointé par netp au format de présentation ; *netp est interprété comme une valeur dans l’ordre d’octets du réseau. L’argument bits indique le nombre de bits dans le numéro de réseau *netp.

La chaîne au format de présentation terminée par NULL est placée dans le tampon pointé par pres. L’argument psize indique le nombre d’octets disponibles dans pres. 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.

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.

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

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.

Valeur de retour de inet_net_pton()¶

La valeur de retour de inet_net_pton() 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 inet_net_pton(). Sinon, la valeur de retour, bits, est supposée comme suit.

• Si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 240, alors bits vaut 32.
• Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 224, alors bits vaut 4.
• Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 192, alors bits vaut 24.
• Sinon, si l'octet de poids fort de l'adresse réseau est supérieur ou égal à 128, alors bits vaut 16.
• Sinon bits vaut 8.

Si la valeur de bits 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 bits/8, alors bits est défini à huit fois le nombre d’octets vraiment indiqué.

Source du programme¶

/* Effectuer l'édition des liens avec "-lresolv" */
#include <arpa/inet.h>
#include <stdio.h>
#include <stdlib.h>
#define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \


                        } 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]\n",


                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\n", 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\n", 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\n", htonl(addr.s_addr));


    exit(EXIT_SUCCESS);
}