pvr_ioctl_vm_map(9)

💅 pvr_ioctl_vm_map(9) — like, the Kernel API Manual page, bestie

Hey so this is pvr_ioctl_vm_map, straight out of the Kernel API Manual, and it's lowkey the IOCTL that maps a buffer into GPU address space. Main character energy for real. Let's get into it 🫶

---

✨ NAME ✨

pvr_ioctl_vm_map — the IOCTL that maps a buffer into the GPU address space. That's it, that's the vibe. 🦋

---

🌸 SYNOPSIS 🌸

int pvr_ioctl_vm_map (struct drm_device *drm_dev , void *raw_args ,
struct drm_file *file );

Look at her. Gorgeous signature. Copy it exactly, no cap. 💖

---

🎀 ARGUMENTS 🎀

• drm_dev [IN] — the DRM device. The whole device. The moment. 👑
• raw_args [IN] — the arguments that got passed into this IOCTL. Heads up: this must be of type struct drm_pvr_ioctl_vm_map_args. Not optional, not negotiable, literally must. 🙈
• file [IN] — the DRM file's private data. Private! Data! 🍓

---

⭐ DESCRIPTION ⭐

Okay so the way this works: userspace calls it with DRM_IOCTL_PVR_VM_MAP. That's the whole description and honestly? Iconic brevity. 💅

---

🔥 RETURN 🔥

Here's the vibe check on what you get back:

• 0 on success — slay ✨
• -EINVAL if drm_pvr_ioctl_vm_op_map_args.flags is not zero. Zero means zero, bestie, don't get cute with it. 💀
• -EINVAL if the bounds specified by drm_pvr_ioctl_vm_op_map_args.offset and drm_pvr_ioctl_vm_op_map_args.size are not valid, or if they don't fall within the buffer object specified by drm_pvr_ioctl_vm_op_map_args.handle. Ngl this one catches a lot of people 😭
• -EINVAL if the bounds specified by drm_pvr_ioctl_vm_op_map_args.device_addr and drm_pvr_ioctl_vm_op_map_args.size don't form a valid device-virtual address range that falls entirely within a single heap. Entirely. Within a single heap. Read it twice, I'll wait 🌸
• -ENOENT if drm_pvr_ioctl_vm_op_map_args.handle does not refer to a valid PowerVR buffer object. i.e. the handle is giving nothing. Not found. Ghosted. 👻

Like, respectfully — every single one of those -EINVALs is a different way to fumble the same call. Check your flags, check your bounds, check your handle. In that order. You're welcome 🫶

---

🌈 SEE ALSO 🌈

Go read these next, they're all in the friend group:

• Kernel file ./drivers/gpu/drm/imagination/pvr_drv.c
• PowerVR (Series 6 and later) and IMG Graphics Driver(9)
• pvr_ioctl_create_bo(9)
• pvr_ioctl_get_bo_mmap_offset(9)
• pvr_dev_query_gpu_info_get(9)
• pvr_dev_query_runtime_info_get(9)
• pvr_dev_query_quirks_get(9)
• pvr_dev_query_enhancements_get(9)
• pvr_ioctl_dev_query(9)
• pvr_ioctl_create_context(9)
• pvr_ioctl_destroy_context(9)
• pvr_ioctl_create_free_list(9)
• pvr_ioctl_destroy_free_list(9)
• pvr_ioctl_create_hwrt_dataset(9)
• pvr_ioctl_destroy_hwrt_dataset(9)
• pvr_ioctl_create_vm_context(9)
• pvr_ioctl_destroy_vm_context(9)
• pvr_ioctl_vm_unmap(9)
• pvr_drm_driver_open(9)
• pvr_drm_driver_postclose(9)

---

And that's the page!! 💜 This lil masterpiece lives in ./drivers/gpu/drm/imagination and it's dated October 2026, so mark your calendars bestie. kthxbye, go map some buffers responsibly 🧚‍♀️✨