From: Paul E. McKenney Date: Thu, 28 Jul 2022 19:04:00 +0000 (-0700) Subject: doc: Use rcu_barrier() to rate-limit RCU callbacks X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=1c1c1d983e75f53b3e307804a39d17d24310c5f2;p=linux.git doc: Use rcu_barrier() to rate-limit RCU callbacks The checklist.rst document advises periodic synchronize_rcu() invocations to prevent callback flooding. However, rcu_barrier() is often a better choice. This commit therefore adds words to this effect. Signed-off-by: Paul E. McKenney --- diff --git a/Documentation/RCU/checklist.rst b/Documentation/RCU/checklist.rst index 2db206fc3465f..178ca7547b987 100644 --- a/Documentation/RCU/checklist.rst +++ b/Documentation/RCU/checklist.rst @@ -305,7 +305,8 @@ over a rather long period of time, but improvements are always welcome! the machine. d. Periodically invoke synchronize_rcu(), permitting a limited - number of updates per grace period. + number of updates per grace period. Better yet, periodically + invoke rcu_barrier() to wait for all outstanding callbacks. The same cautions apply to call_srcu() and kfree_rcu().