STRUCT VMW_SURFACE_DIRTY(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 struct vmw_surface_dirty(9) 🎀

okay so this is a page straight out of the Kernel API Manual — it's all about struct vmw_surface_dirty, aka the surface dirty-tracker. yes bestie, it tracks dirt. (the graphics kind. chill.) 💅

✨ NAME ✨

struct vmw_surface_dirty — surface dirty-tracker, no cap 🧚

🌸 SYNOPSIS 🌸

struct vmw_surface_dirty {
    struct vmw_surface_cache cache;
    u32 num_subres;
    SVGA3dBox boxes[];
};

like, that's the whole shape of it. three members. she's simple. she's iconic. 🫶

🦋 Members 🦋

okay let's do a vibe check on each one:

  • cache — the cached layout information of the surface. it's giving "I already know where everything is, don't @ me." ✨
  • num_subres — the number of subresources. a plain u32 counting them all up, lowkey important.
  • boxes — an array of SVGA3dBoxes indicating dirty regions. and here's the key detail: one per subresource. so if num_subres says there's N of them, there's N boxes. that's the whole point, iykyk 💖
it's a flexible array member situation with boxes[] — the array lives at the end of the struct, so the dirty regions ride along with the header. literally main character energy.

🔥 SEE ALSO 🔥

the kernel file this all lives in is ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c, and honestly the friend group is huge. here's everyone:

like I said. big friend group. go say hi. 🌈

anyway bestie that's the whole page — sourced from ./drivers/gpu/drm/vmwgfx, dated October 2026, and ngl it ate. go touch some subresources. mwah 💜

📦 where this page comes from