From 0db324e2e5d9d3347ea0e93138372fb65aac09e6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:09 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man3/resolver.3 | 71 ++++++++++++++++++++++++++++----------------------------- 1 file changed, 35 insertions(+), 36 deletions(-) (limited to 'man3/resolver.3') 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 .B #include .B #include -.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 . -- cgit v1.2.3