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

connect error: Operation timed out
trying 140.252.1.4:13
connect error: Operation timed out
trying 140.252.104.1:13
connect error: Connection refused
unable to connect
  
11.6. Функция getaddrinfo
 
Функции 
gethostbyname
 и 
gethostbyaddr
 поддерживают только IPv4. Интерфейс IPv6 разрабатывался в несколько этапов (история разработки описана в разделе 11.20), и в конечном итоге получилась функция 
getaddrinfo
. Последняя осуществляет трансляцию имен в адреса и служб в порты, причем возвращает она список структур 
sockaddr
, а не список адресов. Такие структуры могут непосредственно использоваться функциями сокетов. Благодаря этому функция 
getaddrinfo
 скрывает все различия между протоколами в библиотеке функций. Приложение работает только со структурами адресов сокетов, которые заполняются 
getaddrinfo
. Эта функция определяется стандартом POSIX.
 
ПРИМЕЧАНИЕ
 
Определение этой функции в POSIX происходит от более раннего предложения Кейта Склоуэра (Keith Sklower) для функции, называемой getconninfo. Эта функция стала результатом обсуждений с Эриком Олменом (Eric Allman), Вилльямом Дастом (William Durst), Майклом Карелсом (Michael Karels) и Стивеном Вайсом (Steven Wise), а также более ранней реализации, написанной Эриком Олменом. Замечание о том, что указания имени узла и имени службы достаточно для соединения с этой службой независимо от деталей протокола, было сделано Маршалом Роузом (Marshall Rose) в проекте X/Open.
 
#include <netdb.h>
int getaddrinfo(const char *<i>hostname</i>, const char *<i>service</i>,
 const struct addrinfo *<i>hints</i>, struct addrinfo **<i>result</i>);
<i>Возвращает: 0 в случае успешного выполнения, ненулевое значение в случае ошибки</i>
<i>(см. табл. 11.2).</i>
Через указатель 
result
 функция возвращает указатель на связный список структур 
addrinfo
, который задается в заголовочном файле 
&lt;netdb.h&gt;
:
struct addrinfo {
 int    ai_flags;          /* AI_PASSIVE, AI_CANONNAME */
 int    ai_family;         /* AF_xxx */
 int    ai_socktype;       /* SOCK_xxx */
 int    ai_protocol;       /* 0 или IPPROTO_xxx для IPv4 и IPv6 */
 size_t ai_addrlen;        /* длина ai_addr */
 char*  ai_canonname;      /* указатель на каноническое имя узла */
 struct sockaddr *ai_addr; /* указатель на структуру адреса сокета */
 struct addrinfo *ai_next; /* указатель на следующую структуру в связном
                              списке */
};
Переменная 
hostname
 — это либо имя узла, либо строка адреса (точечно-десятичная запись для IPv4 или шестнадцатеричная строка для IPv6). Переменная 
service
 — это либо имя службы, либо строка, содержащая десятичный номер порта. (См. также упражнение 11.4.)
  
Аргумент 
hints
 — это либо пустой указатель, либо указатель на структуру 
addrinfo
, заполненную рекомендациями вызывающего процесса о типах информации, которую он хочет получить. Например, если заданная служба предоставляется и для TCP, и для UDP (служба 
domain
, которая ссылается на сервер DNS), вызывающий процесс может присвоить элементу 
ai_socktype
 структуры 
hints
 значение 
SOCK_DGRAM
. Тогда возвращение информации будет иметь место только для дейтаграммных сокетов.
Вызывающим процессом могут быть установлены значения следующих элементов структуры 
hints
:
■ 
ai_flags
 (несколько констант 
AI_XXX
, объединенных операцией ИЛИ);
■ 
ai_family
 (значение 
AF_xxx
);
■ 
ai_socktype
 (значение 
SOCK_xxx
);
■ 
ai_protocol
.
Поле 
ai_flags
 может содержать следующие константы:
■ 
AI_PASSIVE
 указывает, что сокет будет использоваться для пассивного открытия;
■ 
AI_CANONNAME
 указывает функции на необходимость возвратить каноническое имя узла;
■ 
AI_NUMERICHOST
 запрещает преобразование между именами и адресами. Аргумент 
hostname
 должен представлять собой строку адреса;
■ 
AI_NUMERICSERV
 запрещает преобразование между именами служб и номерами портов. Аргумент 
service
 должен представлять собой строку с десятичным номером порта;
■ 
AI_V4MAPPED
 вместе с 
ai_family = AF_INET6
 указывает функции на необходимость вернуть адреса IPv4 из записей А, преобразованные к IPv6, если записи типа AAAA отсутствуют;
■ 
AI_ALL
 при указании вместе с 
AI_V4MAPPED
 говорит о необходимости вернуть адреса IPv4, преобразованные к IPv6, вместе с истинными адресами IPv6;
■ 
AI_ADDRCONFIG
 возвращает адреса, относящиеся к заданной версии IP, когда имеется несколько интерфейсов, имеющих IP-адреса другой версии.
Если аргументом структуры 
hints
 является пустой указатель, функция подразумевает нулевое значение для 
ai_flags
, 
ai_socktype
 и 
ai_protocol
 и значение 
AF_UNSPEC
 для 
ai_family
.
Если функция завершается успешно (0), то в переменную, на которую указывает аргумент 
result
, записывается указатель на список структур 
addrinfo
, связанных через указатель 
ai_next
. Имеется два способа возвращения множественных структур.
1. Если существует множество адресов, связанных с узлом 
hostname
, то одна структура возвращается для каждого адреса, который может использоваться с запрашиваемым семейством адресов (значение 
ai_family
, если задано).