raw_atomic_..._dec_acquire(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… raw_atomic_..._dec_acquire β€” Kernel API Manual ✨

okay so bestie, welcome to the Kernel API Manual, this is the page for raw_atomic_long_fetch_dec_acquire(9) and honestly? it's a whole vibe. it does one (1) thing and it does it atomically. no cap.


🌸 NAME 🌸

raw_atomic_long_fetch_dec_acquire β€” atomic decrement with acquire ordering πŸ’…

like literally that's the whole personality. decrement, atomically, with acquire ordering. iconic behavior.


✨ SYNOPSIS ✨

long raw_atomic_long_fetch_dec_acquire (atomic_long_t *v );

that's it. that's the function. one pointer, no drama πŸŽ€


πŸ¦‹ ARGUMENTS πŸ¦‹

  • v β€” pointer to atomic_long_t. just a pointer, she's not asking for much 🫢

πŸ’– DESCRIPTION πŸ’–

so here's the tea, bestie: it atomically updates v to (v - 1) with acquire ordering. one decrement, atomically, acquire semantics, done. slay πŸ”₯

it's safe to use in noinstr code β€” that's the special sauce, that's the raw_ in the name. but literally everywhere else, prefer atomic_long_fetch_dec_acquire instead. the raw one is the emergency-exit version, the regular one is the going-out-outfit version. iykyk πŸ’€


πŸ‘‘ RETURN πŸ‘‘

the original value of v β€” like, the value it had before the decrement. so you get the before-pic, not the after-pic πŸ“Έβœ¨


🌈 SEE ALSO 🌈

the whole squad, fr fr. every single one of them:

raw_atomic_long_read(9), raw_atomic_long_read_acquire(9),
raw_atomic_long_set(9), raw_atomic_long_set_release(9),
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), 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), 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), 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_release(9),
raw_atomic_long_fetch_dec_relaxed(9), 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), 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), raw_atomic_long_xor(9),
raw_atomic_long_fetch_xor(9), raw_atomic_long_fetch_xor_acquire(9),
raw_atomic_long_fetch_xor_release(9),
raw_atomic_long_fetch_xor_relaxed(9), raw_atomic_long_xchg(9),
raw_atomic_long_xchg_acquire(9), raw_atomic_long_xchg_release(9),
raw_atomic_long_xchg_relaxed(9), raw_atomic_long_cmpxchg(9),
raw_atomic_long_cmpxchg_acquire(9), raw_atomic_long_cmpxchg_release(9),
raw_atomic_long_cmpxchg_relaxed(9), 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), 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),
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)

and the kernel file herself? ./include/linux/atomic/atomic-long.h β€” go read it, she's gorgeous 🧚


bestie note: raw_ = noinstr-safe. everywhere else, use atomic_long_fetch_dec_acquire. don't be out here using the raw one for no reason, i'm begging πŸ™ˆ

okay so that's the page!! source file is ./include/linux/atomic, dated October 2026, and the whole thing is literally called raw_atomic_..._dec_acquire(9) in case you forgot already πŸ’œ mwah, go decrement something atomically, ily, bye πŸ“πŸ’…

πŸ“¦ where this page comes from