Linux repositories inspector

inet_net_pton(3) - Russkiy

Linux
2019-03-06
Aliases: inet_net_ntop(3), inet_net_ntop(3), inet_net_ntop(3), inet_net_ntop(3), inet_net_ntop(3), inet_net_ntop(3)

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

inet_net_pton, inet_net_ntop - преобразует номер сети Интернета

ОБЗОР

#include <arpa/inet.h>

int inet_net_pton(int af, const char *pres, void *netp, size_t nsize);
char *inet_net_ntop(int af, const void *netp, int bits, char *pres, size_t psize);
Компонуется при указании параметра -lresolv.
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
inet_net_pton(), inet_net_ntop():
Начиная с glibc 2.20:
_DEFAULT_SOURCE
До glibc 2.20:
_BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

Эти функции преобразуют номера сетей, представленных в сетевом формате (т. е. двоичном), в представленческий формат (т. е., печатаемый) и обратно.
В обоих функциях в af задаётся адресное семейство для преобразования; поддерживается только значение AF_INET.

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() возвращает количество бит в номере сети. При ошибке возвращается -1, а в errno содержится код ошибки.
При успешном выполнении inet_net_ntop() возвращается pres. При ошибке возвращается NULL, а в errno содержится код ошибки.

ОШИБКИ

EAFNOSUPPORT
В af указано значение, отличное от AF_INET.
EMSGSIZE
Размер буфера результата недостаточен.
ENOENT (inet_net_pton()) Значение pres имеет некорректный представленческий формат.

СООТВЕТСТВИЕ СТАНДАРТАМ

Функции inet_net_pton() и inet_net_ntop() являются нестандартными, но широко распространены.

ЗАМЕЧАНИЯ

Представленческий формат входных данных 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 кратное количество октетов, указанных на самом деле.

ПРИМЕР

Программа, представленная далее, показывает использование inet_net_pton() и inet_net_ntop(). В ней используется inet_net_pton() для преобразования адреса сети из значения в представленческом формате, переданном в первом аргументе командной строки, в двоичную форму; выводится полученное из inet_net_pton() значение. Затем используется inet_net_ntop() для преобразования двоичной формы обратно в представленческий формат, и выводится полученная строка.
Чтобы продемонстрировать, что inet_net_pton() может не записывать все байты аргумента netp, программе можно передать в командной строке необязательный второй аргумент — число, используемое для заполнения буфера перед вызовом inet_net_pton(). В строке результата программа показывает все байты буфера, возвращаемого inet_net_pton(), позволяя пользователю увидеть какие байты не изменялись inet_net_pton().
Пример работы, показывающий, как inet_net_pton() прогнозирует количество бит в номере сети:
$ ./a.out 193.168 inet_net_pton() вернула: 24 inet_net_ntop() выдала: 193.168.0/24 Необработанный адрес: c1a80000
Демонстрируется, как inet_net_pton() не обнуляет неиспользованные байты в буфере результата:
$ ./a.out 193.168 0xffffffff inet_net_pton() вернула: 24 inet_net_ntop() выдала: 193.168.0/24 Необработанный адрес: c1a800ff
Демонстрируется, как inet_net_pton() расширяет прогнозируемый размер номера сети, если полученное количество байт в представленческой строке превышает прогнозируемое значение:
$ ./a.out 193.168.1.128 inet_net_pton() вернула: 32 inet_net_ntop() выдала: 193.168.1.128/32 Необработанный адрес: c1a80180
Явно указанный размер номера сети заменяет любой прогнозируемый (но все дополнительные байты, указанные явно, всё равно будут использованы inet_net_pton() для заполнения буфера результата):
$ ./a.out 193.168.1.128/24 inet_net_pton() вернула: 24 inet_net_ntop() выдала: 193.168.1/24 Необработанный адрес: c1a80180

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

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

СМОТРИТЕ ТАКЖЕ

REFERENCED BY

⇧ Top