rcu: Provide a boot time parameter to control lazy RCU
authorQais Yousef <qyousef@layalina.io>
Sun, 3 Dec 2023 01:12:52 +0000 (01:12 +0000)
committerBoqun Feng <boqun.feng@gmail.com>
Wed, 14 Feb 2024 16:00:57 +0000 (08:00 -0800)
To allow more flexible arrangements while still provide a single kernel
for distros, provide a boot time parameter to enable/disable lazy RCU.

Specify:

rcutree.enable_rcu_lazy=[y|1|n|0]

Which also requires

rcu_nocbs=all

at boot time to enable/disable lazy RCU.

To disable it by default at build time when CONFIG_RCU_LAZY=y, the new
CONFIG_RCU_LAZY_DEFAULT_OFF can be used.

Signed-off-by: Qais Yousef (Google) <qyousef@layalina.io>
Tested-by: Andrea Righi <andrea.righi@canonical.com>
Reviewed-by: Paul E. McKenney <paulmck@kernel.org>
Signed-off-by: Boqun Feng <boqun.feng@gmail.com>
Documentation/admin-guide/kernel-parameters.txt
kernel/rcu/Kconfig
kernel/rcu/tree.c

index 31b3a25680d08cfac3603d58b3d3783bbf1e34bb..b6c848c29a53da12bba2c44052eff42fe7d6d952 100644 (file)
                        this kernel boot parameter, forcibly setting it
                        to zero.
 
+       rcutree.enable_rcu_lazy= [KNL]
+                       To save power, batch RCU callbacks and flush after
+                       delay, memory pressure or callback list growing too
+                       big.
+
        rcuscale.gp_async= [KNL]
                        Measure performance of asynchronous
                        grace-period primitives such as call_rcu().
index bdd7eadb33d8fe0039349f8295cc967c9f137289..e7d2dd2675931fac627947959f3fbb9e93aae05b 100644 (file)
@@ -314,6 +314,19 @@ config RCU_LAZY
          To save power, batch RCU callbacks and flush after delay, memory
          pressure, or callback list growing too big.
 
+         Requires rcu_nocbs=all to be set.
+
+         Use rcutree.enable_rcu_lazy=0 to turn it off at boot time.
+
+config RCU_LAZY_DEFAULT_OFF
+       bool "Turn RCU lazy invocation off by default"
+       depends on RCU_LAZY
+       default n
+       help
+         Allows building the kernel with CONFIG_RCU_LAZY=y yet keep it default
+         off. Boot time param rcutree.enable_rcu_lazy=1 can be used to switch
+         it back on.
+
 config RCU_DOUBLE_CHECK_CB_TIME
        bool "RCU callback-batch backup time check"
        depends on RCU_EXPERT
index b2bccfd37c383d04692fb6a7a72eb71a1f62798b..41c50a6c607ef460197aa98c5a8d0f72ba1454e4 100644 (file)
@@ -2753,6 +2753,9 @@ __call_rcu_common(struct rcu_head *head, rcu_callback_t func, bool lazy_in)
 }
 
 #ifdef CONFIG_RCU_LAZY
+static bool enable_rcu_lazy __read_mostly = !IS_ENABLED(CONFIG_RCU_LAZY_DEFAULT_OFF);
+module_param(enable_rcu_lazy, bool, 0444);
+
 /**
  * call_rcu_hurry() - Queue RCU callback for invocation after grace period, and
  * flush all lazy callbacks (including the new one) to the main ->cblist while
@@ -2778,6 +2781,8 @@ void call_rcu_hurry(struct rcu_head *head, rcu_callback_t func)
        __call_rcu_common(head, func, false);
 }
 EXPORT_SYMBOL_GPL(call_rcu_hurry);
+#else
+#define enable_rcu_lazy                false
 #endif
 
 /**
@@ -2826,7 +2831,7 @@ EXPORT_SYMBOL_GPL(call_rcu_hurry);
  */
 void call_rcu(struct rcu_head *head, rcu_callback_t func)
 {
-       __call_rcu_common(head, func, IS_ENABLED(CONFIG_RCU_LAZY));
+       __call_rcu_common(head, func, enable_rcu_lazy);
 }
 EXPORT_SYMBOL_GPL(call_rcu);