atomic_dec_return_relaxed(9)

🎀 atomic_dec_return_relaxed — Kernel API Manual 💅

okay so bestie, welcome to the glamorous world of atomic_dec_return_relaxed, straight out of the Kernel API Manual. it's a tiny function, it's an icon, and it does exactly one thing but does it flawlessly. let's get into it ✨

---

🌸 NAME

atomic_dec_return_relaxed — atomic decrement with relaxed ordering 💖

like, it decrements a thing, atomically, and it's relaxed about the memory ordering. lowkey the chillest member of the atomic family.

---

🦋 SYNOPSIS

int atomic_dec_return_relaxed (atomic_t *v );

that's it. that's the whole vibe. one argument, one return value, zero drama 🫶

---

✨ ARGUMENTS

• v — pointer to atomic_t 👑 like, a pointer to an atomic_t. not the atomic_t itself, the pointer. don't @ me, that's just how it is.

---

💜 DESCRIPTION

Atomically updates v to (v - 1) with relaxed ordering.

so like. the value gets decremented by one, and nobody can sneak in between and see a half-done state — that's the atomic part, it's giving main character energy 🔥. and the relaxed ordering part? that means the memory ordering constraints are, well, relaxed. it's not doing the full memory-barrier couture, it's in its comfy clothes. iykyk.

⚠️ Unsafe to use in noinstr code — use raw_atomic_dec_return_relaxed there instead. no cap, do NOT bring this one into noinstr territory, it's literally labeled unsafe. use the raw one, she was built for that 💀

---

⭐ RETURN

The updated value of v. 💫

not the old value, bestie — the updated one, after the decrement. the _return in the name is not decorative, she IS returning something and it's the post-decrement value 🎀

---

🌈 SEE ALSO

first up, the source file: Kernel file ./include/linux/atomic/atomic-instrumented.h 🧚

and now the bit where i introduce you to literally the entire extended family, because this function rolls deep. buckle up.

💅 the atomic_ girlies

atomic_read(9), atomic_read_acquire(9), atomic_set(9), atomic_set_release(9), atomic_add(9), atomic_add_return(9), atomic_add_return_acquire(9), atomic_add_return_release(9), atomic_add_return_relaxed(9), atomic_fetch_add(9), atomic_fetch_add_acquire(9), atomic_fetch_add_release(9), atomic_fetch_add_relaxed(9), atomic_sub(9), atomic_sub_return(9), atomic_sub_return_acquire(9), atomic_sub_return_release(9), atomic_sub_return_relaxed(9), atomic_fetch_sub(9), atomic_fetch_sub_acquire(9), atomic_fetch_sub_release(9), atomic_fetch_sub_relaxed(9), atomic_inc(9), atomic_inc_return(9), atomic_inc_return_acquire(9), atomic_inc_return_release(9), atomic_inc_return_relaxed(9), atomic_fetch_inc(9), atomic_fetch_inc_acquire(9), atomic_fetch_inc_release(9), atomic_fetch_inc_relaxed(9), atomic_dec(9), atomic_dec_return(9), atomic_dec_return_acquire(9), atomic_dec_return_release(9), atomic_fetch_dec(9), atomic_fetch_dec_acquire(9), atomic_fetch_dec_release(9), atomic_fetch_dec_relaxed(9), atomic_and(9), atomic_fetch_and(9), atomic_fetch_and_acquire(9), atomic_fetch_and_release(9), atomic_fetch_and_relaxed(9), atomic_andnot(9), atomic_fetch_andnot(9), atomic_fetch_andnot_acquire(9), atomic_fetch_andnot_release(9), atomic_fetch_andnot_relaxed(9), atomic_or(9), atomic_fetch_or(9), atomic_fetch_or_acquire(9), atomic_fetch_or_release(9), atomic_fetch_or_relaxed(9), atomic_xor(9), atomic_fetch_xor(9), atomic_fetch_xor_acquire(9), atomic_fetch_xor_release(9), atomic_fetch_xor_relaxed(9), atomic_xchg(9), atomic_xchg_acquire(9), atomic_xchg_release(9), atomic_xchg_relaxed(9), atomic_cmpxchg(9), atomic_cmpxchg_acquire(9), atomic_cmpxchg_release(9), atomic_cmpxchg_relaxed(9), atomic_try_cmpxchg(9), atomic_try_cmpxchg_acquire(9), atomic_try_cmpxchg_release(9), atomic_try_cmpxchg_relaxed(9), atomic_sub_and_test(9), atomic_dec_and_test(9), atomic_inc_and_test(9), atomic_add_negative(9), atomic_add_negative_acquire(9), atomic_add_negative_release(9), atomic_add_negative_relaxed(9), atomic_fetch_add_unless(9), atomic_add_unless(9), atomic_inc_not_zero(9), atomic_inc_unless_negative(9), atomic_dec_unless_positive(9), atomic_dec_if_positive(9)

