From 3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Mon, 15 Apr 2024 21:41:07 +0200
Subject: Merging upstream version 6.7.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 man3/getnameinfo.3 | 43 ++++++++++++++++++++++---------------------
 1 file changed, 22 insertions(+), 21 deletions(-)

(limited to 'man3/getnameinfo.3')

diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3
index 580a265..c1453ba 100644
--- a/man3/getnameinfo.3
+++ b/man3/getnameinfo.3
@@ -8,7 +8,7 @@
 .\" 2004-12-14, mtk, Added EAI_OVERFLOW error
 .\" 2004-12-14 Fixed description of error return
 .\"
-.TH getnameinfo 3 2023-07-20 "Linux man-pages 6.05.01"
+.TH getnameinfo 3 2023-10-31 "Linux man-pages 6.7"
 .SH NAME
 getnameinfo \- address-to-name translation in protocol-independent manner
 .SH LIBRARY
@@ -18,7 +18,7 @@ Standard C library
 .nf
 .B #include <sys/socket.h>
 .B #include <netdb.h>
-.PP
+.P
 .BI "int getnameinfo(const struct sockaddr *restrict " addr \
 ", socklen_t " addrlen ,
 .BI "                char " host "[_Nullable restrict ." hostlen ],
@@ -27,12 +27,12 @@ Standard C library
 .BI "                socklen_t " servlen ,
 .BI "                int " flags );
 .fi
-.PP
+.P
 .RS -4
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .RE
-.PP
+.P
 .BR getnameinfo ():
 .nf
     Since glibc 2.22:
@@ -55,7 +55,7 @@ but unlike those functions,
 .BR getnameinfo ()
 is reentrant and allows programs to eliminate
 IPv4-versus-IPv6 dependencies.
-.PP
+.P
 The
 .I addr
 argument is a pointer to a generic socket address structure
@@ -78,7 +78,7 @@ respectively) into which
 .BR getnameinfo ()
 places null-terminated strings containing the host and
 service names respectively.
-.PP
+.P
 The caller can specify that no hostname (or no service name)
 is required by providing a NULL
 .I host
@@ -91,7 +91,7 @@ argument or a zero
 argument.
 However, at least one of hostname or service name
 must be requested.
-.PP
+.P
 The
 .I flags
 argument modifies the behavior of
@@ -140,7 +140,9 @@ converted from IDN format to the locale's encoding if necessary.
 ASCII-only names are not affected by the conversion, which
 makes this flag usable in existing programs and environments.
 .TP
-.BR NI_IDN_ALLOW_UNASSIGNED ", " NI_IDN_USE_STD3_ASCII_RULES
+.B NI_IDN_ALLOW_UNASSIGNED
+.TQ
+.B NI_IDN_USE_STD3_ASCII_RULES
 Setting these flags will enable the
 IDNA_ALLOW_UNASSIGNED (allow unassigned Unicode code points) and
 IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3
@@ -200,7 +202,7 @@ was too small.
 A system error occurred.
 The error code can be found in
 .IR errno .
-.PP
+.P
 The
 .BR gai_strerror (3)
 function translates these error codes to a human readable string,
@@ -225,14 +227,13 @@ T{
 .BR getnameinfo ()
 T}	Thread safety	MT-Safe env locale
 .TE
-.sp 1
 .SH STANDARDS
 POSIX.1-2008.
 RFC\ 2553.
 .SH HISTORY
 glibc 2.1.
 POSIX.1-2001.
-.PP
+.P
 Before glibc 2.2, the
 .I hostlen
 and
@@ -244,14 +245,14 @@ In order to assist the programmer in choosing reasonable sizes
 for the supplied buffers,
 .I <netdb.h>
 defines the constants
-.PP
+.P
 .in +4n
 .EX
 #define NI_MAXHOST      1025
 #define NI_MAXSERV      32
 .EE
 .in
-.PP
+.P
 Since glibc 2.8,
 these definitions are exposed only if suitable
 feature test macros are defined, namely:
@@ -262,7 +263,7 @@ or (in glibc versions up to and including 2.19)
 .B _BSD_SOURCE
 or
 .BR _SVID_SOURCE .
-.PP
+.P
 The former is the constant
 .B MAXDNAME
 in recent versions of BIND's
@@ -275,7 +276,7 @@ The following code tries to get the numeric hostname and service name,
 for a given socket address.
 Note that there is no hardcoded reference to
 a particular address family.
-.PP
+.P
 .in +4n
 .EX
 struct sockaddr *addr;     /* input */
@@ -287,10 +288,10 @@ if (getnameinfo(addr, addrlen, hbuf, sizeof(hbuf), sbuf,
     printf("host=%s, serv=%s\en", hbuf, sbuf);
 .EE
 .in
-.PP
+.P
 The following version checks if the socket address has a
 reverse address mapping.
-.PP
+.P
 .in +4n
 .EX
 struct sockaddr *addr;     /* input */
@@ -304,7 +305,7 @@ else
     printf("host=%s\en", hbuf);
 .EE
 .in
-.PP
+.P
 An example program using
 .BR getnameinfo ()
 can be found in
@@ -324,17 +325,17 @@ can be found in
 .BR services (5),
 .BR hostname (7),
 .BR named (8)
-.PP
+.P
 R.\& Gilligan, S.\& Thomson, J.\& Bound and W.\& Stevens,
 .IR "Basic Socket Interface Extensions for IPv6" ,
 RFC\ 2553, March 1999.
-.PP
+.P
 Tatsuya Jinmei and Atsushi Onoe,
 .IR "An Extension of Format for IPv6 Scoped Addresses" ,
 internet draft, work in progress
 .UR ftp://ftp.ietf.org\:/internet\-drafts\:/draft\-ietf\-ipngwg\-scopedaddr\-format\-02.txt
 .UE .
-.PP
+.P
 Craig Metz,
 .IR "Protocol Independence Using the Sockets API" ,
 Proceedings of the freenix track:
-- 
cgit v1.2.3