Skip to content

Commit 51e69e6

Browse files
rddunlapKAGA-KOKO
authored andcommitted
Documentation/locking/locktypes: Minor copy editor fixes
Minor editorial fixes: - remove 'enabled' from PREEMPT_RT enabled kernels for consistency - add some periods for consistency - add "'" for possessive CPU's - spell out interrupts [ tglx: Picked up Paul's suggestions ] Signed-off-by: Randy Dunlap <[email protected]> Signed-off-by: Thomas Gleixner <[email protected]> Reviewed-by: Paul E. McKenney <[email protected]> Link: https://lkml.kernel.org/r/[email protected]
1 parent 7ecc6aa commit 51e69e6

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

Documentation/locking/locktypes.rst

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ rtmutex
8484

8585
RT-mutexes are mutexes with support for priority inheritance (PI).
8686

87-
PI has limitations on non PREEMPT_RT enabled kernels due to preemption and
87+
PI has limitations on non-PREEMPT_RT kernels due to preemption and
8888
interrupt disabled sections.
8989

9090
PI clearly cannot preempt preemption-disabled or interrupt-disabled
@@ -150,7 +150,7 @@ kernel configuration including PREEMPT_RT enabled kernels.
150150

151151
raw_spinlock_t is a strict spinning lock implementation in all kernels,
152152
including PREEMPT_RT kernels. Use raw_spinlock_t only in real critical
153-
core code, low level interrupt handling and places where disabling
153+
core code, low-level interrupt handling and places where disabling
154154
preemption or interrupts is required, for example, to safely access
155155
hardware state. raw_spinlock_t can sometimes also be used when the
156156
critical section is tiny, thus avoiding RT-mutex overhead.
@@ -160,20 +160,20 @@ spinlock_t
160160

161161
The semantics of spinlock_t change with the state of PREEMPT_RT.
162162

163-
On a non PREEMPT_RT enabled kernel spinlock_t is mapped to raw_spinlock_t
164-
and has exactly the same semantics.
163+
On a non-PREEMPT_RT kernel spinlock_t is mapped to raw_spinlock_t and has
164+
exactly the same semantics.
165165

166166
spinlock_t and PREEMPT_RT
167167
-------------------------
168168

169-
On a PREEMPT_RT enabled kernel spinlock_t is mapped to a separate
170-
implementation based on rt_mutex which changes the semantics:
169+
On a PREEMPT_RT kernel spinlock_t is mapped to a separate implementation
170+
based on rt_mutex which changes the semantics:
171171

172-
- Preemption is not disabled
172+
- Preemption is not disabled.
173173

174174
- The hard interrupt related suffixes for spin_lock / spin_unlock
175-
operations (_irq, _irqsave / _irqrestore) do not affect the CPUs
176-
interrupt disabled state
175+
operations (_irq, _irqsave / _irqrestore) do not affect the CPU's
176+
interrupt disabled state.
177177

178178
- The soft interrupt related suffix (_bh()) still disables softirq
179179
handlers.
@@ -279,8 +279,8 @@ fully preemptible context. Instead, use spin_lock_irq() or
279279
spin_lock_irqsave() and their unlock counterparts. In cases where the
280280
interrupt disabling and locking must remain separate, PREEMPT_RT offers a
281281
local_lock mechanism. Acquiring the local_lock pins the task to a CPU,
282-
allowing things like per-CPU irq-disabled locks to be acquired. However,
283-
this approach should be used only where absolutely necessary.
282+
allowing things like per-CPU interrupt disabled locks to be acquired.
283+
However, this approach should be used only where absolutely necessary.
284284

285285

286286
raw_spinlock_t

0 commit comments

Comments
 (0)