STRUCT VMW_VALIDATION_CONTEXT(9)

🎀 struct vmw_validation_context(9) — Kernel API Manual 🎀

okay so bestie, welcome to the struct vmw_validation_context(9) page — yes, the Kernel API Manual, but make it group chat. The whole vibe is a per command submission validation context. It's literally the little validation HQ that rides along with one command submission. No cap. 🦋

🌸 NAME 🌸

struct vmw_validation_context — per command submission validation context. That's the name, that's the purpose, that's the whole personality. 💅

✨ SYNOPSIS ✨

       struct vmw_validation_context {
           struct vmw_sw_context *sw_context;
           struct list_head resource_list;
           struct list_head resource_ctx_list;
           struct list_head bo_list;
           struct list_head page_list;
           struct ww_acquire_ctx ticket;
           struct mutex *res_mutex;
           unsigned int merge_dups;
           unsigned int mem_size_left;
           u8 *page_address;
        };

🧚 Members 🧚

One field, sw_context, appears in the struct synopsis but this page doesn't give it its own Members blurb — so we are not inventing extra lore for it, bestie. The rest of the cast:

• resource_list — list head for resource validation metadata. It's the main list for resource validation metadata, the guest list.
• resource_ctx_list — list head for resource validation metadata for resources that need to be validated before those in resource_list. It's the before-list for validation order. ⭐
• bo_list — list head for buffer objects. Buffer objects get their own list head. We love a named list.
• page_list — list of pages used by the memory allocator. The allocator's page collection, literally.
• ticket — "Ticked used for ww mutex locking" in the original text, which means the ticket used for ww mutex locking. The typo is canon now. 🎟️
• res_mutex — pointer to mutex used for resource reserving. It's a pointer, not the mutex itself. Important distinction, bestie.
• merge_dups — whether to merge metadata for duplicate resources or buffer objects. Duplicate resource? Duplicate buffer object? This is the merge-metadata switch. 🔥
• mem_size_left — free memory left in the last page in page_list. Free space check: last-page edition. 💀
• page_address — kernel virtual address of the last page in page_list. It's the address of that last page, periodt. 🌈

🦋 SEE ALSO 🦋

The kernel file is ./drivers/gpu/drm/vmwgfx/vmwgfx_validation.h — go look, bestie.

• DECLARE_VAL_CONTEXT(9)
• vmw_validation_has_bos(9)
• vmw_validation_bo_reserve(9)
• vmw_validation_bo_fence(9)
• vmw_validation_align(9)

mwah 💋 stay validated. This page's source/version is ./drivers/gpu/drm/vmwgfx and the date is October 2026. The footer's truncated label is struct vmw_...tion_context(9) — the full name is still struct vmw_validation_context(9), obviously. 🫶