drm_gem_vram...r_prepare_fb(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_gem_vram_plane_helper_prepare_fb(9) 💅

okay bestie, welcome to the Kernel API Manual — yes, the actual kernel, yes we're doing this, and yes you're gonna get it 🫶

✨ NAME ✨

drm_gem_vram_plane_helper_prepare_fb — the function that implements &struct drm_plane_helper_funcs.prepare_fb 🎀

Like, that's literally its whole job description. It's the one holding down that struct slot.

🌸 SYNOPSIS 🌸

int drm_gem_vram_plane_helper_prepare_fb (struct drm_plane *plane ,
       struct drm_plane_state *new_state );

bestie it takes two args and gives you back an int. that's the whole vibe ✨

🌈 ARGUMENTS 🌈

  • plane — a DRM plane 💖 yep, that's the whole description, it's a DRM plane, we love a low-effort queen
  • new_state — the plane's new state 🦋 like the glow-up version of the plane, the one it's about to become

💀 DESCRIPTION 💀

so during plane updates, this function has two jobs and it does them both in one breath:

  1. it sets the plane's fence ⛓️
  2. it pins the GEM VRAM objects of the plane's new framebuffer to VRAM 📌

no cap, that's it. that's the function. and listen — when you're done with those pinned objects, you gotta call drm_gem_vram_plane_helper_cleanup_fb to unpin them. like, that's not optional, that's the other half of the deal, don't leave your pins hanging 🙈

🔥 RETURN 🔥

0 on success 🎉 or a negative errno code otherwise 😭 (if you see a negative number, something went sideways, that's the vibe check failing)

👑 SEE ALSO 👑

the whole friend group, fr fr 🫶:

ngl bestie, this page is short but it ate. go pin your VRAM and remember to clean up 💅

mwah, that's a wrap 🎀 this lil page lives in ./drivers/gpu/drm, and it's dated October 2026 — so it's from the future, main character energy honestly. it's drm_gem_vram...r_prepare_fb(9), and yes the title got cute-truncated, that's just how the header rolls 💜

📦 where this page comes from