vmw_bo_dirty_add(9)

💅 vmw_bo_dirty_add — like, the kernel API manual page, bestie ✨

okay so this is a page from the Kernel API Manual, and honestly? it's a tiny little function but it's doing main character work. let's get into it 🫶

---

🌸 NAME 🌸

vmw_bo_dirty_add — literally just adds a dirty-tracking user to a buffer object. that's it. that's the whole vibe check.

---

⭐ SYNOPSIS ⭐

int vmw_bo_dirty_add (struct vmw_bo *vbo );

one function, one argument, no cap. copy it exactly, bestie, don't get creative with the spacing 💀

---

🎀 ARGUMENTS 🎀

• vbo — the buffer object. yeah. that's the whole description. it's giving "minimalist icon" and honestly? we respect it. 👑

---

🦋 DESCRIPTION 🦋

so what does this thing do? it registers a dirty-tracking user to a buffer object. and before you're like "girl what does that mean," lemme explain the way the manpage explains it: a user can be, for example, a resource ✨ or a vma in a special user-space mapping 🌈.

that's it! that's the whole description! short, sweet, to the point. it's giving "I have nothing to hide" energy and I'm obsessed 💖

---

🔥 RETURN 🔥

• Zero on success — slay 🎉
• -ENOMEM on memory allocation failure — not slay, but at least it's honest 😭

heads up bestie: if you get back -ENOMEM, the allocation failed. that's the whole reason. no mystery, no drama, just the kernel telling you it ran out of memory fr fr.

---

🧚 SEE ALSO 🧚

okay this is the part where the page really pops off, because there is a whole little family of these dirty-tracking functions and they all live in the kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_page_dirty.c 📁 (yup, the DRM vmwgfx crew, they're iconic 👑).

here's the full squad, no gatekeeping:

• struct vmw_bo_dirty(9)
• vmw_bo_dirty_scan_pagetable(9)
• vmw_bo_dirty_scan_mkwrite(9)
• vmw_bo_dirty_scan(9)
• vmw_bo_dirty_pre_unmap(9)
• vmw_bo_dirty_unmap(9)
• vmw_bo_dirty_release(9)
• vmw_bo_dirty_transfer_to_res(9)
• vmw_bo_dirty_clear_res(9)

like, go read them, they're all doing their little part in the same file and honestly it's a whole ecosystem 💜

---

and that's the page!! short, iconic, zero filler. this whole thing comes courtesy of ./drivers/gpu/drm/vmwgfx, dated October 2026 — mark your calendars bestie, and go touch some buffer objects 💅✨🌸