percpu_ref_tryget(9)

📦 version 7.3.1, in nixpkgs unstable

💅 percpu_ref_tryget — the Kernel API Manual edition, bestie ✨

okay so real talk, this one lives in the Kernel API Manual and it is literally the politest little refcount function you will ever meet 🎀

🌸 NAME 🌸

percpu_ref_tryget — bestie's whole job is: try to increment a percpu refcount. that's it. that's the vibe 🫶

✨ SYNOPSIS ✨

bool percpu_ref_tryget (struct percpu_ref *ref );

she takes one thing and she gives you back a bool, no cap 💅

🦋 ARGUMENTS 🦋

  • ref — the percpu_ref you're try-getting. like, this is the refcount you're attempting to bump, mwah 😘

🔥 DESCRIPTION 🔥

so here's the tea ☕ — percpu_ref_tryget increments a percpu refcount unless its count already reached zero. if it's already zero, she simply does not, and honestly? respect 🙈

Returns true on success; false on failure. iconic behaviour, no notes 👑

⚠️ also important, bestie: this function is safe to call as long as ref is between init and exit. that's the window, that's the assignment, do not test her outside of it 😭

👀 SEE ALSO 👀

Kernel file ./include/linux/percpu-refcount.h — the mothership, the main character herself 🌈

go read the whole friend group, they're all serving 💜

and that's a wrap, bestie! 🧚 this one shipped from ./include/linux, dated October 2026, and the page goes by percpu_ref_tryget(9) in case you need to cite her in the group chat 💖💅✨

📦 where this page comes from