atomic64_fetch_and_release(9)

๐Ÿ“ฆ version 7.3.1, in nixpkgs unstable

๐ŸŒธ atomic64_fetch_and_release(9) โ€” from the Kernel API Manual ๐ŸŒธ

okay bestie, sit down, hydrate, and let me tell you about the one kernel function that does an AND and a fetch and has opinions about memory ordering, all at once. it's from the Kernel API Manual, it's an atomic64 situation, and honestly? it ate. ๐Ÿ’…


โœจ NAME โœจ

atomic64_fetch_and_release โ€” atomic bitwise AND, but make it release ordering ๐Ÿ’–


โœจ SYNOPSIS โœจ

s64 atomic64_fetch_and_release (s64 i , atomic64_t *v );

๐Ÿซถ ARGUMENTS ๐Ÿซถ

  • i โ€” an s64 value. yeah. just a signed 64-bit number. it's the mask, bestie.
  • v โ€” pointer to an atomic64_t. this is the thing we're about to mess with, so likeโ€ฆ handle with care โœจ

๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

So the whole vibe is: this thing atomically updates v to (v & i), and it does it with release ordering. no cap. atomically. nobody gets to catch it mid-AND.

โš ๏ธ the important part, do not scroll past this: it is unsafe to use in noinstr code. if you're in noinstr land, use raw_atomic64_fetch_and_release there instead. like, genuinely. i'm not being dramatic, this is a real caveat ๐Ÿ˜ญ

๐Ÿ’€ RETURN ๐Ÿ’€

It gives you back the original value of v โ€” the value from before the AND happened. so you get the receipts of what it used to be ๐Ÿงพโœจ


๐Ÿ‘‘ SEE ALSO ๐Ÿ‘‘

okay this next part is the whole friend group, and i'm not leaving anyone out, so here's the full guest list from the kernel file ./include/linux/atomic/atomic-instrumented.h โ€” every single one, periodt ๐ŸŽ€

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

(yes, all of them. every last one. iykyk ๐Ÿ˜ฎโ€๐Ÿ’จ)


that's the whole page, bestie โ€” go AND some 64-bit values responsibly ๐Ÿ“โœจ

๐ŸŒˆ sign-off: this little masterpiece lives in ./include/linux/atomic, and it's dated October 2026. screenshot it, frame it, put it on the fridge. mwah ๐Ÿ’œ

๐Ÿ“ฆ where this page comes from