#, 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/socket.7:56
#, no-wrap
msgid "SOCKET"
msgstr ""

#. type: TH
#: man-pages/man7/socket.7:56
#, no-wrap
msgid "2014-07-08"
msgstr ""

#. type: TH
#: man-pages/man7/socket.7:56
#, no-wrap
msgid "Linux"
msgstr ""

#. type: TH
#: man-pages/man7/socket.7:56
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:57
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:59
msgid "socket - Linux socket interface"
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:59
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:61
msgid "B<#include E<lt>sys/socket.hE<gt>>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:63
msgid ""
"I<sockfd>B< = socket(int >I<socket_family>B<, int >I<socket_type>B<, int "
">I<protocol>B<);>"
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:63
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:82
msgid ""
"This manual page describes the Linux networking socket layer user interface. "
" The BSD compatible sockets are the uniform interface between the user "
"process and the network protocol stacks in the kernel.  The protocol modules "
"are grouped into I<protocol families> such as B<AF_INET>, B<AF_IPX>, and "
"B<AF_PACKET>, and I<socket types> such as B<SOCK_STREAM> or B<SOCK_DGRAM>.  "
"See B<socket>(2)  for more information on families and types."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:82
#, no-wrap
msgid "Socket-layer functions"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:86
msgid ""
"These functions are used by the user process to send or receive packets and "
"to do other socket operations.  For more information see their respective "
"manual pages."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:102
msgid ""
"B<socket>(2)  creates a socket, B<connect>(2)  connects a socket to a remote "
"socket address, the B<bind>(2)  function binds a socket to a local socket "
"address, B<listen>(2)  tells the socket that new connections shall be "
"accepted, and B<accept>(2)  is used to get a new socket with a new incoming "
"connection.  B<socketpair>(2)  returns two connected anonymous sockets "
"(implemented only for a few local families like B<AF_UNIX>)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:124
msgid ""
"B<send>(2), B<sendto>(2), and B<sendmsg>(2)  send data over a socket, and "
"B<recv>(2), B<recvfrom>(2), B<recvmsg>(2)  receive data from a socket.  "
"B<poll>(2)  and B<select>(2)  wait for arriving data or a readiness to send "
"data.  In addition, the standard I/O operations like B<write>(2), "
"B<writev>(2), B<sendfile>(2), B<read>(2), and B<readv>(2)  can be used to "
"read and write data."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:135
msgid ""
"B<getsockname>(2)  returns the local socket address and B<getpeername>(2)  "
"returns the remote socket address.  B<getsockopt>(2)  and B<setsockopt>(2)  "
"are used to set or get socket layer or protocol options.  B<ioctl>(2)  can "
"be used to set or read some other options."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:140
msgid ""
"B<close>(2)  is used to close a socket.  B<shutdown>(2)  closes parts of a "
"full-duplex socket connection."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:146
msgid ""
"Seeking, or calling B<pread>(2)  or B<pwrite>(2)  with a nonzero position is "
"not supported on sockets."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:163
msgid ""
"It is possible to do nonblocking I/O on sockets by setting the B<O_NONBLOCK> "
"flag on a socket file descriptor using B<fcntl>(2).  Then all operations "
"that would block will (usually)  return with B<EAGAIN> (operation should be "
"retried later); B<connect>(2)  will return B<EINPROGRESS> error.  The user "
"can then wait for various events via B<poll>(2)  or B<select>(2)."
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:167
#, no-wrap
msgid "I/O events\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:168
#, no-wrap
msgid "Event:Poll flag:Occurrence\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:169 man-pages/man7/socket.7:172
#, no-wrap
msgid "Read:POLLIN:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:170
#, no-wrap
msgid "New data arrived.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:171 man-pages/man7/socket.7:175 man-pages/man7/socket.7:178 man-pages/man7/socket.7:184 man-pages/man7/socket.7:187 man-pages/man7/socket.7:196 man-pages/man7/socket.7:203
#, no-wrap
msgid "T}\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:173
#, no-wrap
msgid "A connection setup has been completed\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:174
#, no-wrap
msgid "(for connection-oriented sockets)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:176 man-pages/man7/socket.7:179
#, no-wrap
msgid "Read:POLLHUP:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:177
#, no-wrap
msgid "A disconnection request has been initiated by the other end.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:180
#, no-wrap
msgid "A connection is broken (only for connection-oriented protocols).\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:181
#, no-wrap
msgid "When the socket is written\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:182
#, no-wrap
msgid "B<SIGPIPE>\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:183
#, no-wrap
msgid "is also sent.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:185
#, no-wrap
msgid "Write:POLLOUT:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:186
#, no-wrap
msgid "Socket has enough send buffer space for writing new data.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:188
#, no-wrap
msgid "Read/Write:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:189
#, no-wrap
msgid "POLLIN|\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:190
#, no-wrap
msgid ".br\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:191
#, no-wrap
msgid "POLLOUT\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:192
#, no-wrap
msgid "T}:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:193
#, no-wrap
msgid "An outgoing\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:194
#, no-wrap
msgid "B<connect>(2)\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:195
#, no-wrap
msgid "finished.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:197
#, no-wrap
msgid "Read/Write:POLLERR:An asynchronous error occurred.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:198
#, no-wrap
msgid "Read/Write:POLLHUP:The other end has shut down one direction.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:199
#, no-wrap
msgid "Exception:POLLPRI:T{\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:200
#, no-wrap
msgid "Urgent data arrived.\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:201
#, no-wrap
msgid "B<SIGURG>\n"
msgstr ""

