Вызывающим процессом могут быть установлены значения следующих элементов структуры

:

(несколько констант , объединенных операцией ИЛИ);

(значение );

(значение );

.

Поле

может содержать следующие константы:

указывает, что сокет будет использоваться для пассивного открытия;

указывает функции на необходимость возвратить каноническое имя узла;

запрещает преобразование между именами и адресами. Аргумент должен представлять собой строку адреса;

запрещает преобразование между именами служб и номерами портов. Аргумент должен представлять собой строку с десятичным номером порта;

вместе с указывает функции на необходимость вернуть адреса IPv4 из записей А, преобразованные к IPv6, если записи типа AAAA отсутствуют;

при указании вместе с говорит о необходимости вернуть адреса IPv4, преобразованные к IPv6, вместе с истинными адресами IPv6;

возвращает адреса, относящиеся к заданной версии IP, когда имеется несколько интерфейсов, имеющих IP-адреса другой версии.

Если аргументом структуры

является пустой указатель, функция подразумевает нулевое значение для , и и значение для .

Если функция завершается успешно (0), то в переменную, на которую указывает аргумент

, записывается указатель на список структур , связанных через указатель . Имеется два способа возвращения множественных структур.

1. Если существует множество адресов, связанных с узлом

, то одна структура возвращается для каждого адреса, который может использоваться с запрашиваемым семейством адресов (значение , если задано).

2. Если служба предоставляется для множества типов сокетов, то одна структура может быть возвращена для каждого типа сокета в зависимости от

. (Заметьте, что большинство реализаций считают, что номер порта используется только тем типом сокета, который запрашивается в . Если аргумент не определен, функция возвращает ошибку.)

Например, если структура

пуста, а вы запрашиваете записи для службы на узле с двумя IP-адресами, возвращаются четыре структуры :

одна для первого IP-адреса и типа сокета SOCK_STREAM;

одна для первого IP-адреса и типа сокета SOCK_DGRAM;

одна для второго IP-адреса и типа сокета SOCK_STREAM;

одна для второго IP-адреса и типа сокета SOCK_DGRAM.

Мы показываем схематическое изображение этого примера на рис. 11.3. Не существует никакого гарантированного порядка структур при возвращении множества элементов. Например, мы не можем считать, что службы TCP возвращаются перед службами UDP.

Рис. 11.3. Пример информации, возвращаемой функцией getaddrinfo

ПРИМЕЧАНИЕ

Хотя это и не гарантируется, реализация должна возвращать IP-адреса в том же порядке, в котором они возвращаются DNS. Некоторые распознаватели позволяют администратору указывать порядок сортировки адресов в файле /etc/resolv.conf. Протокол IPv6 определяет правила выбора адресов (RFC 3484 [28]), которые могут влиять на порядок адресов, возвращаемых getaddrinfo.

Информация, возвращаемая в структурах

, готова для передачи функциям и или (для клиента) и (для сервера). Аргументы функции — это элементы , и . Второй и третий аргументы функций и — это элементы (указатель на структуру адреса сокета соответствующего типа, заполняемую функцией ) и (длина этой структуры адреса сокета).