aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSridhar Samudrala <sridhar.samudrala@intel.com>2020-10-27 18:15:22 -0700
committerMichael Kerrisk <mtk.manpages@gmail.com>2020-10-28 07:15:43 +0100
commite8500ecc786f5ee5854d4aa810dcf5124e8ed23f (patch)
tree182121c72137af74ace763218c94a10557599db3
parentf36f4f855b8898d58d20d31ef4d331c787ee7907 (diff)
downloadman-pages-e8500ecc786f5ee5854d4aa810dcf5124e8ed23f.tar.gz
socket.7: Document SO_INCOMING_NAPI_ID
Signed-off-by: Sridhar Samudrala <sridhar.samudrala@intel.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man7/socket.712
1 files changed, 12 insertions, 0 deletions
diff --git a/man7/socket.7 b/man7/socket.7
index 850d3162fb..1f38273e9f 100644
--- a/man7/socket.7
+++ b/man7/socket.7
@@ -519,6 +519,18 @@ This provides optimal NUMA behavior and keeps CPU caches hot.
.\" SO_REUSEPORT logic, selecting the socket to receive the packet, ignores
.\" SO_INCOMING_CPU setting.
.TP
+.BR SO_INCOMING_NAPI_ID " (gettable since Linux 4.12)"
+.\" getsockopt 6d4339028b350efbf87c61e6d9e113e5373545c9
+Returns a system level unique ID called NAPI ID that is associated with a RX
+queue on which the last packet associated with that socket is received.
+.IP
+This can be used by an application to split the incoming flows among worker
+threads based on the RX queue on which the packets associated with the flows
+are received. It allows each worker thread to be associated with a NIC HW
+receive queue and service all the connection requests received on that RX
+queue. This mapping between a app thread and a HW NIC queue streamlines the
+flow of data from the NIC to the application.
+.TP
.B SO_KEEPALIVE
Enable sending of keep-alive messages on connection-oriented sockets.
Expects an integer boolean flag.