#. type: tbl table
#: man-pages/man7/socket.7:202
#, no-wrap
msgid "is sent then.\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:231
msgid ""
"An alternative to B<poll>(2)  and B<select>(2)  is to let the kernel inform "
"the application about events via a B<SIGIO> signal.  For that the B<O_ASYNC> "
"flag must be set on a socket file descriptor via B<fcntl>(2)  and a valid "
"signal handler for B<SIGIO> must be installed via B<sigaction>(2).  See the "
"I<Signals> discussion below."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:231
#, no-wrap
msgid "Socket address structures"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:247
msgid ""
"Each socket domain has its own format for socket addresses, with a domain-"
"specific address structure.  Each of these structures begins with an integer "
"\"family\" field (typed as I<sa_family_t>)  that indicates the type of the "
"address structure.  This allows the various system calls (e.g., "
"B<connect>(2), B<bind>(2), B<accept>(2), B<getsockname>(2), "
"B<getpeername>(2)), which are generic to all socket domains, to determine "
"the domain of a particular socket address."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:257
msgid ""
"To allow any type of socket address to be passed to interfaces in the "
"sockets API, the type I<struct sockaddr> is defined.  The purpose of this "
"type is purely to allow casting of domain-specific socket address types to a "
"\"generic\" type, so as to avoid compiler warnings about type mismatches in "
"calls to the sockets API."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:267
msgid ""
"In addition, the sockets API provides the data type I<struct "
"sockaddr_storage>.  This type is suitable to accommodate all supported "
"domain-specific socket address structures; it is large enough and is aligned "
"properly.  (In particular, it is large enough to hold IPv6 socket addresses."
")  The structure includes the following field, which can be used to identify "
"the type of socket address actually stored in the structure:"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:271
#, no-wrap
msgid "    sa_family_t ss_family;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:279
msgid ""
"The I<sockaddr_storage> structure is useful in programs that must handle "
"socket addresses in a generic way (e.g., programs that must deal with both "
"IPv4 and IPv6 socket addresses)."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:279
#, no-wrap
msgid "Socket options"
msgstr ""

