From: Paul E. McKenney Date: Tue, 18 Oct 2022 15:33:59 +0000 (-0700) Subject: doc: Update RCU's lockdep.rst X-Git-Tag: v6.2-rc1~222^2~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2c3cdf5a8e06723b6ec76f04534fe1a33dd1a6d8;p=thirdparty%2Fkernel%2Flinux.git doc: Update RCU's lockdep.rst This commit adds a couple of new functions to the documentation. Signed-off-by: Paul E. McKenney --- diff --git a/Documentation/RCU/lockdep.rst b/Documentation/RCU/lockdep.rst index a94f55991a71c..9308f1bdba05d 100644 --- a/Documentation/RCU/lockdep.rst +++ b/Documentation/RCU/lockdep.rst @@ -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