Если в структуре

установлен флаг , элемент первой возвращаемой структуры указывает на каноническое имя узла. В терминах DNS это обычно полное доменное имя (FQDN). Программы типа широко используют этот флаг для того, чтобы выводить канонические имена систем, к которым производится подключение. Пользователь может указать короткое имя узла или его альтернативное имя, но он должен знать, с какой системой он в результате соединился.

На рис. 11.3 представлена возвращаемая информация для следующего вызова:

На этом рисунке все, кроме переменной

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

Порт 53 предназначен для службы

, и нужно учитывать, что этот номер порта будет представлен в структурах адресов сокетов в сетевом порядке байтов. Мы приводим возвращаемые значения IPPROTO_TCP и IPPROTO_UDP. Функция может возвращать значение равное 0 для структур SOCK_STREAM, если этого достаточно для однозначного определения протокола (типа сокета недостаточно, например, если в системе помимо TCP реализован и SCTP), и 0 для структур SOCK_DGRAM, если в системе не реализованы другие протоколы дейтаграмм для IP (на момент написания этой книги стандартизованных протоколов еще не было, но два уже разрабатывались IETF). Лучше всего, если всегда будет возвращать конкретный тип протокола.

В табл. 11.1 показано число структур

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

Таблица 11.1. Число структур addrinfo, возвращаемых для каждого IP-адреса

Элемент ai_socktype	Служба обозначена именем и предоставляется:	Служба обозначена именем порта
Только TCP	Только UDP	Только SCTP	TCP и UDP	TCP и SCTP	TCP, UDP и SCTP
0	1	1	1	2	2	3	Ошибка
SOCK_STREAM	1	Ошибка	1	1	2	2	2
SOCK_DGRAM	Ошибка	1		1	Ошибка	1	1
SOCK_SEQPACKET	Ошибка	Ошибка	1	Ошибка	1	1	1

Более одной структуры

возвращается для каждого IP-адреса только в том случае, когда поле структуры пусто и либо служба поддерживается TCP и UDP (как указано в файле ), либо задан номер порта для этой службы.

Если бы мы рассматривали все 64 возможных варианта сочетаний входных данных для функции

(имеется шесть входных переменных), многие сочетания оказались бы недопустимыми, а некоторые не имели бы смысла. Вместо этого рассмотрим наиболее типичные случаи.

Задание имени узлаи службы. Это традиционный случай для клиента TCP и UDP. По завершении клиент TCP перебирает в цикле все возвращаемые IP-адреса, вызывая функции

и для каждого из них, пока не установится соединение или пока не будут перебраны все адреса. Мы показываем такой пример с нашей функцией в листинге 11.2.

Для клиента UDP структура адреса сокета, заполняемая с помощью функции

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

Если клиент знает, что он обрабатывает только один тип сокета (например, клиентами Telnet и FTP обрабатываются только сокеты TCP, а клиентами TFTP — только сокеты UDP), то элементу

структуры должно быть задано соответственно либо значение , либо значение .

Типичный сервер задает службу (service), но не имя узла (hostname), и задает флаг

в структуре . Возвращаемая структура адреса сокета должна содержать IP-адрес, равный (для IPv4) или (для IPv6). Сервер TCP затем вызывает функции , и . Если сервер хочет разместить в памяти с помощью функции другую структуру адреса сокета, чтобы получить адрес клиента из функции , то возвращаемое значение задает требуемый для этого размер.

Сервер UDP вызовет функции

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

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

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