percpu_ref_exit(9)

✨ NAME ✨

percpu_ref_exit — the undo button for percpu_ref_init(), straight from the Kernel API Manual 💅

---

🛠️ SYNOPSIS 🛠️

void percpu_ref_exit (struct percpu_ref *ref );

---

🎀 ARGUMENTS 🎀

• ref — the percpu_ref you want to exit, bestie. That’s the one getting undone here 🫶

---

🌸 DESCRIPTION 🌸

Okay so this function exits ref. Literally what it says on the tin ✨

The caller is responsible for ensuring that ref is no longer in active use. No cap, that part is on you — make sure it’s actually done being used before you call this 🙈

The usual places to invoke this function from are:

• the ref->release callback, or
• in the init failure path where percpu_ref_init succeeded but other parts of the initialization of the embedding object failed.

That’s the vibe: cleanup when the ref is done, or cleanup when the rest of your setup didn’t make it 😭

---

🦋 SEE ALSO 🦋

Kernel file ./lib/percpu-refcount.c

• percpu_ref_init(9)
• percpu_ref_switch_to_atomic(9)
• percpu_ref_switch_to_atomic_sync(9)
• percpu_ref_switch_to_percpu(9)
• percpu_ref_kill_and_confirm(9)
• percpu_ref_is_zero(9)
• percpu_ref_reinit(9)
• percpu_ref_resurrect(9)

---

source/version ./lib, date October 2026, page percpu_ref_exit(9) — catch u later, bye bestie 😘💖