pvr_ioctl_ge..._mmap_offset(9)

📦 version 7.3.1, in nixpkgs unstable

💅 pvr_ioctl_get_bo_mmap_offset — the Kernel API Manual tea 🫶

okay so bestie, welcome to the pvr_ioctl_ge..._mmap_offset(9) page (yes the title is long, she's dramatic, we love her). This is the Kernel API Manual and it's all about one very specific little ioctl. Strap in. ✨

✨ NAME ✨

pvr_ioctl_get_bo_mmap_offset — it's the IOCTL that generates a "fake" offset, and you use that offset when you call mmap() from userspace to map the given GEM buffer object. That's literally her whole job. Iconic behavior, no notes. 💅

🌸 SYNOPSIS 🌸

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

three params, one function, let's get into it 👇

🎀 ARGUMENTS 🎀

  • drm_dev [IN] — the DRM device. and honestly? she's unused. main character who doesn't show up to her own party 😭 still gotta pass her tho.
  • raw_args [IN/OUT] — the arguments passed to this IOCTL. this one must be of type struct drm_pvr_ioctl_get_bo_mmap_offset_args. no substitutions, bestie, it's giving very specific.
  • file [IN] — the DRM file private data. the private data, the lore, the backstory. 🦋

💖 DESCRIPTION 💖

so the way this works: userspace calls in with DRM_IOCTL_PVR_GET_BO_MMAP_OFFSET, and this function answers the door.

but listen — and this is the important part — this IOCTL does *not* perform an mmap. not even a little. it just makes the fake offset, it does not do the mapping. if you want the full details, the docs on struct drm_pvr_ioctl_get_bo_mmap_offset_args have you covered. iykyk 🧚

lowkey the name is a trap, "mmap_offset" ≠ "does the mmap". she's a provider of offsets, not a mapper. periodt.

🔥 RETURN 🔥

  • 0 — on success 🎉 slay.
  • -ENOENT — if the handle does not reference a valid GEM buffer object. the handle is giving nothing, it's not valid, we're upset. 💀
  • -EINVAL — if any padding fields in struct drm_pvr_ioctl_get_bo_mmap_offset_args are not zero. zero them. all of them. 🙈
  • any error returned by drm_gem_create_mmap_offset — yeah, whatever that returns, that's what you get. no cap.

🌈 SEE ALSO 🌈

the whole friend group, assembled 🫶:

okay that's the whole page, you ate that 💜 this lil gem dropped from ./drivers/gpu/drm/imagination, dated October 2026, and her full name is pvr_ioctl_ge..._mmap_offset(9) — go forth and map your buffers responsibly, bestie ⭐🌸👑

📦 where this page comes from