pvr_gem_object_create(9)

💅 pvr_gem_object_create(9) — PowerVR buffer object creation, but make it make sense 💅

okay so welcome to the pvr_gem_object_create(9) page in the Kernel API Manual — yes bestie, we're creating a PowerVR-specific buffer object and we're gonna be normal about it (lie). This is the function that gets a new buffer object born into the world, and the vibes are immaculate.

✨ NAME ✨

pvr_gem_object_create — Creates a PowerVR-specific buffer object. That's it, that's the main character energy.

🫶 SYNOPSIS 🫶

struct pvr_gem_object * pvr_gem_object_create (struct pvr_device
       *pvr_dev , size_t size , u64 flags );

No cap, that's the whole call. Let's meet the arguments.

🎀 ARGUMENTS 🎀

• pvr_dev — Target PowerVR device. This is the device you're doing the whole operation for.
• size — Size of the object to allocate in bytes. Must be greater than zero. Any value which is not an exact multiple of the system page size will be rounded up to satisfy this condition. So yeah, page-size rounding is part of the deal, not a bug.
• flags — Options which affect both this operation and future mapping operations performed on the returned object. Must be a combination of DRM_PVR_BO_* and/or PVR_BO_* flags.

🦋 DESCRIPTION 🦋

The created object may be larger than size, but can never be smaller. To get the exact size, call pvr_gem_object_size on the returned pointer. That's the lowkey important part — don't assume size is the final size, bestie.

🌸 RETURN 🌸

• The newly-minted PowerVR-specific buffer object on success,
• -EINVAL if size is zero or flags is not valid,
• -ENOMEM if sufficient physical memory cannot be allocated, or
• Any other error returned by drm_gem_create_mmap_offset.

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/imagination/pvr_gem.c
• pvr_gem_object_flags_validate(9)
• pvr_gem_object_into_handle(9)
• pvr_gem_object_from_handle(9)
• pvr_gem_object_vmap(9)
• pvr_gem_object_vunmap(9)
• pvr_gem_object_zero(9)
• pvr_gem_create_object(9)
• pvr_gem_get_dma_addr(9)

okay bye bestie 💖 — source/version: ./drivers/gpu/drm/imagination · date: October 2026 · page: pvr_gem_object_create(9) ✨