raw_atomic_...turn_release(9)
okay so bestie, welcome to the Kernel API Manual β today's main character is raw_atomic_sub_return_release, and it's giving atomic subtract with release ordering. Honestly? iconic. π
π NAME π
raw_atomic_sub_return_release β atomic subtract with release ordering. That's the name, that's the vibe, no notes. β¨
β¨ SYNOPSIS β¨
here's the signature, bestie β copy it exactly, because we do not freestyle C signatures in this house:
int raw_atomic_sub_return_release (int i , atomic_t *v );
π ARGUMENTS π
okay so there are exactly two inputs and both matter:
iβintvalue to subtract. the little number doing the subtracting, slay.vβ pointer toatomic_t. this is the atomic bestie getting updated. π«Ά
π¦ DESCRIPTION π¦
okay so the actual tea: it atomically updates v to (v - i) with release ordering. that's the whole move. π
It's safe to use in noinstr code β but the manual says prefer atomic_sub_return_release elsewhere. so that's the preference, iykyk. π
πΈ RETURN πΈ
you get the updated value of v back. that's it. that's the return. periodt. π«Ά
π SEE ALSO π
bestie, the SEE ALSO section is literally the whole atomic extended universe. every single ref is here, no cap:
- Kernel file:
./include/linux/atomic/atomic-arch-fallback.h - atomic read/set crew:
raw_atomic_read(9),raw_atomic_read_acquire(9),raw_atomic_set(9),raw_atomic_set_release(9) - atomic add:
raw_atomic_add(9),raw_atomic_add_return(9),raw_atomic_add_return_acquire(9),raw_atomic_add_return_release(9),raw_atomic_add_return_relaxed(9),raw_atomic_fetch_add(9),raw_atomic_fetch_add_acquire(9),raw_atomic_fetch_add_release(9),raw_atomic_fetch_add_relaxed(9) - atomic sub:
raw_atomic_sub(9),raw_atomic_sub_return(9),raw_atomic_sub_return_acquire(9),raw_atomic_sub_return_relaxed(9),raw_atomic_fetch_sub(9),raw_atomic_fetch_sub_acquire(9),raw_atomic_fetch_sub_release(9),raw_atomic_fetch_sub_relaxed(9) - atomic inc:
raw_atomic_inc(9),raw_atomic_inc_return(9),raw_atomic_inc_return_acquire(9),raw_atomic_inc_return_release(9),raw_atomic_inc_return_relaxed(9),raw_atomic_fetch_inc(9),raw_atomic_fetch_inc_acquire(9),raw_atomic_fetch_inc_release(9),raw_atomic_fetch_inc_relaxed(9) - atomic dec:
raw_atomic_dec(9),raw_atomic_dec_return(9),raw_atomic_dec_return_acquire(9),raw_atomic_dec_return_release(9),raw_atomic_dec_return_relaxed(9),raw_atomic_fetch_dec(9),raw_atomic_fetch_dec_acquire(9),raw_atomic_fetch_dec_release(9),raw_atomic_fetch_dec_relaxed(9) - atomic and/andnot:
raw_atomic_and(9),raw_atomic_fetch_and(9),raw_atomic_fetch_and_acquire(9),raw_atomic_fetch_and_release(9),raw_atomic_fetch_and_relaxed(9),raw_atomic_andnot(9),raw_atomic_fetch_andnot(9),raw_atomic_fetch_andnot_acquire(9),raw_atomic_fetch_andnot_release(9),raw_atomic_fetch_andnot_relaxed(9) - atomic or/xor:
raw_atomic_or(9),raw_atomic_fetch_or(9),raw_atomic_fetch_or_acquire(9),raw_atomic_fetch_or_release(9),raw_atomic_fetch_or_relaxed(9),raw_atomic_xor(9),raw_atomic_fetch_xor(9),raw_atomic_fetch_xor_acquire(9),raw_atomic_fetch_xor_release(9),raw_atomic_fetch_xor_relaxed(9) - atomic xchg/cmpxchg:
raw_atomic_xchg(9),raw_atomic_xchg_acquire(9),raw_atomic_xchg_release(9),raw_atomic_xchg_relaxed(9),raw_atomic_cmpxchg(9),raw_atomic_cmpxchg_acquire(9),raw_atomic_cmpxchg_release(9),raw_atomic_cmpxchg_relaxed(9),raw_atomic_try_cmpxchg(9),raw_atomic_try_cmpxchg_acquire(9),raw_atomic_try_cmpxchg_release(9),raw_atomic_try_cmpxchg_relaxed(9) - atomic tests/negative/unless:
raw_atomic_sub_and_test(9),raw_atomic_dec_and_test(9),raw_atomic_inc_and_test(9),raw_atomic_add_negative(9),raw_atomic_add_negative_acquire(9),raw_atomic_add_negative_release(9),raw_atomic_add_negative_relaxed(9),raw_atomic_fetch_add_unless(9),raw_atomic_add_unless(9),raw_atomic_inc_not_zero(9),raw_atomic_inc_unless_negative(9),raw_atomic_dec_unless_positive(9),raw_atomic_dec_if_positive(9) - atomic64 read/set crew:
raw_atomic64_read(9),raw_atomic64_read_acquire(9),raw_atomic64_set(9),raw_atomic64_set_release(9) - atomic64 add:
raw_atomic64_add(9),raw_atomic64_add_return(9),raw_atomic64_add_return_acquire(9),raw_atomic64_add_return_release(9),raw_atomic64_add_return_relaxed(9),raw_atomic64_fetch_add(9),raw_atomic64_fetch_add_acquire(9),raw_atomic64_fetch_add_release(9),raw_atomic64_fetch_add_relaxed(9) - atomic64 sub:
raw_atomic64_sub(9),raw_atomic64_sub_return(9),raw_atomic64_sub_return_acquire(9),raw_atomic64_sub_return_release(9),raw_atomic64_sub_return_relaxed(9),raw_atomic64_fetch_sub(9),raw_atomic64_fetch_sub_acquire(9),raw_atomic64_fetch_sub_release(9),raw_atomic64_fetch_sub_relaxed(9) - atomic64 inc:
raw_atomic64_inc(9),raw_atomic64_inc_return(9),raw_atomic64_inc_return_acquire(9),raw_atomic64_inc_return_release(9),raw_atomic64_inc_return_relaxed(9),raw_atomic64_fetch_inc(9),raw_atomic64_fetch_inc_acquire(9),raw_atomic64_fetch_inc_release(9),raw_atomic64_fetch_inc_relaxed(9) - atomic64 dec:
raw_atomic64_dec(9),raw_atomic64_dec_return(9),raw_atomic64_dec_return_acquire(9),raw_atomic64_dec_return_release(9),raw_atomic64_dec_return_relaxed(9),raw_atomic64_fetch_dec(9),raw_atomic64_fetch_dec_acquire(9),raw_atomic64_fetch_dec_release(9),raw_atomic64_fetch_dec_relaxed(9) - atomic64 and/andnot:
raw_atomic64_and(9),raw_atomic64_fetch_and(9),raw_atomic64_fetch_and_acquire(9),raw_atomic64_fetch_and_release(9),raw_atomic64_fetch_and_relaxed(9),raw_atomic64_andnot(9),raw_atomic64_fetch_andnot(9),raw_atomic64_fetch_andnot_acquire(9),raw_atomic64_fetch_andnot_release(9),raw_atomic64_fetch_andnot_relaxed(9) - atomic64 or/xor:
raw_atomic64_or(9),raw_atomic64_fetch_or(9),raw_atomic64_fetch_or_acquire(9),raw_atomic64_fetch_or_release(9),raw_atomic64_fetch_or_relaxed(9),raw_atomic64_xor(9),raw_atomic64_fetch_xor(9),raw_atomic64_fetch_xor_acquire(9),raw_atomic64_fetch_xor_release(9),raw_atomic64_fetch_xor_relaxed(9) - atomic64 xchg/cmpxchg:
raw_atomic64_xchg(9),raw_atomic64_xchg_acquire(9),raw_atomic64_xchg_release(9),raw_atomic64_xchg_relaxed(9),raw_atomic64_cmpxchg(9),raw_atomic64_cmpxchg_acquire(9),raw_atomic64_cmpxchg_release(9),raw_atomic64_cmpxchg_relaxed(9),raw_atomic64_try_cmpxchg(9),raw_atomic64_try_cmpxchg_acquire(9),raw_atomic64_try_cmpxchg_release(9),raw_atomic64_try_cmpxchg_relaxed(9) - atomic64 tests/negative/unless:
raw_atomic64_sub_and_test(9),raw_atomic64_dec_and_test(9),raw_atomic64_inc_and_test(9),raw_atomic64_add_negative(9),raw_atomic64_add_negative_acquire(9),raw_atomic64_add_negative_release(9),raw_atomic64_add_negative_relaxed(9),raw_atomic64_fetch_add_unless(9),raw_atomic64_add_unless(9),raw_atomic64_inc_not_zero(9),raw_atomic64_inc_unless_negative(9),raw_atomic64_dec_unless_positive(9),raw_atomic64_dec_if_positive(9)
that's the page, bestie! this is the Kernel API Manual entry for raw_atomic_sub_return_release, source/version ./include/linux/atomic, dated October 2026. if you need to, go update v to (v - i) atomically with release ordering and absolutely slay. π
β¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms