vmw_kms_helper_dirty(9)

💅 vmw_kms_helper_dirty ✨

Okay so bestie, welcome to the vmw_kms_helper_dirty(9) page — this is from the Kernel API Manual and it's literally the helper that builds commands and does the actions based on a set of cliprects and a set of display units. Obsessed. 🎀

🦋 SYNOPSIS 🦋

int vmw_kms_helper_dirty (struct vmw_private *dev_priv , struct
vmw_framebuffer *framebuffer , const struct drm_clip_rect *clips , const
struct drm_vmw_rect *vclips , s32 dest_x , s32 dest_y , int num_clips ,
int increment , struct vmw_kms_dirty *dirty );

No cap, that's the whole signature. Copy it exactly, iykyk. 💅

🌸 ARGUMENTS 🌸

So like, here's every single one, and no I'm not skipping any:

• dev_priv — Pointer to a device private structure. That's your whole vibe-check entry point. ✨
• framebuffer — Pointer to the framebuffer on which to perform the actions. The main character of this whole operation, honestly. 👑
• clips — A set of struct drm_clip_rect. Either this or vclips must be NULL. Cliprects are given in framebuffer coordinates. So don't be messy and pass both, okay? 😭
• vclips — A set of struct drm_vmw_rect cliprects. Either this or clips must be NULL. Cliprects are given in source coordinates. Same energy, different coordinate system. 🦋
• dest_x — X coordinate offset for the crtc / destination clip rects. Literally just the x-shift, bestie. 💖
• dest_y — Y coordinate offset for the crtc / destination clip rects. And that's the y-shift. Slay. 💖
• num_clips — Number of cliprects in the clips or vclips array. Count 'em. 🔢
• increment — Integer with which to increment the clip counter when looping. Used to skip a predetermined number of clip rects. So it's giving "skip ahead" energy, periodt. ⭐
• dirty — Closure structure. See the description of struct vmw_kms_dirty. That's where the real tea is. 🍓

⚠️ Quick vibe check reminder: either clips or vclips must be NULL — not both, not neither. Respect the rules, bestie. 🫶

👀 SEE ALSO 👀

The kernel file is right here: ./drivers/gpu/drm/vmwgfx/vmwgfx_kms.c — go read it if you're feeling curious. And here's the whole squad, every single one, no skipping:

• vmw_du_plane_unpin_surf(9)
• vmw_du_plane_cleanup_fb(9)
• vmw_du_primary_plane_atomic_check(9)
• vmw_du_crtc_duplicate_state(9)
• vmw_du_crtc_reset(9)
• vmw_du_crtc_destroy_state(9)
• vmw_du_plane_duplicate_state(9)
• vmw_du_plane_reset(9)
• vmw_du_plane_destroy_state(9)
• vmw_du_connector_duplicate_state(9)
• vmw_du_connector_reset(9)
• vmw_du_connector_destroy_state(9)
• vmw_kms_readback(9)
• vmw_kms_srf_ok(9)
• vmw_kms_new_framebuffer(9)
• vmw_kms_check_display_memory(9)
• vmw_crtc_state_and_lock(9)
• vmw_kms_check_implicit(9)
• vmw_kms_check_topology(9)
• vmw_kms_atomic_check_modeset(9)
• vmw_du_update_layout(9)
• vmw_guess_mode_timing(9)
• vmw_kms_update_layout_ioctl(9)
• vmw_kms_helper_validation_finish(9)
• vmw_kms_create_implicit_placement_property(9)
• vmw_kms_suspend(9)
• vmw_kms_resume(9)
• vmw_kms_lost_device(9)
• vmw_du_helper_plane_update(9)
• vmw_connector_mode_valid(9)
• vmw_connector_get_modes(9)

Like, that's the whole friend group. 💜

And that's the page, bestie! This little gem lives in ./drivers/gpu/drm/vmwgfx and the version stamp says October 2026 — so yeah, it's giving future vibes but we're here for it. 🌈 Go forth and build those commands, icon. 💅✨