raw_atomic64_xchg_relaxed(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… raw_atomic64_xchg_relaxed πŸ’…

okay so welcome to the raw_atomic64_xchg_relaxed(9) page, bestie β€” this is a Kernel API Manual entry and it's lowkey iconic. it's short, it's snappy, it swaps a 64-bit value atomically with relaxed ordering, and it lives rent-free in the raw atomic family. let's get into it 🫢


πŸŽ€ NAME πŸŽ€

raw_atomic64_xchg_relaxed β€” atomic exchange with relaxed ordering. that's it. that's the whole vibe. swapping values like it's a friendship bracelet exchange, but make it thread-safe ✨


🌸 SYNOPSIS 🌸

s64 raw_atomic64_xchg_relaxed (atomic64_t *v , s64 new );

like… look at her. two args, one s64 coming back out. she's efficient, she's giving ✨main character energy✨ πŸ’…


πŸ¦‹ ARGUMENTS πŸ¦‹

  • v β€” pointer to atomic64_t. this is the thing you're swapping into, the destination of the glow-up πŸ’–
  • new β€” the s64 value to assign. your new value, your new era, periodt πŸ‘‘

πŸ”₯ DESCRIPTION πŸ”₯

Atomically updates v to new with relaxed ordering.

fr fr, that's the whole thing β€” the swap happens atomically so nobody ever catches v mid-transformation, and the ordering is relaxed (iykyk, relaxed = the weakest ordering vibes, no extra barriers, no dramatics) 🌈

it's safe to use in noinstr code; prefer atomic64_xchg_relaxed elsewhere.

ngl the "prefer atomic64_xchg_relaxed elsewhere" part is important, bestie β€” this raw_* version is the one you reach for specifically when you're in noinstr territory. everywhere else? use the regular one. no cap πŸ’€

⭐ RETURN ⭐

The original value of v.

so you get back what was there before, which is honestly so useful β€” the old value returns like a text from your ex, but make it deterministic πŸ˜­πŸŽ€


🧚 SEE ALSO 🧚

Kernel file ./include/linux/atomic/atomic-arch-fallback.h β€” that's where she lives 🏠

and because the manpage author really said "let me list the ENTIRE family," here's the whole squad, exactly as documented:

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_release(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), 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_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)

like… the way she listed every single sibling 😭 that's dedication, that's commitment, that's family βœ¨πŸ’œ


okay that's the whole page bestie, you ate that πŸ“ quick cute sign-off so you know where this came from: it's from ./include/linux/atomic, dated October 2026, and the page itself is raw_atomic64_xchg_relaxed(9) in the Kernel API Manual. slay, go swap some values safely πŸ’…πŸŽ€πŸŒˆ

πŸ“¦ where this page comes from