#.  FIXME
#.  In the list below, the text used to describe argument types
#.  for each socket option should be more consistent
#.  SO_ACCEPTCONN is in POSIX.1-2001, and its origin is explained in
#.  W R Stevens, UNPv1
#. type: Plain text
#: man-pages/man7/socket.7:297
msgid ""
"The socket options listed below can be set by using B<setsockopt>(2)  and "
"read with B<getsockopt>(2)  with the socket level set to B<SOL_SOCKET> for "
"all sockets.  Unless otherwise noted, I<optval> is a pointer to an I<int>."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:297
#, no-wrap
msgid "B<SO_ACCEPTCONN>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:305
msgid ""
"Returns a value indicating whether or not this socket has been marked to "
"accept connections with B<listen>(2).  The value 0 indicates that this is "
"not a listening socket, the value 1 indicates that this is a listening "
"socket.  This socket option is read-only."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:305
#, no-wrap
msgid "B<SO_BINDTODEVICE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:324
msgid ""
"Bind this socket to a particular device like \\(lqeth0\\(rq, as specified in "
"the passed interface name.  If the name is an empty string or the option "
"length is zero, the socket device binding is removed.  The passed option is "
"a variable-length null-terminated interface name string with the maximum "
"size of B<IFNAMSIZ>.  If a socket is bound to an interface, only packets "
"received from that particular interface are processed by the socket.  Note "
"that this works only for some socket types, particularly B<AF_INET> sockets. "
" It is not supported for packet sockets (use normal B<bind>(2)  there)."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:338
msgid ""
"Before Linux 3.8, this socket option could be set, but could not retrieved "
"with B<getsockopt>(2).  Since Linux 3.8, it is readable.  The I<optlen> "
"argument should contain the buffer size available to receive the device name "
"and is recommended to be B<IFNAMSZ> bytes.  The real device name length is "
"reported back in the I<optlen> argument."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:338
#, no-wrap
msgid "B<SO_BROADCAST>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:344
msgid ""
"Set or get the broadcast flag.  When enabled, datagram sockets are allowed "
"to send packets to a broadcast address.  This option has no effect on stream-"
"oriented sockets."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:344
#, no-wrap
msgid "B<SO_BSDCOMPAT>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:356
msgid ""
"Enable BSD bug-to-bug compatibility.  This is used by the UDP protocol "
"module in Linux 2.0 and 2.2.  If enabled, ICMP errors received for a UDP "
"socket will not be passed to the user program.  In later kernel versions, "
"support for this option has been phased out: Linux 2.4 silently ignores it, "
"and Linux 2.6 generates a kernel warning (printk()) if a program uses this "
"option.  Linux 2.0 also enabled BSD bug-to-bug compatibility options (random "
"header changing, skipping of the broadcast flag) for raw sockets with this "
"option, but that was removed in Linux 2.2."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:356
#, no-wrap
msgid "B<SO_DEBUG>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:362
msgid ""
"Enable socket debugging.  Only allowed for processes with the "
"B<CAP_NET_ADMIN> capability or an effective user ID of 0."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:362
#, no-wrap
msgid "B<SO_DOMAIN> (since Linux 2.6.32)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:370
msgid ""
"Retrieves the socket domain as an integer, returning a value such as "
"B<AF_INET6>.  See B<socket>(2)  for details.  This socket option is read-"
"only."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:370
#, no-wrap
msgid "B<SO_ERROR>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:375
msgid ""
"Get and clear the pending socket error.  This socket option is read-only.  "
"Expects an integer."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:375
#, no-wrap
msgid "B<SO_DONTROUTE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:384
msgid ""
"Don't send via a gateway, send only to directly connected hosts.  The same "
"effect can be achieved by setting the B<MSG_DONTROUTE> flag on a socket "
"B<send>(2)  operation.  Expects an integer boolean flag."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:384
#, no-wrap
msgid "B<SO_KEEPALIVE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:388
msgid ""
"Enable sending of keep-alive messages on connection-oriented sockets.  "
"Expects an integer boolean flag."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:388
#, no-wrap
msgid "B<SO_LINGER>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:396
msgid ""
"Sets or gets the B<SO_LINGER> option.  The argument is a I<linger> structure."
""
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:403
#, no-wrap
msgid ""
"struct linger {\n"
"    int l_onoff;    /* linger active */\n"
"    int l_linger;   /* how many seconds to linger for */\n"
"};\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:417
msgid ""
"When enabled, a B<close>(2)  or B<shutdown>(2)  will not return until all "
"queued messages for the socket have been successfully sent or the linger "
"timeout has been reached.  Otherwise, the call returns immediately and the "
"closing is done in the background.  When the socket is closed as part of "
"B<exit>(2), it always lingers in the background."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:417
#, no-wrap
msgid "B<SO_MARK> (since Linux 2.6.25)"
msgstr ""

