Skip to contentSkip to conversation

kbuild: document RPS/XPS network Kconfig options

PATCH In review David Decotigny 2 participants 4 messages Nov 17, 2011 1 message not in the archive

Subsystems (2)
lore
Share & tools
lore
#1 lore raw

PATCH v6 3/9 kbuild: document RPS/XPS network Kconfig options

In reply to a message not in the archive

This adds a description of RPS/XPS options and allow them to be changed at make menuconfig time.

It also fixes following checkpatch syntax warnings:
ERROR: trailing whitespace
+^I $

ERROR: trailing whitespace
+^I$

---
 net/Kconfig |   21 ++++++++++++++++-----
 1 files changed, 16 insertions(+), 5 deletions(-)
net/Kconfig +16 -5
index a073148..991379e 100644
@@ -10,7 +10,7 @@ menuconfig NET
 	  The reason is that some programs need kernel networking support even
 	  when running on a stand-alone machine that isn't connected to any
 	  other computer.
-	  
+
 	  If you are upgrading from an older kernel, you
 	  should consider updating your networking tools too because changes
 	  in the kernel and the tools often go hand in hand. The tools are
@@ -217,20 +217,32 @@ source "net/dns_resolver/Kconfig"
 source "net/batman-adv/Kconfig"
 
 config RPS
-	boolean
+	boolean "Enable Receive Packet Steering"
 	depends on SMP && SYSFS && USE_GENERIC_SMP_HELPERS
 	default y
+	help
+	  RPS distributes the load of received packet processing
+	  across multiple CPUs. If unsure, say Y.
 
 config RFS_ACCEL
-	boolean
+	boolean "Enable Hardware Acceleration of RFS"
 	depends on RPS && GENERIC_HARDIRQS
 	select CPU_RMAP
 	default y
+	help
+	  Allow drivers for multiqueue hardware with flow filter
+	  tables to accelerate RFS. If unsure, say Y.
 
 config XPS
-	boolean
+	boolean "Enable Transmit Packet Steering"
 	depends on SMP && SYSFS && USE_GENERIC_SMP_HELPERS
 	default y
+	help
+	  For multiqueue devices, XPS selects a transmit queue during
+	  packet transmission based on configuration. This is done by
+	  mapping the CPU transmitting the packet to a queue. XPS can
+	  reduce transmit network latency on SMP systems. If unsure,
+	  say Y.
 
 config HAVE_BPF_JIT
 	bool
@@ -274,7 +286,6 @@ config NET_TCPPROBE
 
 	Documentation on how to use TCP connection probing can be found
 	at:
-	
 	  http://www.linuxfoundation.org/collaborate/workgroups/networking/tcpprobe
 
 	To compile this code as a module, choose M here: the
Signature · 1 line
1.7.3.1
maintainer
#2 lore raw

From: David Decotigny <[email protected]>
Date: Wed, 16 Nov 2011 18:39:05 -0800

Quoted 2 lines

This adds a description of RPS/XPS options and allow them to be changed at make menuconfig time.

These aren't meant to be selectable.

They are expressing internal dependencies so we don't have to crap up the code with the complicated dependency conditional test.

They are meant to be turned on, unconditionally, when the dependencies are met. They are not meant to be controllable by the user.

#3 lore raw
Quoted 7 lines · David Miller

From: David Decotigny <[email protected]>
Date: Wed, 16 Nov 2011 18:39:05 -0800

Quoted 2 lines

This adds a description of RPS/XPS options and allow them to be changed at make menuconfig time.

These aren't meant to be selectable.

Ok. I only needed this for our compilation scripts in order to make sure I didn't have my CONFIG_* wrong in patch 4/9. I don't need this patch anymore.

David, should I re-send an updated v7 version of this series with this patch removed? Or is it Ok if I simply mark this patch as rejected in patchwork and stick to patch series v6?

maintainer
#4 lore raw

From: David Decotigny <[email protected]>
Date: Wed, 16 Nov 2011 19:04:58 -0800

Quoted 3 lines

David, should I re-send an updated v7 version of this series with this patch removed? Or is it Ok if I simply mark this patch as rejected in patchwork and stick to patch series v6?

I'll try to apply v6 as-is sans patch #3.