raw_atomic_f..._inc_release(9)
π
raw_atomic_f..._inc_release(9) β the Kernel API Manual, but make it cute β¨
okay so this is a page from the Kernel API Manual β yes, the raw_atomic_f..._inc_release(9) one, the name got squished by the man-page generator and honestly? she's thriving anyway π«Ά
πΈ NAME πΈ
raw_atomic_fetch_inc_release β atomic increment, but make it a release π
(ordering-wise, bestie, keep up)
β¨ SYNOPSIS β¨
int raw_atomic_fetch_inc_release (atomic_t *v );
that's it. that's the whole vibe check. one function, one pointer, one int coming back at you π
π ARGUMENTS π
vβ pointer toatomic_t. literally just a pointer to the atomic thing you're about to bump. she's the main character of this function, no cap π¦
π₯ DESCRIPTION π₯
so what does she do? Atomically updates v to (v + 1) β one clean, indivisible little ++ β and does it with release ordering. the way that one operation is both "add one" and "respect my memory ordering"β¦ obsessed π
also important: Safe to use in noinstr code β like, genuinely safe, that's the whole point of the raw_ prefix β but prefer atomic_fetch_inc_release elsewhere. raw_ is the special-occasion one, not the everyday one. iykyk π§
ngl, if you're reaching for this and you're not in noinstr code, the manpage is gently asking you to use the non-raw version. it's giving "read the room" π
β RETURN β
The original value of v. β¨ Not the new one β the original one. the fetch part of the name is not decorative, bestie π
π SEE ALSO π
first up, the receipts β kernel file ./include/linux/atomic/atomic-arch-fallback.h π
and thenβ¦β¦ the entire extended friend group. like, everyone showed up to this party. no one got left on read π«Ά
π the raw_atomic_* girlies (32-bit era)
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_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 raw_atomic64_* icons (64-bit, obviously)
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_acquire(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)
π sign-off π
and that's the page, bestie!! this one lives in ./include/linux/atomic, dated October 2026, and it answers to the name raw_atomic_f..._inc_release(9) β yes, still squished, still iconic, we stan a truncated filename ππ
go forth and increment atomically. 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