vmw_cotable_create(9)

💅 vmw_cotable_create — Cotable resource create callback

Okay so real quick before we get into it: this page lives in the Kernel API Manual, bestie. That's the official manual name, we don't make the rules, we just make it cute. 🎀

---

✨ NAME ✨

vmw_cotable_create — the cotable resource create callback.

That's it. That's the name. Short, sweet, iconic. 🦋

✨ SYNOPSIS ✨

int vmw_cotable_create (struct vmw_resource *res );

Yep, exactly like that. Spaces and all. Copy it verbatim, don't be weird about it. 💅

✨ ARGUMENTS ✨

• res — a pointer to a cotable resource. One single pointer. That's the whole cast. Main character energy, no ensemble. 👑

✨ DESCRIPTION ✨

Okay so here's the thing that lowkey trips people up: cotables do not have their own separate create command. Like, it just doesn't exist. So instead we have this callback, and it gets called before bind in the validation sequence, and it's out here doing two whole jobs. Double duty, fr fr. 💪

1. Unscrub — if the cotable is scrubbed and it's still attached to a backup buffer, we unscrub it. Scrub still clinging to a backup buffer? Not on this callback's watch. 🙈✨
2. Resize — if the cotable needs resizing, we resize it. Needed resize? Resized. Simple as that. 🎀

Two things, one callback, no separate create command. Periodt.

✨ SEE ALSO ✨

Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_cotable.c — go read it, it's giving lore:

• 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_scrub(9)
• vmw_cotable_unbind(9)
• vmw_cotable_readback(9)
• vmw_cotable_resize(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 a wrap, bestie!! 🫶 Big shoutout to ./drivers/gpu/drm/vmwgfx for being the source/version, and to October 2026 for being the date on this little masterpiece. Go unscrub something 💜🌸