atomic_fetch_add_release(9)
π atomic_fetch_add_release β like, the whole vibe
okay so bestie, welcome to atomic_fetch_add_release(9), straight out of the Kernel API Manual, section 9. it's a kernel function, it's atomic, and it has opinions about ordering. let's get into it π«Ά
β¨ NAME β¨
atomic_fetch_add_release β atomic add with release ordering
(yeah. that's it. that's the whole name. short, iconic, does exactly what it says π )
πΈ SYNOPSIS πΈ
int atomic_fetch_add_release (int i , atomic_t *v );
π ARGUMENTS π
iβ anintvalue to add. just a number, bestie. it's the thing going in.vβ pointer toatomic_t. this is the main character right here β¨
π₯ DESCRIPTION π₯
so what it actually does: it atomically updates v to (v + i) with release ordering. atomically meaning nobody else can sneak in halfway through and mess with it β it's giving locked-in, no cap π
the release part is the ordering. that's the whole flair of this function versus its relaxed cousin.
β οΈ okay important, and I mean it: this one is unsafe to use innoinstrcode. if you're innoinstrland, useraw_atomic_fetch_add_releasethere instead. like, that's not a suggestion, that's the rule π
π RETURN π
it hands you back the original value of v β the value from before the add happened. so you get the receipts of what it used to be π
π SEE ALSO π
okay so this next part is a moment. all of these live in the kernel file ./include/linux/atomic/atomic-instrumented.h, and there are a LOT of them. buckle up, bestie π
π¦ the plain atomic_* fam
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_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_* era
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)
π§ the atomic_long_* collection
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 thing, bestie π this page comes to you from ./include/linux/atomic, dated October 2026 β so like, mark your calendars, and go forth and add atomically with release ordering. slay πβ¨
π¦ 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