STRUCT VMW_RES_CACHE_ENTRY(9)

💖 struct vmw_res_cache_entry(9) 💖

okay so bestie, welcome to the Kernel API Manual — today we're doing struct vmw_res_cache_entry(9), and it's literally the resource information cache entry. lowkey a tiny struct with main character energy. 🫶

🌸 NAME 🌸

struct vmw_res_cache_entry — resource information cache entry. yep, that's the whole vibe: it's a cache entry for resource info. 💅

✨ SYNOPSIS ✨

       struct vmw_res_cache_entry {
           uint32_t handle;
           struct vmw_resource *res;
           unsigned short valid_handle;
           unsigned short valid;
        };

🎀 Members 🎀

• handle — the user-space handle of a resource, bestie. that's the ID situation. 💖
• res — a non-ref-counted pointer to the resource. important: it's not ref-counted, so don't go assuming it's holding a reference for you. 🙈
• valid_handle — tells you whether the handle member is valid. like, is this handle actually valid or not? vibe check. ✨
• valid — tells you whether the entry is valid, which also implies that the execbuf code holds a reference to the resource, and it's placed on the validation list. so valid means a whole little chain of things, no cap. 💀

🦋 Description 🦋

This struct is used to avoid frequent repeated user-space handle lookups of the same resource. basically it's the "bestie we already looked this up" cache so you're not doing the same lookup over and over. iconic efficiency behavior. ⭐

🔥 SEE ALSO 🔥

Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_drv.h — and the whole friend group:

• struct vmw_resource(9)
• struct vmw_surface_metadata(9)
• struct vmw_surface(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)

kisses bestie 💋 this page's source is ./drivers/gpu/drm/vmwgfx, it's dated October 2026, and it's serving struct vmw_res_cache_entry(9) — mwah. 🎀