rproc_detach(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rproc_detach(9)

okay so this is a page straight outta the Kernel API Manual (that's the manual name, bestie, we're fancy now) and it's all about rproc_detach — one little function with main character energy. sit down, grab a strawberry 🍓, let's go.

✨ NAME ✨

rproc_detach — detach the remote processor from the remoteproc core. yeah. that's the whole gig. iconic honestly 👑

🦋 SYNOPSIS 🦋

int rproc_detach (struct rproc *rproc );

🌸 ARGUMENTS 🌸

  • rproc — the remote processor. that's it. that's the argument. it's the one thing you gotta hand over 🫶

💖 DESCRIPTION 💖

so what it does is: it detaches a remote processor — and like, specifically one that was previously attached to with rproc_attach. so this is the breakup function, not the first-date function, iykyk 💔✨

now here's the lowkey important part: in case rproc is still being used by an additional user(s), this function will just decrement the power refcount and exit, without disconnecting the device. so no dramatic goodbye scene. it literally just goes "noted" and leaves 😭 it is NOT severing the connection if other people are still holding on.

rproc_detach calls __rproc_detach in order to let a remote processor know that services provided by the application processor are no longer available. that's the whole message. "bestie the app processor services are gone, no cap."

and from there — this is the slay part — it should be possible to remove the platform driver and even power cycle the application processor (if the HW supports it) without needing to switch off the remote processor. so you can restart one side without dragging the other down with you. healthy boundaries periodt 🧚‍♀️

⚠️ just remember: that power-cycle thing is conditional — if the HW supports it. don't come for me if your hardware says no 🙈

🔥 RETURN 🔥

  • 0 on success 🎉
  • and an appropriate error value otherwise 💀

👑 SEE ALSO 👑

kernel file ./drivers/remoteproc/remoteproc_core.c, and honestly the whole friend group:

🌈 and that's the page!! this lil gem lives in ./drivers/remoteproc and it's stamped October 2026 — future vibes only ⭐ go detach something responsibly, mwah 💜🎀
📦 where this page comes from