vmw_gb_surf...nce_internal(9)

okay so bestie, welcome to vmw_gb_surf...nce_internal(9) — that’s the page title — and it comes from the Kernel API Manual 💖 this one is all about the ioctl function for the user surface reference functionality, and it is short but very “kernel API main character” energy ✨

✨ NAME ✨

vmw_gb_surface_reference_internal — Ioctl function implementing the user surface reference functionality. that’s the whole name-and-purpose moment, no cap 🎀

📜 SYNOPSIS 📜

int vmw_gb_surface_reference_internal (struct drm_device *dev , struct drm_vmw_surface_arg *req , struct drm_vmw_gb_surface_ref_ext_rep *rep , struct drm_file *file_priv );

🎀 ARGUMENTS 🎀

four pointers, one function, and a whole lot of kernel API vibes 💅 here’s the guest list:

• dev — pointer to a struct drm_device. yes, that’s the dev pointer 🫶
• req — pointer to user-space request surface arg. that’s the request-side pointer, struct drm_vmw_surface_arg *req energy ✨
• rep — pointer to response to user-space. the response pointer, struct drm_vmw_gb_surface_ref_ext_rep *rep style 💌
• file_priv — pointer to a drm file private structure. private as in struct drm_file *file_priv, not private private 🙈

👀 SEE ALSO 👀

the page says to look at Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c, and then it gives you the whole friend group — every single ref, fr fr:

• struct vmw_user_surface(9)
• 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_subres_dirty_add(9)
• vmw_subres_dirty_full(9)
• vmw_dumb_create(9)

that’s the whole page, bestie — short, slay, and fully referenced 💅💖 The footer’s source/version is ./drivers/gpu/drm/vmwgfx, the date is October 2026, and the footer title is vmw_gb_surf...nce_internal(9). byeee 🦋✨