diff options
author | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2010-07-08 17:38:59 -0700 |
---|---|---|
committer | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2010-08-19 17:18:02 -0700 |
commit | 77d8485a8b5416c615b6acd95f01bfcacd7d81ff (patch) | |
tree | 725742c078b9712d875e9c633d249b6da14e5f00 /kernel/rcutree_plugin.h | |
parent | 742734eea0cf5314cde5945963ed964be167bd84 (diff) | |
download | linux-77d8485a8b5416c615b6acd95f01bfcacd7d81ff.tar.gz linux-77d8485a8b5416c615b6acd95f01bfcacd7d81ff.tar.bz2 linux-77d8485a8b5416c615b6acd95f01bfcacd7d81ff.zip |
rcu: improve kerneldoc for rcu_read_lock(), call_rcu(), and synchronize_rcu()
Make it explicit that new RCU read-side critical sections that start
after call_rcu() and synchronize_rcu() start might still be running
after the end of the relevant grace period.
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: Josh Triplett <josh@joshtriplett.org>
Diffstat (limited to 'kernel/rcutree_plugin.h')
-rw-r--r-- | kernel/rcutree_plugin.h | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/kernel/rcutree_plugin.h b/kernel/rcutree_plugin.h index 9906f85c7780..63bb7714fdeb 100644 --- a/kernel/rcutree_plugin.h +++ b/kernel/rcutree_plugin.h @@ -546,9 +546,11 @@ EXPORT_SYMBOL_GPL(call_rcu); * * Control will return to the caller some time after a full grace * period has elapsed, in other words after all currently executing RCU - * read-side critical sections have completed. RCU read-side critical - * sections are delimited by rcu_read_lock() and rcu_read_unlock(), - * and may be nested. + * read-side critical sections have completed. Note, however, that + * upon return from synchronize_rcu(), the caller might well be executing + * concurrently with new RCU read-side critical sections that began while + * synchronize_rcu() was waiting. RCU read-side critical sections are + * delimited by rcu_read_lock() and rcu_read_unlock(), and may be nested. */ void synchronize_rcu(void) { |