raw_atomic64_fetch_add(9)
π raw_atomic64_fetch_add β Kernel API Manual π
okay bestie, so you know how sometimes you need to add a number to a thing and also get the old number back, and you need it to be, like, atomic about it? Yeah. That's this. It's in the Kernel API Manual, and it's lowkey iconic. β¨
πΈ NAME πΈ
raw_atomic64_fetch_add β atomic add, but make it full ordering. Periodt. π
π¦ SYNOPSIS π¦
s64 raw_atomic64_fetch_add (s64 i , atomic64_t *v );
π ARGUMENTS π
iβ ans64. It's the value you're adding. The little guy. πvβ a pointer toatomic64_t. This is the thing getting updated, bestie.
β¨ DESCRIPTION β¨
So the way this works: it atomically updates v to (v + i) β with full ordering. Not relaxed, not acquire, not release. Full. Ordering. The whole vibe check passed. π₯
And the tea β: this one is safe to use in noinstr code. But the manpage itself says prefer atomic64_fetch_add elsewhere β so like, this is the special-occasion version, not the everyday one. iykyk. π
π RETURN π
It gives you back the original value of v. The value before the add. Fetch-and-add, babes β that's literally the name. You get the old one, the variable keeps the new one. We both win. π«Ά
π SEE ALSO π
The kernel file where the magic lives: ./include/linux/atomic/atomic-arch-fallback.h
And now, the whole entire friend group π β buckle up, this is a long one:
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)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_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(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)
ngl bestie, that's a LOT of friends. but like, they're all in ./include/linux/atomic and you can go read every single one. go off. π
πΈ okay that's the whole page, mwah π β this beauty comes from ./include/linux/atomic, dated October 2026, and it's the raw_atomic64_fetch_add(9) page. slay, stay atomic, and don't forget the full ordering. πβ¨π¦
π¦ 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