#.  commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0
#.  and    914a9ab386a288d0f22252fc268ecbc048cdcbd5
#. type: Plain text
#: man-pages/man7/socket.7:428
msgid ""
"Set the mark for each packet sent through this socket (similar to the "
"netfilter MARK target but socket-based).  Changing the mark can be used for "
"mark-based routing without netfilter or for packet filtering.  Setting this "
"option requires the B<CAP_NET_ADMIN> capability."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:428
#, no-wrap
msgid "B<SO_OOBINLINE>"
msgstr ""

#.  don't document it because it can do too much harm.
#. .B SO_NO_CHECK
#. type: Plain text
#: man-pages/man7/socket.7:437
msgid ""
"If this option is enabled, out-of-band data is directly placed into the "
"receive data stream.  Otherwise, out-of-band data is passed only when the "
"B<MSG_OOB> flag is set during receiving."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:437
#, no-wrap
msgid "B<SO_PASSCRED>"
msgstr ""

#.  FIXME Document SO_PASSSEC, added in 2.6.18; there is some info
#.  in the 2.6.18 ChangeLog
#. type: Plain text
#: man-pages/man7/socket.7:446
msgid ""
"Enable or disable the receiving of the B<SCM_CREDENTIALS> control message.  "
"For more information see B<unix>(7)."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:446
#, no-wrap
msgid "B<SO_PEEK_OFF> (since Linux 3.4)"
msgstr ""

#.  commit ef64a54f6e558155b4f149bb10666b9e914b6c54
#. type: Plain text
#: man-pages/man7/socket.7:456
msgid ""
"This option, which is currently supported only for B<unix>(7)  sockets, sets "
"the value of the \"peek offset\" for the B<recv>(2)  system call when used "
"with B<MSG_PEEK> flag."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:464
msgid ""
"When this option is set to a negative value (it is set to -1 for all new "
"sockets), traditional behavior is provided: B<recv>(2)  with the B<MSG_PEEK> "
"flag will peek data from the front of the queue."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:471
msgid ""
"When the option is set to a value greater than or equal to zero, then the "
"next peek at data queued in the socket will occur at the byte offset "
"specified by the option value.  At the same time, the \"peek offset\" will "
"be incremented by the number of bytes that were peeked from the queue, so "
"that a subsequent peek will return the next data in the queue."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:483
msgid ""
"If data is removed from the front of the queue via a call to B<recv>(2)  (or "
"similar) without the B<MSG_PEEK> flag, the \"peek offset\" will be decreased "
"by the number of bytes removed.  In other words, receiving data without the "
"B<MSG_PEEK> flag will cause the \"peek offset\" to be adjusted to maintain "
"the correct relative position in the queued data, so that a subsequent peek "
"will retrieve the data that would have been retrieved had the data not been "
"removed."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:488
msgid ""
"For datagram sockets, if the \"peek offset\" points to the middle of a "
"packet, the data returned will be marked with the B<MSG_TRUNC> flag."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:492
msgid ""
"The following example serves to illustrate the use of B<SO_PEEK_OFF>.  "
"Suppose a stream socket has the following queued input data:"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:494
#, no-wrap
msgid "    aabbccddeeff\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:499
msgid ""
"The following sequence of B<recv>(2)  calls would have the effect noted in "
"the comments:"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:504
#, no-wrap
msgid ""
"int ov = 4;                  // Set peek offset to 4\n"
"setsockopt(fd, SOL_SOCKET, SO_PEEK_OFF, &ov, sizeof(ov));\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:509
#, no-wrap
msgid ""
"recv(fd, buf, 2, MSG_PEEK);  // Peeks \"cc\"; offset set to 6\n"
"recv(fd, buf, 2, MSG_PEEK);  // Peeks \"dd\"; offset set to 8\n"
"recv(fd, buf, 2, 0);         // Reads \"aa\"; offset set to 6\n"
"recv(fd, buf, 2, MSG_PEEK);  // Peeks \"ee\"; offset set to 8\n"
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:511
#, no-wrap
msgid "B<SO_PEERCRED>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:534
msgid ""
"Return the credentials of the foreign process connected to this socket.  "
"This is possible only for connected B<AF_UNIX> stream sockets and B<AF_UNIX> "
"stream and datagram socket pairs created using B<socketpair>(2); see "
"B<unix>(7).  The returned credentials are those that were in effect at the "
"time of the call to B<connect>(2)  or B<socketpair>(2).  The argument is a "
"I<ucred> structure; define the B<_GNU_SOURCE> feature test macro to obtain "
"the definition of that structure from I<E<lt>sys/socket.hE<gt>>.  This "
"socket option is read-only."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:534
#, no-wrap
msgid "B<SO_PRIORITY>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:547
msgid ""
"Set the protocol-defined priority for all packets to be sent on this socket. "
" Linux uses this value to order the networking queues: packets with a higher "
"priority may be processed first depending on the selected device queueing "
"discipline.  For B<ip>(7), this also sets the IP type-of-service (TOS) field "
"for outgoing packets.  Setting a priority outside the range 0 to 6 requires "
"the B<CAP_NET_ADMIN> capability."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:547
#, no-wrap
msgid "B<SO_PROTOCOL> (since Linux 2.6.32)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:555
msgid ""
"Retrieves the socket protocol as an integer, returning a value such as "
"B<IPPROTO_SCTP>.  See B<socket>(2)  for details.  This socket option is read-"
"only."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:555
#, no-wrap
msgid "B<SO_RCVBUF>"
msgstr ""

