for_each_new_plane_in_state(9)

💅 for_each_new_plane_in_state(9) — like, the actual Kernel API Manual, bestie ✨

okay okay okay so you found the for_each_new_plane_in_state(9) page, welcome, this one's a macro and honestly it's a vibe 🌸

---

🎀 NAME 🎀

for_each_new_plane_in_state — loops over every plane in an atomic update, no cap 💫

---

✨ SYNOPSIS ✨

for_each_new_plane_in_state (__state , plane , new_plane_state , __i );

---

🦋 ARGUMENTS 🦋

• __state — a struct drm_atomic_commit pointer. yes it's a pointer. it's the commit. love that for us 💖
• plane — a struct drm_plane iteration cursor, aka your little iterator bestie 🫶
• new_plane_state — a struct drm_plane_state iteration cursor, but specifically for the new state 🔥
• __i — an int iteration cursor, and it's for macro-internal use only, so don't touch it, it's not your business 🙈

---

🌈 DESCRIPTION 🌈

So the way this works: it iterates over all the planes in an atomic update, and it tracks only the new state. that's it, that's the whole personality ✨

Which is genuinely useful — like, icon behaviour — in enable functions, where we need the new state that the hardware should be in once the atomic commit operation has completed 👑

---

💜 SEE ALSO 💜

Kernel file ./include/drm/drm_atomic.h — go read it, iykyk 📖

• struct drm_crtc_commit(9)
• struct drm_private_state_funcs(9)
• struct drm_private_obj(9)
• drm_for_each_privobj(9)
• struct drm_private_state(9)
• struct drm_atomic_commit(9)
• drm_crtc_commit_get(9)
• drm_crtc_commit_put(9)
• drm_atomic_commit_get(9)
• drm_atomic_commit_put(9)
• drm_atomic_get_old_crtc_state(9)
• drm_atomic_get_new_crtc_state(9)
• drm_atomic_get_old_plane_state(9)
• drm_atomic_get_new_plane_state(9)
• drm_atomic_get_old_connector_state(9)
• drm_atomic_get_new_connector_state(9)
• __drm_atomic_get_current_plane_state(9)
• for_each_oldnew_connector_in_state(9)
• for_each_old_connector_in_state(9)
• for_each_new_connector_in_state(9)
• for_each_oldnew_crtc_in_state(9)
• for_each_old_crtc_in_state(9)
• for_each_new_crtc_in_state(9)
• for_each_oldnew_colorop_in_state(9)
• for_each_new_colorop_in_state(9)
• for_each_oldnew_plane_in_state(9)
• for_each_oldnew_plane_in_state_reverse(9)
• for_each_new_plane_in_state_reverse(9)
• for_each_old_plane_in_state(9)
• for_each_oldnew_private_obj_in_state(9)
• for_each_old_private_obj_in_state(9)
• for_each_new_private_obj_in_state(9)
• drm_atomic_crtc_needs_modeset(9)
• drm_atomic_crtc_effectively_active(9)
• struct drm_bus_cfg(9)
• struct drm_bridge_state(9)

---

and that's the whole page, periodt 💅

k byeee, this came from ./include/drm, dated October 2026, and it's literally the for_each_new_plane_in_state(9) page, mwah 😽 🎀🦋✨