#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:57+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man7/udp.7:12 #, no-wrap msgid "UDP" msgstr "" #. type: TH #: man-pages/man7/udp.7:12 #, no-wrap msgid "2013-07-31" msgstr "" #. type: TH #: man-pages/man7/udp.7:12 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man7/udp.7:12 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man7/udp.7:13 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:15 msgid "udp - User Datagram Protocol for IPv4" msgstr "" #. type: SH #: man-pages/man7/udp.7:15 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:17 msgid "B<#include Esys/socket.hE>" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:19 msgid "B<#include Enetinet/in.hE>" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:21 msgid "B<#include Enetinet/udp.hE>" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:23 msgid "B" msgstr "" #. type: SH #: man-pages/man7/udp.7:23 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:29 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 #: man-pages/man7/udp.7:58 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 #: man-pages/man7/udp.7:66 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 #: man-pages/man7/udp.7:75 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 #: man-pages/man7/udp.7:80 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 #: man-pages/man7/udp.7:98 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 #: man-pages/man7/udp.7:98 #, no-wrap msgid "Address format" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:103 msgid "UDP uses the IPv4 I address format described in B(7)." msgstr "" #. type: SS #: man-pages/man7/udp.7:103 #, no-wrap msgid "Error handling" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:114 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 #: man-pages/man7/udp.7:128 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 #: man-pages/man7/udp.7:137 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 #: man-pages/man7/udp.7:137 #, no-wrap msgid "/proc interfaces" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:140 msgid "" "System-wide UDP parameter settings can be accessed by files in the directory " "I." msgstr "" #. type: TP #: man-pages/man7/udp.7:140 #, no-wrap msgid "I (since Linux 2.6.25)" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:144 msgid "" "This is a vector of three integers governing the number of pages allowed for " "queueing by all UDP sockets." msgstr "" #. type: TP #: man-pages/man7/udp.7:145 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:151 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 #: man-pages/man7/udp.7:151 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:157 msgid "" "This value was introduced to follow the format of I (see B(7))." "" msgstr "" #. type: TP #: man-pages/man7/udp.7:157 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:160 msgid "Number of pages allowed for queueing by all UDP sockets." msgstr "" #. type: Plain text #: man-pages/man7/udp.7:164 msgid "" "Defaults values for these three items are calculated at boot time from the " "amount of available memory." msgstr "" #. type: TP #: man-pages/man7/udp.7:164 #, no-wrap msgid "" "I (integer; default value: PAGE_SIZE; since Linux 2.6.25)" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:171 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 #: man-pages/man7/udp.7:171 #, no-wrap msgid "" "I (integer; default value: PAGE_SIZE; since Linux 2.6.25)" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:178 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 #: man-pages/man7/udp.7:178 #, no-wrap msgid "Socket options" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:189 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: TP #: man-pages/man7/udp.7:189 #, no-wrap msgid "B (since Linux 2.5.44)" msgstr "" #. FIXME document UDP_ENCAP (new in kernel 2.5.67) #. From include/linux/udp.h: #. /* UDP encapsulation types */ #. #define UDP_ENCAP_ESPINUDP_NON_IKE 1 /* draft-ietf-ipsec-nat-t-ike-00/01 */ #. #define UDP_ENCAP_ESPINUDP 2 /* draft-ietf-ipsec-udp-encaps-06 */ #. #define UDP_ENCAP_L2TPINUDP 3 /* rfc2661 */ #. type: Plain text #: man-pages/man7/udp.7:202 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: SS #: man-pages/man7/udp.7:202 #, no-wrap msgid "Ioctls" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:206 msgid "" "These ioctls can be accessed using B(2). The correct syntax is:" msgstr "" #. type: Plain text #: man-pages/man7/udp.7:211 #, no-wrap msgid "" "BI< value>B<;>\n" "IB< = ioctl(>IB<, >IB<, &>IB<);>\n" msgstr "" #. type: TP #: man-pages/man7/udp.7:213 #, 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 #: man-pages/man7/udp.7:231 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