FLAGS FOR DRM_IOCTL_PVR_CREATE_BO (KERNEL-ONLY)(9)

✨ Flags for DRM_IOCTL_PVR_CREATE_BO (kernel-only) ✨

okay bestie, the Kernel API Manual has entered the chat, and this page is all about the kernel-only values allowed in pvr_gem_object->flags. The majority of options for this field are specified in the UAPI header pvr_drm.h with a DRM_PVR_BO_ prefix. To distinguish these internal options (which must exist in ranges marked as "reserved" in the UAPI header), we drop the DRM prefix. The public options should be used directly, DRM prefix and all. 💅

To avoid potentially confusing gaps in the UAPI options, these kernel-only options are specified "in reverse", starting at bit 63. We use "reserved" to refer to bits defined here and not exposed in the UAPI. Bits not defined anywhere are "undefined". Not me explaining bit ranges like a group project, but here we are. 🎀

🦋 CPU mapping options 🦋

• PVR_BO_CPU_CACHED — bestie, by default all GEM objects are mapped write-combined on the CPU. Set this flag to override that behaviour and map the object cached. If the dma_coherent property is present in devicetree, all allocations will be mapped as if this flag was set. This does not require any additional consideration at allocation time. 💖

🔥 Firmware options 🔥

• PVR_BO_FW_NO_CLEAR_ON_RESET — by default all FW objects are cleared and reinitialised on hard reset. Set this flag to override this behaviour and preserve buffer contents on reset. ✨

👀 SEE ALSO 👀

• Kernel file ./drivers/gpu/drm/imagination/pvr_gem.h, plus struct pvr_gem_object(9), pvr_gem_object_get(9), and pvr_gem_object_put(9). 🫶

source/version: ./drivers/gpu/drm/imagination · date: October 2026 — byeee, ily 💋🌈