atomic_inc_and_test(9)

📦 version 7.3.1, in nixpkgs unstable

✨ atomic_inc_and_test(9) ✨

okay so this is the manual page for atomic_inc_and_test, straight out of the Kernel API Manual — yes, that Kernel API Manual. pull up a chair bestie, this one's short and so useful 🫶

🌸 NAME 🌸

atomic_inc_and_test — bumps a value up by one, atomically, with full ordering, and then tells you whether it landed on zero 💅

🎀 SYNOPSIS 🎀

bool atomic_inc_and_test (atomic_t *v );

🦋 ARGUMENTS 🦋

  • v — a pointer to an atomic_t. that's it. that's the whole arg list. iconic minimalism 💖

⭐ DESCRIPTION ⭐

so what it does: it atomically updates v to (v + 1), and it does the whole thing with full ordering. no cap, the ordering is the whole point — that's what makes it "full ordering" and not some relaxed little guy.

🚨 real talk though: this is unsafe to use in noinstr code. if you're living in noinstr land, use raw_atomic_inc_and_test there instead. like, don't come for me, that's just the rule 💀

🔥 RETURN 🔥

  • true — the resulting value of v is zero 🎉
  • false — it's literally anything else 🙈

👑 SEE ALSO 👑

first up, the source of truth — the kernel file ./include/linux/atomic/atomic-instrumented.h — and then, like, the entire atomic family tree. every single one. follow for follow bestie 🌈

and that's the whole page, bestie 💖 mwah 💋

okay real quick sign-off: this lil masterpiece lives in ./include/linux/atomic and it's dated October 2026 — go be atomic, stay ordered, and don't use it in noinstr code ✨🎀🦋

📦 where this page comes from