drm_plane_he...able_primary(9)

💅 drm_plane_he...able_primary(9) — a Kernel API Manual moment

okay so bestie, welcome to the Kernel API Manual ✨ this one's about drm_plane_helper_disable_primary, and ngl the name is a whole keyboard smash but we move 🫶

---

🌸 NAME 🌸

drm_plane_helper_disable_primary — the helper for disabling primary planes 💅

---

✨ SYNOPSIS ✨

int drm_plane_helper_disable_primary (struct drm_plane *plane , struct
       drm_modeset_acquire_ctx *ctx );

like, it takes two things and gives you back an int. that's the whole vibe 💖

---

🎀 ARGUMENTS 🎀

• plane — the plane you're trying to disable, bestie. that's the main character here 👑
• ctx — the modeset locking context. it's giving "let me in, I have the keys" 🔑

---

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓 this helper returns an error when you try to disable the primary plane. like, it literally does not let you. not me being told no 😭

and the important part, bestie: this function is only useful for non-atomic modesetting. that's it, that's the whole lane it stays in.

⚠️ fr fr, do not use it in new drivers. it's not for the new girls. periodt 💀

---

🌈 RETURN 🌈

an errno code. that's the whole return value, no cap ✨

---

💜 SEE ALSO 💜

• the Kernel file ./drivers/gpu/drm/drm_plane_helper.c overview(9) — go read the source, iykyk 📖
• drm_plane_helper_update_primary(9) — the sibling that actually updates stuff 🔥
• drm_plane_helper_destroy(9) — the one that handles the goodbye 🧚

---

🎀 cute sign-off time 🎀 — this lil page lives in ./drivers/gpu/drm, dated October 2026. stan the kernel docs, drink water, and don't use deprecated helpers in new drivers 💖💅🦋