arch/x86/include/asm/atomic.h
Source file repositories/reference/linux-study-clean/arch/x86/include/asm/atomic.h
File Facts
- System
- Linux kernel
- Corpus path
arch/x86/include/asm/atomic.h- Extension
.h- Size
- 4514 bytes
- Lines
- 178
- Domain
- Architecture Layer
- Bucket
- arch/x86
- Inferred role
- Architecture Layer: implementation source
- Status
- source implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
Dependency Surface
linux/compiler.hlinux/types.hasm/alternative.hasm/cmpxchg.hasm/rmwcc.hasm/barrier.hasm/atomic64_32.hasm/atomic64_64.h
Detected Declarations
function arch_atomic_readfunction arch_atomic_setfunction arch_atomic_addfunction arch_atomic_subfunction arch_atomic_sub_and_testfunction arch_atomic_incfunction arch_atomic_decfunction arch_atomic_dec_and_testfunction arch_atomic_inc_and_testfunction arch_atomic_add_negativefunction arch_atomic_add_returnfunction arch_atomic_fetch_addfunction arch_atomic_cmpxchgfunction arch_atomic_try_cmpxchgfunction arch_atomic_xchgfunction arch_atomic_andfunction arch_atomic_fetch_andfunction arch_atomic_orfunction arch_atomic_fetch_orfunction arch_atomic_xorfunction arch_atomic_fetch_xor
Annotated Snippet
#ifndef _ASM_X86_ATOMIC_H
#define _ASM_X86_ATOMIC_H
#include <linux/compiler.h>
#include <linux/types.h>
#include <asm/alternative.h>
#include <asm/cmpxchg.h>
#include <asm/rmwcc.h>
#include <asm/barrier.h>
/*
* Atomic operations that C can't guarantee us. Useful for
* resource counting etc..
*/
static __always_inline int arch_atomic_read(const atomic_t *v)
{
/*
* Note for KASAN: we deliberately don't use READ_ONCE_NOCHECK() here,
* it's non-inlined function that increases binary size and stack usage.
*/
return __READ_ONCE((v)->counter);
}
static __always_inline void arch_atomic_set(atomic_t *v, int i)
{
__WRITE_ONCE(v->counter, i);
}
static __always_inline void arch_atomic_add(int i, atomic_t *v)
{
asm_inline volatile(LOCK_PREFIX "addl %1, %0"
: "+m" (v->counter)
: "ir" (i) : "memory");
}
static __always_inline void arch_atomic_sub(int i, atomic_t *v)
{
asm_inline volatile(LOCK_PREFIX "subl %1, %0"
: "+m" (v->counter)
: "ir" (i) : "memory");
}
static __always_inline bool arch_atomic_sub_and_test(int i, atomic_t *v)
{
return GEN_BINARY_RMWcc(LOCK_PREFIX "subl", v->counter, e, "er", i);
}
#define arch_atomic_sub_and_test arch_atomic_sub_and_test
static __always_inline void arch_atomic_inc(atomic_t *v)
{
asm_inline volatile(LOCK_PREFIX "incl %0"
: "+m" (v->counter) :: "memory");
}
#define arch_atomic_inc arch_atomic_inc
static __always_inline void arch_atomic_dec(atomic_t *v)
{
asm_inline volatile(LOCK_PREFIX "decl %0"
: "+m" (v->counter) :: "memory");
}
#define arch_atomic_dec arch_atomic_dec
static __always_inline bool arch_atomic_dec_and_test(atomic_t *v)
{
return GEN_UNARY_RMWcc(LOCK_PREFIX "decl", v->counter, e);
}
#define arch_atomic_dec_and_test arch_atomic_dec_and_test
static __always_inline bool arch_atomic_inc_and_test(atomic_t *v)
{
return GEN_UNARY_RMWcc(LOCK_PREFIX "incl", v->counter, e);
}
#define arch_atomic_inc_and_test arch_atomic_inc_and_test
static __always_inline bool arch_atomic_add_negative(int i, atomic_t *v)
{
return GEN_BINARY_RMWcc(LOCK_PREFIX "addl", v->counter, s, "er", i);
}
#define arch_atomic_add_negative arch_atomic_add_negative
static __always_inline int arch_atomic_add_return(int i, atomic_t *v)
{
return i + xadd(&v->counter, i);
}
#define arch_atomic_add_return arch_atomic_add_return
#define arch_atomic_sub_return(i, v) arch_atomic_add_return(-(i), v)
static __always_inline int arch_atomic_fetch_add(int i, atomic_t *v)
Annotation
- Immediate include surface: `linux/compiler.h`, `linux/types.h`, `asm/alternative.h`, `asm/cmpxchg.h`, `asm/rmwcc.h`, `asm/barrier.h`, `asm/atomic64_32.h`, `asm/atomic64_64.h`.
- Detected declarations: `function arch_atomic_read`, `function arch_atomic_set`, `function arch_atomic_add`, `function arch_atomic_sub`, `function arch_atomic_sub_and_test`, `function arch_atomic_inc`, `function arch_atomic_dec`, `function arch_atomic_dec_and_test`, `function arch_atomic_inc_and_test`, `function arch_atomic_add_negative`.
- Atlas domain: Architecture Layer / arch/x86.
- 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.