raw_atomic_add_return(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… NAME πŸ’…

okay so bestie, this is raw_atomic_add_return(9) from the Kernel API Manual β€” it's the atomic add with full ordering girlie ✨ like, it adds stuff to your atomic variable and gives you the brand new value back, all in one unfazed, can't-be-interrupted move 🫢


🌈 SYNOPSIS 🌈

int raw_atomic_add_return (int i , atomic_t *v );

πŸŽ€ ARGUMENTS πŸŽ€

  • i β€” the int value you're adding, like your little contribution to the cause πŸ’–
  • v β€” pointer to atomic_t, aka where the magic happens πŸ‘‘

✨ DESCRIPTION ✨

Atomically updates v to (v + i) with full ordering. that's it, that's the vibe πŸ’… nobody can sneak a read in halfway through, the ordering is locked in, periodt.

Safe to use in noinstr code; prefer atomic_add_return elsewhere. ok so like β€” it works in noinstr, no cap, but if you're not in noinstr land you should lowkey be using atomic_add_return instead πŸ™ˆ the raw version is the special-occasion fit, not the everyday 'fit.

real talk: the noinstr thing is the whole reason this raw flavor exists β€” don't just reach for it because it sounds cooler, bestie 😭

πŸ”₯ RETURN πŸ”₯

The updated value of v. so like, (v + i) after the add β€” the new number, the fresh look, the after photo πŸ“Έ


πŸ¦‹ SEE ALSO πŸ¦‹

literally the entire extended friend group πŸ’€ the whole roster came to the group chat, and yes we are listing every single one of them because nobody gets left on read:

Kernel file ./include/linux/atomic/atomic-arch-fallback.h
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_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(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)

and that's the whole page bestie, ily, go add some numbers atomically πŸ’œ

source: ./include/linux/atomic Β· date: October 2026 πŸŽ€ mwah, see u in the next manpage 🫢✨

πŸ“¦ where this page comes from