atomic64_sub_return_acquire(9)

✨ NAME ✨

okay so bestie, this page is from the Kernel API Manual 💖 and the main character is:

atomic64_sub_return_acquire - atomic subtract with acquire ordering 🌸

---

🎀 SYNOPSIS 🎀

s64 atomic64_sub_return_acquire (s64 i , atomic64_t *v );

---

🫶 ARGUMENTS 🫶

• i — the s64 value to subtract. literally the amount getting taken off, no cap.
• v — pointer to atomic64_t. this is the atomic bestie that gets updated. 💅

---

💅 DESCRIPTION 💅

okay so the whole vibe: atomically updates v to (v - i) with acquire ordering. it's giving synchronized, it's giving correct, it's giving slay. 🔥

⚠️ unsafe to use in noinstr code — use raw_atomic64_sub_return_acquire there instead. bestie this is the important warning, do not skip it 😭🙈

---

⭐ RETURN ⭐

the updated value of v. that's it, that's the tea. 💖

---

🦋 SEE ALSO 🦋

the kernel file is ./include/linux/atomic/atomic-instrumented.h — and here's the whole atomic squad, every single ref, exactly as they appear, because we do not drop links in this group chat 🫶✨

Kernel file ./include/linux/atomic/atomic-instrumented.h 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_dec_return_relaxed(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), 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_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),
       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)

okay bye bestie 🫶 this page came from ./include/linux/atomic, dated October 2026, and it's the atomic64_sub_return_acquire(9) entry in the Kernel API Manual. periodt. 💅✨