vmw_subres_dirty_add(9)

💅 vmw_subres_dirty_add — the kernel API manual, bestie edition ✨

Okay so bestie, we're deep in the Kernel API Manual today and the function on the docket is vmw_subres_dirty_add(9). Yes it's a mouthful, no you're not gonna fumble it — we're gonna get through this together 🫶

---

✨ NAME ✨

vmw_subres_dirty_add — literally just adds a dirty region to a subresource, that's the whole gig 💖

---

🦋 SYNOPSIS 🦋

void vmw_subres_dirty_add (struct vmw_surface_dirty *dirty , const
struct vmw_surface_loc *loc_start , const struct vmw_surface_loc
*loc_end );

---

🎀 ARGUMENTS 🎀

• dirty — the surface's dirty tracker. This is the main character, the one actually keeping receipts 🗒️
• loc_start — the location that corresponds to the start of the region. Where the region begins, iykyk.
• loc_end — the location that corresponds to the end of the region. Where it wraps up ✨

---

🌸 DESCRIPTION 🌸

So the whole vibe here is that we're assuming loc_start and loc_end represent a sequential range of backing store memory. Like, in order, one after the other, no chaos 💅

And because of that assumption, two things follow:

• If the region spans multiple lines, then it doesn't matter what the x coordinate is — the full lines get dirtied. Partial lines? Not today, bestie.
• Correspondingly, if the region spans multiple z slices, then you get full z slices dirtied rather than partial ones. Whole slices only, periodt 🔥

---

👑 SEE ALSO 👑

The kernel file is ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c and here's the whole extended friend group you should also go say hi to 💜

• struct vmw_user_surface(9)
• struct vmw_surface_offset(9)
• struct vmw_surface_dirty(9)
• vmw_surface_dma_size(9)
• vmw_surface_define_size(9)
• vmw_surface_destroy_size(9)
• vmw_surface_destroy_encode(9)
• vmw_surface_define_encode(9)
• vmw_surface_dma_encode(9)
• vmw_hw_surface_destroy(9)
• vmw_legacy_srf_create(9)
• vmw_legacy_srf_dma(9)
• vmw_legacy_srf_bind(9)
• vmw_legacy_srf_unbind(9)
• vmw_legacy_srf_destroy(9)
• vmw_surface_init(9)
• vmw_user_surface_base_to_res(9)
• vmw_user_surface_free(9)
• vmw_user_surface_base_release(9)
• vmw_surface_destroy_ioctl(9)
• vmw_surface_define_ioctl(9)
• vmw_surface_reference_ioctl(9)
• vmw_gb_surface_create(9)
• vmw_gb_surface_define_ioctl(9)
• vmw_gb_surface_reference_ioctl(9)
• vmw_gb_surface_define_ext_ioctl(9)
• vmw_gb_surface_reference_ext_ioctl(9)
• vmw_gb_surface_define_internal(9)
• vmw_gb_surface_reference_internal(9)
• vmw_subres_dirty_full(9)
• vmw_dumb_create(9)

---

ngl bestie, if you ever find yourself dirtying a partial line or a partial z slice in here, that's not the vibe this function is giving. Full lines, full slices, that's the assignment 💀

---

And that's the page!! 🎀 This one lives under ./drivers/gpu/drm/vmwgfx, dated October 2026, and it's filed as vmw_subres_dirty_add(9) — go forth and dirty those regions correctly, icon 👑💖