summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul E. McKenney <paulmck@kernel.org>2022-07-28 21:04:00 +0200
committerPaul E. McKenney <paulmck@kernel.org>2022-08-31 13:58:15 +0200
commit1c1c1d983e75f53b3e307804a39d17d24310c5f2 (patch)
treedc25fb7d30fa26674fcfc7343dbd77ab51c5529f
parentdoc: Call out queue_rcu_work() for blocking RCU callbacks (diff)
downloadlinux-1c1c1d983e75f53b3e307804a39d17d24310c5f2.tar.xz
linux-1c1c1d983e75f53b3e307804a39d17d24310c5f2.zip
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 <paulmck@kernel.org>
-rw-r--r--Documentation/RCU/checklist.rst3
1 files changed, 2 insertions, 1 deletions
diff --git a/Documentation/RCU/checklist.rst b/Documentation/RCU/checklist.rst
index 2db206fc3465..178ca7547b98 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().