for_each_ne...obj_in_state(9)

💅 for_each_ne...obj_in_state(9) — Kernel API Manual

okay so bestie, welcome to the Kernel API Manual page for for_each_ne...obj_in_state(9) — yes the name is truncated with the little dots, that's just how the header do 💀 — and it's genuinely one of those macro-girlies that eats. let's get into it 🔥

---

✨ NAME ✨

for_each_new_private_obj_in_state — iterate over all private objects in an atomic update 🦋

no cap, that's the whole vibe: loop over private objects, new state only.

---

🎀 SYNOPSIS 🎀

for_each_new_private_obj_in_state (__state , obj , new_obj_state , __i );

four args, all of them, copy them exactly, iykyk 😌

---

🌸 ARGUMENTS 🌸

• __state — a struct drm_atomic_commit pointer. the whole commit situation, main character energy 👑
• obj — a struct drm_private_obj iteration cursor. it's the thing you're walkin' through, one private object at a time ✨
• new_obj_state — a struct drm_private_state iteration cursor for the new state. literally the fresh state, the one we actually care about 💖
• __i — an int iteration cursor, for macro-internal use. do not touch her, she's busy doing bookkeeping 🫶

---

🔥 DESCRIPTION 🔥

so this macro iterates over all private objects in an atomic update, but check it — it tracks only the new state 🌈

it's giving extremely useful in enable functions, where we need the new state the hardware should be in when the atomic commit operation has completed. like, the after-picture 💅 the state the hardware is gonna be living in post-commit, periodt.

ngl, if you're reaching for this, you're probably writing an enable function and you already know what you want. slay. the macro just hands you the new private state per object and gets out of your way 🙈

---

🦋 SEE ALSO 🦋

the kernel file is ./include/drm/drm_atomic.h — go read the source, it's iconic 🧚

• 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_new_plane_in_state(9)
• for_each_oldnew_private_obj_in_state(9)
• for_each_old_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)

like, that's the whole friend group fr fr — every one of them is in there, no skips 🫶

---

and that's the page!! mwah 💋 this lil' beauty lives in ./include/drm, dated October 2026, and it's for_each_ne...obj_in_state(9) til the end. go forth and iterate, bestie — you're gonna slay those private objects 💜✨🎀