pvr_fw_object_create(9)

📦 version 7.3.1, in nixpkgs unstable

💅 pvr_fw_object_create(9) — from the Kernel API Manual ✨

okay so bestie, buckle up 🎀 this one's a kernel API page from the PowerVR / Imagination driver corner of the tree, and honestly? it's giving "small function, big responsibilities." let's get into it 💖

🌸 NAME 🌸

pvr_fw_object_create — literally just: create a FW object and map it to firmware. that's the whole vibe. no cap.

✨ SYNOPSIS ✨

int pvr_fw_object_create (struct pvr_device *pvr_dev , size_t size , u64
flags , void (*init)(void *cpu_ptr, void *priv) , void *init_priv ,
struct pvr_fw_object **fw_obj_out );

like yes, it's a lot of arguments, but we're gonna go through every single one together 🫶

🦋 ARGUMENTS 🦋

  • pvr_dev — the PowerVR device pointer. your main character struct, iykyk 👑
  • size — size of the object, in bytes. measured in bytes, not vibes 💀
  • flags — the options that affect both this operation and any future mapping operations done on the returned object. must be a combination of DRM_PVR_BO_* and/or PVR_BO_* flags. so like, mix and match from those two families, but only those two families ✨
  • init — the initialisation callback. this is the lil function that runs to set your object up 🧚
  • init_priv — private pointer that gets passed straight through to that initialisation callback. no questions asked, it just hands it over 💜
  • fw_obj_out — pointer to the location where the created object pointer gets stored. this is where your new object shows up to the party 🎀

🌈 DESCRIPTION 🌈

so here's the tea, bestie ☕ — DRM_PVR_BO_DEVICE_PM_FW_PROTECT is implied for all FW objects. like, it's automatic, it comes with the outfit, you don't get to opt out 💅

and because of that consequence: this function will fail if flags has DRM_PVR_BO_CPU_ALLOW_USERSPACE_ACCESS set. not "might", not "could", it will fail. so don't do that 🙈

⭐ RETURN ⭐

  • 0 on success 🎉 or
  • any error returned by pvr_fw_object_create_common 😭 (yeah, the errors get passed up from there, we don't gatekeep them)

💖 SEE ALSO 💖

Kernel file ./drivers/gpu/drm/imagination/pvr_fw.c plus the whole friend group 💫

aaaand that's the page!! 🍓 this icon was living in ./drivers/gpu/drm/imagination, dated October 2026 — slay, go read the rest of the family, they all ate 🔥💜

📦 where this page comes from