drm_atomic_set_fb_for_plane(9)

✨ drm_atomic_set_fb_for_plane(9) ✨

okay so bestie, we're in the Kernel API Manual today and this one is a little function from the DRM atomic world 💖 it's called drm_atomic_set_fb_for_plane and honestly? it's giving "quietly does the important bookkeeping so you don't have to" energy. iconic behavior fr fr.

---

🌸 NAME 🌸

drm_atomic_set_fb_for_plane — set framebuffer for plane 💅

---

🎀 SYNOPSIS 🎀

void drm_atomic_set_fb_for_plane (struct drm_plane_state *plane_state ,
       struct drm_framebuffer *fb );

literally that's the whole signature, no notes 👑

---

🦋 ARGUMENTS 🦋

• plane_state — the atomic state object for the plane ✨ this is the state you're editing, the main character of the operation ngl
• fb — the fb you wanna use for the plane 🌸

---

💜 DESCRIPTION 💜

okay so here's the tea ☕: changing the assigned framebuffer for a plane isn't just "point at the new one and go" — it requires us to grab a reference to the new fb and drop the reference to the old fb, if there is one. like, you gotta be polite to both of them, y'know? 🫶

This function takes care of all these details besides updating the pointer in the state object itself. so basically it handles the refcount drama and you handle the pointer assignment — teamwork, lowkey 💖

bestie pls note: the function does not update the pointer in the state object. that part is on you. no cap.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_atomic_uapi.c
• overview(9)
• drm_atomic_set_mode_for_crtc(9)
• drm_atomic_set_mode_prop_for_crtc(9)
• drm_atomic_set_crtc_for_plane(9)
• drm_atomic_set_colorop_for_plane(9)
• drm_atomic_set_crtc_for_connector(9)
• explicit fencing properties(9)

like, go read the whole friend group, they're all slay 🔥

---

and that's the page!! 💅 this little icon lives in ./drivers/gpu/drm, the Kernel API Manual, dated October 2026, and the whole thing is filed under drm_atomic_set_fb_for_plane(9) — mwah, bye bestie, go set some framebuffers responsibly 🎀✨💖