UNIX: разработка сетевых приложений

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

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

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

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

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

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

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

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

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

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

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

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

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

установлен флаг , элемент первой возвращаемой структуры указывает на каноническое имя узла. В терминах 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 (как указано в файле ), либо задан номер порта для этой службы.