| RESOLVER(3) | Руководство программиста Linux | RESOLVER(3) |
res_ninit, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand - процедуры определителя имён
#include <netinet/in.h> #include <arpa/nameser.h> #include <resolv.h>
struct __res_state; typedef struct __res_state *res_state;
int res_ninit(res_state statep);
int res_nquery(res_state statep,
const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_nsearch(res_state statep,
const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_nquerydomain(res_state statep,
const char *name, const char *domain,
int class, int type, unsigned char *answer,
int anslen);
int res_nmkquery(res_state statep,
int op, const char *dname, int class,
int type, const unsigned char *data, int datalen,
const unsigned char *newrr,
unsigned char *buf, int buflen);
int res_nsend(res_state statep,
const unsigned char *msg, int msglen,
unsigned char *answer, int anslen);
int dn_comp(const char *exp_dn, unsigned char *comp_dn,
int length, unsigned char **dnptrs,
unsigned char **lastdnptr);
int dn_expand(const unsigned char *msg,
const unsigned char *eomorig,
const unsigned char *comp_dn, char *exp_dn,
int length);
extern struct __res_state _res;
int res_init(void);
int res_query(const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_search(const char *dname, int class, int type,
unsigned char *answer, int anslen);
int res_querydomain(const char *name, const char *domain,
int class, int type, unsigned char *answer,
int anslen);
int res_mkquery(int op, const char *dname, int class,
int type, const unsigned char *data, int datalen,
const unsigned char *newrr,
unsigned char *buf, int buflen);
int res_send(const unsigned char *msg, int msglen,
unsigned char *answer, int anslen);
Компонуется при указании параметра -lresolv.
Замечание: Данная страница не полна (не описаны различные функции определителя, предоставляемые glibc) и, вероятно, содержит устаревшую информацию.
Описываемые далее функции выполняют запросы и обрабатывают ответы, полученные от серверов доменных имён Интернет.
В программный интерфейс входят как современные, реентерабельные функции, так и устаревшие не реентерабельные. Функции res_init() и res_query() из обычного интерфейса определителя использует статическое (глобальное) состояние, хранимое в структуре _res, что делает эти функции небезопасным при использовании в нитях. В BIND 8.2 появился набор новых интерфейсов res_ninit(), res_nquery() и т. п., в котором res_state указывается в третьем аргументе, что позволяет использовать отдельное состояние определителя в каждой нити.
Функции res_ninit() и res_init() читают файлы настройки (смотрите resolv.conf(5)) для получения имени домена по умолчанию и адреса(-ов) сервера имён. Если серверы не заданы, то используется локальный узел. Если не задан домен, то используется домен локального узла. Это может быть изменено через переменную окружения LOCALDOMAIN. Обычно, функция res_ninit() или res_init() выполняется первой из других функций.
Функции res_nquery() и res_query() запрашивают у сервера имён полное доменное имя name заданного типа type и класса class. Ответ помещается в буфер answer длиной anslen, указанный вызывающим.
Функции res_nsearch() и res_search() отправляют запрос и ждут ответа, подобно res_nquery() и res_query(), но при этом ещё учитывают правила работы и поиска по умолчанию, настраиваемые через RES_DEFNAMES и RES_DNSRCH (смотрите ниже описание параметров _res).
Функции res_nquerydomain() и res_querydomain() отправляют запрос с помощью res_nquery()/res_query() с объединённым name и domain.
Следующие функции являются процедурами низкого уровня, которые используются res_nquery()/res_query().
Функции res_nmkquery() и res_mkquery() создают сообщение-запрос в buf длиной buflen для имени домена dname. Типом запроса op может быть:
Параметр newrr в настоящее время не используется.
Функции res_nsend() и res_send() посылают заранее созданный запрос, указанный в msg длиной msglen, и возвращают ответ в answer длиной anslen. Вызывают функцию res_ninit()/res_init(), если этого ещё не было.
Функция dn_comp() сжимает имя домена exp_dn и сохраняет его в буфере comp_dn длиной length. Сжатие использует массив указателей dnptrs на предварительно сжатые имена в текущем сообщении. Первый указатель обозначает начало сообщения, а весь список оканчивается NULL. Предел массива определяется в lastdnptr. Если dnptr равно NULL, то имя домена не является сжатым. Если lastdnptr равно NULL, то список меток не обновляется.
Функция dn_expand() раскрывает сжатое имя домена comp_dn до полного доменного имени, которое затем сохраняется в буфере exp_dn длиной length. Сжатое имя содержится в запросе или ответном сообщении, а msg указывает на начало сообщения.
Процедуры определителя используют настройки и информацию о состоянии из структуры __res_state (переданной в аргументе statep или в глобальной переменной _res, если используются старые не реентерабельные функции). Обычно, пользователь изменяет в этой структуре только поле options. Данное поле может содержать следующие значения, объединённые с помощью «OR»:
При успешном выполнении функции res_ninit() и res_init() возвращают 0, и -1 при ошибке.
Функции res_nquery(), res_query(), res_nsearch(), res_search(), res_nquerydomain(), res_querydomain(), res_nmkquery(), res_mkquery(), res_nsend() и res_send() возвращают длину ответа или -1 при ошибке.
Функции dn_comp() и dn_expand() возвращают длину сжатого имени, или -1 при ошибках.
/etc/resolv.conf файл настройки определителя имён /etc/host.conf файл настройки определителя имён
Описание терминов данного раздела смотрите в attributes(7).
| Интерфейс | Атрибут | Значение |
| res_ninit(), res_nquery(), res_nsearch(), res_nquerydomain(), res_nsend() | Безвредность в нитях | MT-Safe locale |
| res_nmkquery(), dn_comp(), dn_expand() | Безвредность в нитях | MT-Safe |
4.3BSD.
gethostbyname(3), resolv.conf(5), resolver(5), hostname(7), named(8)
Файл resolv/README из библиотеки GNU C.
| 2017-09-15 | GNU |