rproc_alloc(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rproc_alloc(9) — allocate a remote processor handle 💅

okay so welcome to the Kernel API Manual, bestie — this is the rproc_alloc(9) page, and it's literally giving “make me a remote processor handle, but don't register it yet.” ✨

🌸 NAME 🌸

rproc_alloc — allocate a remote processor handle. That's the whole vibe: you're allocating the handle, not doing the full registration dance yet. 💖

✨ SYNOPSIS ✨

struct rproc * rproc_alloc (struct device *dev , const char *name ,
       const struct rproc_ops *ops , const char *firmware , int len );

🎀 ARGUMENTS 🎀

  • dev — the underlying device. Like, the device this whole remote-processor situation is sitting on top of. 🫶
  • name — name of this remote processor. Give it a cute lil identity, bestie. 💅
  • ops — platform-specific handlers (mainly start/stop). This is where the platform-specific behavior lives. 👑
  • firmware — name of firmware file to load, can be NULL. If it's NULL, don't panic — the DESCRIPTION has the tea. 🍓
  • len — length of private data needed by the rproc driver (in bytes). Bytes, not vibes. 😌

🦋 DESCRIPTION 🦋

Allocates a new remote processor handle, but does not register it yet. If firmware is NULL, a default name is used. No cap, that's the deal. ✨

This function should be used by rproc implementations during initialization of the remote processor. Like, this is the setup-era move, bestie. 🛠️

After creating an rproc handle using this function, and when ready, implementations should then call rproc_add to complete the registration of the remote processor. That's the completion step — rproc_add, iykyk. 👑

💀 NOTE 💀

NO CAP: _never_ directly deallocate rproc, even if it was not registered yet. Instead, when you need to unroll rproc_alloc, use rproc_free. Do not do the forbidden thing, bestie. 🙈

🫶 RETURN 🫶

new rproc pointer on success, and NULL on failure. Slay on success, sad little NULL on failure. 😭

🌈 SEE ALSO 🌈

mwah 💋 this page came from ./drivers/remoteproc, dated October 2026, and it's the rproc_alloc(9) page — periodt. 🌟

📦 where this page comes from