percpu_ref_put_many(9)

💅 NAME — percpu_ref_put_many(9)

Okay so welcome to the percpu_ref_put_many(9) page from the Kernel API Manual, bestie. This one is literally about decrementing a percpu refcount, and it’s giving “put those references back” energy. 🎀

✨ SYNOPSIS ✨

void percpu_ref_put_many (struct percpu_ref *ref , unsigned long nr );

🫶 ARGUMENTS 🫶

• ref — the percpu_ref to put. That’s the main character here, no cap. 💅
• nr — the number of references to put. Like, how many are we dropping? 🔥

🌸 DESCRIPTION 🌸

So what it does: decrement the refcount, and if it hits 0, call the release function — and yes, that’s the release function that was passed to percpu_ref_init. Periodt. 💖

Safety vibe check: this function is safe to call as long as ref is between init and exit. That’s the whole condition, bestie — don’t skip it. 🚨

👑 SEE ALSO 👑

Kernel file ./include/linux/percpu-refcount.h, plus all these iconic little functions:

• percpu_ref_kill(9)
• percpu_ref_get_many(9)
• percpu_ref_get(9)
• percpu_ref_tryget_many(9)
• percpu_ref_tryget(9)
• percpu_ref_tryget_live_rcu(9)
• percpu_ref_tryget_live(9)
• percpu_ref_put(9)
• percpu_ref_is_dying(9)

Cute sign-off: source/version ./include/linux, date October 2026 — percpu_ref_put_many(9) 💖