#.  Most (all?) other implementations do not do this -- MTK, Dec 05
#.  The following thread on LMKL is quite informative:
#.  getsockopt/setsockopt with SO_RCVBUF and SO_SNDBUF "non-standard" behavior
#.  17 July 2012
#.  http://thread.gmane.org/gmane.linux.kernel/1328935
#. type: Plain text
#: man-pages/man7/socket.7:574
msgid ""
"Sets or gets the maximum socket receive buffer in bytes.  The kernel doubles "
"this value (to allow space for bookkeeping overhead)  when it is set using "
"B<setsockopt>(2), and this doubled value is returned by B<getsockopt>(2).  "
"The default value is set by the I</proc/sys/net/core/rmem_default> file, and "
"the maximum allowed value is set by the I</proc/sys/net/core/rmem_max> file. "
" The minimum (doubled) value for this option is 256."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:574
#, no-wrap
msgid "B<SO_RCVBUFFORCE> (since Linux 2.6.14)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:583
msgid ""
"Using this socket option, a privileged (B<CAP_NET_ADMIN>)  process can "
"perform the same task as B<SO_RCVBUF>, but the I<rmem_max> limit can be "
"overridden."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:583
#, no-wrap
msgid "B<SO_RCVLOWAT> and B<SO_SNDLOWAT>"
msgstr ""

#.  See http://marc.theaimsgroup.com/?l=linux-kernel&m=111049368106984&w=2
#.  Tested on kernel 2.6.14 -- mtk, 30 Nov 05
#. type: Plain text
#: man-pages/man7/socket.7:612
msgid ""
"Specify the minimum number of bytes in the buffer until the socket layer "
"will pass the data to the protocol (B<SO_SNDLOWAT>)  or the user on "
"receiving (B<SO_RCVLOWAT>).  These two values are initialized to 1.  "
"B<SO_SNDLOWAT> is not changeable on Linux (B<setsockopt>(2)  fails with the "
"error B<ENOPROTOOPT>).  B<SO_RCVLOWAT> is changeable only since Linux 2.4.  "
"The B<select>(2)  and B<poll>(2)  system calls currently do not respect the "
"B<SO_RCVLOWAT> setting on Linux, and mark a socket readable when even a "
"single byte of data is available.  A subsequent read from the socket will "
"block until B<SO_RCVLOWAT> bytes are available."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:612
#, no-wrap
msgid "B<SO_RCVTIMEO> and B<SO_SNDTIMEO>"
msgstr ""

