vmw_legacy_srf_unbind(9)

💅 vmw_legacy_srf_unbind(9) — like, the kernel API manual bestie 🎀

okay so real talk, this is a page from the Kernel API Manual and it's about vmw_legacy_srf_unbind. yes the name is a mouthful, yes it slaps anyway. sit down, grab a strawberry drink 🍓, we're doing this.

---

✨ NAME ✨

vmw_legacy_srf_unbind — the function that does a legacy surface unbind as part of the whole surface eviction situation. 🦋

---

🌸 SYNOPSIS 🌸

int vmw_legacy_srf_unbind (struct vmw_resource *res , bool readback ,
       struct ttm_validate_buffer *val_buf );

no cap, that's the whole signature, copy it exactly bestie 💅

---

🎀 ARGUMENTS 🎀

• res — a pointer to a struct vmw_res that's embedded in a struct vmw_surface. it's giving "nested struct realness" fr fr.
• readback — the readback flag! it is only true if the thing is dirty. like, only-true-if-dirty, that's the whole vibe check on this one 👑
• val_buf — a pointer to a struct ttm_validate_buffer that's carrying the info about the backup buffer. it's basically the backup buffer's little info card 💌

---

💖 DESCRIPTION 💖

this function will copy backup data from the surface. that's it, that's the moment, that's the main character energy 🔥

---

🌈 SEE ALSO 🌈

buckle up bestie, this list is LONG and honestly iconic for it. all of these are in the kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_surface.c:

• 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_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)

thirty entries. thirty!! not me counting them. okay I counted them. ate and left no crumbs 🫶

---

and that's the page, bestie!! written from the ./drivers/gpu/drm/vmwgfx source situation, dated October 2026 — mwah, love you, go read your kernel source responsibly 💜✨🧚