Троан Эрик В.
Шрифт:
Один из параметров может равняться
NULL
, при этом функция getnameinfo
не ищет соответствие имени для данного параметра. Параметры
hostlen
и servicelen
определяют, сколько байт доступно в буферах, на которые указывают hostname
и servicename
соответственно. Если ни одно имя не умещается в доступном пространстве, буфера переполняются и возвращается ошибка (EAI_OVERFLOW
). Последний аргумент
flags
изменяет способ, которым функция getnameinfo
производит поиск имен. Параметр должен быть равен нулю или принимать одно или несколько (объединенных логическим "ИЛИ") из описанных ниже значений. NI_DGRAM | Отыскивается имя службы UDP для указанного порта (вместо имени службы TCP). Примечание. Эти два имени почти всегда идентичны, однако существует несколько портов, определенных только для UDP-портов (протокол прерывания SNMP — один из них), и несколько случаев, когда один и тот же номер порта используется для различных TCP и UDP служб (например, порт 512 применяется и для TCP-службы exec , и для UDP-службы biff ). |
NI_NAMEREQD | Если преобразование IP-адреса в имя хоста завершается неудачей и установлен данный флаг, то функция getnameinfo возвращает ошибку. В противном случае она возвращает IP-адрес в формате с разделительными точками или двоеточиями. |
NI_NOFQDN | Имена хостов обычно возвращаются как полностью уточненные имена доменов. Это означает, что возвращается полное имя хоста, а не локальное сокращение. Если, к примеру, установлен данный флаг, вашим хостом является digit.iana.org , и вы ищете IP-адрес, соответствующий www.iana.org , тогда будет возвращено имя хоста www . Поиск имен хостов для остальных машин при этом не затрагивается (в предыдущем примере поиск адреса для www.ietf.org предоставит полное имя хоста www.ietf.org . |
NI_NUMERICHOST | Вместо выполнения поиска имен хостов функция getnameinfo преобразует IP-адрес в IP-адрес по аналогии с inet_ntop . |
NI_NUMERICSERV | Номер порта размещается в servicename в виде форматированной числовой строки (а не преобразуется в имя службы). |
Возвращаемые коды для
getnameinfo
— те же самые, что и для gethostinfо
; в случае успеха возвращается нуль, в случае неудачи — код ошибки. Полный перечень возможных ошибок приведен в табл. 17.3. Для преобразования этих ошибок в описательные строки служит функция gai_strerror
. Ниже приведен пример, показывающий использование
getnameinfo
для выполнения обратного поиска имени для адресов IPv4 и IPv6. $ ./reverselookup --host ::1
hostname: localhost
$ ./reverselookup --host 127.0.0.1
hostname: localhost
$ ./reverselookup --host 3ffe:b00:c18:1::10
hostname: www.6bone.net
$ ./reverselookup --host 206.123.31.124 --service 80
hostname: www.6bone.net service name: http
1: /* reverselookup.с */
2:
3: #include <netdb.h>
4: #include <arpa/inet.h>
5: #include <netinet/in.h>
6: #include <stdio.h>
7: #include <string.h>
8: #include <stdlib.h>
9:
10: /* Вызывается, если во время обработки командной строки происходит ошибка;
11: отображает короткое сообщение для пользователя и завершается. */
12: void usage(void) {
13: fprintf(stderr, "использование: reverselookup [--numerichost] "
14: "[--numericserv] [--namereqd] [--udp]\n");
15: fprintf(stderr, " [--nofqdn] "
16: "[--service<служба>] [--host<имя_хоста>]\n");
17: exit(1);
18: }
19:
20: int main(int argc, const char ** argv) {
21: int flags;
22: const char * hostAddress = NULL;
23: const char * serviceAddress = NULL;
24: struct sockaddr_in addr4;
25: struct sockaddr_in6 addr6;
26: struct sockaddr *addr = (struct sockaddr *) &addr4;
27: int addrLen = sizeof(addr4);
28: int rc;
29: int portNum = 0;
30: const char ** ptr;
31: char hostName[1024];
32: char serviceName[256];
33:
34: /* очистить флаги */
35: flags = 0;
36:
37: /* разобрать аргументы командной строки, игнорируя argv[0] */
38: ptr = argv + 1;
39: while (*ptr && *ptr[0] == '-') {
40: if (!strcmp(*ptr, "—numerichost")) {
41: flags |= NI_NUMERICHOST;
42: } else if (!strcmp (*ptr, "--numericserv")) {