raw_atomic6...tive_release(9)
π raw_atomic6...tive_release(9) β¨
okay bestie, welcome to the Kernel API Manual π β yes the title got cut off mid-word, that's just how the man page renderer does her thing, don't @ her. The full name is in the NAME section, breathe.
πΈ NAME πΈ
raw_atomic64_add_negative_release β atomic add and test if negative with release ordering π¦
β¨ SYNOPSIS β¨
bool raw_atomic64_add_negative_release (s64 i , atomic64_t *v );
π§ ARGUMENTS π§
iβ thes64value to add πvβ pointer toatomic64_tπ
π₯ DESCRIPTION π₯
So the whole vibe here: this function atomically updates v to (v + i) and it does it with release ordering. Atomic, ordered, slay. No cap. β
It's safe to use in noinstr code β that's its whole main character moment β but everywhere else you should prefer atomic64_add_negative_release instead. Like, this one's the backup dancer, the other one's the lead. iykyk π
π RETURN π
Returns true if the resulting value of v is negative, false otherwise. That's it, that's the whole test. Simple. Iconic. π
π¦ SEE ALSO π¦
The kernel file is literally ./include/linux/atomic/atomic-arch-fallback.h β go read it, it's giving lore. π
And because this page refuses to be normal, here's every single sibling in the family. Yes, all of them. Buckle up bestie, we're going in order:
the 32-bit intros β read / set / add / sub edition π
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),
the inc / dec girlies πΈ
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),
the bit-twiddlers β and / andnot π
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),
or / xor, keep the vibe going β¨
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),
xchg / cmpxchg / try_cmpxchg β the swap squad π
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),
the testers and the "unless" crew π₯
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),
π and now the 64-bit remix π
read / set / add / sub, but wide π«Ά
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),
inc / dec, 64-bit boogaloo π
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),
and / andnot, the wide cut π
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),
or / xor, wide flavor π
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),
xchg / cmpxchg / try_cmpxchg, big mode π
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),
and the final boss: 64-bit testers + unless crew β
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_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 if you actually read all of those, you're built different. π«Ά
π§ sign-off π§
This little page lives in ./include/linux/atomic, and it's stamped October 2026 β so go forth, add your negatives, and remember: release ordering isn't a suggestion, bestie. πβ¨π
π¦ 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