STRUCT RPROC_OPS(9)

🌸 NAME 🌸

okay bestie, welcome to struct rproc_ops(9) from the Kernel API Manual — this is the struct that holds platform-specific device handlers 💅

✨ SYNOPSIS ✨

here's the struct in all its exact glory, line breaks and all. copy it exactly, no editing the drip:

       struct rproc_ops {
           int (*prepare)(struct rproc *rproc);
           int (*unprepare)(struct rproc *rproc);
           int (*start)(struct rproc *rproc);
           int (*stop)(struct rproc *rproc);
           int (*attach)(struct rproc *rproc);
           int (*detach)(struct rproc *rproc);
           void (*kick)(struct rproc *rproc, int vqid);
           void * (*da_to_va)(struct rproc *rproc, u64 da, size_t len, bool
       *is_iomem);
           int (*parse_fw)(struct rproc *rproc, const struct firmware *fw);
           int (*handle_rsc)(struct rproc *rproc, u32 rsc_type, void *rsc, int
       offset, int avail);
           struct resource_table *(*find_loaded_rsc_table)(struct rproc *rproc,
       const struct firmware *fw);
           struct resource_table *(*get_loaded_rsc_table)(struct rproc *rproc,
       size_t *size);
           int (*load)(struct rproc *rproc, const struct firmware *fw);
           int (*sanity_check)(struct rproc *rproc, const struct firmware *fw);
           u64 (*get_boot_addr)(struct rproc *rproc, const struct firmware
       *fw);
           unsigned long (*panic)(struct rproc *rproc);
           void (*coredump)(struct rproc *rproc);
        };

💖 Members 💖

okay so these are the members, aka the function-pointer besties inside the struct. every single one has a job and we're gonna hype them all:

• prepare — prepare the device for code loading 💫
• unprepare — unprepare the device after stop
• start — power on the device and boot it 🔥
• stop — power off the device
• attach — attach to a device that his already powered up (the manpage said what it said, bestie 🫶)
• detach — detach from a device, leaving it powered up
• kick — kick a virtqueue (virtqueue id given as a parameter)
• da_to_va — optional platform hook to perform address translations
• parse_fw — parse firmware to extract information (e.g. resource table)
• handle_rsc — optional platform hook to handle vendor resources. Should return RSC_HANDLED if the resource was handled, RSC_IGNORED if not handled, and a negative value on error ⚠️
• find_loaded_rsc_table — find the loaded resource table from firmware image
• get_loaded_rsc_table — get resource table installed in memory by external entity
• load — load firmware to memory, where the remote processor expects to find it
• sanity_check — sanity check the fw image
• get_boot_addr — get boot address to entry point specified in firmware
• panic — optional callback to react to system panic; the core will delay panic at least the returned number of milliseconds 😭
• coredump — collect firmware dump after the subsystem is shutdown

🔮 SEE ALSO 🔮

Kernel file ./include/linux/remoteproc.h — and the whole friend group:

• struct rproc_mem_entry(9)
• enum rsc_handling_status(9)
• enum rproc_state(9)
• enum rproc_crash_type(9)
• enum rproc_dump_mechanism(9)
• struct rproc_dump_segment(9)
• enum rproc_features(9)
• struct rproc(9)
• struct rproc_subdev(9)
• struct rproc_vring(9)
• struct rproc_vdev(9)

xoxo, your kernel group-chat admin 💖 — source/version: ./include/linux · date: October 2026 · page: struct rproc_ops(9) ✨