Майкл Джонсон - Разработка приложений в среде Linux. Второе издание

AI_PASSIVE

Если hostname равен NULLи присутствует этот флаг, то возвращается неустановленный адрес, который позволяет ожидать соединений на всех интерфейсах. Если данный флаг не указан (а значение hostnameравно NULL), возвращается адрес обратной связи [135] Адрес обратной связи — это специальный адрес, который позволяет программам взаимодействовать через TCP/IP с приложениями только на одной и той же машине. .

Последний параметр resв getaddrinfo()должен быть адресом указателя на struct addrinfo. Для успешного завершения переменная, на которую указывает res, устанавливается на первую запись в односвязном списке адресов, который соответствует запросу. Член ai_nextструктуры struct addrinfoуказывает на следующий член связного списка, и для последнего узла в списке параметр ai_nextравен NULL.

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

#include

#include

#include

void freeaddrinfo(struct addrinfo * res);

Единственным параметром для freeaddrinfoявляется указатель на первый узел в списке.

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

Каждый узел содержит описанную ниже информацию.

• ai_family— семейство протоколов ( PF_INETили PF_INET6), к которому принадлежит адрес.

• ai_socktype— тип соединения для адреса (как правило, принимает одно из значений SOCK_STREAM, SOCK_DGRAMили SOCK_RAW).

• ai_protocol— протокол для адреса (обычно IPPROTO_TCPили IPPROTO_UDP).

• Если в параметре hintsбыл указан флаг AI_CANONNAME, то ai_canonnameсодержит каноническое имя для адреса.

• ai_addrуказывает на struct sockaddrдля соответствующего протокола. Например, если ai_familyпринимает значение PF_INET, то ai_addrуказывает на struct sockaddr_in. Член ai_addrlenопределяет длину структуры, на которую указывает ai_addr.

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

• Если не был передан параметр hostname, то номера портов устанавливаются для каждого адреса, однако в качестве IP-адреса определяется или адрес обратной связи, или неустановленный адрес (как указывалось ранее в описании флага AI_PASSIVE).

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

1: /* clientlookup.c */

2:

3: #include

4: #include

5: #include

6:

7: int main(int argc, const char ** argv) {

8: struct addrinfo hints, * addr;

9: const char * host = argv[1], * service = argv[2];

10: int rc;

11:

12: if (argc != 3) {

13: fprintf(stderr, "требуется в точности два аргумента\n");

14: return 1;

15: }

16:

17: memset(&hints, 0, sizeof(hints));

18:

19: hints.ai_socktype = SOCK_STREAM;

20: hints.ai_flags = AI_ADDRCONFIG;

21: if ((rc = getaddrinfo(host, service, &hints, &addr)))

22: fprintf(stderr, "сбой поиска\n");

23: else

24: freeaddrinfo(addr);

25:

26: return 0;

27: }

Давайте обратим внимание на строки 17–24 этой программы. После очистки структуры hints приложение запрашивает адреса SOCK_STREAM, которые используют протокол, сконфигурированный на локальной системе (путем установки флага AI_ADDRCONFIG). Затем активизируется функция getaddrinfo()с именем хоста, именем службы, подсказками и в случае невозможности найти соответствие отображается сообщение об ошибке. Если все проходит нормально, то первый элемент в связном списке, на который указывает addr, представляет собой соответствующий адрес, который программа может использовать для установки соединения с указанной службой и хостом. Программа не решает, через какой протокол (IPv4 или IPv6) соединение будет лучшим.