#.  Not implemented in 2.0.
#.  Implemented in 2.1.11 for getsockopt: always return a zero struct.
#.  Implemented in 2.3.41 for setsockopt, and actually used.
#.  in fact to EAGAIN
#. type: Plain text
#: man-pages/man7/socket.7:647
msgid ""
"Specify the receiving or sending timeouts until reporting an error.  The "
"argument is a I<struct timeval>.  If an input or output function blocks for "
"this period of time, and data has been sent or received, the return value of "
"that function will be the amount of data transferred; if no data has been "
"transferred and the timeout has been reached, then -1 is returned with "
"I<errno> set to B<EAGAIN> or B<EWOULDBLOCK>, or B<EINPROGRESS> (for "
"B<connect>(2))  just as if the socket was specified to be nonblocking.  If "
"the timeout is set to zero (the default), then the operation will never "
"timeout.  Timeouts only have effect for system calls that perform socket I/O "
"(e.g., B<read>(2), B<recvmsg>(2), B<send>(2), B<sendmsg>(2)); timeouts have "
"no effect for B<select>(2), B<poll>(2), B<epoll_wait>(2), and so on."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:647
#, no-wrap
msgid "B<SO_REUSEADDR>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:662
msgid ""
"Indicates that the rules used in validating addresses supplied in a "
"B<bind>(2)  call should allow reuse of local addresses.  For B<AF_INET> "
"sockets this means that a socket may bind, except when there is an active "
"listening socket bound to the address.  When the listening socket is bound "
"to B<INADDR_ANY> with a specific port then it is not possible to bind to "
"this port for any local address.  Argument is an integer boolean flag."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:662
#, no-wrap
msgid "B<SO_RXQ_OVFL> (since Linux 2.6.33)"
msgstr ""

#.  commit 3b885787ea4112eaa80945999ea0901bf742707f
#. type: Plain text
#: man-pages/man7/socket.7:669
msgid ""
"Indicates that an unsigned 32-bit value ancillary message (cmsg)  should be "
"attached to received skbs indicating the number of packets dropped by the "
"socket between the last received packet and this received packet."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:669
#, no-wrap
msgid "B<SO_SNDBUF>"
msgstr ""

#.  Most (all?) other implementations do not do this -- MTK, Dec 05
#.  See also the comment to SO_RCVBUF (17 Jul 2012 LKML mail)
#. type: Plain text
#: man-pages/man7/socket.7:685
msgid ""
"Sets or gets the maximum socket send buffer in bytes.  The kernel doubles "
"this value (to allow space for bookkeeping overhead)  when it is set using "
"B<setsockopt>(2), and this doubled value is returned by B<getsockopt>(2).  "
"The default value is set by the I</proc/sys/net/core/wmem_default> file and "
"the maximum allowed value is set by the I</proc/sys/net/core/wmem_max> file. "
" The minimum (doubled) value for this option is 2048."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:685
#, no-wrap
msgid "B<SO_SNDBUFFORCE> (since Linux 2.6.14)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:694
msgid ""
"Using this socket option, a privileged (B<CAP_NET_ADMIN>)  process can "
"perform the same task as B<SO_SNDBUF>, but the I<wmem_max> limit can be "
"overridden."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:694
#, no-wrap
msgid "B<SO_TIMESTAMP>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:710
msgid ""
"Enable or disable the receiving of the B<SO_TIMESTAMP> control message.  The "
"timestamp control message is sent with level B<SOL_SOCKET> and the "
"I<cmsg_data> field is a I<struct timeval> indicating the reception time of "
"the last packet passed to the user in this call.  See B<cmsg>(3)  for "
"details on control messages."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:710
#, no-wrap
msgid "B<SO_TYPE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:715
msgid ""
"Gets the socket type as an integer (e.g., B<SOCK_STREAM>).  This socket "
"option is read-only."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:715
#, no-wrap
msgid "B<SO_BUSY_POLL> (since Linux 3.11)"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:724
msgid ""
"Sets the approximate time in microseconds to busy poll on a blocking receive "
"when there is no data.  Increasing this value requires B<CAP_NET_ADMIN>.  "
"The default for this option is controlled by the I</proc/sys/net/core/"
"busy_read> file."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:734
msgid ""
"The value in the I</proc/sys/net/core/busy_poll> file determines how long "
"B<select>(2)  and B<poll>(2)  will busy poll when they operate on sockets "
"with B<SO_BUSY_POLL> set and no events to report are found."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:738
msgid ""
"In both cases, busy polling will only be done when the socket last received "
"data from a network device that supports this option."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:742
msgid ""
"While busy polling may improve latency of some applications, care must be "
"taken when using it since this will increase both CPU utilization and power "
"usage."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:742
#, no-wrap
msgid "Signals"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:753
msgid ""
"When writing onto a connection-oriented socket that has been shut down (by "
"the local or the remote end)  B<SIGPIPE> is sent to the writing process and "
"B<EPIPE> is returned.  The signal is not sent when the write call specified "
"the B<MSG_NOSIGNAL> flag."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:778
msgid ""
"When requested with the B<FIOSETOWN> B<fcntl>(2)  or B<SIOCSPGRP> "
"B<ioctl>(2), B<SIGIO> is sent when an I/O event occurs.  It is possible to "
"use B<poll>(2)  or B<select>(2)  in the signal handler to find out which "
"socket the event occurred on.  An alternative (in Linux 2.2) is to set a "
"real-time signal using the B<F_SETSIG> B<fcntl>(2); the handler of the real "
"time signal will be called with the file descriptor in the I<si_fd> field of "
"its I<siginfo_t>.  See B<fcntl>(2)  for more information."
msgstr ""

