for_each_old...ane_in_state(9)

💖 NAME 💖

Okay bestie, welcome to the for_each_old...ane_in_state(9) page from the Kernel API Manual — the actual star of the show is for_each_oldnew_plane_in_state, and its whole job is to iterate over all planes in an atomic update. Iconic behavior, honestly.

---

✨ SYNOPSIS ✨

for_each_oldnew_plane_in_state (__state , plane , old_plane_state ,
       new_plane_state , __i );

---

💅 ARGUMENTS 💅

• __state — a struct drm_atomic_commit pointer. That's your atomic commit vibe.
• plane — a struct drm_plane iteration cursor.
• old_plane_state — a struct drm_plane_state iteration cursor for the old state.
• new_plane_state — a struct drm_plane_state iteration cursor for the new state.
• __i — an int iteration cursor, strictly for macro-internal use.

---

🦋 DESCRIPTION 🦋

So what does it do? It iterates over all planes in an atomic update, tracking both the old state and the new state at the same time. That's lowkey the whole point.

This is useful in places where you need to consider the state delta — for example, in atomic check functions. No cap, that's exactly the situation it's built for.

---

🔥 SEE ALSO 🔥

Kernel file: ./include/drm/drm_atomic.h

The whole friend group is here, bestie:

• 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_reverse(9)
• for_each_new_plane_in_state_reverse(9)
• for_each_old_plane_in_state(9)
• for_each_new_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)

---

That's the whole vibe 💖 This page lives in ./include/drm, dated October 2026, and the footer is still serving for_each_old...ane_in_state(9). Bye bestie, go iterate slayfully ✨🎀