diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /templates/man2/recvmmsg.2.pot | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | templates/man2/recvmmsg.2.pot | 608 |
1 files changed, 608 insertions, 0 deletions
diff --git a/templates/man2/recvmmsg.2.pot b/templates/man2/recvmmsg.2.pot new file mode 100644 index 00000000..1ac58ab6 --- /dev/null +++ b/templates/man2/recvmmsg.2.pot @@ -0,0 +1,608 @@ +# 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 17:05+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 "recvmmsg" +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 "recvmmsg - receive multiple messages on a socket" +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 "Standard C library (I<libc>, I<-lc>)" +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>sys/socket.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 recvmmsg(int >I<sockfd>B<, struct mmsghdr *>I<msgvec>B<, unsigned int >I<vlen>B<,>\n" +"B< int >I<flags>B<, struct timespec *>I<timeout>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<recvmmsg>() system call is an extension of B<recvmsg>(2) that allows " +"the caller to receive multiple messages from a socket using a single system " +"call. (This has performance benefits for some applications.) A further " +"extension over B<recvmsg>(2) is support for a timeout on the receive " +"operation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<sockfd> argument is the file descriptor of the socket to receive data " +"from." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<msgvec> argument is a pointer to an array of I<mmsghdr> structures. " +"The size of this array is specified in I<vlen>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The I<mmsghdr> structure is defined in I<E<lt>sys/socket.hE<gt>> as:" +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 mmsghdr {\n" +" struct msghdr msg_hdr; /* Message header */\n" +" unsigned int msg_len; /* Number of received bytes for header */\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 I<msg_hdr> field is a I<msghdr> structure, as described in " +"B<recvmsg>(2). The I<msg_len> field is the number of bytes returned for the " +"message in the entry. This field has the same value as the return value of " +"a single B<recvmsg>(2) on the header." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<flags> argument contains flags ORed together. The flags are the same " +"as documented for B<recvmsg>(2), with the following addition:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<MSG_WAITFORONE> (since Linux 2.6.34)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Turns on B<MSG_DONTWAIT> after the first message has been received." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<timeout> argument points to a I<struct timespec> (see " +"B<clock_gettime>(2)) defining a timeout (seconds plus nanoseconds) for the " +"receive operation (I<but see BUGS!>). (This interval will be rounded up to " +"the system clock granularity, and kernel scheduling delays mean that the " +"blocking interval may overrun by a small amount.) If I<timeout> is NULL, " +"then the operation blocks indefinitely." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A blocking B<recvmmsg>() call blocks until I<vlen> messages have been " +"received or until the timeout expires. A nonblocking call reads as many " +"messages as are available (up to the limit specified by I<vlen>) and " +"returns immediately." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On return from B<recvmmsg>(), successive elements of I<msgvec> are updated " +"to contain information about each received message: I<msg_len> contains the " +"size of the received message; the subfields of I<msg_hdr> are updated as " +"described in B<recvmsg>(2). The return value of the call indicates the " +"number of elements of I<msgvec> that have been updated." +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 "" +"On success, B<recvmmsg>() returns the number of messages received in " +"I<msgvec>; on error, -1 is returned, and I<errno> is set to indicate the " +"error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Errors are as for B<recvmsg>(2). In addition, the following error can occur:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<timeout> is invalid." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "See also BUGS." +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 "Linux." +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 "Linux 2.6.33, glibc 2.12." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. FIXME . https://bugzilla.kernel.org/show_bug.cgi?id=75371 +#. http://thread.gmane.org/gmane.linux.man/5677 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<timeout> argument does not work as intended. The timeout is checked " +"only after the receipt of each datagram, so that if up to I<vlen-1> " +"datagrams are received before the timeout expires, but then no further " +"datagrams are received, the call will block forever." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If an error occurs after at least one message has been received, the call " +"succeeds, and returns the number of messages received. The error code is " +"expected to be returned on a subsequent call to B<recvmmsg>(). In the " +"current implementation, however, the error code can be overwritten in the " +"meantime by an unrelated network event on a socket, for example an incoming " +"ICMP packet." +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 "" +"The following program uses B<recvmmsg>() to receive multiple messages on a " +"socket and stores them in multiple buffers. The call returns if all buffers " +"are filled or if the timeout specified has expired." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The following snippet periodically generates UDP datagrams containing a " +"random number:" +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< while true; do echo $RANDOM E<gt> /dev/udp/127.0.0.1/1234;>\n" +"B<sleep 0.25; done>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"These datagrams are read by the example application, which can give the " +"following output:" +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" +"5 messages received\n" +"1 11782\n" +"2 11345\n" +"3 304\n" +"4 13514\n" +"5 28421\n" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Program source" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>arpa/inet.hE<gt>\n" +"#include E<lt>netinet/in.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/socket.hE<gt>\n" +"#include E<lt>time.hE<gt>\n" +"\\&\n" +"int\n" +"main(void)\n" +"{\n" +"#define VLEN 10\n" +"#define BUFSIZE 200\n" +"#define TIMEOUT 1\n" +" int sockfd, retval;\n" +" char bufs[VLEN][BUFSIZE+1];\n" +" struct iovec iovecs[VLEN];\n" +" struct mmsghdr msgs[VLEN];\n" +" struct timespec timeout;\n" +" struct sockaddr_in addr;\n" +"\\&\n" +" sockfd = socket(AF_INET, SOCK_DGRAM, 0);\n" +" if (sockfd == -1) {\n" +" perror(\"socket()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" addr.sin_family = AF_INET;\n" +" addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK);\n" +" addr.sin_port = htons(1234);\n" +" if (bind(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == -1) {\n" +" perror(\"bind()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" memset(msgs, 0, sizeof(msgs));\n" +" for (size_t i = 0; i E<lt> VLEN; i++) {\n" +" iovecs[i].iov_base = bufs[i];\n" +" iovecs[i].iov_len = BUFSIZE;\n" +" msgs[i].msg_hdr.msg_iov = &iovecs[i];\n" +" msgs[i].msg_hdr.msg_iovlen = 1;\n" +" }\n" +"\\&\n" +" timeout.tv_sec = TIMEOUT;\n" +" timeout.tv_nsec = 0;\n" +"\\&\n" +" retval = recvmmsg(sockfd, msgs, VLEN, 0, &timeout);\n" +" if (retval == -1) {\n" +" perror(\"recvmmsg()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" printf(\"%d messages received\\en\", retval);\n" +" for (size_t i = 0; i E<lt> retval; i++) {\n" +" bufs[i][msgs[i].msg_len] = 0;\n" +" printf(\"%zu %s\", i+1, bufs[i]);\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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<clock_gettime>(2), B<recvmsg>(2), B<sendmmsg>(2), B<sendmsg>(2), " +"B<socket>(2), B<socket>(7)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2022-12-04" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: SH +#: debian-bookworm +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"The B<recvmmsg>() system call was added in Linux 2.6.33. Support in glibc " +"was added in glibc 2.12." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "B<recvmmsg>() is Linux-specific." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>arpa/inet.hE<gt>\n" +"#include E<lt>netinet/in.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/socket.hE<gt>\n" +"#include E<lt>time.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(void)\n" +"{\n" +"#define VLEN 10\n" +"#define BUFSIZE 200\n" +"#define TIMEOUT 1\n" +" int sockfd, retval;\n" +" char bufs[VLEN][BUFSIZE+1];\n" +" struct iovec iovecs[VLEN];\n" +" struct mmsghdr msgs[VLEN];\n" +" struct timespec timeout;\n" +" struct sockaddr_in addr;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" sockfd = socket(AF_INET, SOCK_DGRAM, 0);\n" +" if (sockfd == -1) {\n" +" perror(\"socket()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" addr.sin_family = AF_INET;\n" +" addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK);\n" +" addr.sin_port = htons(1234);\n" +" if (bind(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == -1) {\n" +" perror(\"bind()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" memset(msgs, 0, sizeof(msgs));\n" +" for (size_t i = 0; i E<lt> VLEN; i++) {\n" +" iovecs[i].iov_base = bufs[i];\n" +" iovecs[i].iov_len = BUFSIZE;\n" +" msgs[i].msg_hdr.msg_iov = &iovecs[i];\n" +" msgs[i].msg_hdr.msg_iovlen = 1;\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" timeout.tv_sec = TIMEOUT;\n" +" timeout.tv_nsec = 0;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" retval = recvmmsg(sockfd, msgs, VLEN, 0, &timeout);\n" +" if (retval == -1) {\n" +" perror(\"recvmmsg()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"%d messages received\\en\", retval);\n" +" for (size_t i = 0; i E<lt> retval; i++) {\n" +" bufs[i][msgs[i].msg_len] = 0;\n" +" printf(\"%zu %s\", i+1, bufs[i]);\n" +" }\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-05-03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +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 "" |