# 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-03-01 17:12+0100\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 "udp" 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 "udp - User Datagram Protocol for IPv4" 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<#include Esys/socket.hE>\n" "B<#include Enetinet/in.hE>\n" "B<#include Enetinet/udp.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 "IB< = socket(AF_INET, SOCK_DGRAM, 0);>\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 "" "This is an implementation of the User Datagram Protocol described in RFC\\ " "768. It implements a connectionless, unreliable datagram packet service. " "Packets may be reordered or duplicated before they arrive. UDP generates " "and checks checksums to catch transmission errors." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When a UDP socket is created, its local and remote addresses are " "unspecified. Datagrams can be sent immediately using B(2) or " "B(2) with a valid destination address as an argument. When " "B(2) is called on the socket, the default destination address is " "set and datagrams can now be sent using B(2) or B(2) without " "specifying a destination address. It is still possible to send to other " "destinations by passing an address to B(2) or B(2). In " "order to receive packets, the socket can be bound to a local address first " "by using B(2). Otherwise, the socket layer will automatically assign " "a free local port out of the range defined by I and bind the socket to B." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "All receive operations return only one packet. When the packet is smaller " "than the passed buffer, only that much data is returned; when it is bigger, " "the packet is truncated and the B flag is set. B is " "not supported." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "IP options may be sent or received using the socket options described in " "B(7). They are processed by the kernel only when the appropriate I parameter is enabled (but still passed to the user even when it is " "turned off). See B(7)." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When the B flag is set on sending, the destination address " "must refer to a local interface address and the packet is sent only to that " "interface." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "By default, Linux UDP does path MTU (Maximum Transmission Unit) discovery. " "This means the kernel will keep track of the MTU to a specific target IP " "address and return B when a UDP packet write exceeds it. When " "this happens, the application should decrease the packet size. Path MTU " "discovery can be also turned off using the B socket option " "or the I file; see B(7) for " "details. When turned off, UDP will fragment outgoing UDP packets that " "exceed the interface MTU. However, disabling it is not recommended for " "performance and reliability reasons." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Address format" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "UDP uses the IPv4 I address format described in B(7)." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Error handling" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "All fatal errors will be passed to the user as an error return even when the " "socket is not connected. This includes asynchronous errors received from " "the network. You may get an error for an earlier packet that was sent on " "the same socket. This behavior differs from many other BSD socket " "implementations which don't pass any errors unless the socket is connected. " "Linux's behavior is mandated by B." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For compatibility with legacy code, in Linux 2.0 and 2.2 it was possible to " "set the B B option to receive remote errors only " "when the socket has been connected (except for B and B). " "Locally generated errors are always passed. Support for this socket option " "was removed in later kernels; see B(7) for further information." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "When the B option is enabled, all errors are stored in the " "socket error queue, and can be received by B(2) with the " "B flag set." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "/proc interfaces" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "System-wide UDP parameter settings can be accessed by files in the directory " "I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I (since Linux 2.6.25)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This is a vector of three integers governing the number of pages allowed for " "queueing by all UDP sockets." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Below this number of pages, UDP is not bothered about its memory appetite. " "When the amount of memory allocated by UDP exceeds this number, UDP starts " "to moderate memory usage." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This value was introduced to follow the format of I (see B(7))." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Number of pages allowed for queueing by all UDP sockets." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Defaults values for these three items are calculated at boot time from the " "amount of available memory." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I (integer; default value: PAGE_SIZE; since Linux 2.6.25)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Minimal size, in bytes, of receive buffers used by UDP sockets in " "moderation. Each UDP socket is able to use the size for receiving data, " "even if total pages of UDP sockets exceed I pressure." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I (integer; default value: PAGE_SIZE; since Linux 2.6.25)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Minimal size, in bytes, of send buffer used by UDP sockets in moderation. " "Each UDP socket is able to use the size for sending data, even if total " "pages of UDP sockets exceed I pressure." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Socket options" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "To set or get a UDP socket option, call B(2) to read or " "B(2) to write the option with the option level argument set to " "B. Unless otherwise noted, I is a pointer to an I." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Following is a list of UDP-specific socket options. For details of some " "other socket options that are also applicable for UDP sockets, see " "B(7)." 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.5.44)" msgstr "" #. FIXME document UDP_ENCAP (new in Linux 2.5.67) #. From include/linux/udp.h: #. UDP_ENCAP_ESPINUDP_NON_IKE draft-ietf-ipsec-nat-t-ike-00/01 #. UDP_ENCAP_ESPINUDP draft-ietf-ipsec-udp-encaps-06 #. UDP_ENCAP_L2TPINUDP rfc2661 #. FIXME Document UDP_NO_CHECK6_TX and UDP_NO_CHECK6_RX, added in Linux 3.16 #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If this option is enabled, then all data output on this socket is " "accumulated into a single datagram that is transmitted when the option is " "disabled. This option should not be used in code intended to be portable." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B (since Linux 4.18)" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Enables UDP segmentation offload. Segmentation offload reduces B(2) " "cost by transferring multiple datagrams worth of data as a single large " "packet through the kernel transmit path, even when that exceeds MTU. As " "late as possible, the large packet is split by segment size into a series of " "datagrams. This segmentation offload step is deferred to hardware if " "supported, else performed in software. This option takes a value in the " "range [B<0>,\\~B] that sets the segment size: the size of " "datagram payload, excluding the UDP header. The segment size must be chosen " "such that at most 64 datagrams are sent in a single call and that the " "datagrams after segmentation meet the same MTU rules that apply to datagrams " "sent without this option. Segmentation offload depends on checksum offload, " "as datagram checksums are computed after segmentation. The option may also " "be set for individual B(2) calls by passing it as a B(3). A " "value of zero disables the feature. This option should not be used in code " "intended to be portable." msgstr "" #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B (since Linux 5.0)" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Enables UDP receive offload. If enabled, the socket may receive multiple " "datagrams worth of data as a single large buffer, together with a " "B(3) that holds the segment size. This option is the inverse of " "segmentation offload. It reduces receive cost by handling multiple " "datagrams worth of data as a single large packet in the kernel receive path, " "even when that exceeds MTU. This option should not be used in code intended " "to be portable." msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Ioctls" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "These ioctls can be accessed using B(2). The correct syntax is:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "BI< value>B<;>\n" "IB< = ioctl(>IB<, >IB<, &>IB<);>\n" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B (B)" msgstr "" #. See http://www.securiteam.com/unixfocus/5KP0I15IKO.html #. "GNUnet DoS (UDP Socket Unreachable)", 14 May 2006 #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Gets a pointer to an integer as argument. Returns the size of the next " "pending datagram in the integer in bytes, or 0 when no datagram is pending. " "B Using B, it is impossible to distinguish the case " "where no datagram is pending from the case where the next pending datagram " "contains zero bytes of data. It is safer to use B