for_each_new_crtc_in_state(9)

✨ for_each_new_crtc_in_state(9) ✨

okay bestie, welcome to the Kernel API Manual 💖 this one is a macro moment and it's literally about looping through CRTCs in an atomic update, so grab your iced coffee and let's get into it 🧚

🌸 NAME 🌸

for_each_new_crtc_in_state — iterate over all CRTCs in an atomic update. That's the whole assignment: every CRTC in the atomic update gets a lil visit from the loop 🦋

✨ SYNOPSIS ✨

for_each_new_crtc_in_state (__state , crtc , new_crtc_state , __i );

copy it exactly, spaces and all — the compiler does not care about your aesthetic 💀

🎀 ARGUMENTS 🎀

• __state — a struct drm_atomic_commit pointer. it's the atomic commit you're working with, bestie 💅
• crtc — a struct drm_crtc iteration cursor. this is your current CRTC as the loop does its thing 🫶
• new_crtc_state — a struct drm_crtc_state iteration cursor for the new state. not the old state, the new one — she's the main character here 👑
• __i — an int iteration cursor, and it's for macro-internal use 🙈 that's the macro's own little bookkeeping, iykyk

🦋 DESCRIPTION 🦋

so this iterates over all CRTCs in an atomic update, tracking only the new state. no old-state baggage, just the new state, periodt 💅

it's giving enable-function energy: this is useful in enable functions, where we need the new state the hardware should be in when the atomic commit operation has completed. like, the hardware's final form after the commit finishes ✨ that's the vibe check this macro passes every time 💯

🌈 SEE ALSO 🌈

the kernel file is ./include/drm/drm_atomic.h, and the whole squad is here — no cuts, no skips, all of them:

• 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_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_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)

mwah 💋 this one lives in ./include/drm, it's dated October 2026, and it answers to for_each_new_crtc_in_state(9) — slay, bye bestie 🌈💖