STRUCT VMW_USER_SURFACE(9)

💅 struct vmw_user_surface(9) — the kernel API manual, bestie edition

okay so this page is all about struct vmw_user_surface, which is a user-space visible surface resource. that's the whole vibe. it's the thing userspace can actually see, no cap. 🦋

---

✨ SYNOPSIS ✨

here's the whole struct, exactly as it lives, don't touch a single semicolon:

struct vmw_user_surface {
    struct ttm_prime_object prime;
    struct vmw_surface srf;
    struct drm_master *master;
 };

like, that's it. three members, one icon. 👑

---

🎀 Members 🎀

bestie we gotta go through them one by one, they all matter:

• prime — the TTM prime object. that's it, that's the member. 💖
• srf — the surface metadata. all the data about the surface lives here.
• master — the master of the creating client. it gets used for a security check, so like… it's the bouncer at the club. do not mess with it. 🙈

---

⭐ SEE ALSO ⭐

the kernel file lives at ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c — that's the main character file, go read it.

and here's the whole friend group, fr fr, every single one of these pages:

• 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_add(9)
• vmw_subres_dirty_full(9)
• vmw_dumb_create(9)

like, that's a lot of siblings. every single one gets a shoutout. 🌈

---

ok that's the whole page!! nothing else hiding in here, you got every member, every reference, the works. go forth and understand your surface resource bestie 🫶

mwah 💋 — this came out of ./drivers/gpu/drm/vmwgfx in October 2026, and it's literally titled struct vmw_user_surface(9). slay. 🎀✨