rproc_get_by_phandle(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rproc_get_by_phandle(9) ✨

okay bestie, welcome to the Kernel API Manual — this one's called rproc_get_by_phandle(9) and it's genuinely one of the shorter ones so we can absolutely get through it together 🫶

🌸 NAME 🌸

rproc_get_by_phandle — find a remote processor by phandle. that's it, that's the whole gig 💖

⭐ SYNOPSIS ⭐

struct rproc * rproc_get_by_phandle (phandle phandle );

like yes girl, hand it a phandle and it hands you back a struct rproc *. iconic behavior honestly 👑

🎀 ARGUMENTS 🎀

  • phandle — the phandle pointing at the rproc. that's the one thing you gotta give it 🦋

🧚 DESCRIPTION 🧚

so here's the vibe: this function finds an rproc handle using the remote processor's phandle, and then returns a handle to the rproc. literally that's it. find + return. clean. efficient. main character energy ✨

🚨 okay this part is important, do NOT skip it: this function increments the remote processor's refcount, so you always need to use rproc_put to decrement it back once the rproc isn't needed anymore. no cap. if you don't, the refcount just sits there being wrong and that's not the energy we're bringing today 😭

🌈 RETURN 🌈

rproc handle on success 💖 — and NULL on failure 💀

👑 SEE ALSO 👑

Kernel file ./drivers/remoteproc/remoteproc_core.c — and like, the whole friend group:

and that's the whole page bestie, you ate that fr fr 🔥 this little gem lives over in ./drivers/remoteproc and it's dated October 2026 — go forth and remember your rproc_put, i'm begging you 🙈💜

📦 where this page comes from