drm_framebuffer_cleanup(9)

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

okay so you found the drm_framebuffer_cleanup(9) page in the Kernel API Manual and you're like "what does this even do" — don't worry, I got you. this is the whole thing, no cap 🫶

---

✨ NAME ✨

drm_framebuffer_cleanup — remove a framebuffer object 🎀

---

✨ SYNOPSIS ✨

void drm_framebuffer_cleanup (struct drm_framebuffer *fb );

that's it. one function, one arg, iconic signature energy 👑

---

✨ ARGUMENTS ✨

• fb — the framebuffer to remove. that's your girly. she's getting cleaned up 💅

---

✨ DESCRIPTION ✨

so basically: cleanup framebuffer. 🌸

this function is intended to be used from the driver's drm_framebuffer_funcs.destroy callback. it can also be used to clean up driver private framebuffers that are embedded into a larger structure — yes bestie, nested-struct cleanup is a thing and this handles it 🦋

⚠️ okay listen, important part: this function does not remove the fb from active usage. if it's still used anywhere, hilarity can ensue 😭 — literally, because userspace could call getfb on the id and get back -EINVAL. obviously no concern at driver unload time, though. like at that point who cares 💀

also — and this is the part people forget — the framebuffer will not be removed from the lookup idr. 🙈

• for user-created framebuffers, that happens in the rmfb ioctl
• for driver-private objects (e.g. for fbdev), drivers need to explicitly call drm_framebuffer_unregister_private

so like… do that. don't skip it. it's giving "I forgot the second step" energy and nobody wants that 💜

---

✨ SEE ALSO ✨

go read these too, iykyk 🌈

• Kernel file ./drivers/gpu/drm/drm_framebuffer.c overview(9)
• drm_mode_addfb(9)
• drm_mode_addfb2(9)
• drm_mode_rmfb(9)
• drm_mode_getfb(9)
• drm_mode_getfb2_ioctl(9)
• drm_mode_dirtyfb_ioctl(9)
• drm_fb_release(9)
• drm_framebuffer_init(9)
• drm_framebuffer_lookup(9)
• drm_framebuffer_unregister_private(9)
• drm_framebuffer_remove(9)

---

anyway bestie that's the whole page — this one came out of ./drivers/gpu/drm in the Kernel API Manual, dated October 2026 ⭐ go clean up those framebuffers responsibly, and remember: drm_framebuffer_cleanup does not unregister your private fb for you, no matter how much you want it to 😭💖