atomic64_try_cmpxchg(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… atomic64_try_cmpxchg(9)

okay so bestie, welcome to the Kernel API Manual β€” today's main character is atomic64_try_cmpxchg, and she is literally the "compare and exchange, but with full ordering" girlie. no cap. πŸ¦‹


✨ NAME ✨

atomic64_try_cmpxchg β€” atomic compare and exchange with full ordering πŸ’–


🌸 SYNOPSIS 🌸

bool atomic64_try_cmpxchg (atomic64_t *v , s64 *old , s64 new );

like yes, that's the whole vibe. three args, one bool back. periodt. πŸŽ€


🧚 ARGUMENTS 🧚

  • v β€” pointer to atomic64_t. this is the thing we're messing with, bestie 🫢
  • old β€” pointer to the s64 value we're comparing against. yes, it's a pointer, don't come for me πŸ™ˆ
  • new β€” the s64 value we wanna assign if the vibe check passes ✨

πŸ’œ DESCRIPTION πŸ’œ

so here's the tea β˜•: if (v == old), she atomically updates v to new with full ordering. slay. iconic. no notes. πŸ”₯

otherwise? v is not modified, old gets updated to the current value of v, and you only get relaxed ordering. it's giving "consolation prize" ngl πŸ’€

🚨 real talk though β€” this is unsafe to use in noinstr code. if you're in there, use raw_atomic64_try_cmpxchg instead. don't be that girl. 🌈

πŸ‘‘ RETURN πŸ‘‘

true if the exchange actually occurred β€” like, she went through with it πŸ’…

false otherwise β€” she looked at it, said "not today", and handed you back the real current value 😭


πŸ¦‹ SEE ALSO πŸ¦‹

okay buckle up bestie, this list is long long. but every single one of them matters, iykyk πŸ’–

kernel file ./include/linux/atomic/atomic-instrumented.h, and then:

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_release(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), 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_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), 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 page, bestie!! sourced from ./include/linux/atomic, dated October 2026, straight out of the Kernel API Manual. go forth and compare-and-exchange responsibly πŸŽ€βœ¨πŸ¦‹πŸ’…

πŸ“¦ where this page comes from