vmw_dx_cont...rub_cotables(9)

💖 vmw_dx_context_scrub_cotables 💖

okay so bestie, this one's a kernel API page from the Kernel API Manual — the function is literally called vmw_dx_context_scrub_cotables (yes the man page header truncates it to vmw_dx_cont...rub_cotables(9) bc terminal columns are haters, but we know her full name 💅).

---

✨ NAME ✨

vmw_dx_context_scrub_cotables — scrub all the bindings and cotables off a context 🧹✨

---

🌸 SYNOPSIS 🌸

void vmw_dx_context_scrub_cotables(struct vmw_resource *ctx, bool readback);

like, that's the whole plot. she returns nothing (void), she just does the thing 🔥

---

🎀 ARGUMENTS 🎀

• ctx — pointer to the context resource 🫶 (the main character of this whole operation, ngl)
• readback — whether to save the otable contents while scrubbing. yes/no energy, literally a bool 💀

---

🦋 DESCRIPTION 🦋

okay so here's the situation, and it's giving logistics:

COtables must be unbound before their context — that's the rule, no cap. But unbinding requires the backup buffer being reserved, whereas scrubbing does not. and like… that's the whole reason this function exists 😭

So vmw_dx_context_scrub_cotables scrubs all cotables of a context, potentially reading back the contents into their backup buffers (that's your readback flag doing its thing ✨).

⚠️ BUT — and this is the important part, bestie, don't skip it — scrubbing cotables also makes the device context invalid. so you gotta scrub all bindings first, so that doesn't have to be done later with an invalid context. order matters, periodt 💅

fr fr, do the bindings first. the vibes (and the hardware) will thank you 🙏

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_context.c — go read the source, it's right there 🍓
• vmw_context_binding_list(9) 🦋
• vmw_context_binding_state(9) 🦋
• vmw_context_bind_dx_query(9) 🦋
• vmw_context_get_dx_query_mob(9) 🦋

the whole friend group, honestly 💜

---

<div align="center">🌸 💖 🌸</div>

and that's the page!! mwah 💋 this one lives in ./drivers/gpu/drm/vmwgfx, the man page footer says October 2026 and it's from the Kernel API Manual — so yeah, dated october 2026, which is honestly iconic of her. stay scrubbing, bestie, and remember: bindings first, cotables second, invalid context never 💅✨🫶