pvr_vm_find_gem_object(9)

📦 version 7.3.1, in nixpkgs unstable

💖 NAME 💖

okay so this is pvr_vm_find_gem_object(9), straight out of the Kernel API Manual, and it's literally about how to look up a buffer object from a given device-virtual address. bestie, it's giving "find the thing that lives at this virtual address" energy ✨

pvr_vm_find_gem_object — look up a buffer object from a given device-virtual address.

✨ SYNOPSIS ✨

struct pvr_gem_object * pvr_vm_find_gem_object (struct pvr_vm_context
       *vm_ctx , u64 device_addr , u64 *mapped_offset_out , u64
       *mapped_size_out );

🎀 ARGUMENTS 🎀

  • vm_ctx — [IN] the target VM context. like, the context you're doing the lookup in, bestie.
  • device_addr — [IN] virtual device address at the start of the required object. this is the address you're investigating 🔍
  • mapped_offset_out — [OUT] pointer to the location where the offset of the start of the mapped region within the buffer object gets written. it may be NULL if you don't need this info.
  • mapped_size_out — [OUT] pointer to the location where the size of the mapped region gets written. also may be NULL if you don't need this info.

🦋 DESCRIPTION 🦋

so if this succeeds, a reference is taken on the buffer object. that means you, the caller, have to drop that reference with pvr_gem_object_put — no ghosting your refs, okay? 💅

🌸 RETURN 🌸

  • The PowerVR buffer object mapped at device_addr if one exists, or
  • NULL otherwise.

💅 SEE ALSO 💅

This iconic page lives in ./drivers/gpu/drm/imagination in the Kernel API Manual, dated October 2026 🫶 go forth and drop those refs, bestie 💖

📦 where this page comes from