summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorPaul E. McKenney <paulmck@kernel.org>2022-07-28 22:04:00 +0300
committerPaul E. McKenney <paulmck@kernel.org>2022-08-31 14:58:15 +0300
commit1c1c1d983e75f53b3e307804a39d17d24310c5f2 (patch)
treedc25fb7d30fa26674fcfc7343dbd77ab51c5529f /Documentation
parented336c6fe4c0110a56f6f237865ff9660de8c598 (diff)
downloadlinux-1c1c1d983e75f53b3e307804a39d17d24310c5f2.tar.xz
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>
Diffstat (limited to 'Documentation')
-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().