vmw_kms_sou_...urface_dirty(9)

💖 vmw_kms_sou_do_surface_dirty 💖

okay so this is from the Kernel API Manual, and the page header is literally vmw_kms_sou_...urface_dirty(9) (yes, with the lil ellipsis moment 😭), but the function we are actually hyping is vmw_kms_sou_do_surface_dirty 💅✨

---

✨ NAME ✨

vmw_kms_sou_do_surface_dirty — dirty part of a surface backed framebuffer 🎀

---

🌸 SYNOPSIS 🌸

the whole signature, no cuts, bestie:

int vmw_kms_sou_do_surface_dirty (struct vmw_private *dev_priv , struct
       vmw_framebuffer *framebuffer , struct drm_clip_rect *clips , struct
       drm_vmw_rect *vclips , struct vmw_resource *srf , s32 dest_x , s32
       dest_y , unsigned num_clips , int inc , struct vmw_fence_obj **out_fence
       , struct drm_crtc *crtc );

---

🎀 ARGUMENTS 🎀

• dev_priv — pointer to the device private structure. iconic little context holder 💖
• framebuffer — pointer to the surface-buffer backed framebuffer. yes bestie, that one 🦋
• clips — array of clip rects. 🚨 real talk from the page: either clips or vclips must be NULL.
• vclips — alternate array of clip rects. same vibe check: either clips or vclips must be NULL 💀
• srf — pointer to surface to blit from. if it’s NULL, the surface attached to framebuffer will be used ✨
• dest_x — X coordinate offset to align srf with framebuffer coordinates 🌈
• dest_y — Y coordinate offset to align srf with framebuffer coordinates 🌈
• num_clips — number of clip rects in clips 🍓
• inc — increment to use when looping over clips 🔥
• out_fence — if non-NULL, will return a ref-counted pointer to a struct vmw_fence_obj. the returned fence pointer may be NULL, in which case the device has already synchronized 👑
• crtc — if crtc is passed, perform surface dirty on that crtc only 💅

---

🦋 DESCRIPTION 🦋

Returns 0 on success, negative error code on failure. and specifically -ERESTARTSYS if interrupted 😭 periodt.

---

💜 SEE ALSO 💜

the kernel file is ./drivers/gpu/drm/vmwgfx/vmwgfx_scrn.c, and the whole crew is here:

• 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_bo(9)
• vmw_sou_plane_update_surface(9)
• vmw_sou_surface_fifo_commit(9)
• vmw_sou_surface_clip(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)

---

okay bye bestie 🫶 this cutie comes from ./drivers/gpu/drm/vmwgfx, dated October 2026, and the footer still calls it vmw_kms_sou_...urface_dirty(9) — periodt 💅✨