pru_rproc_get(9)

✨ pru_rproc_get ✨

okay bestie, gather round, because this is a page from the Kernel API Manual and it's honestly kind of a big deal 💅

🌸 NAME 🌸

pru_rproc_get — grab the PRU rproc instance from a device node, no cap

🦋 SYNOPSIS 🦋

struct rproc * pru_rproc_get (struct device_node *np , int index , enum
pruss_pru_id *pru_id );

🎀 ARGUMENTS 🎀

• np — the user/client device node. like, the device node of whoever's asking 🫶
• index — the index to use for the ti,prus property
• pru_id — optional pointer to return the PRU remoteproc processor id. optional!! you don't have to pass it ✨

💖 DESCRIPTION 💖

So what this function actually does: it looks through a client device node's ti,prus property at index index and returns the rproc handle for a valid PRU remote processor if it finds one. it's giving "let me check the property real quick and see if your PRU is in there" 🔍

Bestie, listen — the function allows only one user to own the PRU rproc resource at a time. one. singular. main character energy only, no plus-ones 👑

The caller must call pru_rproc_put when done with the rproc. like, that's the whole etiquette. but good news!! it's not required if the function returns a failure — you're off the hook in that case 🙈

And when the optional pru_id pointer is passed, the PRU remoteproc processor id is returned. cute little bonus info 🍓

🔥 RETURN 🔥

rproc handle on success, and an ERR_PTR on failure using one of these error values:

• -ENODEV if device is not found — literally nowhere to be found 😭
• -EBUSY if PRU is already acquired by anyone — somebody else got there first, it's taken 💀
• -EPROBE_DEFER is PRU device is not probed yet — not ready yet, come back later ⭐

🧚 SEE ALSO 🧚

• Kernel file ./drivers/remoteproc/pru_rproc.c
• enum pru_iomem(9)
• struct pru_private_data(9)
• struct pru_rproc(9)
• pru_rproc_set_firmware(9)
• pru_rproc_put(9)
• pru_rproc_set_ctable(9)

---

and that's the whole page, bestie, you ate that 🫶✨ this little gem lives in ./drivers/remoteproc, dated October 2026, and the header/footer vibe is pru_rproc_get(9) — go forth and get your rproc responsibly 💜