drm_atomic_h...plane_damage(9)

✨ drm_atomic_h...plane_damage(9) ✨

okay bestie, so this is a page straight out of the Kernel API Manual, and it's about a lil helper that does a vibe check on your plane damage during atomic_check. it's tiny, it's important, let's get into it. 🎀

---

🦋 NAME 🦋

drm_atomic_helper_check_plane_damage — literally just Verify plane damage on atomic_check. that's it, that's the whole job, and it does it well. 💅

---

🌸 SYNOPSIS 🌸

void drm_atomic_helper_check_plane_damage (struct drm_atomic_commit
                                           *state , struct drm_plane_state
                                           *plane_state );

it returns void, so like… no return value to obsess over. it just happens. ✨

---

🫶 ARGUMENTS 🫶

• state — the driver state object. yep, the whole state situation. 🌀
• plane_state — the plane state for which we're verifying damage. this is the one getting inspected, bestie. 🔍

---

👑 DESCRIPTION 👑

so the way this works is: this helper function makes sure that damage from plane state is discarded for full modeset. like, if you're doing a full modeset, all that nitpicky damage info gets yeeted, periodt. 💀

and if there are, like, more reasons a driver would want to do a full plane update rather than processing individual damage regions? then those cases should be taken care of here. this is the spot. this is the function. don't go looking elsewhere. 📍

now the fine print, and this part matters fr fr:

note that drm_plane_state.fb_damage_clips == NULL in plane state means that a full plane update should happen. that's the signal, that's the flag, that's the whole mood.

it also ensures the helper iterator will return drm_plane_state.src as damage. so the iterator's got your back. 🧚

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_damage_helper.c — go read the source, iykyk 📖
• drm_atomic_helper_dirtyfb(9)
• drm_atomic_helper_damage_iter_init(9)
• drm_atomic_helper_damage_iter_next(9)
• drm_atomic_helper_damage_merged(9)

---

ok that's the whole page, no cap. short and iconic. 🍓

much love from ./drivers/gpu/drm, October 2026, xoxo — drm_atomic_h...plane_damage(9) 💖✨🦋