raw_atomic_t...xchg_release(9)
π NAME π
raw_atomic_try_cmpxchg_release β it's the atomic compare-and-exchange function, but make it release-ordering β¨ (this is page 9 of the Kernel API Manual, bestie, so you know it's a real one π«Ά)
πΈ SYNOPSIS πΈ
bool raw_atomic_try_cmpxchg_release (atomic_t *v , int *old , int new );
π ARGUMENTS π
vβ a pointer toatomic_t. this is the thing we're messing with, the main character of the whole operation πoldβ a pointer to theintvalue we're comparing against. note that it's a pointer, bestie, she does double duty (more on that below π)newβ theintvalue to assign. the new era π«
π¦ DESCRIPTION π¦
okay so here's the vibe check. if (v == old), the function atomically updates v to new with release ordering. slay, exchange happened π
but if that's not the case? then v is not modified at all β she said "no thank you" β and instead old gets updated to the current value of v, and relaxed ordering is provided. so old walks away holding the real answer. that's the plot twist, iykyk π
it's safe to use innoinstrcode β but fr fr, preferatomic_try_cmpxchg_releaseeverywhere else. theraw_version is the low-level one, it's giving "built different, use with intention" energy π
β RETURN β
true if the exchange occurred, false otherwise. that's it, that's the whole personality π
π SEE ALSO π
lowkey the biggest friend group in the whole kernel, no cap. here's everyone:
- it lives in the 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(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_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)- the 64-bit girlies:
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)
that's the whole page, bestie π«Ά go forth and compare-and-exchange responsibly π
this icon lives in ./include/linux/atomic, dated October 2026, and the header up top calls her raw_atomic_t...xchg_release(9) (the name got truncated mid-vibe, we don't gatekeep, we love her anyway πβ¨)
π¦ 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