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

  
11.8. Функция freeaddrinfo
 
Вся память, занимаемая структурами 
addrinfo
, структурами 
ai_addr
 и строкой 
ai_canonname
, которые возвращаются функцией 
getaddrinfo
, динамически выделяется функцией 
malloc
. Эта память освобождается при вызове функции 
freeaddrinfo
.
#include <netdb.h>
void freeaddrinfo(struct addrinfo *<i>ai</i>);
Переменная 
ai
 должна указывать на первую из структур 
addrinfo
, возвращаемых функцией 
getaddrinfo
. Освобождается вся область памяти, занятая структурами из связного списка, вместе с динамически выделенной областью памяти, содержащей данные, на которые указывают эти структуры (например, структуры адресов сокетов и канонические имена узлов).
Предположим, что мы вызываем функцию 
getaddrinfo
, проходим последовательно по всему связному списку структур 
addrinfo
 и находим нужную структуру. Если далее мы попытаемся сохранить нужную нам информацию простым копированием структуры 
addrinfo
, а затем вызовем функцию 
freeaddrinfo
, мы получим скрытую ошибку. Причина в том, что структура 
addrinfo
 сама указывает на динамически выделенный участок памяти (для структуры адреса сокета и, возможно, для канонического имени). Но эта область памяти, на которую указывает сохраненная нами структура, при вызове функции 
freeaddrinfo
 освобождается и может использоваться для хранения какой-либо иной информации.
 
ПРИМЕЧАНИЕ
 
Создание копии только самой структуры addrinfo, а не структур, на которые она, в свою очередь, указывает, называется поверхностным копированием (shallow сору). Копирование структуры addrinfo и всех структур, на которые она указывает, называется детальным копированием (deep сору).
 
  
11.9. Функция getaddrinfo: IPv6
 
Стандарт POSIX определяет как 
getaddrinfo
, так и возвращаемые этой функцией данные для протоколов IPv4 и IPv6. Отметим следующие моменты, прежде чем свести возвращаемые значения воедино в табл. 11.3.
■ Входные данные функции 
getaddrinfo
 могут относиться к двум различным типам, которые выбираются в зависимости от того, какой тип структуры адреса сокета вызывающий процесс хочет получить обратно и какой тип записей нужно искать в DNS или иной базе данных.
■ Семейством адресов, указанным вызывающим процессом в структуре 
hints
, задается тип структуры адреса сокета, который вызывающий процесс предполагает получить. Если вызывающий процесс задает 
AF_INET
, функция не должна возвращать структуры 
sockaddr_in6
, а для 
AF_INET6
 функция не должна возвращать структур 
sockaddr_in
.
■ POSIX утверждает, что при задании семейства 
AF_UNSPEC
 должны возвращаться адреса, которые могут использоваться с любым семейством протоколов, допускающим применение имени узла и имени службы. Это подразумевает, что если у узла имеются как записи типа AAAA, так и записи типа А, то записи типа AAAA возвращаются как структуры 
sockaddr_in6
, а записи типа A — как структуры 
sockaddr_in
. Нет смысла возвращать еще и записи типа А как адреса IPv4, преобразованные к виду IPv6, в структурах 
sockaddr_in6
, потому что при этом не возвращается никакой дополнительной информации — эти адреса уже возвращены в структурах 
sockaddr_in
.
  
■ Это утверждение POSIX также подразумевает, что если флаг 
AI_PASSIVE
 задан без имени узла, то должен быть возвращен универсальный адрес IPv6 (
IN6ADDR_ANY_INIT
 или 0::0) в структуре 
sockaddr_in6
 вместе с универсальным адресом IPv4 (
INADDR_ANY
 или 0.0.0.0) в структуре 
sockaddr_in
. Также нет смысла возвращать сначала универсальный адрес IPv4, поскольку мы увидим в разделе 12.2, что на узле с двойным стеком сокет сервера IPv6 может обрабатывать и клиенты IPv4, и клиенты IPv6.
■ Семейство адресов, указанное в поле 
ai_family
 структуры 
hint
 вместе с флагами 
AI_V4MAPPED
 и 
AI_ALL
 поля 
ai_flags
, задают тип записей, поиск которых ведется в DNS (тип А или тип AAAA), и тип возвращаемых адресов (IPv4, IPv6 или IPv4, преобразованные к виду IPv6). Мы обобщили это в табл. 11.3.
■ Имя узла может также быть либо шестнадцатеричной строкой IPv6, либо строкой в точечно-десятичной записи IPv4. Допустимость этой строки зависит от семейства адресов, заданного вызывающим процессом. Шестнадцатеричная строка IPv6 неприемлема, если задано семейство 
AF_INET
, а строка в точечно-десятичной записи IPv4 неприемлема, если задано семейство 
AF_INET6
. Но если задано семейство 
AF_UNSPEC
, то допустимы оба варианта, и при этом возвращается соответствующий тип структуры адреса сокета.
 
ПРИМЕЧАНИЕ
 
Можно возразить, что если в качестве семейства протоколов задано AF_INET6, строка в точечно-десятичной записи должна возвращаться как адрес IPv4, преобразованный к виду IPv6 в структуре sockaddr_in6. Но другим способом получения этого результата является установка префикса строки с десятичной точкой 0::ffff:.
 
В табл. 11.3 показано, как будут обрабатываться адреса IPv4 и IPv6 функцией 
getaddrinfo
. Колонка «Результат» отражает то, что мы хотим возвратить вызывающему процессу, если входные переменные таковы, как показано в первых трех колонках. Колонка «Действия» — то, каким образом мы получаем этот результат.
Таблица 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)