vmw_sou_plane_update_bo(9)

okay bestie, welcome to vmw_sou_plane_update_bo(9) from the Kernel API Manual — the moment we update the display unit for a bo backed fb. 💅✨

🌸 NAME 🌸

vmw_sou_plane_update_bo — update display unit for bo backed fb. That’s the whole assignment, and it’s giving kernel-display main character energy. 💖

✨ SYNOPSIS ✨

       int vmw_sou_plane_update_bo (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 );

she takes five arguments, no cap. 🎀

🎀 ARGUMENTS 🎀

• dev_priv — device private, aka the device-private pointer doing its private little device thing. 🫶
• plane — plane state. that’s the vibe. ✨
• old_state — old plane state, the before picture. 🙈
• vfb — framebuffer which is blitted to display unit — yes, vfb, and yes, blitted. 💅
• out_fence — if it’s non-NULL, it will return a ref-counted pointer to vmw_fence_obj. the returned fence pointer may be NULL, in which case the device has already synchronized — periodt. 🫶

🔥 RETURN 🔥

0 on success or a negative error code on failure. that’s it, that’s the return, no cap. 🎀

🦋 SEE ALSO 🦋

go read these, bestie — the whole friend group:

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_scrn.c struct vmw_kms_sou_surface_dirty(9)
• vmw_sou_crtc_mode_set_nofb(9)
• vmw_sou_crtc_helper_prepare(9)
• vmw_sou_crtc_atomic_disable(9)
• vmw_sou_primary_plane_cleanup_fb(9)
• vmw_sou_primary_plane_prepare_fb(9)
• vmw_sou_plane_update_surface(9)
• vmw_sou_surface_fifo_commit(9)
• vmw_sou_surface_clip(9)
• vmw_kms_sou_do_surface_dirty(9)
• vmw_sou_bo_fifo_commit(9)
• vmw_sou_bo_clip(9)
• vmw_kms_sou_do_bo_dirty(9)
• vmw_sou_readback_fifo_commit(9)
• vmw_sou_readback_clip(9)
• vmw_kms_sou_readback(9)

mwah 💋 — this page lives in ./drivers/gpu/drm/vmwgfx, dated October 2026, and it’s literally vmw_sou_plane_update_bo(9). go be iconic, bestie! 🫶