raw_atomic_..._xor_release(9)
π raw_atomic_..._xor_release(9) π
okay so you're reading the Kernel API Manual bestie, welcome, pull up a chair π this one's raw_atomic_..._xor_release(9) and honestly? she's a baddie with a very specific job.
β¨ NAME β¨
raw_atomic_long_fetch_xor_release β atomic bitwise XOR with release ordering. that's it, that's the whole vibe π₯
πΈ SYNOPSIS πΈ
long raw_atomic_long_fetch_xor_release (long i , atomic_long_t *v );
π¦ ARGUMENTS π¦
iβ alongvalue. just a long. living her life. πvβ pointer to anatomic_long_t. this is the main character fr. π
π DESCRIPTION π
so what she does: atomically updates v to (v ^ i) with release ordering. no cap, atomic, and the release ordering is the whole point β don't sleep on it β¨
also important bestie: she is safe to use in noinstr code. but everywhere else, prefer atomic_long_fetch_xor_release instead. like, she's the raw version for a reason, iykyk π
β RETURN β
the original value of v π«Ά β not the new one, the original. read the label before you assume, okay?
π SEE ALSO π
the kernel file lives at ./include/linux/atomic/atomic-long.h β that's the source of truth, go look π§
and here's the whole family, because she does not exist in isolation and you will meet all of them:
- reads & writes:
raw_atomic_long_read(9),raw_atomic_long_read_acquire(9),raw_atomic_long_set(9),raw_atomic_long_set_release(9) - adds:
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) - subs:
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) - incs:
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) - decs:
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) - ands & andnots:
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) - ors:
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) - xors (our girl's whole household π):
raw_atomic_long_xor(9),raw_atomic_long_fetch_xor(9),raw_atomic_long_fetch_xor_acquire(9),raw_atomic_long_fetch_xor_relaxed(9) - xchgs:
raw_atomic_long_xchg(9),raw_atomic_long_xchg_acquire(9),raw_atomic_long_xchg_release(9),raw_atomic_long_xchg_relaxed(9) - cmpxchgs:
raw_atomic_long_cmpxchg(9),raw_atomic_long_cmpxchg_acquire(9),raw_atomic_long_cmpxchg_release(9),raw_atomic_long_cmpxchg_relaxed(9) - try_cmpxchgs:
raw_atomic_long_try_cmpxchg(9),raw_atomic_long_try_cmpxchg_acquire(9),raw_atomic_long_try_cmpxchg_release(9),raw_atomic_long_try_cmpxchg_relaxed(9) - the test-y ones:
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) - the "unless" girlies:
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)
lowkey go read the non-raw atomic_long_fetch_xor_release for normal code, okay? this page is your noinstr-era friend π
okay that's the page!! mwah, go write some correct atomics π«Άβ¨ sourced straight from ./include/linux/atomic, dated October 2026 β literally iconic, periodt π
π
π¦ 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