.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sun Jul 25 11:01:53 1993 by Rik Faith (faith@cs.unc.edu)
.TH RESOLVER 3  "21 de maio de 1993" "BSD" "Manual do Programador Linux"
.SH NOME
res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, 
dn_comp, dn_expand \- rotinas resolvedoras
.SH SINOPSE
.nf
.B #include <netinet/in.h>
.B #include <arpa/nameser.h>
.B #include <resolv.h>
.B extern struct state _res;
.sp
.B int res_init(void);
.sp
.BI "int res_query(const char *" dname ", int " class ", int " type ,
.RS
.BI "unsigned char *" answer ", int " anslen );
.RE
.sp
.BI "int res_search(const char *" dname ", int " class ", int " type ,
.RS
.BI "unsigned char *" answer ", int " anslen );
.RE
.sp
.BI "int res_querydomain(const char *" name ", const char *" domain ,
.RS
.BI "int " class ", int " type ", unsigned char *" answer ,
.BI "int " anslen );
.RE
.sp
.BI "int res_mkquery(int " op ", const char *" dname ", int " class ,
.RS
.BI "int " type ", char *" data ", int " datalen ", struct rrec *" newrr ,
.BI "char *" buf ", int " buflen );
.RE
.sp
.BI "int res_send(const char *" msg ", int " msglen ", char *" answer , 
.RS
.BI "int " anslen );
.RE
.sp
.BI "int dn_comp(unsigned char *" exp_dn ", unsigned char *" comp_dn ,
.RS
.BI "int " length ", unsigned char **" dnptrs ", unsigned char *" exp_dn ,
.BI "unsigned char **" lastdnptr );
.RE
.sp
.BI "int dn_expand(unsigned char *" msg ", unsigned char *" eomorig ,
.RS
.BI "unsigned char *" comp_dn ", unsigned char *" exp_dn ,
.BI "int " length );
.RE
.fi
.SH DESCRIO
Estas funes fazem pesquisas e interpretam as respostas de servidores de nomes de 
domnio da Internet.
.PP
A funo \fBres_init()\fP l os arquivos de configurao (veja 
resolv+(8)) para obter o nome de domnio padro, a ordem de buscas e o(s) endereo(s)
do(s) servidor(es) de nome. Se nenhum servidor  dado, o host local  tentado. Se nenhum
domnio  dado,  usado aquele domnio associado ao host local. Ele pode ser
sobreposto pela varivel de ambiente LOCALDOMAIN.
\fBres_init()\fP  executado normalmente pela primeira chamada a uma das outras 
funes.
.PP
A funo \fBres_query()\fP pesquisa o servidor de nome para o nome de domnio
totalmente qualificado \fIname\fP do \fItipo\fP e da
\fIclasse\fP especificada. O que for retornado  deixado no buffer \fIanswer\fP de
comprimento \fIanslen\fP fornecido pelo chamador.
.PP
A funo \fBres_search()\fP faz uma pesquisa e espera pela resposta como
\fBres_query()\fP, mas alm disso implementa as regras padro e de busca
controladas por RES_DEFNAMES e RES_DNSRCH (veja a descrio das opes
\fI_res\fP abaixo).
.PP
A funo \fBres_querydomain()\fP faz uma pesquisa usando \fBres_query()\fP sobre a 
conecatenao de \fInome\fP e \fIdomnio\fP.
.PP
As seguintes funes so rotinas de nvel mais baixo, usadas por \fBres_query()\fP.
.PP
A funo \fBres_mkquery()\fP constri uma mensagem de pesquisa em \fIbuf\fP de
comprimento \fIbuflen\fP para o nome de domnio \fIdname\fP. O tipo de pesquisa
\fIop\fP  geralmente QUERY, mas pode ser qualquer um dos tipos definidos em
\fI<arpa/nameser.h>\fP. \fInewrr\fP no  usado correntemente.
.PP
A funo \fBres_send()\fP envia uma pesquisa pr-formatada dada em
\fImsg\fP de comprimento \fImsglen\fP e retorna a resposta em \fIanswer\fP
que tem comprimento \fIanslen\fP. Ela chamar a funo \fBres_init()\fP, se ela j no tiver
sido chamada.
.PP
A funo \fBdn_comp()\fP comprime o nome de domnio \fIexp_dn\fP e o armazena no buffer
\fIcomp_dn\fP de comprimento \fIlength\fP. A compresso usa uma matriz de ponteiros
\fIdnptrs\fP para nomes previamente comprimidos na mensagem corrente. O primeiro ponteiro
aponta para o incio da mensagem, e a lista termina com NULL. O limite da matriz 
especificada por \fIlastdnptr\fP. Se \fIdnptr\fP  NULL, os nomes de domnio no so
comprimidos. Se \fIlastdnptr\fP  NULL, a lista de ttulos no  atualizada.
.PP
A funo \fPdn_expand()\fP expande o nome de domnio comprimido
\fIcomp_dn\fP para um nome de domnio completo, que  colocado no buffer
\fIexp_dn\fP de tamanho \fIlength\fP. O nome comprimido est contido em uma pesquisa ou
mensagem de resposta, e \fImsg\fP aponta para o incio da mensagem.
.PP
As rotinas de resoluo usam configuraes globais e informaes de estado contidas na 
estrutura \fI_res\fP, que est definida em \fI<resolv.h>\fP. O nico campo que normalmente  
manipulado pelo usurio  \fI_res.options\fP. Este campo pode conter um 'OU' bit-a-bit das
seguintes opes:
.sp
.TP
.B RES_INIT
Verdadeiro se \fBres_init()\fP foi chamado.
.TP
.B RES_DEBUG
Imprime mensagens de eliminao de erros.
.TP
.B RES_AAONLY
Aceita somente respostas autoritativas. \fBres_send()\fP continua at encontrar uma 
resposta autoritativas ou retorna um erro.  [No implementado correntemente].
.TP
.B RES_USEVC
Usa conexes TCP para pesquisas em vez de datagramas UDP.
.TP
.B RES_PRIMARY
Somente servidor primrio de nome de domnio de pesquisa.
.TP
.B RES_IGNTC
Ignora erros de truncamento. No tenta novamente com TCP.  [No implementado correntemente].
.TP
.B RES_RECURSE
Seta o bit de recurso desejado em pesquisas. A recurso  realizada pelo servidor de
nome de domnio, e no por \fBres_send()\fP.  [Habilitado por padro].
.TP
.B RES_DEFNAMES
Se setado, \fBres_search()\fP acrescentar o nome de domnio padro a nomes de componentes
simples, isto , aqueles que no contm um ponto. [Habilitado por padro].
.TP
.B RES_STAYOPEN
Usado com RES_USEVC para manter a conexo TCP aberta entre pesquisas.
.TP
.B RES_DNSRCH
Se setado, \fBres_search()\fP buscar nomes de hosts no domnio corrente e em domnios pais.
Esta opo  usada por
.BR gethostbyname (3).
[Habilitado por padro].
.SH "VALOR DE RETORNO"
A funo \fBres_init()\fP retorna 0 em caso de sucesso, ou \-1 se ocorrer um erro.
.PP
As funes \fBres_query()\fP, \fBres_search()\fP, \fBres_querydomain()\fP,
\fBres_mkquery()\fP e \fBres_send()\fP retornam o comprimento da resposta, ou
\-1 se ocorre um erro.
.PP
The \fBdn_comp()\fP and \fBdn_expand()\fP functions return the length
of the compressed name, or \-1 if an error occurs.
.SH FILES
.nf
/etc/resolv.conf          arquivo de configurao do resolvedor
/etc/host.conf            arquivo de configurao do resolvedor
.fi
.SH "CONFORME"
BSD 4.3
.SH "VEJA TAMBM"
.BR gethostbyname "(3), " hostname "(7), " named "(8), " resolv+ (8)
.SH TRADUZIDO PELO LDP-BR EM dd/MM/AAAA
\&\fR\&\f(CWRUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (traduo)\fR
\&\fR\&\f(CWXXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (reviso)\fR