[PATCH v2] socket.7: Add description of SO_SELECT_ERR_QUEUE

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Signed-off-by: Ricardo Biehl Pasquali <pasqualirb@xxxxxxxxx>
---
 man7/socket.7 | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

Jonathan, can you help to reach Michael or review yourself?
Sorry for bothering you.

It's the fourth time I'm sending this.
First time was on 2019-02-28.

version 2: Rewrite the description for greater clarity.

diff --git a/man7/socket.7 b/man7/socket.7
index b8d053dfe..b43075185 100644
--- a/man7/socket.7
+++ b/man7/socket.7
@@ -49,10 +49,6 @@
 .\"	commit a8fc92778080c845eaadc369a0ecf5699a03bef0
 .\"	Author: Pavel Emelyanov <xemul@xxxxxxxxxxxxx>
 .\"
-.\" SO_SELECT_ERR_QUEUE (3.10)
-.\"	commit 7d4c04fc170087119727119074e72445f2bb192b
-.\"	Author: Keller, Jacob E <jacob.e.keller@xxxxxxxxx>
-.\"
 .\" SO_MAX_PACING_RATE (3.13)
 .\"	commit 62748f32d501f5d3712a7c372bbb92abc7c62bc7
 .\"	Author: Eric Dumazet <edumazet@xxxxxxxxxx>
@@ -869,6 +865,28 @@ 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 since its creation.
 .TP
+.BR SO_SELECT_ERR_QUEUE " (since Linux 3.10)"
+.\"	commit 7d4c04fc170087119727119074e72445f2bb192b
+.\"	Author: Keller, Jacob E <jacob.e.keller@xxxxxxxxx>
+Makes poll adding
+.B POLLPRI
+when
+.B POLLERR
+event is returned. It does not affect wake up.
+.IP
+Background: The flag was added when waking up on
+.B POLLERR
+required requesting
+.B POLLIN
+or
+.B POLLPRI.
+After the commit 6e5d58fdc9bedd0255a8 ("skbuff: Fix not
+waking applications when errors are enqueued"), introduced
+in Linux 4.16, waking up on
+.B POLLERR
+does not require requesting other events. The flag is kept
+only for backwards compatibility.
+.TP
 .B SO_SNDBUF
 Sets or gets the maximum socket send buffer in bytes.
 The kernel doubles this value (to allow space for bookkeeping overhead)
-- 
2.19.1



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux