aboutsummaryrefslogtreecommitdiffstats
path: root/man7/socket.7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2005-12-14 10:27:30 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2005-12-14 10:27:30 +0000
commit514d7e5b9262ecf21f936f131bf6a6e2f6a7c3c7 (patch)
treeb949e5d8c0053ba7b3ec1ab00bd386861ff61d58 /man7/socket.7
parent9ae132041b6eff3788dff5a6a1d3fa45ae6f9e19 (diff)
downloadman-pages-514d7e5b9262ecf21f936f131bf6a6e2f6a7c3c7.tar.gz
Updated discussion of SO_BSDCOMPAT.
Reformatted some long lines.
Diffstat (limited to 'man7/socket.7')
-rw-r--r--man7/socket.734
1 files changed, 19 insertions, 15 deletions
diff --git a/man7/socket.7 b/man7/socket.7
index 9f87550343..c517bfd145 100644
--- a/man7/socket.7
+++ b/man7/socket.7
@@ -205,12 +205,13 @@ with the socket level set to
for all sockets:
.TP
.B SO_KEEPALIVE
-Enable sending of keep-alive messages on connection-oriented sockets. Expects
-an integer boolean flag.
+Enable sending of keep-alive messages on connection-oriented sockets.
+Expects an integer boolean flag.
.TP
.B SO_OOBINLINE
-If this option is enabled, out-of-band data is directly placed into the receive
-data stream. Otherwise out-of-band data is only passed when the
+If this option is enabled,
+out-of-band data is directly placed into the receive data stream.
+Otherwise out-of-band data is only passed when the
.B MSG_OOB
flag is set during receiving.
.\" don't document it because it can do too much harm.
@@ -264,13 +265,16 @@ If the timeout is set to zero (the default)
then the operation will never timeout.
.TP
.B SO_BSDCOMPAT
-Enable BSD bug-to-bug compatibility. This is used only by the UDP
-protocol module and scheduled to be removed in future.
+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. Linux 2.0 also enabled BSD bug-to-bug compatibility
+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 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 has been removed in Linux 2.2. It is
-better to fix the user programs than to enable this flag.
+sockets with this option, but that was removed in Linux 2.2.
.TP
.B SO_PASSCRED
Enable or disable the receiving of the
@@ -366,16 +370,16 @@ packets to a broadcast address.
This option has no effect on stream-oriented sockets.
.TP
.B SO_SNDBUF
-Sets or gets the maximum socket send buffer in bytes. The default value is set
-by the
+Sets or gets the maximum socket send buffer in bytes.
+The default value is set by the
.B wmem_default
sysctl and the maximum allowed value is set by the
.B wmem_max
sysctl.
.TP
.B SO_RCVBUF
-Sets or gets the maximum socket receive buffer in bytes. The default value is
-set by the
+Sets or gets the maximum socket receive buffer in bytes.
+The default value is set by the
.B rmem_default
sysctl and the maximum allowed value is set by the
.B rmem_max
@@ -573,8 +577,8 @@ capability or an effective UID of 0.
.B FIOASYNC
Change the
.B O_ASYNC
-flag to enable or disable asynchronous IO mode of the socket. Asynchronous IO
-mode means that the
+flag to enable or disable asynchronous IO mode of the socket.
+Asynchronous IO mode means that the
.B SIGIO
signal or the signal set with
.B F_SETSIG