summaryrefslogtreecommitdiffstats
path: root/man3/resolver.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/resolver.3')
-rw-r--r--man3/resolver.371
1 files changed, 35 insertions, 36 deletions
diff --git a/man3/resolver.3 b/man3/resolver.3
index 416951f..f44c51b 100644
--- a/man3/resolver.3
+++ b/man3/resolver.3
@@ -11,7 +11,7 @@
.\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu)
.\" Modified 2004-10-31 by aeb
.\"
-.TH resolver 3 2023-07-20 "Linux man-pages 6.05.01"
+.TH resolver 3 2023-10-31 "Linux man-pages 6.7"
.SH NAME
res_ninit, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend,
res_nclose,
@@ -26,71 +26,71 @@ Resolver library
.B #include <netinet/in.h>
.B #include <arpa/nameser.h>
.B #include <resolv.h>
-.PP
+.P
.B struct __res_state;
.B typedef struct __res_state *res_state;
-.PP
+.P
.BI "int res_ninit(res_state " statep );
-.PP
+.P
.BI "void res_nclose(res_state " statep );
-.PP
+.P
.BI "int res_nquery(res_state " statep ,
.BI " const char *" dname ", int " class ", int " type ,
.BI " unsigned char " answer [. anslen "], int " anslen );
-.PP
+.P
.BI "int res_nsearch(res_state " statep ,
.BI " const char *" dname ", int " class ", int " type ,
.BI " unsigned char " answer [. anslen "], int " anslen );
-.PP
+.P
.BI "int res_nquerydomain(res_state " statep ,
.BI " const char *" name ", const char *" domain ,
.BI " int " class ", int " type ", unsigned char " answer [. anslen ],
.BI " int " anslen );
-.PP
+.P
.BI "int res_nmkquery(res_state " statep ,
.BI " int " op ", const char *" dname ", int " class ,
.BI " int " type ", const unsigned char " data [. datalen "], \
int " datalen ,
.BI " const unsigned char *" newrr ,
.BI " unsigned char " buf [. buflen "], int " buflen );
-.PP
+.P
.BI "int res_nsend(res_state " statep ,
.BI " const unsigned char " msg [. msglen "], int " msglen ,
.BI " unsigned char " answer [. anslen "], int " anslen );
-.PP
+.P
.BI "int dn_comp(const char *" exp_dn ", unsigned char " comp_dn [. length ],
.BI " int " length ", unsigned char **" dnptrs ,
.BI " unsigned char **" lastdnptr );
-.PP
+.P
.BI "int dn_expand(const unsigned char *" msg ,
.BI " const unsigned char *" eomorig ,
.BI " const unsigned char *" comp_dn ", char " exp_dn [. length ],
.BI " int " length );
-.PP
+.P
.B [[deprecated]] extern struct __res_state _res;
-.PP
+.P
.B [[deprecated]] int res_init(void);
-.PP
+.P
.B [[deprecated]]
.BI "int res_query(const char *" dname ", int " class ", int " type ,
.BI " unsigned char " answer [. anslen "], int " anslen );
-.PP
+.P
.B [[deprecated]]
.BI "int res_search(const char *" dname ", int " class ", int " type ,
.BI " unsigned char " answer [. anslen "], int " anslen );
-.PP
+.P
.B [[deprecated]]
.BI "int res_querydomain(const char *" name ", const char *" domain ,
.BI " int " class ", int " type ", unsigned char " answer [. anslen ],
.BI " int " anslen );
-.PP
+.P
.B [[deprecated]]
.BI "int res_mkquery(int " op ", const char *" dname ", int " class ,
.BI " int " type ", const unsigned char " data [. datalen "], \
int " datalen ,
.BI " const unsigned char *" newrr ,
.BI " unsigned char " buf [. buflen "], int " buflen );
-.PP
+.P
.B [[deprecated]]
.BI "int res_send(const unsigned char " msg [. msglen "], int " msglen ,
.BI " unsigned char " answer [. anslen "], int " anslen );
@@ -99,10 +99,10 @@ int " datalen ,
.B Note:
This page is incomplete (various resolver functions provided by glibc
are not described) and likely out of date.
-.PP
+.P
The functions described below make queries to and interpret
the responses from Internet domain name servers.
-.PP
+.P
The API consists of a set of more modern, reentrant functions
and an older set of nonreentrant functions that have been superseded.
The traditional resolver interfaces such as
@@ -118,7 +118,7 @@ BIND 8.2 introduced a set of new interfaces
and so on, which take a
.I res_state
as their first argument, so you can use a per-thread resolver state.
-.PP
+.P
The
.BR res_ninit ()
and
@@ -144,7 +144,7 @@ to free memory allocated by
.BR res_ninit ()
and subsequent calls to
.BR res_nquery ().
-.PP
+.P
The
.BR res_nquery ()
and
@@ -154,7 +154,7 @@ fully qualified domain name \fIname\fP of specified \fItype\fP and
\fIclass\fP.
The reply is left in the buffer \fIanswer\fP of length
\fIanslen\fP supplied by the caller.
-.PP
+.P
The
.BR res_nsearch ()
and
@@ -170,7 +170,7 @@ and
.B RES_DNSRCH
(see description of
\fI_res\fP options below).
-.PP
+.P
The
.BR res_nquerydomain ()
and
@@ -178,10 +178,10 @@ and
functions make a query using
.BR res_nquery ()/ res_query ()
on the concatenation of \fIname\fP and \fIdomain\fP.
-.PP
+.P
The following functions are lower-level routines used by
.BR res_nquery ()/ res_query ().
-.PP
+.P
The
.BR res_nmkquery ()
and
@@ -203,9 +203,9 @@ since it has not been supported by DNS servers for a very long time.
.TP
.B NS_NOTIFY_OP
Notify secondary of SOA (Start of Authority) change.
-.PP
+.P
\fInewrr\fP is currently unused.
-.PP
+.P
The
.BR res_nsend ()
and
@@ -216,7 +216,7 @@ which is of length \fIanslen\fP.
They will call
.BR res_ninit ()/ res_init ()
if it has not already been called.
-.PP
+.P
The
.BR dn_comp ()
function compresses the domain name \fIexp_dn\fP
@@ -229,7 +229,7 @@ The limit of the array is specified by \fIlastdnptr\fP.
If \fIdnptr\fP is NULL, domain names are not compressed.
If \fIlastdnptr\fP is NULL, the list
of labels is not updated.
-.PP
+.P
The
.BR dn_expand ()
function expands the compressed domain name
@@ -238,7 +238,7 @@ function expands the compressed domain name
The compressed name is contained
in a query or reply message, and \fImsg\fP points to the beginning of
the message.
-.PP
+.P
The resolver routines use configuration and state information
contained in a
.I __res_state
@@ -427,7 +427,7 @@ and
.BR res_init ()
functions return 0 on success, or \-1 if an error
occurs.
-.PP
+.P
The
.BR res_nquery (),
.BR res_query (),
@@ -442,14 +442,14 @@ and
.BR res_send ()
functions return the length
of the response, or \-1 if an error occurs.
-.PP
+.P
The
.BR dn_comp ()
and
.BR dn_expand ()
functions return the length
of the compressed name, or \-1 if an error occurs.
-.PP
+.P
In the case of an error return from
.BR res_nquery (),
.BR res_query (),
@@ -496,7 +496,6 @@ T{
.BR dn_expand ()
T} Thread safety MT-Safe
.TE
-.sp 1
.SH STANDARDS
None.
.SH HISTORY
@@ -507,6 +506,6 @@ None.
.BR resolver (5),
.BR hostname (7),
.BR named (8)
-.PP
+.P
The GNU C library source file
.IR resolv/README .