#.  .SS Ancillary messages
#. type: Plain text
#: man-pages/man7/socket.7:786
msgid ""
"Under some circumstances (e.g., multiple processes accessing a single "
"socket), the condition that caused the B<SIGIO> may have already disappeared "
"when the process reacts to the signal.  If this happens, the process should "
"wait again because Linux will resend the signal later."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:786
#, no-wrap
msgid "/proc interfaces"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:790
msgid ""
"The core socket networking parameters can be accessed via files in the "
"directory I</proc/sys/net/core/>."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:790
#, no-wrap
msgid "I<rmem_default>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:793
msgid "contains the default setting in bytes of the socket receive buffer."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:793
#, no-wrap
msgid "I<rmem_max>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:799
msgid ""
"contains the maximum socket receive buffer size in bytes which a user may "
"set by using the B<SO_RCVBUF> socket option."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:799
#, no-wrap
msgid "I<wmem_default>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:802
msgid "contains the default setting in bytes of the socket send buffer."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:802
#, no-wrap
msgid "I<wmem_max>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:808
msgid ""
"contains the maximum socket send buffer size in bytes which a user may set "
"by using the B<SO_SNDBUF> socket option."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:808
#, no-wrap
msgid "I<message_cost> and I<message_burst>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:812
msgid ""
"configure the token bucket filter used to load limit warning messages caused "
"by external network events."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:812
#, no-wrap
msgid "I<netdev_max_backlog>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:815
msgid "Maximum number of packets in the global input queue."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:815
#, no-wrap
msgid "I<optmem_max>"
msgstr ""

#.  netdev_fastroute is not documented because it is experimental
#. type: Plain text
#: man-pages/man7/socket.7:820
msgid ""
"Maximum length of ancillary data and user control data like the iovecs per "
"socket."
msgstr ""

