drm_atomic_c...r_each_plane(9)

💖 NAME 💖

drm_atomic_crtc_for_each_plane — okay so this one iterates over the planes that are currently attached to a CRTC 🦋

---

✨ SYNOPSIS ✨

drm_atomic_crtc_for_each_plane (plane , crtc );

(it's a macro, bestie, so yes the spacing is a whole vibe 😭 keep it exactly like that)

---

🎀 ARGUMENTS 🎀

• plane — this is your loop cursor 👑 like, the variable that hops from plane to plane while you're looping.
• crtc — the CRTC whose planes are getting iterated 💅 that's the one you're looking at.

---

🌸 DESCRIPTION 🌸

So here's the tea: this iterates over the current state ⭐ useful, for example, when you're applying atomic state after it's already been checked and swapped. Lowkey the "we're done deciding, now commit" moment 🫶

But if you want to iterate over the planes that will be attached — which is, ngl, more useful in code called from drm_mode_config_funcs.atomic_check — then you want drm_atomic_crtc_state_for_each_plane instead 👀✨ iykyk.

fr fr though, don't mix these two up — one is "what's attached rn", the other is "what's about to be attached". Different vibes, different macros, no cap 💀

---

🔥 SEE ALSO 🔥

• Kernel file ./include/drm/drm_atomic_helper.h 📁
• drm_atomic_crtc_state_for_each_plane(9)
• drm_atomic_crtc_state_for_each_plane_state(9)
• drm_atomic_plane_enabling(9)
• drm_atomic_plane_disabling(9)

---

and that's the whole page, periodt 💅 This little icon lives over in ./include/drm, dated October 2026, and the header on it is drm_atomic_c...r_each_plane(9) — mwah, go slay some atomic state 🧚💜