atomic64_fetch_and(9)
π NAME π
okay so bestie, you're looking at atomic64_fetch_and(9) β the Kernel API Manual page for an atomic bitwise AND with full ordering. one function, zero drama, maximum atomicity β¨
β¨ SYNOPSIS β¨
s64 atomic64_fetch_and (s64 i , atomic64_t *v );
π«Ά ARGUMENTS π«Ά
iβ ans64value. that's the number, bestie, the one doing the ANDing.vβ pointer toatomic64_t. the actual spot in memory getting updated, front and center, main character energy π
π¦ DESCRIPTION π¦
so what does it do? it atomically updates v to (v & i) β with full ordering, no cap. the whole operation lands as one indivisible little moment, and everyone else watching that value sees it happen in the correct order π
π© real talk though: it's unsafe to use innoinstrcode β useraw_atomic64_fetch_andthere instead. don't be the person who ignores this, i'm begging π
πΈ RETURN πΈ
it hands you back the original value of v β the pre-glow-up version, before the AND hit it π
π SEE ALSO π
the source of all this is the kernel file ./include/linux/atomic/atomic-instrumented.h, and honestly? the family tree is huge. every single one of these is invited to the group chat π
the atomic_* girlies
- reads & sets:
atomic_read(9),atomic_read_acquire(9),atomic_set(9),atomic_set_release(9) - add:
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) - sub:
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) - inc:
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) - dec:
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) - bitwise:
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) - swaps & compares:
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) - tests & unless-es:
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)
the atomic64_* besties (yes, our girl's whole family π)
- reads & sets:
atomic64_read(9),atomic64_read_acquire(9),atomic64_set(9),atomic64_set_release(9) - add:
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) - sub:
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) - inc:
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) - dec:
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) - bitwise:
atomic64_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) - swaps & compares:
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) - tests & unless-es:
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)
the atomic_long_* cousins π§
- reads & sets:
atomic_long_read(9),atomic_long_read_acquire(9),atomic_long_set(9),atomic_long_set_release(9) - add:
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) - sub:
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) - inc:
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) - dec:
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) - bitwise:
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) - swaps & compares:
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) - tests & unless-es:
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)
that's the whole page, bestie, and it lives in ./include/linux/atomic, dated October 2026 β mwah, go AND some bits safely ππ¦
π¦ 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