aleph/lkl_linux
1
0
Fork 0
mirror of https://github.com/lkl/linux.git synced 2025-12-19 16:13:19 +09:00
Code Issues Packages Projects Releases Wiki Activity

rcu: Clarify rcu_is_watching() kernel-doc comment

Browse Source 
Make it clear that this function always returns either true or false
without other planned failure modes.

Reported-by: Masami Hiramatsu <mhiramat@kernel.org>
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Reviewed-by: Joel Fernandes (Google) <joel@joelfernandes.org>
This commit is contained in:
Paul E. McKenney
2023-05-23 02:22:10 -07:00
parent 6716f4d39c
commit c924bf5a43
1 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
kernel/rcu/tree.c
View File

@@ -677,12 +677,16 @@ static void rcu_disable_urgency_upon_qs(struct rcu_data *rdp)
} }
/** /**
* rcu_is_watching - see if RCU thinks that the current CPU is not idle * rcu_is_watching - RCU read-side critical sections permitted on current CPU?
* *
* Return true if RCU is watching the running CPU, which means that this * Return @true if RCU is watching the running CPU and @false otherwise.
* CPU can safely enter RCU read-side critical sections. In other words, * An @true return means that this CPU can safely enter RCU read-side
* if the current CPU is not in its idle loop or is in an interrupt or * critical sections.
* NMI handler, return true. *
* Although calls to rcu_is_watching() from most parts of the kernel
* will return @true, there are important exceptions. For example, if the
* current CPU is deep within its idle loop, in kernel entry/exit code,
* or offline, rcu_is_watching() will return @false.
* *
* Make notrace because it can be called by the internal functions of * Make notrace because it can be called by the internal functions of
* ftrace, and making this notrace removes unnecessary recursion calls. * ftrace, and making this notrace removes unnecessary recursion calls.