vmw_stdu_pl...date_surface(9)

📦 version 7.3.1, in nixpkgs unstable

💅 vmw_stdu_plane_update_surface(9) — like, the Kernel API Manual, but make it cute

Okay bestie, buckle up 🎀 this is a page straight out of the Kernel API Manual, and it's all about vmw_stdu_plane_update_surface — the little function that updates your display unit for a surface-backed framebuffer. Yes, that's a lot of words. No, we're not skipping any of them. Let's go ✨

🌸 NAME 🌸

vmw_stdu_plane_update_surface — update the display unit for a surface-backed framebuffer, periodt 💅

✨ SYNOPSIS ✨

int vmw_stdu_plane_update_surface (struct vmw_private *dev_priv , struct
drm_plane *plane , struct drm_plane_state *old_state , struct
vmw_framebuffer *vfb , struct vmw_fence_obj **out_fence );

That's the whole vibe check right there — one function, five arguments, zero chill 🫶

🦋 ARGUMENTS 🦋

Breaking it down one bestie at a time:

  • dev_priv — the device private. Your main character device data, lowkey the source of truth 💖
  • plane — the plane state. Not a literal airplane, we're talking DRM planes here ✈️
  • old_state — the old plane state. Yes, we keep the receipts of what it used to be 🙈
  • vfb — the framebuffer which is blitted to the display unit. She's getting copied over, iconic behavior 🎀
  • out_fence — if this is non-NULL, it will return a ref-counted pointer to vmw_fence_obj. And ngl, heads up: the returned fence pointer may be NULL, in which case the device has already synchronized. Not a bug, just the plot twist 💀

🌈 RETURN 🌈

0 on success, or a negative error code on failure. That's it, that's the whole mood — slay if it's zero, cry if it's negative 😭

🔥 SEE ALSO 🔥

The whole friend group, in order, no one left out 💜 — kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c, plus:

Like, that's the entire group chat, and they all ate 💅✨

fr fr, if you're digging into the vmwgfx display unit code, this list is your bestie for the restie — read them all before you touch anything 🧚

Okay bye, ily, go read the source 🫶 This cutie of a page lives over in ./drivers/gpu/drm/vmwgfx, dated October 2026, and it's signing off — mwah 💖🌸🎀

📦 where this page comes from