🍓 the atomic64_ crew (the big ones)

atomic64_read(9), atomic64_read_acquire(9), atomic64_set(9), atomic64_set_release(9), atomic64_add(9), atomic64_add_return(9), atomic64_add_return_acquire(9), atomic64_add_return_release(9), atomic64_add_return_relaxed(9), atomic64_fetch_add(9), atomic64_fetch_add_acquire(9), atomic64_fetch_add_release(9), atomic64_fetch_add_relaxed(9), atomic64_sub(9), atomic64_sub_return(9), atomic64_sub_return_acquire(9), atomic64_sub_return_release(9), atomic64_sub_return_relaxed(9), atomic64_fetch_sub(9), atomic64_fetch_sub_acquire(9), atomic64_fetch_sub_release(9), atomic64_fetch_sub_relaxed(9), atomic64_inc(9), atomic64_inc_return(9), atomic64_inc_return_acquire(9), atomic64_inc_return_release(9), atomic64_inc_return_relaxed(9), atomic64_fetch_inc(9), atomic64_fetch_inc_acquire(9), atomic64_fetch_inc_release(9), atomic64_fetch_inc_relaxed(9), atomic64_dec(9), atomic64_dec_return(9), atomic64_dec_return_acquire(9), atomic64_dec_return_release(9), atomic64_dec_return_relaxed(9), atomic64_fetch_dec(9), atomic64_fetch_dec_acquire(9), atomic64_fetch_dec_release(9), atomic64_fetch_dec_relaxed(9), atomic64_and(9), atomic64_fetch_and(9), atomic64_fetch_and_acquire(9), atomic64_fetch_and_release(9), atomic64_fetch_and_relaxed(9), atomic64_andnot(9), atomic64_fetch_andnot(9), atomic64_fetch_andnot_acquire(9), atomic64_fetch_andnot_release(9), atomic64_fetch_andnot_relaxed(9), atomic64_or(9), atomic64_fetch_or(9), atomic64_fetch_or_acquire(9), atomic64_fetch_or_release(9), atomic64_fetch_or_relaxed(9), atomic64_xor(9), atomic64_fetch_xor(9), atomic64_fetch_xor_acquire(9), atomic64_fetch_xor_release(9), atomic64_fetch_xor_relaxed(9), atomic64_xchg(9), atomic64_xchg_acquire(9), atomic64_xchg_release(9), atomic64_xchg_relaxed(9), atomic64_cmpxchg(9), atomic64_cmpxchg_acquire(9), atomic64_cmpxchg_release(9), atomic64_cmpxchg_relaxed(9), atomic64_try_cmpxchg(9), atomic64_try_cmpxchg_acquire(9), atomic64_try_cmpxchg_release(9), atomic64_try_cmpxchg_relaxed(9), atomic64_sub_and_test(9), atomic64_dec_and_test(9), atomic64_inc_and_test(9), atomic64_add_negative(9), atomic64_add_negative_acquire(9), atomic64_add_negative_release(9), atomic64_add_negative_relaxed(9), atomic64_fetch_add_unless(9), atomic64_add_unless(9), atomic64_inc_not_zero(9), atomic64_inc_unless_negative(9), atomic64_dec_unless_positive(9), atomic64_dec_if_positive(9)

