vmw_sou_plan...date_surface(9)

📦 version 7.3.1, in nixpkgs unstable

💻 vmw_sou_plane_update_surface — a little kernel-y moment 💅

okay so bestie, buckle up, because this one lives in the vmw_sou_plan...date_surface(9) manual (yes that's the truncated header name fr, it's giving "my name got cut off in the terminal") 💖 It's part of the Linux Kernel API Manual and it is literally about updating the display unit for a surface backed framebuffer. slay.

✨ NAME ✨

vmw_sou_plane_update_surface — update the display unit for a surface-backed fb 🎀

like… it's the function that goes "hey display unit, new surface just dropped" and honestly? iconic.

🌸 SYNOPSIS 🌸

int vmw_sou_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 );

it returns an int, bestie. remember that. 🫶

🦋 ARGUMENTS 🦋

  • dev_priv — the device private. it's the private ✨device✨ data, the main character of the whole driver ngl.
  • plane — the plane state. yes, plane like the display plane, not like an airplane 😭
  • old_state — the old plane state. the before-pic, if you will. 🙈
  • vfb — the framebuffer which is blitted to the display unit. this is the actual visual content being pushed out 💫
  • out_fence — if it's non-NULL, this will return a ref-counted pointer to vmw_fence_obj. and listen, the returned fence pointer may be NULL, in which case the device has already synchronized. so like, don't panic if it's NULL, that's just the device saying "already handled it, we're good" 👑

⭐ RETURN ⭐

0 on success, or a negative error code on failure. that's it, that's the whole vibe check 🔥

💜 SEE ALSO 💜

kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_scrn.c, plus the whole friend group:

no cap, that's a whole squad 🫶

💀 real talk though: out_fence may hand you a NULL pointer and that is not an error, it just means the device already synchronized. don't @ me, it's in the docs.

and that's the whole page, bestie! this one's from ./drivers/gpu/drm/vmwgfx, dated October 2026, and the manual page itself is vmw_sou_plan...date_surface(9) 🎀 go forth and update those surfaces, ily, mwah 💖✨🌸

📦 where this page comes from