drm_plane_force_disable(9)

💅 drm_plane_force_disable(9) — the kernel API manual, but make it make sense

okay so bestie, welcome to drm_plane_force_disable(9), a little corner of the Kernel API Manual that's about to become your whole personality. yes we're doing this. let's go 🎀

---

✨ NAME ✨

drm_plane_force_disable — forcibly disable a plane. not "gently encourage." not "ask nicely." forcibly. it's giving main character energy with zero patience 💅

---

🔥 SYNOPSIS 🔥

void drm_plane_force_disable (struct drm_plane *plane );

---

🧚 ARGUMENTS 🧚

• plane — the plane we're disabling. that's her. that's the one. she's getting turned off, no vote in the matter 💀

---

🌸 DESCRIPTION 🌸

so literally what it says on the tin: it forces the plane to be disabled. no negotiation, no vibes check, just off.

when do we call it? glad you asked, bestie 🫶

• when the plane's current framebuffer gets destroyed, and
• when restoring fbdev mode

🚨 okay important warning, do not skip this. this function is not suitable for atomic drivers. why? because it doesn't wire through the lock acquisition context properly, which means it can't handle retries or driver private locks. so like... it's lowkey not built for the atomic lifestyle, no cap.

if you're on an atomic driver and you're reaching for this, what you probably want instead is drm_atomic_helper_disable_plane or drm_atomic_helper_disable_planes_on_crtc. use those. they ate. 🌈

---

👑 SEE ALSO 👑

the whole squad, fr fr:

• Kernel file ./drivers/gpu/drm/drm_plane.c
• overview(9)
• standard plane properties(9)
• hotspot properties(9)
• drm_plane_create_hotspot_properties(9)
• drm_universal_plane_init(9)
• drm_plane_cleanup(9)
• drm_plane_from_index(9)
• drm_mode_plane_set_obj_prop(9)
• drm_plane_has_format(9)
• drm_any_plane_has_format(9)
• damage tracking(9)
• drm_plane_enable_fb_damage_clips(9)
• drm_plane_get_damage_clips_count(9)
• drm_plane_get_damage_clips(9)
• drm_plane_create_scaling_filter_property(9)
• drm_plane_add_size_hints_property(9)
• drm_plane_create_color_pipeline_property(9)

---

⭐ that's the whole page, bestie. this one lives at ./drivers/gpu/drm and it's stamped October 2026 — so screenshot it, cite it, print it out and tape it to your monitor. iconic behavior only. mwah 💖🦋✨