pvr_heap_contains_range(9)

💖 pvr_heap_contains_range — a Kernel API Manual moment 💖

okay so bestie, we're in the Kernel API Manual today and the vibe is very "does this heap hold this address range or not". stay with me, it's gonna slay 🦋

---

✨ NAME ✨

pvr_heap_contains_range — literally just answers the question: does a given heap contain the device-virtual address range you're pointing at? that's it, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

bool pvr_heap_contains_range (const struct drm_pvr_heap *pvr_heap , u64
start , u64 end );

it returns a bool, so like… yes or no, no in-between, no "it's complicated" 🎀

---

🫶 ARGUMENTS 🫶

• pvr_heap — the target heap. the one we're checking against. main character of this function ngl 👑
• start — inclusive start of the target range. inclusive, bestie, don't forget that ✨
• end — inclusive end of the target range. also inclusive. both ends are invited to the party 🎉

---

💀 DESCRIPTION 💀

here's the thing — it is an error to call this function with values of start and end that do not satisfy the condition start <= end. like, fr fr, that's a hard no. so make sure start is less than or equal to end before you even think about calling this, or the vibe check will fail catastrophically 😭

no cap: start <= end is the law. break it and it's an error, periodt.

---

🧚 SEE ALSO 🧚

the whole friend group, in the kernel file ./drivers/gpu/drm/imagination/pvr_vm.c:

• Memory context(9)
• struct pvr_vm_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_find_heap_containing(9)
• pvr_vm_find_gem_object(9)
• pvr_vm_get_fw_mem_context(9)

---

and that's the whole page, bestie 🍓 this icon came from ./drivers/gpu/drm/imagination and it's dated October 2026 — so like, future vibes only 💜 mwah, go check your ranges, ily bye!! 💅✨