Documentation/locking/locktypes.rst

48  - local_lock
56  - local_lock
58 On non-PREEMPT_RT kernels, local_lock functions are wrappers around
158 local_lock  chapter
161 local_lock provides a named scope to critical sections which are protected
164 On non-PREEMPT_RT kernels local_lock operations map to the preemption and
168  local_lock(&llock)               preempt_disable()
176 The named scope of local_lock has two advantages over the regular
183   - If lockdep is enabled the local_lock gains a lockmap which allows to
189 local_lock and PREEMPT_RT
192 PREEMPT_RT kernels map local_lock to a per-CPU spinlock_t, thus changing
195   - All spinlock_t changes also apply to local_lock.
197 local_lock usage
200 local_lock should be used in situations where disabling preemption or
204 local_lock is not suitable to protect against preemption or interrupts on a
324 local_lock on RT
327 The mapping of local_lock to spinlock_t on PREEMPT_RT kernels has a few
331   local_lock_irq(&local_lock);
343   local_lock_irq(&local_lock);
346 Another caveat with local locks is that each local_lock has a specific
377     local_irq_save(flags);    -> local_lock_irqsave(&local_lock, flags);
379     local_irq_restore(flags); -> local_unlock_irqrestore(&local_lock, flags);
384     local_irq_save(flags);    -> local_lock_irqsave(&local_lock, flags);
386     local_irq_restore(flags); -> local_unlock_irqrestore(&local_lock, flags);
391     lockdep_assert_held(&local_lock);
416 local_lock mechanism.  Acquiring the local_lock pins the task to a CPU,
461     local_lock(&foo_lock);
525 rwlock_t from spinning to sleeping and substitutes local_lock with a
530   2) spinlock_t, rwlock_t, local_lock