Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 1706 insertions, 0 deletions

diff --git a/templates/man3/getaddrinfo_a.3.pot b/templates/man3/getaddrinfo_a.3.pot
new file mode 100644
index 00000000..bb6e836e
--- /dev/null
+++ b/templates/man3/getaddrinfo_a.3.pot
@@ -0,0 +1,1706 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2024-03-01 16:56+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: TH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "getaddrinfo_a"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "2023-10-31"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "Linux man-pages 6.06"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"getaddrinfo_a, gai_suspend, gai_error, gai_cancel - asynchronous network "
+"address and service translation"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "LIBRARY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Asynchronous name lookup library (I<libanl>, I<-lanl>)"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SYNOPSIS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
+"B<#include E<lt>netdb.hE<gt>>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<int getaddrinfo_a(int >I<mode>B<, struct gaicb *>I<list>B<[restrict],>\n"
+"B<                  int >I<nitems>B<, struct sigevent *restrict >I<sevp>B<);>\n"
+"B<int gai_suspend(const struct gaicb *const >I<list>B<[], int >I<nitems>B<,>\n"
+"B<                  const struct timespec *>I<timeout>B<);>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<int gai_error(struct gaicb *>I<req>B<);>\n"
+"B<int gai_cancel(struct gaicb *>I<req>B<);>\n"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "DESCRIPTION"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<getaddrinfo_a>()  function performs the same task as "
+"B<getaddrinfo>(3), but allows multiple name look-ups to be performed "
+"asynchronously, with optional notification on completion of look-up "
+"operations."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The I<mode> argument has one of the following values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<GAI_WAIT>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Perform the look-ups synchronously.  The call blocks until the look-ups have "
+"completed."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<GAI_NOWAIT>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Perform the look-ups asynchronously.  The call returns immediately, and the "
+"requests are resolved in the background.  See the discussion of the I<sevp> "
+"argument below."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The array I<list> specifies the look-up requests to process.  The I<nitems> "
+"argument specifies the number of elements in I<list>.  The requested look-up "
+"operations are started in parallel.  NULL elements in I<list> are ignored.  "
+"Each request is described by a I<gaicb> structure, defined as follows:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"struct gaicb {\n"
+"    const char            *ar_name;\n"
+"    const char            *ar_service;\n"
+"    const struct addrinfo *ar_request;\n"
+"    struct addrinfo       *ar_result;\n"
+"};\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The elements of this structure correspond to the arguments of "
+"B<getaddrinfo>(3).  Thus, I<ar_name> corresponds to the I<node> argument and "
+"I<ar_service> to the I<service> argument, identifying an Internet host and a "
+"service.  The I<ar_request> element corresponds to the I<hints> argument, "
+"specifying the criteria for selecting the returned socket address "
+"structures.  Finally, I<ar_result> corresponds to the I<res> argument; you "
+"do not need to initialize this element, it will be automatically set when "
+"the request is resolved.  The I<addrinfo> structure referenced by the last "
+"two elements is described in B<getaddrinfo>(3)."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+msgid ""
+"When I<mode> is specified as B<GAI_NOWAIT>, notifications about resolved "
+"requests can be obtained by employing the I<sigevent> structure pointed to "
+"by the I<sevp> argument.  For the definition and general details of this "
+"structure, see B<sigevent>(3type).  The I<sevp-E<gt>sigev_notify> field can "
+"have the following values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<SIGEV_NONE>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Don't provide any notification."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<SIGEV_SIGNAL>"
+msgstr ""
+
+#.  si_pid and si_uid are also set, to the values of the calling process,
+#.  which doesn't provide useful information, so we'll skip mentioning it.
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+msgid ""
+"When a look-up completes, generate the signal I<sigev_signo> for the "
+"process.  See B<sigevent>(3type)  for general details.  The I<si_code> field "
+"of the I<siginfo_t> structure will be set to B<SI_ASYNCNL>."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<SIGEV_THREAD>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+msgid ""
+"When a look-up completes, invoke I<sigev_notify_function> as if it were the "
+"start function of a new thread.  See B<sigevent>(3type)  for details."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"For B<SIGEV_SIGNAL> and B<SIGEV_THREAD>, it may be useful to point I<sevp-"
+"E<gt>sigev_value.sival_ptr> to I<list>."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_suspend>()  function suspends execution of the calling thread, "
+"waiting for the completion of one or more requests in the array I<list>.  "
+"The I<nitems> argument specifies the size of the array I<list>.  The call "
+"blocks until one of the following occurs:"
+msgstr ""
+
+#. type: IP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "\\[bu]"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "One or more of the operations in I<list> completes."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The call is interrupted by a signal that is caught."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The time interval specified in I<timeout> elapses.  This argument specifies "
+"a timeout in seconds plus nanoseconds (see B<nanosleep>(2)  for details of "
+"the I<timespec> structure).  If I<timeout> is NULL, then the call blocks "
+"indefinitely (until one of the events above occurs)."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"No explicit indication of which request was completed is given; you must "
+"determine which request(s) have completed by iterating with B<gai_error>()  "
+"over the list of requests."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_error>()  function returns the status of the request I<req>: "
+"either B<EAI_INPROGRESS> if the request was not completed yet, 0 if it was "
+"handled successfully, or an error code if the request could not be resolved."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_cancel>()  function cancels the request I<req>.  If the request "
+"has been canceled successfully, the error status of the request will be set "
+"to B<EAI_CANCELED> and normal asynchronous notification will be performed.  "
+"The request cannot be canceled if it is currently being processed; in that "
+"case, it will be handled as if B<gai_cancel>()  has never been called.  If "
+"I<req> is NULL, an attempt is made to cancel all outstanding requests that "
+"the process has made."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "RETURN VALUE"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<getaddrinfo_a>()  function returns 0 if all of the requests have been "
+"enqueued successfully, or one of the following nonzero error codes:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_AGAIN>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The resources necessary to enqueue the look-up requests were not available.  "
+"The application may check the error status of each request to determine "
+"which ones failed."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_MEMORY>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Out of memory."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_SYSTEM>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "I<mode> is invalid."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_suspend>()  function returns 0 if at least one of the listed "
+"requests has been completed.  Otherwise, it returns one of the following "
+"nonzero error codes:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The given timeout expired before any of the requests could be completed."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_ALLDONE>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "There were no actual requests given to the function."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_INTR>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"A signal has interrupted the function.  Note that this interruption might "
+"have been caused by signal notification of some completed look-up request."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_error>()  function can return B<EAI_INPROGRESS> for an unfinished "
+"look-up request, 0 for a successfully completed look-up (as described "
+"above), one of the error codes that could be returned by B<getaddrinfo>(3), "
+"or the error code B<EAI_CANCELED> if the request has been canceled "
+"explicitly before it could be finished."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The B<gai_cancel>()  function can return one of these values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_CANCELED>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The request has been canceled successfully."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<EAI_NOTCANCELED>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The request has not been canceled."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The request has already completed."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<gai_strerror>(3)  function translates these error codes to a human "
+"readable string, suitable for error reporting."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "ATTRIBUTES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"For an explanation of the terms used in this section, see B<attributes>(7)."
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Interface"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Attribute"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Value"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ".na\n"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ".nh\n"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<getaddrinfo_a>(),\n"
+"B<gai_suspend>(),\n"
+"B<gai_error>(),\n"
+"B<gai_cancel>()"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Thread safety"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "MT-Safe"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "STANDARDS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "GNU."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "HISTORY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "glibc 2.2.3."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The interface of B<getaddrinfo_a>()  was modeled after the B<lio_listio>(3)  "
+"interface."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "EXAMPLES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Two examples are provided: a simple example that resolves several requests "
+"in parallel synchronously, and a complex example showing some of the "
+"asynchronous capabilities."
+msgstr ""
+
+#. type: SS
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Synchronous example"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The program below simply resolves several hostnames in parallel, giving a "
+"speed-up compared to resolving the hostnames sequentially using "
+"B<getaddrinfo>(3).  The program might be used like this:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"$ B<./a.out mirrors.kernel.org enoent.linuxfoundation.org gnu.org>\n"
+"mirrors.kernel.org: 139.178.88.99\n"
+"enoent.linuxfoundation.org: Name or service not known\n"
+"gnu.org: 209.51.188.116\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Here is the program source code"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>err.hE<gt>\n"
+"#include E<lt>netdb.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"\\&\n"
+"#define MALLOC(n, type)  ((type *) reallocarray(NULL, n, sizeof(type)))\n"
+"\\&\n"
+"int\n"
+"main(int argc, char *argv[])\n"
+"{\n"
+"    int ret;\n"
+"    struct gaicb *reqs[argc - 1];\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+"\\&\n"
+"    if (argc E<lt> 2) {\n"
+"        fprintf(stderr, \"Usage: %s HOST...\\en\", argv[0]);\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        reqs[i] = MALLOC(1, struct gaicb);\n"
+"        if (reqs[i] == NULL)\n"
+"            err(EXIT_FAILURE, \"malloc\");\n"
+"\\&\n"
+"        memset(reqs[i], 0, sizeof(*reqs[0]));\n"
+"        reqs[i]-E<gt>ar_name = argv[i + 1];\n"
+"    }\n"
+"\\&\n"
+"    ret = getaddrinfo_a(GAI_WAIT, reqs, argc - 1, NULL);\n"
+"    if (ret != 0) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        printf(\"%s: \", reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == 0) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+"\\&\n"
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret != 0) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+"\\&\n"
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#.  SRC END
+#. type: SS
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Asynchronous example"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"This example shows a simple interactive B<getaddrinfo_a>()  front-end.  The "
+"notification facility is not demonstrated."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "An example session might look like this:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"$ B<./a.out>\n"
+"E<gt> a mirrors.kernel.org enoent.linuxfoundation.org gnu.org\n"
+"E<gt> c 2\n"
+"[2] gnu.org: Request not canceled\n"
+"E<gt> w 0 1\n"
+"[00] mirrors.kernel.org: Finished\n"
+"E<gt> l\n"
+"[00] mirrors.kernel.org: 139.178.88.99\n"
+"[01] enoent.linuxfoundation.org: Processing request in progress\n"
+"[02] gnu.org: 209.51.188.116\n"
+"E<gt> l\n"
+"[00] mirrors.kernel.org: 139.178.88.99\n"
+"[01] enoent.linuxfoundation.org: Name or service not known\n"
+"[02] gnu.org: 209.51.188.116\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The program source is as follows:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>assert.hE<gt>\n"
+"#include E<lt>err.hE<gt>\n"
+"#include E<lt>netdb.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"\\&\n"
+"#define CALLOC(n, type)  ((type *) calloc(n, sizeof(type)))\n"
+"\\&\n"
+"#define REALLOCF(ptr, n, type)                                          \\e\n"
+"({                                                                      \\e\n"
+"    static_assert(__builtin_types_compatible_p(typeof(ptr), type *));   \\e\n"
+"                                                                        \\e\n"
+"    (type *) reallocarrayf(ptr, n, sizeof(type));                       \\e\n"
+"})\n"
+"\\&\n"
+"static struct gaicb **reqs = NULL;\n"
+"static size_t nreqs = 0;\n"
+"\\&\n"
+"static inline void *\n"
+"reallocarrayf(void *p, size_t nmemb, size_t size)\n"
+"{\n"
+"    void  *q;\n"
+"\\&\n"
+"    q = reallocarray(p, nmemb, size);\n"
+"    if (q == NULL && nmemb != 0 && size != 0)\n"
+"        free(p);\n"
+"    return q;\n"
+"}\n"
+"\\&\n"
+"static char *\n"
+"getcmd(void)\n"
+"{\n"
+"    static char buf[256];\n"
+"\\&\n"
+"    fputs(\"E<gt> \", stdout); fflush(stdout);\n"
+"    if (fgets(buf, sizeof(buf), stdin) == NULL)\n"
+"        return NULL;\n"
+"\\&\n"
+"    if (buf[strlen(buf) - 1] == \\[aq]\\en\\[aq])\n"
+"        buf[strlen(buf) - 1] = 0;\n"
+"\\&\n"
+"    return buf;\n"
+"}\n"
+"\\&\n"
+"/* Add requests for specified hostnames. */\n"
+"static void\n"
+"add_requests(void)\n"
+"{\n"
+"    size_t nreqs_base = nreqs;\n"
+"    char *host;\n"
+"    int ret;\n"
+"\\&\n"
+"    while ((host = strtok(NULL, \" \"))) {\n"
+"        nreqs++;\n"
+"        reqs = REALLOCF(reqs, nreqs, struct gaicb *);\n"
+"        if (reqs == NULL)\n"
+"            err(EXIT_FAILURE, \"reallocf\");\n"
+"\\&\n"
+"        reqs[nreqs - 1] = CALLOC(1, struct gaicb);\n"
+"        if (reqs[nreqs - 1] == NULL)\n"
+"            err(EXIT_FAILURE, \"calloc\");\n"
+"\\&\n"
+"        reqs[nreqs - 1]-E<gt>ar_name = strdup(host);\n"
+"    }\n"
+"\\&\n"
+"    /* Queue nreqs_base..nreqs requests. */\n"
+"\\&\n"
+"    ret = getaddrinfo_a(GAI_NOWAIT, &reqs[nreqs_base],\n"
+"                        nreqs - nreqs_base, NULL);\n"
+"    if (ret) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* Wait until at least one of specified requests completes. */\n"
+"static void\n"
+"wait_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+"    struct gaicb const **wait_reqs;\n"
+"\\&\n"
+"    wait_reqs = CALLOC(nreqs, const struct gaicb *);\n"
+"    if (wait_reqs == NULL)\n"
+"        err(EXIT_FAILURE, \"calloc\");\n"
+"\\&\n"
+"                /* NULL elements are ignored by gai_suspend(). */\n"
+"\\&\n"
+"    while ((id = strtok(NULL, \" \")) != NULL) {\n"
+"        n = atoi(id);\n"
+"\\&\n"
+"        if (n E<gt>= nreqs) {\n"
+"            printf(\"Bad request number: %s\\en\", id);\n"
+"            return;\n"
+"        }\n"
+"\\&\n"
+"        wait_reqs[n] = reqs[n];\n"
+"    }\n"
+"\\&\n"
+"    ret = gai_suspend(wait_reqs, nreqs, NULL);\n"
+"    if (ret) {\n"
+"        printf(\"gai_suspend(): %s\\en\", gai_strerror(ret));\n"
+"        return;\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        if (wait_reqs[i] == NULL)\n"
+"            continue;\n"
+"\\&\n"
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == EAI_INPROGRESS)\n"
+"            continue;\n"
+"\\&\n"
+"        printf(\"[%02zu] %s: %s\\en\", i, reqs[i]-E<gt>ar_name,\n"
+"               ret == 0 ? \"Finished\" : gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* Cancel specified requests. */\n"
+"static void\n"
+"cancel_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+"\\&\n"
+"    while ((id = strtok(NULL, \" \")) != NULL) {\n"
+"        n = atoi(id);\n"
+"\\&\n"
+"        if (n E<gt>= nreqs) {\n"
+"            printf(\"Bad request number: %s\\en\", id);\n"
+"            return;\n"
+"        }\n"
+"\\&\n"
+"        ret = gai_cancel(reqs[n]);\n"
+"        printf(\"[%s] %s: %s\\en\", id, reqs[atoi(id)]-E<gt>ar_name,\n"
+"               gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* List all requests. */\n"
+"static void\n"
+"list_requests(void)\n"
+"{\n"
+"    int ret;\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        printf(\"[%02zu] %s: \", i, reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+"\\&\n"
+"        if (!ret) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+"\\&\n"
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"int\n"
+"main(void)\n"
+"{\n"
+"    char *cmdline;\n"
+"    char *cmd;\n"
+"\\&\n"
+"    while ((cmdline = getcmd()) != NULL) {\n"
+"        cmd = strtok(cmdline, \" \");\n"
+"\\&\n"
+"        if (cmd == NULL) {\n"
+"            list_requests();\n"
+"        } else {\n"
+"            switch (cmd[0]) {\n"
+"            case \\[aq]a\\[aq]:\n"
+"                add_requests();\n"
+"                break;\n"
+"            case \\[aq]w\\[aq]:\n"
+"                wait_requests();\n"
+"                break;\n"
+"            case \\[aq]c\\[aq]:\n"
+"                cancel_requests();\n"
+"                break;\n"
+"            case \\[aq]l\\[aq]:\n"
+"                list_requests();\n"
+"                break;\n"
+"            default:\n"
+"                fprintf(stderr, \"Bad command: %c\\en\", cmd[0]);\n"
+"                break;\n"
+"            }\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#.  SRC END
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+msgid ""
+"B<getaddrinfo>(3), B<inet>(3), B<lio_listio>(3), B<hostname>(7), B<ip>(7), "
+"B<sigevent>(3type)"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm
+#, no-wrap
+msgid "2023-02-05"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm
+#, no-wrap
+msgid "Linux man-pages 6.03"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"When I<mode> is specified as B<GAI_NOWAIT>, notifications about resolved "
+"requests can be obtained by employing the I<sigevent> structure pointed to "
+"by the I<sevp> argument.  For the definition and general details of this "
+"structure, see B<sigevent>(7).  The I<sevp-E<gt>sigev_notify> field can have "
+"the following values:"
+msgstr ""
+
+#.  si_pid and si_uid are also set, to the values of the calling process,
+#.  which doesn't provide useful information, so we'll skip mentioning it.
+#. type: Plain text
+#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"When a look-up completes, generate the signal I<sigev_signo> for the "
+"process.  See B<sigevent>(7)  for general details.  The I<si_code> field of "
+"the I<siginfo_t> structure will be set to B<SI_ASYNCNL>."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"When a look-up completes, invoke I<sigev_notify_function> as if it were the "
+"start function of a new thread.  See B<sigevent>(7)  for details."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm
+msgid "These functions are GNU extensions; they first appeared in glibc 2.2.3."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm
+#, no-wrap
+msgid "NOTES"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>netdb.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"int\n"
+"main(int argc, char *argv[])\n"
+"{\n"
+"    int ret;\n"
+"    struct gaicb *reqs[argc - 1];\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    if (argc E<lt> 2) {\n"
+"        fprintf(stderr, \"Usage: %s HOST...\\en\", argv[0]);\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        reqs[i] = malloc(sizeof(*reqs[0]));\n"
+"        if (reqs[i] == NULL) {\n"
+"            perror(\"malloc\");\n"
+"            exit(EXIT_FAILURE);\n"
+"        }\n"
+"        memset(reqs[i], 0, sizeof(*reqs[0]));\n"
+"        reqs[i]-E<gt>ar_name = argv[i + 1];\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    ret = getaddrinfo_a(GAI_WAIT, reqs, argc - 1, NULL);\n"
+"    if (ret != 0) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        printf(\"%s: \", reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == 0) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret != 0) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"static struct gaicb **reqs = NULL;\n"
+"static size_t nreqs = 0;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"static char *\n"
+"getcmd(void)\n"
+"{\n"
+"    static char buf[256];\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    fputs(\"E<gt> \", stdout); fflush(stdout);\n"
+"    if (fgets(buf, sizeof(buf), stdin) == NULL)\n"
+"        return NULL;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    if (buf[strlen(buf) - 1] == \\[aq]\\en\\[aq])\n"
+"        buf[strlen(buf) - 1] = 0;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    return buf;\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"/* Add requests for specified hostnames. */\n"
+"static void\n"
+"add_requests(void)\n"
+"{\n"
+"    size_t nreqs_base = nreqs;\n"
+"    char *host;\n"
+"    int ret;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    while ((host = strtok(NULL, \" \"))) {\n"
+"        nreqs++;\n"
+"        reqs = realloc(reqs, sizeof(reqs[0]) * nreqs);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        reqs[nreqs - 1] = calloc(1, sizeof(*reqs[0]));\n"
+"        reqs[nreqs - 1]-E<gt>ar_name = strdup(host);\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid "    /* Queue nreqs_base..nreqs requests. */\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    ret = getaddrinfo_a(GAI_NOWAIT, &reqs[nreqs_base],\n"
+"                        nreqs - nreqs_base, NULL);\n"
+"    if (ret) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"/* Wait until at least one of specified requests completes. */\n"
+"static void\n"
+"wait_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+"    struct gaicb const **wait_reqs = calloc(nreqs, sizeof(*wait_reqs));\n"
+"                /* NULL elements are ignored by gai_suspend(). */\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    while ((id = strtok(NULL, \" \")) != NULL) {\n"
+"        n = atoi(id);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        if (n E<gt>= nreqs) {\n"
+"            printf(\"Bad request number: %s\\en\", id);\n"
+"            return;\n"
+"        }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        wait_reqs[n] = reqs[n];\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    ret = gai_suspend(wait_reqs, nreqs, NULL);\n"
+"    if (ret) {\n"
+"        printf(\"gai_suspend(): %s\\en\", gai_strerror(ret));\n"
+"        return;\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        if (wait_reqs[i] == NULL)\n"
+"            continue;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == EAI_INPROGRESS)\n"
+"            continue;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        printf(\"[%02zu] %s: %s\\en\", i, reqs[i]-E<gt>ar_name,\n"
+"               ret == 0 ? \"Finished\" : gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"/* Cancel specified requests. */\n"
+"static void\n"
+"cancel_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        ret = gai_cancel(reqs[n]);\n"
+"        printf(\"[%s] %s: %s\\en\", id, reqs[atoi(id)]-E<gt>ar_name,\n"
+"               gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"/* List all requests. */\n"
+"static void\n"
+"list_requests(void)\n"
+"{\n"
+"    int ret;\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        printf(\"[%02zu] %s: \", i, reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        if (!ret) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"int\n"
+"main(void)\n"
+"{\n"
+"    char *cmdline;\n"
+"    char *cmd;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    while ((cmdline = getcmd()) != NULL) {\n"
+"        cmd = strtok(cmdline, \" \");\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"        if (cmd == NULL) {\n"
+"            list_requests();\n"
+"        } else {\n"
+"            switch (cmd[0]) {\n"
+"            case \\[aq]a\\[aq]:\n"
+"                add_requests();\n"
+"                break;\n"
+"            case \\[aq]w\\[aq]:\n"
+"                wait_requests();\n"
+"                break;\n"
+"            case \\[aq]c\\[aq]:\n"
+"                cancel_requests();\n"
+"                break;\n"
+"            case \\[aq]l\\[aq]:\n"
+"                list_requests();\n"
+"                break;\n"
+"            default:\n"
+"                fprintf(stderr, \"Bad command: %c\\en\", cmd[0]);\n"
+"                break;\n"
+"            }\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"B<getaddrinfo>(3), B<inet>(3), B<lio_listio>(3), B<hostname>(7), B<ip>(7), "
+"B<sigevent>(7)"
+msgstr ""
+
+#. type: TH
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid "2023-07-20"
+msgstr ""
+
+#. type: TH
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid "Linux man-pages 6.05.01"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>netdb.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"\\&\n"
+"int\n"
+"main(int argc, char *argv[])\n"
+"{\n"
+"    int ret;\n"
+"    struct gaicb *reqs[argc - 1];\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+"\\&\n"
+"    if (argc E<lt> 2) {\n"
+"        fprintf(stderr, \"Usage: %s HOST...\\en\", argv[0]);\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        reqs[i] = malloc(sizeof(*reqs[0]));\n"
+"        if (reqs[i] == NULL) {\n"
+"            perror(\"malloc\");\n"
+"            exit(EXIT_FAILURE);\n"
+"        }\n"
+"        memset(reqs[i], 0, sizeof(*reqs[0]));\n"
+"        reqs[i]-E<gt>ar_name = argv[i + 1];\n"
+"    }\n"
+"\\&\n"
+"    ret = getaddrinfo_a(GAI_WAIT, reqs, argc - 1, NULL);\n"
+"    if (ret != 0) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> argc - 1; i++) {\n"
+"        printf(\"%s: \", reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == 0) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+"\\&\n"
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret != 0) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+"\\&\n"
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>netdb.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"\\&\n"
+"static struct gaicb **reqs = NULL;\n"
+"static size_t nreqs = 0;\n"
+"\\&\n"
+"static char *\n"
+"getcmd(void)\n"
+"{\n"
+"    static char buf[256];\n"
+"\\&\n"
+"    fputs(\"E<gt> \", stdout); fflush(stdout);\n"
+"    if (fgets(buf, sizeof(buf), stdin) == NULL)\n"
+"        return NULL;\n"
+"\\&\n"
+"    if (buf[strlen(buf) - 1] == \\[aq]\\en\\[aq])\n"
+"        buf[strlen(buf) - 1] = 0;\n"
+"\\&\n"
+"    return buf;\n"
+"}\n"
+"\\&\n"
+"/* Add requests for specified hostnames. */\n"
+"static void\n"
+"add_requests(void)\n"
+"{\n"
+"    size_t nreqs_base = nreqs;\n"
+"    char *host;\n"
+"    int ret;\n"
+"\\&\n"
+"    while ((host = strtok(NULL, \" \"))) {\n"
+"        nreqs++;\n"
+"        reqs = realloc(reqs, sizeof(reqs[0]) * nreqs);\n"
+"\\&\n"
+"        reqs[nreqs - 1] = calloc(1, sizeof(*reqs[0]));\n"
+"        reqs[nreqs - 1]-E<gt>ar_name = strdup(host);\n"
+"    }\n"
+"\\&\n"
+"    /* Queue nreqs_base..nreqs requests. */\n"
+"\\&\n"
+"    ret = getaddrinfo_a(GAI_NOWAIT, &reqs[nreqs_base],\n"
+"                        nreqs - nreqs_base, NULL);\n"
+"    if (ret) {\n"
+"        fprintf(stderr, \"getaddrinfo_a() failed: %s\\en\",\n"
+"                gai_strerror(ret));\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* Wait until at least one of specified requests completes. */\n"
+"static void\n"
+"wait_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+"    struct gaicb const **wait_reqs = calloc(nreqs, sizeof(*wait_reqs));\n"
+"                /* NULL elements are ignored by gai_suspend(). */\n"
+"\\&\n"
+"    while ((id = strtok(NULL, \" \")) != NULL) {\n"
+"        n = atoi(id);\n"
+"\\&\n"
+"        if (n E<gt>= nreqs) {\n"
+"            printf(\"Bad request number: %s\\en\", id);\n"
+"            return;\n"
+"        }\n"
+"\\&\n"
+"        wait_reqs[n] = reqs[n];\n"
+"    }\n"
+"\\&\n"
+"    ret = gai_suspend(wait_reqs, nreqs, NULL);\n"
+"    if (ret) {\n"
+"        printf(\"gai_suspend(): %s\\en\", gai_strerror(ret));\n"
+"        return;\n"
+"    }\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        if (wait_reqs[i] == NULL)\n"
+"            continue;\n"
+"\\&\n"
+"        ret = gai_error(reqs[i]);\n"
+"        if (ret == EAI_INPROGRESS)\n"
+"            continue;\n"
+"\\&\n"
+"        printf(\"[%02zu] %s: %s\\en\", i, reqs[i]-E<gt>ar_name,\n"
+"               ret == 0 ? \"Finished\" : gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* Cancel specified requests. */\n"
+"static void\n"
+"cancel_requests(void)\n"
+"{\n"
+"    char *id;\n"
+"    int ret;\n"
+"    size_t n;\n"
+"\\&\n"
+"    while ((id = strtok(NULL, \" \")) != NULL) {\n"
+"        n = atoi(id);\n"
+"\\&\n"
+"        if (n E<gt>= nreqs) {\n"
+"            printf(\"Bad request number: %s\\en\", id);\n"
+"            return;\n"
+"        }\n"
+"\\&\n"
+"        ret = gai_cancel(reqs[n]);\n"
+"        printf(\"[%s] %s: %s\\en\", id, reqs[atoi(id)]-E<gt>ar_name,\n"
+"               gai_strerror(ret));\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"/* List all requests. */\n"
+"static void\n"
+"list_requests(void)\n"
+"{\n"
+"    int ret;\n"
+"    char host[NI_MAXHOST];\n"
+"    struct addrinfo *res;\n"
+"\\&\n"
+"    for (size_t i = 0; i E<lt> nreqs; i++) {\n"
+"        printf(\"[%02zu] %s: \", i, reqs[i]-E<gt>ar_name);\n"
+"        ret = gai_error(reqs[i]);\n"
+"\\&\n"
+"        if (!ret) {\n"
+"            res = reqs[i]-E<gt>ar_result;\n"
+"\\&\n"
+"            ret = getnameinfo(res-E<gt>ai_addr, res-E<gt>ai_addrlen,\n"
+"                              host, sizeof(host),\n"
+"                              NULL, 0, NI_NUMERICHOST);\n"
+"            if (ret) {\n"
+"                fprintf(stderr, \"getnameinfo() failed: %s\\en\",\n"
+"                        gai_strerror(ret));\n"
+"                exit(EXIT_FAILURE);\n"
+"            }\n"
+"            puts(host);\n"
+"        } else {\n"
+"            puts(gai_strerror(ret));\n"
+"        }\n"
+"    }\n"
+"}\n"
+"\\&\n"
+"int\n"
+"main(void)\n"
+"{\n"
+"    char *cmdline;\n"
+"    char *cmd;\n"
+"\\&\n"
+"    while ((cmdline = getcmd()) != NULL) {\n"
+"        cmd = strtok(cmdline, \" \");\n"
+"\\&\n"
+"        if (cmd == NULL) {\n"
+"            list_requests();\n"
+"        } else {\n"
+"            switch (cmd[0]) {\n"
+"            case \\[aq]a\\[aq]:\n"
+"                add_requests();\n"
+"                break;\n"
+"            case \\[aq]w\\[aq]:\n"
+"                wait_requests();\n"
+"                break;\n"
+"            case \\[aq]c\\[aq]:\n"
+"                cancel_requests();\n"
+"                break;\n"
+"            case \\[aq]l\\[aq]:\n"
+"                list_requests();\n"
+"                break;\n"
+"            default:\n"
+"                fprintf(stderr, \"Bad command: %c\\en\", cmd[0]);\n"
+"                break;\n"
+"            }\n"
+"        }\n"
+"    }\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6
+#, no-wrap
+msgid "2023-03-30"
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6
+#, no-wrap
+msgid "Linux man-pages 6.04"
+msgstr ""