raw_atomic_sub(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 NAME 🎀

okay so bestie, welcome to the Kernel API Manual — we're looking at raw_atomic_sub(9), aka atomic subtract with relaxed ordering. It's giving “do one very specific thing and do it atomically,” and honestly? iconic. 💅

✨ SYNOPSIS ✨

void raw_atomic_sub (int i , atomic_t *v );

that's the whole signature, no cap. Copy it exactly, spacing and all — we do not freestyle the C. 🫶

🌸 ARGUMENTS 🌸

  • i — an int: the value to subtract. simple. slay. 🍓
  • v — a pointer to atomic_t. this is the atomic thing getting updated, bestie. ✨

💅 DESCRIPTION 💅

Atomically updates v to (v - i) with relaxed ordering. that's the whole vibe: one atomic subtraction, relaxed ordering, no extra drama. 🦋

Safe to use in noinstr code; prefer atomic_sub elsewhere.

big caveat energy: this is the raw/noinstr-friendly one, and it's relaxed ordering. If you're not in noinstr, the page says prefer atomic_sub, okay? 🫶

🦋 RETURN 🦋

Nothing. Literally nothing, bestie — no return value, no sneaky little number, just the atomic subtract happening. periodt. 💀✨

🌈 SEE ALSO 🌈

the whole link web, and yes I'm keeping every single one — no skips, no “etc.” shenanigans. 👑

  • Kernel file: ./include/linux/atomic/atomic-arch-fallback.h — the source baddie. 🎀

🫶 the raw_atomic core-ish crew

💖 inc/dec moment

🍓 and / andnot / or / xor

🧚 xchg + cmpxchg

🦋 tests and unlesses

👑 raw_atomic64 core squad

🌈 raw_atomic64 inc/dec

🔥 raw_atomic64 bitwise crew

⭐ raw_atomic64 xchg + cmpxchg

💀 raw_atomic64 tests and unlesses

mwah 💋 — this page is straight from ./include/linux/atomic, dated October 2026, and yeah bestie, it's literally raw_atomic_sub(9). 🎀✨

📦 where this page comes from