raw_atomic6...turn_release(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… raw_atomic64_add_return_release πŸ’…

okay so bestie, welcome to the Kernel API Manual ✨ β€” this page is about raw_atomic64_add_return_release, and yes, the header up top gets truncated to raw_atomic6...turn_release(9) because man page headers are dramatic like that πŸ’€. It's the raw, low-level one. Here's the whole vibe.


🌸 SYNOPSIS 🌸

s64 raw_atomic64_add_return_release (s64 i , atomic64_t *v );

literally just two args and it hands you back an s64. slay.


πŸŽ€ ARGUMENTS πŸŽ€

  • i β€” the s64 value you're adding. the amount. the contribution. the little guy going into the pile πŸ’–
  • v β€” a pointer to an atomic64_t. that's the thing you're updating, she's the main character here πŸ‘‘

πŸ¦‹ DESCRIPTION πŸ¦‹

So what does she actually do? She atomically updates v to (v + i), with release ordering. atomic means no one else can catch her mid-update, and the release ordering is the memory-barrier part β€” she's telling the rest of the kernel "okay, everything before this is done-done before you see the new value" 🫢

And the important deets, no cap:

  • It's safe to use in noinstr code β€” that's the whole reason the raw_ version exists, iykyk.
  • Prefer atomic64_add_return_release everywhere else. please. bestie. the raw_ one is for the special noinstr case, not your everyday code πŸ™ˆ
Real talk: this is the arch-fallback / raw layer. If you're not writing noinstr code, you're just making your life harder for no reason πŸ’€

⭐ RETURN ⭐

The updated value of v β€” so, v plus i, post-addition. she gives back the new number, not the old one πŸ’…


🌈 SEE ALSO 🌈

Kernel file: ./include/linux/atomic/atomic-arch-fallback.h

And here's the whole group chat β€” every friend in the family, no one left out 🫢 (yes there are a LOT of them, that's just how the atomic headers roll):

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_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 ✨ this lil gem lives in the kernel source tree at ./include/linux/atomic, dated October 2026 β€” go forth, add your 64-bit integers atomically, and remember: release ordering, not your ex's release ordering πŸ’…πŸ«ΆπŸ’–

πŸ“¦ where this page comes from