diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man2/sendmmsg.2.pot | 541 |
1 files changed, 541 insertions, 0 deletions
diff --git a/templates/man2/sendmmsg.2.pot b/templates/man2/sendmmsg.2.pot new file mode 100644 index 00000000..b1790c14 --- /dev/null +++ b/templates/man2/sendmmsg.2.pot @@ -0,0 +1,541 @@ +# 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:07+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 "sendmmsg" +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 "sendmmsg - send 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 sendmmsg(int >I<sockfd>B<, struct mmsghdr *>I<msgvec>B<, unsigned int >I<vlen>B<,>\n" +"B< int >I<flags>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 "" + +#. See commit 228e548e602061b08ee8e8966f567c12aa079682 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<sendmmsg>() system call is an extension of B<sendmsg>(2) that allows " +"the caller to transmit multiple messages on a socket using a single system " +"call. (This has performance benefits for some applications.)" +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 on which data is " +"to be transmitted." +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 bytes transmitted */\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<sendmsg>(2). The I<msg_len> field is used to return the number of bytes " +"sent from the message in I<msg_hdr> (i.e., the same as the return value from " +"a single B<sendmsg>(2) call)." +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 for B<sendmsg>(2)." +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<sendmmsg>() call blocks until I<vlen> messages have been " +"sent. A nonblocking call sends as many messages as possible (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<sendmmsg>(), the I<msg_len> fields of successive elements " +"of I<msgvec> are updated to contain the number of bytes transmitted from the " +"corresponding I<msg_hdr>. 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<sendmmsg>() returns the number of messages sent from " +"I<msgvec>; if this is less than I<vlen>, the caller can retry with a further " +"B<sendmmsg>() call to send the remaining messages." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "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 "" + +# +#. commit 728ffb86f10873aaf4abd26dde691ee40ae731fe +#. ... only return an error if no datagrams could be sent. +#. If less than the requested number of messages were sent, the application +#. must retry starting at the first failed one and if the problem is +#. persistent the error will be returned. +#. This matches the behavior of other syscalls like read/write - it +#. is not an error if less than the requested number of elements are sent. +#. 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<sendmsg>(2). An error is returned only if no datagrams " +"could be sent. 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 3.0, glibc 2.14." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +# +# +#. commit 98382f419f32d2c12d021943b87dea555677144b +#. net: Cap number of elements for sendmmsg +#. To limit the amount of time we can spend in sendmmsg, cap the +#. number of elements to UIO_MAXIOV (currently 1024). +#. For error handling an application using sendmmsg needs to retry at +#. the first unsent message, so capping is simpler and requires less +#. application logic than returning EINVAL. +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The value specified in I<vlen> is capped to B<UIO_MAXIOV> (1024)." +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 "" + +#. 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 sent, the call " +"succeeds, and returns the number of messages sent. The error code is lost. " +"The caller can retry the transmission, starting at the first failed message, " +"but there is no guarantee that, if an error is returned, it will be the same " +"as the one that was lost on the previous call." +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 example below uses B<sendmmsg>() to send I<onetwo> and I<three> in two " +"distinct UDP datagrams using one system call. The contents of the first " +"datagram originates from a pair of buffers." +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>sys/types.hE<gt>\n" +"\\&\n" +"int\n" +"main(void)\n" +"{\n" +" int retval;\n" +" int sockfd;\n" +" struct iovec msg1[2], msg2;\n" +" struct mmsghdr msg[2];\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 (connect(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == -1) {\n" +" perror(\"connect()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" memset(msg1, 0, sizeof(msg1));\n" +" msg1[0].iov_base = \"one\";\n" +" msg1[0].iov_len = 3;\n" +" msg1[1].iov_base = \"two\";\n" +" msg1[1].iov_len = 3;\n" +"\\&\n" +" memset(&msg2, 0, sizeof(msg2));\n" +" msg2.iov_base = \"three\";\n" +" msg2.iov_len = 5;\n" +"\\&\n" +" memset(msg, 0, sizeof(msg));\n" +" msg[0].msg_hdr.msg_iov = msg1;\n" +" msg[0].msg_hdr.msg_iovlen = 2;\n" +"\\&\n" +" msg[1].msg_hdr.msg_iov = &msg2;\n" +" msg[1].msg_hdr.msg_iovlen = 1;\n" +"\\&\n" +" retval = sendmmsg(sockfd, msg, 2, 0);\n" +" if (retval == -1)\n" +" perror(\"sendmmsg()\");\n" +" else\n" +" printf(\"%d messages sent\\en\", retval);\n" +"\\&\n" +" exit(0);\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<recvmmsg>(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<sendmmsg>() system call was added in Linux 3.0. Support in glibc was " +"added in Linux 2.14." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "B<sendmmsg>() 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>sys/types.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(void)\n" +"{\n" +" int retval;\n" +" int sockfd;\n" +" struct iovec msg1[2], msg2;\n" +" struct mmsghdr msg[2];\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 (connect(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == -1) {\n" +" perror(\"connect()\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" memset(msg1, 0, sizeof(msg1));\n" +" msg1[0].iov_base = \"one\";\n" +" msg1[0].iov_len = 3;\n" +" msg1[1].iov_base = \"two\";\n" +" msg1[1].iov_len = 3;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" memset(&msg2, 0, sizeof(msg2));\n" +" msg2.iov_base = \"three\";\n" +" msg2.iov_len = 5;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" memset(msg, 0, sizeof(msg));\n" +" msg[0].msg_hdr.msg_iov = msg1;\n" +" msg[0].msg_hdr.msg_iovlen = 2;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" msg[1].msg_hdr.msg_iov = &msg2;\n" +" msg[1].msg_hdr.msg_iovlen = 1;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" retval = sendmmsg(sockfd, msg, 2, 0);\n" +" if (retval == -1)\n" +" perror(\"sendmmsg()\");\n" +" else\n" +" printf(\"%d messages sent\\en\", retval);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" exit(0);\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 "" |