for_each_ne...rop_in_state(9)

📦 version 7.3.1, in nixpkgs unstable

🌈 for_each_new_colorop_in_state(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ — yes this is a real macro in the kernel and yes it's giving main character energy. Sit down, grab a boba, we're iterating 🍓

✨ NAME ✨

for_each_new_colorop_in_state — iterate over all colorops in an atomic update 🎀

🦋 SYNOPSIS 🦋

for_each_new_colorop_in_state (__state , colorop , new_colorop_state ,
__i );

like, that's the whole vibe. four args, one macro, periodt 💅

🌸 ARGUMENTS 🌸

  • __state — a struct drm_atomic_commit pointer. this is your main character of the whole operation, the atomic update itself ✨
  • colorop — a struct drm_colorop iteration cursor. it's the little guy that walks through every colorop, one at a time 🚶‍♀️
  • new_colorop_state — a struct drm_colorop_state iteration cursor, but for the new state. yes the new one, keep up bestie 💖
  • __i — an int iteration cursor, and it's for macro-internal use only 🙈 don't touch it, don't look at it, it's not for you

💫 DESCRIPTION 💫

So here's the tea ☕ — this macro iterates over all colorops in an atomic update, and while it's doing that it also tracks the new state for you. Obsessed, honestly.

The way that's useful: it's for places where the state delta actually needs to be considered 👀 — for example, in atomic check functions. Like, if you need to know what changed, not just what is, this is your girl 🫶

👑 SEE ALSO 👑

Kernel file ./include/drm/drm_atomic.h — and then the whole friend group, no cap 🫂

aaaand that's the page bestie, you ate that 💅✨ this lil masterpiece lives in ./include/drm, came to you courtesy of the Kernel API Manual, and it's dated October 2026 🗓️💜 go forth and iterate, icon 🎀🦋

📦 where this page comes from