atomic_long_fetch_add(9)

💅 atomic_long_fetch_add — Kernel API Manual, section 9

okay so bestie, come sit — this one is from the Kernel API Manual (section 9, the atomic girlies) and it's genuinely one of the cleanest little manpages out there. no cap. let's get into it 💖

---

✨ NAME ✨

atomic_long_fetch_add — atomic add with full ordering

like yes, that's the whole pitch, and it ate. 🫶

---

🦋 SYNOPSIS 🦋

long atomic_long_fetch_add (long i , atomic_long_t *v );

she's a long, she takes two args, she returns a long. iconic signature, no notes. ⭐

---

🎀 ARGUMENTS 🎀

• i — the long value you're adding. your contribution to the cause 💐
• v — pointer to atomic_long_t. the object she's about to make history on 👑

---

🔥 DESCRIPTION 🔥

okay so the main character energy here: she atomically updates v to (v + i) with full ordering. literally nobody else gets to see a half-done version of this operation — it's all or nothing, and the ordering is the strictest vibe. 🔒✨

🚨 important bestie warning: this is unsafe to use in noinstr code. if you're in noinstr land, use raw_atomic_long_fetch_add there instead. do not skip this, i'm serious 😭

---

⭐ RETURN ⭐

she hands you back the original value of v — the one before the add. so you get the receipts, not the after-party. iykyk 💅

---

🌈 SEE ALSO 🌈

this section is a whole family reunion, so buckle up. the kernel file is ./include/linux/atomic/atomic-instrumented.h.

the atomic_* girlies (32-bit flavoured):

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) 💖

the atomic64_* cousins (same energy, 64 bits):

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) 🦋

and finally the atomic_long_* crew — our girl's own household 💜:

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_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) ✨

---

and that's the whole page, bestie!! 🎀 this one lives in the kernel source dir ./include/linux/atomic, stamped October 2026, and it's filed under atomic_long_fetch_add(9) — go forth and add atomically, you absolute queen 👑💖