raw_atomic6...tive_relaxed(9)

📦 version 7.3.1, in nixpkgs unstable

💅 raw_atomic64_add_negative_relaxed 💅

ok so welcome to the Kernel API Manual bestie, and today's main character is raw_atomic64_add_negative_relaxed — the lowercase-regex-looking name is literally just how the page header squishes it (raw_atomic6...tive_relaxed(9)), do not let that jump-scare you 💀

✨ NAME ✨

raw_atomic64_add_negative_relaxed — atomic add and test if negative, with relaxed ordering 🎀

Like, you add a thing, and then you check if the result went negative. Atomically. With relaxed ordering. That's the whole vibe ✨

🌸 SYNOPSIS 🌸

bool raw_atomic64_add_negative_relaxed (s64 i , atomic64_t *v );

Yup, that spacing is canon, copy it exactly 🫶

🎀 ARGUMENTS 🎀

  • i — an s64 value to add 💖 that's the number going in
  • v — pointer to atomic64_t 👑 that's the thing getting updated

🦋 DESCRIPTION 🦋

So here's the tea: it atomically updates v to (v + i) with relaxed ordering.

That's it. That's the function. Add, and it's relaxed about memory ordering the way I'm relaxed about my sleep schedule 😭

It's safe to use in noinstr code — which is a mood, honestly. But elsewhere, prefer atomic64_add_negative_relaxed instead. That's not me being shady, that's literally what the page says 🫶

ngl, if you're not in noinstr territory, use the non-raw_ version — the raw one is for the special cases, iykyk 💅

🌈 RETURN 🌈

Returns true if the resulting value of v is negative, false otherwise ✨

Literally a vibe check on your number: negative = true, not negative = false 🦋

💜 SEE ALSO 💜

Kernel file: ./include/linux/atomic/atomic-arch-fallback.h 🍓

ok this list is long long, but every single one is here because we do not skip entries in this house 👑

ok that's the whole fam, all accounted for, no crumbs left behind 🧚

and that's the page!! ty for coming to my ted talk 🫶 this one lives in ./include/linux/atomic and it's dated October 2026 — slay, see u next time bestie 💖✨

📦 where this page comes from