STRUCT PVR_FW_OBJECT(9)

💖 struct pvr_fw_object(9) 💖

okay bestie so this is a page out of the Kernel API Manual, and today's main character is struct pvr_fw_object — lowkey just a container for firmware memory allocations. that's it, that's the vibe. ✨

✨ SYNOPSIS ✨

here's the whole glow-up, verbatim, no cap:

struct pvr_fw_object {
    struct kref ref_count;
    struct pvr_gem_object *gem;
    struct drm_mm_node fw_mm_node;
    u32 fw_addr_offset;
    void (*init)(void *cpu_ptr, void *priv);
    void *init_priv;
    struct list_head node;
 };

🎀 Members 🎀

every field, bestie, we're not skipping a single one 💅

• ref_count — the FW object reference counter. it's keeping score fr fr.
• gem — the GEM object backing the FW object. the whole thing is built on top of it 🫶
• fw_mm_node — the node representing the mapping in FW address space. ⚠️ important: pvr_obj->lock must be held when writing. like, not optional, not a suggestion, hold the lock.
• fw_addr_offset — the virtual address offset of the firmware mapping. this one's only valid if flags has PVR_GEM_OBJECT_FLAGS_FW_MAPPED set. no flag, no validity, iykyk 🙈
• init — the initialisation callback. it gets called on object creation and on FW hard reset 🔥. and heads up: the object will have been zeroed before this is called, so don't come for it expecting leftovers.
• init_priv — private data for the initialisation callback. its little emotional support pointer 🎀
• node — the node for the firmware object list. every baddie needs a linked list to belong to 💜

🌈 SEE ALSO 🌈

go read these next, bestie, they're iconic:

• Kernel file ./drivers/gpu/drm/imagination/pvr_fw.h struct
• pvr_fw_defs(9), struct pvr_fw_mem(9), pvr_fw_object_get_dma_addr(9)

and that's the whole page babes 🌸 this one lives in ./drivers/gpu/drm/imagination, dated October 2026 — so yeah, future-coded. slay. 💅👑