vmw_kms_sou_do_bo_dirty(9)

💅 vmw_kms_sou_do_bo_dirty(9) 💅

okay bestie, welcome to the Kernel API Manual — this one is about dirtying part of a buffer-object backed framebuffer, and yes, that is exactly as niche and iconic as it sounds. 🫶

---

🌸 NAME 🌸

vmw_kms_sou_do_bo_dirty — dirty part of a buffer-object backed framebuffer. periodt. 💖

---

✨ SYNOPSIS ✨

int vmw_kms_sou_do_bo_dirty (struct vmw_private *dev_priv , struct
vmw_framebuffer *framebuffer , struct drm_clip_rect *clips , struct
drm_vmw_rect *vclips , unsigned num_clips , int increment , bool
interruptible , struct vmw_fence_obj **out_fence , struct drm_crtc *crtc
);

---

🎀 ARGUMENTS 🎀

• dev_priv — pointer to the device private structure. your device’s private little world 💅
• framebuffer — pointer to the buffer-object backed framebuffer. yes, the framebuffer in question ✨
• clips — array of clip rects. the clip crew 🎀
• vclips — alternate array of clip rects. either clips or vclips must be NULL. no cap, that part is literally required 💀
• num_clips — number of clip rects in clips. count ’em 🍓
• increment — increment to use when looping over clips. the step size for the loop vibe 🌈
• interruptible — whether to perform waits interruptible if possible. be polite to waits, bestie 😭
• 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. so if it hands you NULL, that’s a whole “already done” moment 👑
• crtc — if crtc is passed, perform bo dirty on that crtc only. one crtc, no side quests 🦋

---

💖 DESCRIPTION 💖

returns 0 on success, negative error code on failure. -ERESTARTSYS if interrupted. that’s the whole return vibe check, bestie — success is 0, failure is a negative error code, and interruption is giving -ERESTARTSYS 🔥

---

🔥 SEE ALSO 🔥

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_bo(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_sou_readback_fifo_commit(9), vmw_sou_readback_clip(9), vmw_kms_sou_readback(9) — the whole related-API group chat is right there, iykyk 💜

---

bye bestie 💖 source/version: ./drivers/gpu/drm/vmwgfx · date: October 2026 · page: vmw_kms_sou_do_bo_dirty(9) ✨