raw_atomic64..._add_acquire(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 raw_atomic64_fetch_add_acquire(9) — from the Kernel API Manual ✨

Okay bestie, listen. This one's from the Kernel API Manual, and it's giving "tiny function, huge responsibilities" energy. It's raw_atomic64_fetch_add_acquire(9) and honestly? She does one thing and she does it immaculately. 💅

🎀 NAME 🎀

raw_atomic64_fetch_add_acquire — atomic add, but make it acquire ordering. Like adding, but with ✨commitment issues handled properly✨.

🦋 SYNOPSIS 🦋

s64 raw_atomic64_fetch_add_acquire (s64 i , atomic64_t *v );

No cap, that's the whole signature. Two args, one s64 coming back at you. 🫶

🌈 ARGUMENTS 🌈

  • i — the s64 value you're adding. Your contribution. Your little donation to the counter. 🍓
  • v — a pointer to atomic64_t. This is the main character, the thing actually getting updated.

💖 DESCRIPTION 💖

So here's the tea: this atomically updates v to (v + i), and it does it with acquire ordering. Atomic means nobody's gonna catch her mid-update — it's all-or-nothing, periodt. 🔥

The acquire part is the whole vibe check: it's memory-ordering business, and she takes it seriously.

Also, super important, bestie: this one is safe to use in noinstr code. That's her whole niche! But if you're not in noinstr code, the page is literally begging you — prefer atomic64_fetch_add_acquire elsewhere. Like, please. 🙈

Not me reading "prefer atomic64_fetch_add_acquire elsewhere" and feeling personally called out. It's fine. It's fine. 😭

⭐ RETURN ⭐

She gives you back the original value of v. As in, what it was before she added i to it. Rewind energy. 👑

👑 SEE ALSO 👑

First things first — she lives in this file, go say hi:

  • Kernel file ./include/linux/atomic/atomic-arch-fallback.h

🧚 the raw_atomic_* crew (32-bit-flavoured)

💜 the raw_atomic64_* crew (our girl's family, 64-bit royalty)

Yeah, that's a lot of siblings. It's a big family. Everybody's slaying in their own ordering. 💀

Okay that's the whole page, bestie — every last reference accounted for, nothing ghosted. 🫶 This one came from the source ./include/linux/atomic, dated October 2026, and she's filed under raw_atomic64..._add_acquire(9) in case you need to find her again. Mwah. 💖✨

📦 where this page comes from