vmw_cotable_scrub(9)

💖 vmw_cotable_scrub — a Kernel API Manual moment ✨

okay so bestie, welcome to the section 9 glow-up of vmw_cotable_scrub, brought to you by the Kernel API Manual 💅 this one's lowkey niche (it's giving "you either know vmwgfx or you don't, iykyk") but she's iconic and we're gonna get into it 🎀

---

✨ NAME ✨

vmw_cotable_scrub — scrub the cotable from the device 🧚 no cap, that's literally the whole job.

---

🦋 SYNOPSIS 🦋

int vmw_cotable_scrub (struct vmw_resource *res , bool readback );

---

🌸 ARGUMENTS 🌸

• res — pointer to the cotable resource, bestie. that's the main character here 👑
• readback — a bool that decides whether to initiate a readback of the cotable data into the backup buffer. like, do we want a lil copy for later or not 🙈

---

⭐ DESCRIPTION ⭐

so in some situations — context swapouts, specifically — it might be desirable to make the device forget about the cotable without doing a full unbind. and the reason is honestly so valid: a full unbind requires reserved backup buffers, and it might not be possible to reserve them because of locking order violation issues 😭 messy.

so vmw_cotable_scrub implements a partial unbind that doesn't need that requirement — but it comes with the following restrictions, and no, you can't skip them, periodt:

1. Before the cotable is again used by the GPU, vmw_cotable_unscrub must be called. like, non-negotiable ✋
2. Before the cotable backing buffer is used by the CPU, or during the resource destruction, vmw_cotable_unbind must be called. also non-negotiable 💀

bestie these aren't suggestions, they're the whole vibe check. skip them and that's on you 🫶

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_cotable.c
• struct vmw_cotable(9)
• struct vmw_cotable_info(9)
• vmw_cotable(9)
• vmw_cotable_destroy(9)
• vmw_cotable_unscrub(9)
• vmw_cotable_bind(9)
• vmw_cotable_unbind(9)
• vmw_cotable_readback(9)
• vmw_cotable_resize(9)
• vmw_cotable_create(9)
• vmw_hw_cotable_destroy(9)
• vmw_cotable_free(9)
• vmw_cotable_alloc(9)
• vmw_cotable_notify(9)
• vmw_cotable_add_resource(9)

---

and that's the page, bestie 💖 this lil icon lives in ./drivers/gpu/drm/vmwgfx, dated October 2026, and she ate. mwah 💅✨🎀