inet_net_pton()¶

Функция inet_net_pton() преобразует pres, строку с null в конце, содержащую номер сети Интернета в представленческом формате, в сетевой формат. Результат преобразования с сетевым порядком байт помещается в буфер, указанный в net (аргумент netp, обычно, указывает на структуру in_addr). В аргументе nsize задаётся количество доступных байт в netp.

При успешном выполнении inet_net_pton() возвращает количество бит в поле номера сети результата, помещённого в netp. Обсуждение входного представленческого формата и возвращаемое значение смотрите в ЗАМЕЧАНИЯХ.

Замечание: буфер, указанный в netp, должен быть заполнен нулями до вызова inet_net_pton(), так как вызов изменяет только байты, необходимые для номера сети (или сколько явно указано в pres), что может быть меньше, чем байт в полном адресе сети.

inet_net_ntop()¶

Функция inet_net_ntop() преобразует номер сети в буфере, указанном в netp, в представленческий формат; значение *netp рассматривается в сетевом порядке байт. В аргументе bits задаётся количество бит в номере сети из *netp.

Строка в представленческом формате с null в конце помещается в буфер, на который указывает pres. В аргументе psize задаётся количество байт, доступных в pres. Представленческая строка имеет формат CIDR: адрес сети в виде чисел, разделённых точками, затем косая черта и размер сети в битах.

Представленческий формат входных данных inet_net_pton()¶

Номер сети может задаваться в виде шестнадцатеричного значения или в точечно-десятичной форме.

Шестнадцатеричное значение определяется по начальному «0x» или «0X». Шестнадцатеричные цифры заполняют полубайты (половина октета) номера сети слева направо в сетевом порядке байт.

В точечно-десятичной форме указываются, максимум, первые четыре октета, с помощью десятичных чисел и точек. То есть можно использовать следующие форматы:

a.b.c.d
a.b.c
a.b
a

Каждая часть — это число от 0 до 255, которое заполняет один байт получаемого номера сети; заполнение производится слева направо, в сетевом порядке байт (от старшего к младшему). Если часть пропущена, то байт результата в номере сети равно нулю.

В шестнадцатеричном или точечно-десятичном формате номер сети может содержать косую черту и число от 0 до 32, которое задаёт размер сети в битах.

Возвращаемое значение inet_net_pton()¶

Возвращаемым значением inet_net_pton() является количество бит поля номера сети. Если входная строка представленческих данных заканчивается косой чертой и явным значением размера, то это значение является результатом inet_net_pton(). В противном случае возвращаемое значение, bits, определяется следующим образом:

• Если наиболее значимый байт номер сети больше или равен 240, то bits равно 32.
• Или же, если наиболее значимый байт номер сети больше или равен 224, то bits равно 4.
• Или же, если наиболее значимый байт номер сети больше или равен 192, то bits равно 24.
• Или же, если наиболее значимый байт номер сети больше или равен 128, то bits равно 16.
• В противном случае bits равно 8.

Если значение результата bits после определения больше или равно 8, но количество октетов, указанных в номере сети, превышает bits/8, то bits присваивается 8 кратное количество октетов, указанных на самом деле.

Исходный код программы¶

/* Компоновать с «-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,


                "Использование: %s представленческая-форма \


                                   [начальное-значение-адреса]\n",


                argv[0]);


        exit(EXIT_FAILURE);


    }


    /* Если указан argv[2] (число), то использовать его для инициализации


       буфера результата, передаваемого inet_net_pton() для того, чтобы


       мы могли увидеть, что inet_net_pton() инициализирует только те


       байты, которые нужны для номера сети. Если argv[2] не указан, то


       буфер инициализируется нулями (как рекомендуется). */


    addr.s_addr = (argc > 2) ? strtod(argv[2], NULL) : 0;


    /* Преобразование представленческого формата номера сети


       из argv[1] в двоичный */


    bits = inet_net_pton(AF_INET, argv[1], &addr, sizeof(addr));


    if (bits == -1)


        errExit("inet_net_ntop");


    printf("inet_net_pton() вернула: %d\n", bits);


    /* Преобразование двоичного формата обратно в представленческий,


       используя значение «bits», возвращённое inet_net_pton() */


    if (inet_net_ntop(AF_INET, &addr, bits, buf, sizeof(buf)) == NULL)


        errExit("inet_net_ntop");


    printf("inet_net_ntop() выдала:  %s\n", buf);


    /* Показать «addr» в необработанном виде (в сетевом порядке байт)


       для того, чтобы мы могли увидеть байты, не отображаемые


       inet_net_ntop(); некоторые из этих байт могут быть не изменены


       inet_net_ntop(), и поэтому будут содержать любое начальное


       значение, которое было задано в argv[2]. */


    printf("Необработанный адрес:            %x\n", htonl(addr.s_addr));


    exit(EXIT_SUCCESS);
}