doc: Spinlocks are implied RCU readers
authorPaul E. McKenney <paulmck@kernel.org>
Fri, 24 Nov 2023 22:55:37 +0000 (14:55 -0800)
committerBoqun Feng <boqun.feng@gmail.com>
Wed, 14 Feb 2024 15:53:49 +0000 (07:53 -0800)
commit120311acb01d7360dcc70c0862c83758fbcd28d2
tree57c50d1c5e3b886e2daadbd3924bbd5628226880
parent41bccc98fb7931d63d03f326a746ac4d429c1dd3
doc: Spinlocks are implied RCU readers

In kernels built with CONFIG_PREEMPT_RT=n, spinlock critical sections
are RCU readers because they disable preemption.  However, they are also
RCU readers in CONFIG_PREEMPT_RT=y because the -rt locking primitives
contain rcu_read_lock() and rcu_read_unlock().  Therefore, upgrade
rcu_dereference.rst to document this non-obvious case.

Reported-by: Linus Torvalds <torvalds@linux-foundation.org>
Closes: https://lore.kernel.org/lkml/CAHk-=whGKvjHCtJ6W4pQ0_h_k9fiFQ8V2GpM=BqYnB2X=SJ+XQ@mail.gmail.com/
Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Signed-off-by: Boqun Feng <boqun.feng@gmail.com>
Documentation/RCU/rcu_dereference.rst