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

11.8. Функция freeaddrinfo

Вся память, занимаемая структурами

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

Переменная

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

Предположим, что мы вызываем функцию

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

11.9. Функция getaddrinfo: IPv6

Стандарт POSIX определяет как

, так и возвращаемые этой функцией данные для протоколов IPv4 и IPv6. Отметим следующие моменты, прежде чем свести возвращаемые значения воедино в табл. 11.3.

■ Входные данные функции

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

■ Семейством адресов, указанным вызывающим процессом в структуре

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

■ POSIX утверждает, что при задании семейства

должны возвращаться адреса, которые могут использоваться с любым семейством протоколов, допускающим применение имени узла и имени службы. Это подразумевает, что если у узла имеются как записи типа AAAA, так и записи типа А, то записи типа AAAA возвращаются как структуры , а записи типа A — как структуры . Нет смысла возвращать еще и записи типа А как адреса IPv4, преобразованные к виду IPv6, в структурах , потому что при этом не возвращается никакой дополнительной информации — эти адреса уже возвращены в структурах .

■ Это утверждение POSIX также подразумевает, что если флаг

задан без имени узла, то должен быть возвращен универсальный адрес IPv6 ( или 0::0) в структуре вместе с универсальным адресом IPv4 ( или 0.0.0.0) в структуре . Также нет смысла возвращать сначала универсальный адрес IPv4, поскольку мы увидим в разделе 12.2, что на узле с двойным стеком сокет сервера IPv6 может обрабатывать и клиенты IPv4, и клиенты IPv6.

■ Семейство адресов, указанное в поле

структуры вместе с флагами и поля , задают тип записей, поиск которых ведется в DNS (тип А или тип AAAA), и тип возвращаемых адресов (IPv4, IPv6 или IPv4, преобразованные к виду IPv6). Мы обобщили это в табл. 11.3.

■ Имя узла может также быть либо шестнадцатеричной строкой IPv6, либо строкой в точечно-десятичной записи IPv4. Допустимость этой строки зависит от семейства адресов, заданного вызывающим процессом. Шестнадцатеричная строка IPv6 неприемлема, если задано семейство

, а строка в точечно-десятичной записи IPv4 неприемлема, если задано семейство . Но если задано семейство , то допустимы оба варианта, и при этом возвращается соответствующий тип структуры адреса сокета.

В табл. 11.3 показано, как будут обрабатываться адреса IPv4 и IPv6 функцией

. Колонка «Результат» отражает то, что мы хотим возвратить вызывающему процессу, если входные переменные таковы, как показано в первых трех колонках. Колонка «Действия» — то, каким образом мы получаем этот результат.

Таблица 11.3. Функция getaddrinfo: ее действия и результаты

Имя узла, указанное вызывающим процессом	Семейство адресов, указанное вызывающим процессом	Строка с именем узла содержит	Результат	Действия
Ненулевая строка с именем узла; активное или пассивное открытие	AF_UNSPEC	Имя узла	Все записи AAAA возвращаются как структуры sockaddr_in6{} и все записи А возвращаются как структуры sockaddr_in{}	Поиск по записям AAAA и поиск по записям A
		Шестнадцатеричная строка	Одна структура sockaddr_in6{}	inet_pton(AF_INET6)
		Строка в точечно- десятичной записи	Одна структура sockaddr_in{}	inet_pton(AF_INET)
	AF_INET6	Имя узла	Все записи AAAA возвращаются как структуры sockaddr_in6{} либо все записи А возвращаются как структуры sockaddr_in6{} с адресами IPv4, преобразованными к виду IPv6	Поиск по записям AAAA
		Шестнадцатеричная строка	Одна структура sockaddr_in6{}	inet_pton(AF_INET6)
		Строка в точечно-десятичной записи	Ищется как имя узла
	AF_INET	Имя узла	Все записи А возвращаются как структуры sockaddr_in{}	Поиск по записям типа A
		Шестнадцатеричная строка	Ошибка: EAI_ADDRFAMILY
		Строка в точечно-десятичной записи	Одна структура sockaddr_in{}	inet_pton(AF_INET)
Пустая строка с именем узла; пассивное открытие	AF_UNSPEC	Неявный адрес 0::0 Неявный адрес 0.0.0.0	Одна структура sockaddr_in6{} и одна структура sockaddr_in{}	inet_pton(AF_INET6) inet_pton(AF_INET)
	AF_INET6	Неявный адрес 0::0	Одна структура sockaddr_in6{}	inet_pton(AF_INET6)
	AF_INET	Неявный адрес 0.0.0.0	Одна структура sockaddr_in{}	inet_pton(AF_INET)
Пустая строка с именем узла; активное открытие	AF_UNSPEC	Неявный адрес 0::1 Неявный адрес 127.0.0.1	Одна структура sockaddr_in6{} и одна структура sockaddr_in{}	inet_pton(AF_INET6) inet_pton(AF_INET)
	AF_INET6	Неявный адрес 0::1	Одна структура sockaddr_in6{}	inet_pton(AF_INET6)
	AF_INET	Неявный адрес 127.0.0.1	Одна структура sockaddr_in{}	inet_pton(AF_INET)