res_search()

Запросить локальный сервер, используя параметры поиска

Прототип:

#include <sys/types.h>
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
int res_search( const char *dname,
int class,
int type,
u_char *answer,
int anslen );

Аргументы:

dname
Полное доменное имя, которое требуется запросить.
class
Требуемый класс информации; один из следующих:
C_IN
ARPA Internet.
C_CHAOS
Chaos net (MIT).
C_HS
сервер имен Hesiod (MIT).
C_ANY
произвольный класс.
Обычно используется C_IN.
type
Тип требуемой информации. Обычно используется T_PTR, но также можно использовать и константы T_*, определенные в <arpa/nameser.h>.
answer
Указатель на буфер, в котором функция может хранить ответ на запрос.
anslen
Размер буфера.

Библиотека:

libsocket

Описание:

Процедура res_search() выполняет поиск доменного имени в Интернете. Аналогично res_query(), res_search() делает запрос и ждет ответа. Но она также реализует правила по умолчанию и правила поиска, управляемые параметрами RES_DEFNAMES и RES_DNSRCH. Возвращается первый успешный ответ.

Процедуры преобразователя используются для создания, отправки и интерпретации запросов и ответов с серверами доменных имен в Интернете.

Информация о глобальной конфигурации и состоянии, используемая процедурами преобразователя, хранится в структуре _res. Для получения дополнительной информации о параметрах см. res_init().

Возвращаемое значение:

Длина ответного сообщения в байтах.

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

См. herror().

Файлы:

/etc/resolv.conf
Файл конфигурации преобразователя.

Переменные окружения:

LOCALDOMAIN
Если установлена, то LOCALDOMAIN содержит доменное имя, которое переопределяет текущее доменное имя.

Классификация:

Unix

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

Тематические ссылки:

dn_comp(), dn_expand(), gethostbyname(), herror(), res_init(), res_mkquery(), res_query(), res_querydomain(), res_send()

hostname, /etc/resolv.conf в Справочнике по Утилитам

Основано на RFC 974, RFC 1032, RFC 1033, RFC 1034, RFC 1035




Предыдущий раздел: Описание API сетевой библиотеки