🧚 the atomic_long_ fam (long edition, obviously)

atomic_long_read(9), atomic_long_read_acquire(9), atomic_long_set(9), atomic_long_set_release(9), atomic_long_add(9), atomic_long_add_return(9), atomic_long_add_return_acquire(9), atomic_long_add_return_release(9), atomic_long_add_return_relaxed(9), atomic_long_fetch_add(9), atomic_long_fetch_add_acquire(9), atomic_long_fetch_add_release(9), atomic_long_fetch_add_relaxed(9), atomic_long_sub(9), atomic_long_sub_return(9), atomic_long_sub_return_acquire(9), atomic_long_sub_return_release(9), atomic_long_sub_return_relaxed(9), atomic_long_fetch_sub(9), atomic_long_fetch_sub_acquire(9), atomic_long_fetch_sub_release(9), atomic_long_fetch_sub_relaxed(9), atomic_long_inc(9), atomic_long_inc_return(9), atomic_long_inc_return_acquire(9), atomic_long_inc_return_release(9), atomic_long_inc_return_relaxed(9), atomic_long_fetch_inc(9), atomic_long_fetch_inc_acquire(9), atomic_long_fetch_inc_release(9), atomic_long_fetch_inc_relaxed(9), atomic_long_dec(9), atomic_long_dec_return(9), atomic_long_dec_return_acquire(9), atomic_long_dec_return_release(9), atomic_long_dec_return_relaxed(9), atomic_long_fetch_dec(9), atomic_long_fetch_dec_acquire(9), atomic_long_fetch_dec_release(9), atomic_long_fetch_dec_relaxed(9), atomic_long_and(9), atomic_long_fetch_and(9), atomic_long_fetch_and_acquire(9), atomic_long_fetch_and_release(9), atomic_long_fetch_and_relaxed(9), atomic_long_andnot(9), atomic_long_fetch_andnot(9), atomic_long_fetch_andnot_acquire(9), atomic_long_fetch_andnot_release(9), atomic_long_fetch_andnot_relaxed(9), atomic_long_or(9), atomic_long_fetch_or(9), atomic_long_fetch_or_acquire(9), atomic_long_fetch_or_release(9), atomic_long_fetch_or_relaxed(9), atomic_long_xor(9), atomic_long_fetch_xor(9), atomic_long_fetch_xor_acquire(9), atomic_long_fetch_xor_release(9), atomic_long_fetch_xor_relaxed(9), atomic_long_xchg(9), atomic_long_xchg_acquire(9), atomic_long_xchg_release(9), atomic_long_xchg_relaxed(9), atomic_long_cmpxchg(9), atomic_long_cmpxchg_acquire(9), atomic_long_cmpxchg_release(9), atomic_long_cmpxchg_relaxed(9), atomic_long_try_cmpxchg(9), atomic_long_try_cmpxchg_acquire(9), atomic_long_try_cmpxchg_release(9), atomic_long_try_cmpxchg_relaxed(9), atomic_long_sub_and_test(9), atomic_long_dec_and_test(9), atomic_long_inc_and_test(9), atomic_long_add_negative(9), atomic_long_add_negative_acquire(9), atomic_long_add_negative_release(9), atomic_long_add_negative_relaxed(9), atomic_long_fetch_add_unless(9), atomic_long_add_unless(9), atomic_long_inc_not_zero(9), atomic_long_inc_unless_negative(9), atomic_long_dec_unless_positive(9), atomic_long_dec_if_positive(9)

like i said. the whole family. she's not going anywhere without her friends 💜

---

and that's the page!! this little beauty lives over at ./include/linux/atomic, the date on her birth certificate says October 2026, and yeah — she's still atomic_dec_return_relaxed(9), always and forever. mwah 💋💖🎀