# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-01 06:15+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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 debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "" #. type: TH #: archlinux debian-unstable #, no-wrap msgid "Linux man-pages 6.8" 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, 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 Esys/socket.hE>\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 "" "BIB<, struct mmsghdr *>IB<, unsigned int >IB<,>\n" "B< int >IB<, struct timespec *>IB<);>\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() system call is an extension of B(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(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 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 argument is a pointer to an array of I structures. " "The size of this array is specified in I." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The I structure is defined in Isys/socket.hE> 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 field is a I structure, as described in " "B(2). The I 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(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 argument contains flags ORed together. The flags are the same " "as documented for B(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 (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 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 argument points to a I (see " "B(2)) defining a timeout (seconds plus nanoseconds) for the " "receive operation (I). (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 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() call blocks until I 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) 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(), successive elements of I are updated " "to contain information about each received message: I contains the " "size of the received message; the subfields of I are updated as " "described in B(2). The return value of the call indicates the " "number of elements of I 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() returns the number of messages received in " "I; on error, -1 is returned, and I 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(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" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I 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 argument does not work as intended. The timeout is checked " "only after the receipt of each datagram, so that if up to I " "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(). 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() 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 /dev/udp/127.0.0.1/1234;>\n" "B\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 Earpa/inet.hE\n" "#include Enetinet/in.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Estring.hE\n" "#include Esys/socket.hE\n" "#include Etime.hE\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 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 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(2), B(2), B(2), B(2), " "B(2), B(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() 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() is Linux-specific." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "#define _GNU_SOURCE\n" "#include Earpa/inet.hE\n" "#include Enetinet/in.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Estring.hE\n" "#include Esys/socket.hE\n" "#include Etime.hE\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 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 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 #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-10-31" msgstr "" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" 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 "" #. type: TH #: opensuse-tumbleweed #, no-wrap msgid "Linux man-pages (unreleased)" msgstr ""