include/linux/spinlock_api_up.h
Source file repositories/reference/linux-study-clean/include/linux/spinlock_api_up.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/spinlock_api_up.h- Extension
.h- Size
- 4628 bytes
- Lines
- 145
- Domain
- Core OS
- Bucket
- Core Kernel Interface
- Inferred role
- Core OS: implementation source
- Status
- source implementation candidate
Why This File Exists
Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
Dependency Surface
- No C-style include directives detected by the generator.
Detected Declarations
function _raw_spin_trylockfunction _raw_spin_trylock_bhfunction _raw_spin_trylock_irqfunction _raw_spin_trylock_irqsavefunction _raw_read_trylockfunction _raw_write_trylockfunction _raw_write_trylock_irqsave
Annotated Snippet
#ifndef __LINUX_SPINLOCK_API_UP_H
#define __LINUX_SPINLOCK_API_UP_H
#ifndef __LINUX_INSIDE_SPINLOCK_H
# error "please don't include this file directly"
#endif
/*
* include/linux/spinlock_api_up.h
*
* spinlock API implementation on UP-nondebug (inlined implementation)
*
* portions Copyright 2005, Red Hat, Inc., Ingo Molnar
* Released under the General Public License (GPL).
*/
#define in_lock_functions(ADDR) 0
#define assert_raw_spin_locked(lock) do { (void)(lock); } while (0)
/*
* In the UP-nondebug case there's no real locking going on, so the
* only thing we have to do is to keep the preempt counts and irq
* flags straight, to suppress compiler warnings of unused lock
* variables, and to add the proper checker annotations:
*/
#define ___LOCK_(lock) \
do { __acquire(lock); (void)(lock); } while (0)
#define ___LOCK_shared(lock) \
do { __acquire_shared(lock); (void)(lock); } while (0)
#define __LOCK(lock, ...) \
do { preempt_disable(); ___LOCK_##__VA_ARGS__(lock); } while (0)
#define __LOCK_BH(lock, ...) \
do { __local_bh_disable_ip(_THIS_IP_, SOFTIRQ_LOCK_OFFSET); ___LOCK_##__VA_ARGS__(lock); } while (0)
#define __LOCK_IRQ(lock, ...) \
do { local_irq_disable(); __LOCK(lock, ##__VA_ARGS__); } while (0)
#define __LOCK_IRQSAVE(lock, flags, ...) \
do { local_irq_save(flags); __LOCK(lock, ##__VA_ARGS__); } while (0)
#define ___UNLOCK_(lock) \
do { __release(lock); (void)(lock); } while (0)
#define ___UNLOCK_shared(lock) \
do { __release_shared(lock); (void)(lock); } while (0)
#define __UNLOCK(lock, ...) \
do { preempt_enable(); ___UNLOCK_##__VA_ARGS__(lock); } while (0)
#define __UNLOCK_BH(lock, ...) \
do { __local_bh_enable_ip(_THIS_IP_, SOFTIRQ_LOCK_OFFSET); \
___UNLOCK_##__VA_ARGS__(lock); } while (0)
#define __UNLOCK_IRQ(lock, ...) \
do { local_irq_enable(); __UNLOCK(lock, ##__VA_ARGS__); } while (0)
#define __UNLOCK_IRQRESTORE(lock, flags, ...) \
do { local_irq_restore(flags); __UNLOCK(lock, ##__VA_ARGS__); } while (0)
#define _raw_spin_lock(lock) __LOCK(lock)
#define _raw_spin_lock_nested(lock, subclass) __LOCK(lock)
#define _raw_read_lock(lock) __LOCK(lock, shared)
#define _raw_write_lock(lock) __LOCK(lock)
#define _raw_write_lock_nested(lock, subclass) __LOCK(lock)
#define _raw_spin_lock_bh(lock) __LOCK_BH(lock)
#define _raw_read_lock_bh(lock) __LOCK_BH(lock, shared)
#define _raw_write_lock_bh(lock) __LOCK_BH(lock)
#define _raw_spin_lock_irq(lock) __LOCK_IRQ(lock)
#define _raw_read_lock_irq(lock) __LOCK_IRQ(lock, shared)
#define _raw_write_lock_irq(lock) __LOCK_IRQ(lock)
#define _raw_spin_lock_irqsave(lock, flags) __LOCK_IRQSAVE(lock, flags)
#define _raw_read_lock_irqsave(lock, flags) __LOCK_IRQSAVE(lock, flags, shared)
#define _raw_write_lock_irqsave(lock, flags) __LOCK_IRQSAVE(lock, flags)
static __always_inline int _raw_spin_trylock(raw_spinlock_t *lock)
__cond_acquires(true, lock)
{
__LOCK(lock);
return 1;
}
static __always_inline int _raw_spin_trylock_bh(raw_spinlock_t *lock)
__cond_acquires(true, lock)
{
__LOCK_BH(lock);
return 1;
Annotation
- Detected declarations: `function _raw_spin_trylock`, `function _raw_spin_trylock_bh`, `function _raw_spin_trylock_irq`, `function _raw_spin_trylock_irqsave`, `function _raw_read_trylock`, `function _raw_write_trylock`, `function _raw_write_trylock_irqsave`.
- Atlas domain: Core OS / Core Kernel Interface.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.