doc: Update RCU's lockdep.rst
authorPaul E. McKenney <paulmck@kernel.org>
Tue, 18 Oct 2022 15:33:59 +0000 (08:33 -0700)
committerPaul E. McKenney <paulmck@kernel.org>
Thu, 20 Oct 2022 18:57:46 +0000 (11:57 -0700)
This commit adds a couple of new functions to the documentation.

Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Documentation/RCU/lockdep.rst

index a94f55991a71cbe9a87a227590329a21caf4be3e..9308f1bdba05de32ff9c462307d86530abb21c48 100644 (file)
@@ -17,7 +17,9 @@ state::
        rcu_read_lock_held() for normal RCU.
        rcu_read_lock_bh_held() for RCU-bh.
        rcu_read_lock_sched_held() for RCU-sched.
+       rcu_read_lock_any_held() for any of normal RCU, RCU-bh, and RCU-sched.
        srcu_read_lock_held() for SRCU.
+       rcu_read_lock_trace_held() for RCU Tasks Trace.
 
 These functions are conservative, and will therefore return 1 if they
 aren't certain (for example, if CONFIG_DEBUG_LOCK_ALLOC is not set).
@@ -53,6 +55,8 @@ checking of rcu_dereference() primitives:
                is invoked by both SRCU readers and updaters.
        rcu_dereference_raw(p):
                Don't check.  (Use sparingly, if at all.)
+       rcu_dereference_raw_check(p):
+               Don't do lockdep at all.  (Use sparingly, if at all.)
        rcu_dereference_protected(p, c):
                Use explicit check expression "c", and omit all barriers
                and compiler constraints.  This is useful when the data