raw_atomic_...ess_negative(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 raw_atomic_...ess_negative(9) 🌸

okay bestie, so this is from the Kernel API Manual and it's about raw_atomic_long_inc_unless_negative — yes the name is a whole meal and then some, but stay with me, it's actually so good 💅

✨ NAME ✨

raw_atomic_long_inc_unless_negative — atomic increment unless negative, with full ordering 💖

🎀 SYNOPSIS 🎀

bool raw_atomic_long_inc_unless_negative (atomic_long_t *v );

🦋 ARGUMENTS 🦋

  • v — pointer to atomic_long_t. that's the lil guy you're gonna poke at 🫶

💜 DESCRIPTION 💜

okay so if (v >= 0), it atomically updates v to (v + 1) with full ordering. literally doing the most, in the best way ✨

otherwise — like if v is negative — v is not modified, and you get relaxed ordering instead. no cap, it just sits there 💀

it's safe to use in noinstr code; but please prefer atomic_long_inc_unless_negative everywhere else, iykyk 🌈

👑 RETURN 👑

returns true if v was updated, false otherwise. simple as that, periodt 💅

🔥 SEE ALSO 🔥

kernel file ./include/linux/atomic/atomic-long.h — the whole squad lives here 🧚

that's the whole page, and fr fr you ate that 🍓

source: ./include/linux/atomic · dated October 2026 · and we're closing out raw_atomic_...ess_negative(9) — mwah, main character energy, bye bestie 💖🎀✨

📦 where this page comes from