inet_net_pton()¶

The inet_net_pton() function converts pres, a null-terminated string containing an Internet network number in presentation format to network format. The result of the conversion, which is in network byte order, is placed in the buffer pointed to by netp. (The netp argument typically points to an in_addr structure.) The nsize argument specifies the number of bytes available in 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 кратное количество октетов, указанных на самом деле.

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

/* Link with "-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,


                "Usage: %s presentation-form [addr-init-value]\n",


                argv[0]);


        exit(EXIT_FAILURE);


    }


    /* If argv[2] is supplied (a numeric value), use it to initialize


       the output buffer given to inet_net_pton(), so that we can see


       that inet_net_pton() initializes only those bytes needed for


       the network number. If argv[2] is not supplied, then initialize


       the buffer to zero (as is recommended practice). */


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


    /* Convert presentation network number in argv[1] to binary. */


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


    if (bits == -1)


        errExit("inet_net_ntop");


    printf("inet_net_pton() returned: %d\n", bits);


    /* Convert binary format back to presentation, using 'bits'


       returned by inet_net_pton(). */


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


        errExit("inet_net_ntop");


    printf("inet_net_ntop() yielded:  %s\n", buf);


    /* Display 'addr' in raw form (in network byte order), so we can


       see bytes not displayed by inet_net_ntop(); some of those bytes


       may not have been touched by inet_net_ntop(), and so will still


       have any initial value that was specified in argv[2]. */


    printf("Raw address:              %x\n", htonl(addr.s_addr));


    exit(EXIT_SUCCESS);
}