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>
This commit is contained in:
Sridhar Samudrala 2020-10-27 18:15:22 -07:00 committed by Michael Kerrisk
parent f36f4f855b
commit e8500ecc78
1 changed files with 12 additions and 0 deletions

View File

@ -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.