drm_atomic_plane_enabling(9)

💅 drm_atomic_plane_enabling(9)

okay so bestie, welcome to the Kernel API Manual entry for drm_atomic_plane_enabling — this is a kernel function, not a command you type in your terminal, so no, you can't just run it, but you can absolutely understand it. let's go 🫶

---

✨ NAME ✨

drm_atomic_plane_enabling — check whether a plane is being enabled 🌸

like, literally just peeking at a plane and going "hey are you turning on or not" — that's the whole vibe check 🔥

---

✨ SYNOPSIS ✨

bool drm_atomic_plane_enabling (struct drm_plane_state *old_plane_state
, struct drm_plane_state *new_plane_state );

it takes two plane states and hands you back a bool — simple, iconic, no drama 💅

---

✨ ARGUMENTS ✨

• old_plane_state — the old atomic plane state, i.e. the "before" picture 🎀
• new_plane_state — the new atomic plane state, aka the "after" — what it wants to become ✨

ngl, it's just old vs new, side by side, and the function is judging the glow-up 💖

---

✨ DESCRIPTION ✨

so what this does is it checks the atomic state of a plane to determine whether it's being enabled or not 👑

and yes, it also WARNs if it detects an invalid state — because both CRTC and FB need to either both be NULL or both be non-NULL. no mixing and matching, that's the rule, periodt 💀

so if one of them is NULL and the other isn't, that's a red flag 🚩 and the kernel will absolutely let you know via a warning. it's giving "i'm not mad, i'm just disappointed" 😭

---

✨ RETURN ✨

• True — the plane is being enabled, slay, it's turning on 🌈
• false — otherwise, it's not 🔕

that's it, two outcomes, no in-between, very main character energy ⭐

---

✨ SEE ALSO ✨

the kernel file lives at ./include/drm/drm_atomic_helper.h 🦋 — go check it out, iykyk

and while you're there, these are all the besties in the same friend group:

• drm_atomic_crtc_for_each_plane(9)
• drm_atomic_crtc_state_for_each_plane(9)
• drm_atomic_crtc_state_for_each_plane_state(9)
• drm_atomic_plane_disabling(9) — the evil twin, the disabling one 🙈

---

that's the whole page bestie, every flag, every warning, every reference — nothing left out, we ate and left no crumbs 👑✨

this gem came from ./include/drm, and it's dated October 2026 — note the version, screenshot it, put it on your mood board 🎀

mwah, ily, go read more manpages 💖🫶💜