atomic64_add_return_relaxed(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… atomic64_add_return_relaxed(9) πŸ’…

okay so bestie, this is a page from the Kernel API Manual, and it's honestly one of those tiny-but-iconic ones. we're doing a 64-bit atomic add that gives you the new value back, and it's relaxed about ordering because it's chill like that πŸ¦‹


✨ NAME ✨

atomic64_add_return_relaxed β€” atomic add with relaxed ordering. that's it, that's the whole vibe πŸŽ€


🌸 SYNOPSIS 🌸

s64 atomic64_add_return_relaxed (s64 i , atomic64_t *v );

look at her. two args, one beautiful s64 coming right back at you 🫢


🧚 ARGUMENTS 🧚

  • i β€” the s64 value you wanna add. yes, add this much, bestie πŸ’œ
  • v β€” pointer to an atomic64_t. this is the little counter we're messing with ✨

πŸ”₯ DESCRIPTION πŸ”₯

so basically: atomically updates v to (v + i) with relaxed ordering. no cap, that's the whole function. the "atomically" is doing so much work here β€” nobody's gonna sneak in between you reading and writing, it just happens as one whole unit πŸ‘‘

"relaxed ordering" means she's not doing any extra memory-ordering ceremony for you. she's lowkey just vibing through the operation. so don't expect ordering guarantees the strict variants give you β€” this is the chill one 🌈

⚠️ Unsafe to use in noinstr code β€” for real for real. if you're in noinstr you must use raw_atomic64_add_return_relaxed there instead. do not try it, the kernel will not be cute about it πŸ’€

πŸ’– RETURN πŸ’–

the updated value of v. so you get the new value after the add β€” not the old one, not a status code, just the freshly-bumped number handed straight to you 🎁


⭐ SEE ALSO ⭐

she comes from the kernel file ./include/linux/atomic/atomic-instrumented.h β€” and listen, the family tree is huge, so buckle up bestie 😭

🌸 the atomic_ girlies

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_ besties (our girl's home crew)

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

πŸ¦‹ the atomic_long_ cousins

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)

and that's the whole page, bestie πŸ’œ this one lives in ./include/linux/atomic, dated October 2026, and honestly? she ate. periodt. πŸ‘‘βœ¨πŸŽ€

πŸ“¦ where this page comes from