STRUCT VMW_SURFACE(9)

💅 struct vmw_surface(9) 💅

okay bestie, welcome to the struct vmw_surface(9) page from the Kernel API Manual — yes this is the vmwgfx one and yes it's lowkey iconic 🎀

---

✨ NAME ✨

struct vmw_surface — literally the resource structure for a surface. that's it, that's the whole vibe 💖

---

🌸 SYNOPSIS 🌸

struct vmw_surface {
    struct vmw_resource res;
    struct vmw_surface_metadata metadata;
    struct vmw_cursor_snooper snooper;
    struct vmw_surface_offset *offsets;
    struct list_head view_list;
 };

like, that's the whole struct. five fields. she's compact, she's clean, she ate 💅

---

👑 Members 👑

• res — the base resource for this surface. she's the foundation, the main character energy the rest of the struct is built on 🫶
• metadata — the metadata for this surface resource. all the little details about her ✨
• snooper — cursor data. legacy surface only 👀 so if you're on a fancy modern surface, she's not invited
• offsets — legacy surface only too, ngl. same deal, not for the new kids 💀
• view_list — the list of views bound to this surface. everyone who's looking at her, gathered in one list_head 🦋

---

🌈 SEE ALSO 🌈

okay this is the part where the manpage just goes off, so buckle up bestie, we're listing everything, no cap:

Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_drv.h, plus:

• struct vmw_resource(9)
• struct vmw_surface_metadata(9)
• struct vmw_res_cache_entry(9)
• enum vmw_dma_map_mode(9)
• struct vmw_sg_table(9)
• struct vmw_piter(9)
• struct vmw_sw_context(9)
• enum vmw_sm_type(9)
• has_sm4_context(9)
• has_sm4_1_context(9)
• has_sm5_context(9)
• has_gl43_context(9)
• vmw_resource_mob_attached(9)
• vmw_fifo_caps(9)
• vmw_is_cursor_bypass3_enabled(9)
• vmw_piter_next(9)
• vmw_piter_dma_addr(9)
• vmw_piter_page(9)
• struct vmw_diff_cpy(9)
• VMW_DEBUG_USER(9)
• VMW_DEBUG_KMS(9)
• vmw_fifo_mem_read(9)
• vmw_fifo_mem_write(9)

like, that's the whole friend group fr fr — go read them if you want the full lore 🍓

---

lowkey reminder: snooper and offsets are legacy surface only — don't come for them on a modern surface, they're not there 💀

---

and that's the page!! this one lives in ./drivers/gpu/drm/vmwgfx, dated October 2026, from the Kernel API Manual — mwah, stan her, periodt 🧚💜