Merging upstream version 4.23.0.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 35 insertions, 36 deletions

diff --git a/upstream/opensuse-tumbleweed/man3/resolver.3 b/upstream/opensuse-tumbleweed/man3/resolver.3
index 416951f1..cc5f404e 100644
--- a/upstream/opensuse-tumbleweed/man3/resolver.3
+++ b/upstream/opensuse-tumbleweed/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 2024-05-02 "Linux man-pages (unreleased)"
 .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 .