#. type: SS
#: man-pages/man7/socket.7:820
#, no-wrap
msgid "Ioctls"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:823
msgid "These operations can be accessed using B<ioctl>(2):"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:827
#, no-wrap
msgid ""
"I<error>B< = ioctl(>I<ip_socket>B<, >I<ioctl_type>B<, "
">I<&value_result>B<);>\n"
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:829
#, no-wrap
msgid "B<SIOCGSTAMP>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:853
msgid ""
"Return a I<struct timeval> with the receive timestamp of the last packet "
"passed to the user.  This is useful for accurate round trip time "
"measurements.  See B<setitimer>(2)  for a description of I<struct timeval>.  "
"This ioctl should be used only if the socket option B<SO_TIMESTAMP> is not "
"set on the socket.  Otherwise, it returns the timestamp of the last packet "
"that was received while B<SO_TIMESTAMP> was not set, or it fails if no such "
"packet has been received, (i.e., B<ioctl>(2)  returns -1 with I<errno> set "
"to B<ENOENT>)."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:853
#, no-wrap
msgid "B<SIOCSPGRP>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:872
msgid ""
"Set the process or process group to send B<SIGIO> or B<SIGURG> signals to "
"when an asynchronous I/O operation has finished or urgent data is available. "
" The argument is a pointer to a I<pid_t>.  If the argument is positive, send "
"the signals to that process.  If the argument is negative, send the signals "
"to the process group with the ID of the absolute value of the argument.  The "
"process may only choose itself or its own process group to receive signals "
"unless it has the B<CAP_KILL> capability or an effective UID of 0."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:872
#, no-wrap
msgid "B<FIOASYNC>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:882
msgid ""
"Change the B<O_ASYNC> flag to enable or disable asynchronous I/O mode of the "
"socket.  Asynchronous I/O mode means that the B<SIGIO> signal or the signal "
"set with B<F_SETSIG> is raised when a new I/O event occurs."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:890
msgid ""
"Argument is an integer boolean flag.  (This operation is synonymous with the "
"use of B<fcntl>(2)  to set the B<O_ASYNC> flag.)"
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:890
#, no-wrap
msgid "B<SIOCGPGRP>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:899
msgid ""
"Get the current process or process group that receives B<SIGIO> or B<SIGURG> "
"signals, or 0 when none is set."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:903
msgid "Valid B<fcntl>(2)  operations:"
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:903
#, no-wrap
msgid "B<FIOGETOWN>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:908
msgid "The same as the B<SIOCGPGRP> B<ioctl>(2)."
msgstr ""

#. type: TP
#: man-pages/man7/socket.7:908
#, no-wrap
msgid "B<FIOSETOWN>"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:913
msgid "The same as the B<SIOCSPGRP> B<ioctl>(2)."
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:913
#, no-wrap
msgid "VERSIONS"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:927
msgid ""
"B<SO_BINDTODEVICE> was introduced in Linux 2.0.30.  B<SO_PASSCRED> is new in "
"Linux 2.2.  The I</proc> interfaces was introduced in Linux 2.2.  "
"B<SO_RCVTIMEO> and B<SO_SNDTIMEO> are supported since Linux 2.3.41.  "
"Earlier, timeouts were fixed to a protocol-specific setting, and could not "
"be read or written."
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:927
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:932
msgid ""
"Linux assumes that half of the send/receive buffer is used for internal "
"kernel structures; thus the values in the corresponding I</proc> files are "
"twice what can be observed on the wire."
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:945
msgid ""
"Linux will only allow port reuse with the B<SO_REUSEADDR> option when this "
"option was set both in the previous program that performed a B<bind>(2)  to "
"the port and in the program that wants to reuse the port.  This differs from "
"some implementations (e.g., FreeBSD)  where only the later program needs to "
"set the B<SO_REUSEADDR> option.  Typically this difference is invisible, "
"since, for example, a server program is designed to always set this option."
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:945
#, no-wrap
msgid "BUGS"
msgstr ""

#.  FIXME Document SO_ATTACH_FILTER and SO_DETACH_FILTER
#.  .SH AUTHORS
#.  This man page was written by Andi Kleen.
#. type: Plain text
#: man-pages/man7/socket.7:958
msgid ""
"The B<CONFIG_FILTER> socket options B<SO_ATTACH_FILTER> and "
"B<SO_DETACH_FILTER> are not documented.  The suggested interface to use them "
"is via the libpcap library."
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:958
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:970
msgid ""
"B<connect>(2), B<getsockopt>(2), B<setsockopt>(2), B<socket>(2), "
"B<capabilities>(7), B<ddp>(7), B<ip>(7), B<packet>(7), B<tcp>(7), B<udp>(7), "
"B<unix>(7)"
msgstr ""

#. type: SH
#: man-pages/man7/socket.7:970
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: man-pages/man7/socket.7:978
msgid ""
"This page is part of release 3.70 of the Linux I<man-pages> project.  A "
"description of the project, information about reporting bugs, and the latest "
"version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/"
"."
msgstr ""