Linux API. Исчерпывающее руководство

• AI_CANONNAME — если аргумент host не равен NULL, то возвращает указатель на строку с каноническим именем узла с нулевым символом в конце. Указатель возвращается в буфере, на который ссылается поле ai_canonname структуры addrinfo, полученной в аргументе result.

• AI_NUMERICHOST — делает так, что аргумент host интерпретируется как адрес, имеющий числовое представление. Это позволяет предотвратить поиск IP-адреса в ситуациях, когда он не требуется, поскольку данная операция может занимать существенное время.

• AI_NUMERICSERV — интерпретирует аргумент service как номер порта. Данный флаг предотвращает обращение к любой службе разрешения имен, потому что при установке аргументу service числового значения данный этап становится лишним.

• AI_PASSIVE — возвращает структуры с адресами сокетов, подходящие для пассивного открытия (то есть для слушающего сокета). В этом случае аргумент host должен быть равен NULL, а IP-адрес, хранящийся в итоговой структуре в аргументе result, будет универсальным (INADDR_ANY или IN6ADDR_ANY_INIT). Если данный флаг не установлен, то итоговые структуры с адресами подойдут для использования в вызовах connect() и sendto(). Если аргумент host равен NULL, то полученный адрес сокета будет замкнутым на себя (INADDR_LOOPBACK или IN6ADDR_LOOPBACK_INIT в зависимости от домена).

• AI_V4MAPPED — если в поле ai_family структуры hint было указано значение AF_INET6 и если не было найдено ни одного IPv6-адреса, то в качестве результата должны вернуться структуры с IPv4-адресами, совместимыми с IPv6. При указанном сочетании флагов AI_ALL и AI_V4MAPPED в аргумент result попадут структуры с IPv6- и IPv4-адресами (последние будут совместимы с IPv6).

Рис. 55.3. Структуры, выделяемые и возвращаемые функцией getaddrinfo()

Как уже отмечалось выше, при использовании флага AI_PASSIVE аргумент hint может быть равен NULL. Данное значение можно передать и аргументу service — в этом случае номер порта, возвращаемый в структурах с адресами, будет равен 0 (то есть нас интересуют только адреса). Однако аргументы host и service не могут быть равны NULL одновременно.

Если нам не нужно задавать какие-либо из вышеописанных критериев, то аргументу hints можно передать NULL; в этом случае подразумевается, что его поля ai_socktype и ai_protocol равны 0, ai_flags равен (AI_V4MAPPED | AI_ADDRCONFIG), а ai_family равен AF_UNSPEC (в библиотеке glibc специально предусмотрено отклонение от стандарта SUSv3, согласно которому поле ai_flags считается равным 0, если аргумент hints равен NULL).

55.10.2. Удаление списков со структурами addrinfo: freeaddrinfo()

Функция getaddrinfo() динамически выделяет память для всех структур, на которые указывает result (см. рис. 55.3). Следовательно, когда эти структуры больше не нужны, вызывающему процессу нужно освободить занимаемые ими ресурсы. Для выполнения данной процедуры за один вызов предусмотрена функция freeaddrinfo().

#include

#include

void freeaddrinfo(struct addrinfo *result);

Если нужно сохранить копию одной из структур addrinfo или связанную с ней структуру с адресом сокета, то перед вызовом freeaddrinfo() их нужно продублировать.

55.10.3. Выявление ошибок: gai_strerror()

В случае ошибки функция getaddrinfo() возвращает один из ненулевых кодов, перечисленных в табл. 55.1.

Таблица 55.1. Ошибки, возвращаемые функциями getaddrinfo() и getnameinfo()

Ошибка — Описание

EAI_ADDRFAMILY — У узла host нет адресов в семействе hints.ai_family (не входит в стандарт SUSv3, но поддерживается большинством реализаций; только для getaddrinfo())

EAI_AGAIN — Временный сбой при разрешении имени (нужно попробовать позже)

EAI_BADFLAGS — В поле hints.ai_flags был указан некорректный флаг

EAI_FAIL — При доступе к DNS-серверу произошла необратимая ошибка

EAI_FAMILY — Семейство адресов, заданное в поле hints.ai_family, не поддерживается

EAI_MEMORY — Сбой при выделении памяти

EAI_NODATA — С именем host не связан ни один адрес (не входит в стандарт SUSv3, но поддерживается большинством реализаций; только для getaddrinfo())

EAI_NONAME — Неизвестные имена host или service, оба аргумента host и service равны NULL, либо же был задан флаг AI_NUMERICSERV, а строка, на которую указывает service, не содержит число

EAI_OVERFLOW — Переполнение буфера в аргументе

EAI_SERVICE — Заданная служба service не поддерживается типом hints.ai_socktype (только для getaddrinfo())

EAI_SOCKTYPE — Заданный тип hints.ai_socktype не поддерживается (только для getaddrinfo())

EAI_SYSTEM — Системная ошибка, возвращенная в глобальной переменной errno

Функция gai_strerror() возвращает строку с описанием одной из ошибок, перечисленных в табл. 55.1 (эти описания обычно более короткие, чем те, что представлены выше).

#include

const char *gai_strerror(int errcode);

Возвращает указатель на строку, содержащую сообщение об ошибке