raw_atomic_...xchg_relaxed(9)

hi bestie!! 💖 we're in the Kernel API Manual, and this page is the one and only raw_atomic_long_try_cmpxchg_relaxed — header title says raw_atomic_...xchg_relaxed(9). it's giving raw atomic-long compare-and-exchange with relaxed ordering, and yes, it's lowkey iconic ✨

✨ NAME ✨

raw_atomic_long_try_cmpxchg_relaxed — atomic compare and exchange with relaxed ordering. that's the whole assignment bestie 💅

🦋 SYNOPSIS 🦋

the signature is literally this, no edits, no vibes-based renaming:

bool raw_atomic_long_try_cmpxchg_relaxed (atomic_long_t *v , long *old ,
       long new );

🎀 ARGUMENTS 🎀

• v — pointer to atomic_long_t. (the atomic long getting the main-character treatment 💖)
• old — pointer to long value to compare with. (the compare partner)
• new — long value to assign. (the new value that might slide in ✨)

💅 DESCRIPTION 💅

okay so here's the lore: if (v == old), it atomically updates v to new with relaxed ordering. otherwise, v is not modified, old is updated to the current value of v, and relaxed ordering is provided. it's giving “maybe swap, maybe just update the comparison value” and either way the ordering is relaxed, no cap 🦋

important bestie note: it's safe to use in noinstr code; prefer atomic_long_try_cmpxchg_relaxed elsewhere 🫶

🌈 RETURN 🌈

• true if the exchange occurred.
• false otherwise.

that's the bool reveal, periodt 💖

🌸 SEE ALSO 🌸

Kernel file: ./include/linux/atomic/atomic-long.h — that's the home base, iykyk 🏠

the whole atomic-long squad is here:

raw_atomic_long_read(9), raw_atomic_long_read_acquire(9),
raw_atomic_long_set(9), raw_atomic_long_set_release(9),
raw_atomic_long_add(9), raw_atomic_long_add_return(9),
raw_atomic_long_add_return_acquire(9),
raw_atomic_long_add_return_release(9),
raw_atomic_long_add_return_relaxed(9), raw_atomic_long_fetch_add(9),
raw_atomic_long_fetch_add_acquire(9),
raw_atomic_long_fetch_add_release(9),
raw_atomic_long_fetch_add_relaxed(9), raw_atomic_long_sub(9),
raw_atomic_long_sub_return(9), raw_atomic_long_sub_return_acquire(9),
raw_atomic_long_sub_return_release(9),
raw_atomic_long_sub_return_relaxed(9), raw_atomic_long_fetch_sub(9),
raw_atomic_long_fetch_sub_acquire(9),
raw_atomic_long_fetch_sub_release(9),
raw_atomic_long_fetch_sub_relaxed(9), raw_atomic_long_inc(9),
raw_atomic_long_inc_return(9), raw_atomic_long_inc_return_acquire(9),
raw_atomic_long_inc_return_release(9),
raw_atomic_long_inc_return_relaxed(9), raw_atomic_long_fetch_inc(9),
raw_atomic_long_fetch_inc_acquire(9),
raw_atomic_long_fetch_inc_release(9),
raw_atomic_long_fetch_inc_relaxed(9), raw_atomic_long_dec(9),
raw_atomic_long_dec_return(9), raw_atomic_long_dec_return_acquire(9),
raw_atomic_long_dec_return_release(9),
raw_atomic_long_dec_return_relaxed(9), raw_atomic_long_fetch_dec(9),
raw_atomic_long_fetch_dec_acquire(9),
raw_atomic_long_fetch_dec_release(9),
raw_atomic_long_fetch_dec_relaxed(9), raw_atomic_long_and(9),
raw_atomic_long_fetch_and(9), raw_atomic_long_fetch_and_acquire(9),
raw_atomic_long_fetch_and_release(9),
raw_atomic_long_fetch_and_relaxed(9), raw_atomic_long_andnot(9),
raw_atomic_long_fetch_andnot(9),
raw_atomic_long_fetch_andnot_acquire(9),
raw_atomic_long_fetch_andnot_release(9),
raw_atomic_long_fetch_andnot_relaxed(9), raw_atomic_long_or(9),
raw_atomic_long_fetch_or(9), raw_atomic_long_fetch_or_acquire(9),
raw_atomic_long_fetch_or_release(9),
raw_atomic_long_fetch_or_relaxed(9), raw_atomic_long_xor(9),
raw_atomic_long_fetch_xor(9), raw_atomic_long_fetch_xor_acquire(9),
raw_atomic_long_fetch_xor_release(9),
raw_atomic_long_fetch_xor_relaxed(9), raw_atomic_long_xchg(9),
raw_atomic_long_xchg_acquire(9), raw_atomic_long_xchg_release(9),
raw_atomic_long_xchg_relaxed(9), raw_atomic_long_cmpxchg(9),
raw_atomic_long_cmpxchg_acquire(9), raw_atomic_long_cmpxchg_release(9),
raw_atomic_long_cmpxchg_relaxed(9), raw_atomic_long_try_cmpxchg(9),
raw_atomic_long_try_cmpxchg_acquire(9),
raw_atomic_long_try_cmpxchg_release(9), raw_atomic_long_sub_and_test(9),
raw_atomic_long_dec_and_test(9), raw_atomic_long_inc_and_test(9),
raw_atomic_long_add_negative(9),
raw_atomic_long_add_negative_acquire(9),
raw_atomic_long_add_negative_release(9),
raw_atomic_long_add_negative_relaxed(9),
raw_atomic_long_fetch_add_unless(9), raw_atomic_long_add_unless(9),
raw_atomic_long_inc_not_zero(9), raw_atomic_long_inc_unless_negative(9),
raw_atomic_long_dec_unless_positive(9),
raw_atomic_long_dec_if_positive(9)

that's the full squad — every single ref made it to the group chat 💅

mwah 💋 this page came from ./include/linux/atomic, dated October 2026, and yes the header title is raw_atomic_...xchg_relaxed(9). periodt.