raw_atomic64_dec(9)
π raw_atomic64_dec(9) β Kernel API Manual β¨
okay bestie, so this is a page from the Kernel API Manual and it's about raw_atomic64_dec β yes, the lowercase-with-underscores queen herself π she's a build-your-own building block in the kernel's atomic toolbox, and she's honestly so straightforward it's giving "one job, does it well" energy.
πΈ NAME πΈ
raw_atomic64_dec β atomic decrement with relaxed ordering π¦
lowkey iconic: minus one, but make it thread-safe.
β¨ SYNOPSIS β¨
void raw_atomic64_dec (atomic64_t *v );
literally that's the whole signature. one pointer, no return, no drama π
π ARGUMENTS π
vβ pointer toatomic64_tπ«Ά that's it, that's the whole argument list. it's the thing you're about to knock down by one.
π DESCRIPTION π
Atomically updates v to (v - 1) with relaxed ordering.
so basically: v goes down by exactly one, and the whole read-modify-write happens atomically β nobody can sneak in halfway and catch her mid-decrement π the ordering is relaxed, meaning she's not out here building fences for you; if you need ordering guarantees, that's a different function's job, iykyk.
Safe to use in noinstr code; prefer atomic64_dec elsewhere.
π¨ okay this is the important part, don't skip it bestie: this one is explicitly safe insidenoinstrcode. everywhere else? preferatomic64_dec. that's not a suggestion, that's the manpage talking. fr fr.
π¦ RETURN π¦
Nothing.
no value, no status, no little gift back. void is void. she decrements and she leaves π§β¨
π₯ SEE ALSO π₯
Kernel file: ./include/linux/atomic/atomic-arch-fallback.h β that's where she lives in the source tree π
and now the full family reunion, because the kernel really said "make a variant for every vibe" and meant it π the 32-bit side first:
raw_atomic_read(9),raw_atomic_read_acquire(9),raw_atomic_set(9),raw_atomic_set_release(9)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)raw_atomic_sub(9),raw_atomic_sub_return(9),raw_atomic_sub_return_acquire(9),raw_atomic_sub_return_release(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)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)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)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)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)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)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)
and now the 64-bit girlies, aka her actual siblings π:
raw_atomic64_read(9),raw_atomic64_read_acquire(9),raw_atomic64_set(9),raw_atomic64_set_release(9)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)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)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)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)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)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)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)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)
and that's the whole page, bestie, you ate it π β¨
π cute little sign-off: this one ships out of ./include/linux/atomic and the page is dated October 2026. go forth and decrement responsibly, mwah π«Άπ
π¦ 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