raw_atomic6...turn_acquire(9)
β¨ NAME β¨
okay so first things first bestie β welcome to the Kernel API Manual π and today's main character is raw_atomic64_inc_return_acquire β atomic increment with acquire ordering. yes that's the whole name. it's a mouthful. we love her anyway π
πΈ SYNOPSIS πΈ
s64 raw_atomic64_inc_return_acquire (atomic64_t *v );
like. look at her. s64 in the front, atomic64_t *v in the back. iconic signature, no notes π
(and yes, the spacing up there is exactly how it's written β don't come for me, I'm just the messenger π«Ά)
π¦ ARGUMENTS π¦
vβ pointer toatomic64_t. that's it. that's the whole argument. she takes one (1) thing and she takes it well β¨
π§ DESCRIPTION π§
okay so what does she actually do? bestie. she atomically updates v to (v + 1) with acquire ordering. that's the whole vibe. one function, one job, one increment, no cap π₯
and the important part, the part where you need to pay attention π β she's safe to use in noinstr code. so if you're living that noinstr life, she's your girl.
but β and I cannot stress this enough β elsewhere? prefer atomic64_inc_return_acquire. like, this one is the raw one for a reason. she's the special-occasion friend, not the everyday one. lowkey that's the whole plot twist of this page π
no invented lore here, bestie β that's literally all the description says. safe innoinstr, preferatomic64_inc_return_acquireotherwise. periodt.
π RETURN π
the updated value of v π so you don't gotta go read it back yourself, she hands it to you. main character behavior.
π SEE ALSO π
she's got a whole extended universe of friends, I'm not even kidding, this is the longest group chat in the kernel π«Ά first up, the file she lives in:
- Kernel file
./include/linux/atomic/atomic-arch-fallback.h
and now the family reunion β every single one of these, in order, no skipping π
π the 32-bit raw crew
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)
π the 64-bit raw crew (our girl's home turf)
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_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_xchg_relaxed(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)
and that's the page !! π¦ go forth and increment, bestie. this little beauty comes to you from ./include/linux/atomic (that's where the kernel keeps her π) and she's dated October 2026 β so she's fresh, she's glowing, she's got main character energy. slay β¨ππ
π¦ 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