STRUCT PVR_VM_CONTEXT(9)

💖 struct pvr_vm_context(9) 💖

okay bestie, welcome to the Kernel API Manual ✨ this one is literally all about struct pvr_vm_context and it's giving "I hold a whole VM together" energy, periodt.

🌸 NAME 🌸

struct pvr_vm_context — the context type used to represent a single VM. no cap, that's the whole vibe.

🦋 SYNOPSIS 🦋

struct pvr_vm_context {
    struct pvr_device *pvr_dev;
    struct pvr_mmu_context *mmu_ctx;
    struct drm_gpuvm gpuvm_mgr;
    struct mutex lock;
    struct pvr_fw_object *fw_mem_ctx_obj;
    struct kref ref_count;
    struct drm_gem_object dummy_gem;
};

🎀 Members 🎀

• pvr_dev — the PowerVR device this context is bound to, and bestie, that binding is immutable for the life of the context. it's not changing, okay? that's its main character commitment. 👑
• mmu_ctx — the context for binding to physical memory. literally the link between this VM and actual memory. 🔥
• gpuvm_mgr — the GPUVM object associated with this context. yes, it manages the GPUVM side of things, slay. ✨
• lock — a global lock on this VM. one lock to rule them all, no cap. 🔒💅
• fw_mem_ctx_obj — the firmware object that represents the firmware memory context. it's giving "firmware memory representation" and we're obsessed. 🧚
• ref_count — the reference count of the object. classic refcounting moment, fr fr. 🫶
• dummy_gem — a GEM object that exists to enable VM reservation. important caveat bestie: all private BOs should use dummy_gem.resv and not their own _resv field. like, do not do that. use the dummy one. periodt. 💀

lowkey this dummy_gem detail is the one that matters most, so don't skip it. it's literally the rule. 🚨

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/imagination/pvr_vm.c
• Memory context(9)
• pvr_vm_get_page_table_root_addr(9)
• pvr_vm_get_dma_resv(9)
• Memory mappings(9)
• struct pvr_vm_gpuva(9)
• struct pvr_vm_bind_op(9)
• pvr_vm_bind_op_exec(9)
• pvr_vm_gpuva_map(9)
• pvr_vm_gpuva_unmap(9)
• pvr_vm_gpuva_remap(9)
• pvr_device_addr_is_valid(9)
• pvr_device_addr_and_size_are_valid(9)
• pvr_vm_create_context(9)
• pvr_vm_context_release(9)
• pvr_vm_context_lookup(9)
• pvr_vm_context_put(9)
• pvr_destroy_vm_contexts_for_file(9)
• pvr_vm_map(9)
• pvr_vm_unmap_obj_locked(9)
• pvr_vm_unmap_obj(9)
• pvr_vm_unmap(9)
• pvr_vm_unmap_all(9)
• pvr_heap_contains_range(9)
• pvr_find_heap_containing(9)
• pvr_vm_find_gem_object(9)
• pvr_vm_get_fw_mem_context(9)

like, that's a whole friend group of references, and you should def go say hi to them. 💖

okay that's the whole page, bestie! this lovely little manpage came from ./drivers/gpu/drm/imagination and it's dated October 2026 — iconic. stay slay, keep your refcounts balanced, and remember: use dummy_gem.resv, not your own _resv. mwah! 💅✨🎀