Commit f8466f94 authored by Paul E. McKenney's avatar Paul E. McKenney

rcu: Add comment documenting rcu_callback_map's purpose

The rcu_callback_map lockdep_map structure was added back in 2013, but
its purpose has become obscure.  This commit therefore documments that the
purpose of rcu_callback map is, in the words of commit 24ef659a ("rcu:
Provide better diagnostics for blocking in RCU callback functions"),
to help lockdep to tie an "inappropriate voluntary context switch back
to the fact that the function is being invoked from within a callback."
Signed-off-by: default avatarPaul E. McKenney <paulmck@kernel.org>
parent e816d56f
...@@ -279,6 +279,7 @@ struct lockdep_map rcu_sched_lock_map = { ...@@ -279,6 +279,7 @@ struct lockdep_map rcu_sched_lock_map = {
}; };
EXPORT_SYMBOL_GPL(rcu_sched_lock_map); EXPORT_SYMBOL_GPL(rcu_sched_lock_map);
// Tell lockdep when RCU callbacks are being invoked.
static struct lock_class_key rcu_callback_key; static struct lock_class_key rcu_callback_key;
struct lockdep_map rcu_callback_map = struct lockdep_map rcu_callback_map =
STATIC_LOCKDEP_MAP_INIT("rcu_callback", &rcu_callback_key); STATIC_LOCKDEP_MAP_INIT("rcu_callback", &rcu_callback_key);
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment