drm_atomic_h...epare_planes(9)

💅 drm_atomic_h...epare_planes(9) — a Kernel API Manual moment

okay so bestie, you're reading the Kernel API Manual and this one is about drm_atomic_helper_unprepare_planes ✨ like the header literally got truncated in the middle of the name and honestly? relatable. it's giving dramatic entrance. anyway, let's get into it 🎀

---

🌸 NAME

drm_atomic_helper_unprepare_planes — release plane resources on aborts 💀

like. it's the cleanup crew. the "we tried, it didn't work, put everything back" girlie 🫶

---

✨ SYNOPSIS

void drm_atomic_helper_unprepare_planes (struct drm_device *dev , struct
       drm_atomic_commit *state );

that's the whole vibe. takes two things, returns nothing, no cap.

---

🦋 ARGUMENTS

• dev — the DRM device 💖 like, the actual graphics device we're doing all this for
• state — atomic state object with old state structures 👀 important detail bestie, the OLD ones

---

💅 DESCRIPTION

okay so listen. this function cleans up plane state — and specifically framebuffers — from the atomic state 🔥

it undoes the effects of drm_atomic_helper_prepare_planes when you're aborting an atomic commit 😭 like it's the undo button, the "jk bestie nevermind", the graceful exit ✨

⚠️ and this is the part where you have to pay attention: if you're cleaning up after a successful commit, you do NOT use this one. you use drm_atomic_helper_cleanup_planes instead. different girl, different job 💀 don't mix them up fr fr

so to recap the timeline:

1. prepare planes → stuff happens
2. it worked? → drm_atomic_helper_cleanup_planes 🌈
3. it didn't? → this function, right here, drm_atomic_helper_unprepare_planes 🧚

periodt. no cap. that's the whole thing 💜

---

👑 SEE ALSO

okay bestie this list is LONG so buckle up, but every single one of these is here because it's family 🫶

• Kernel file ./drivers/gpu/drm/drm_atomic_helper.c
• overview(9)
• drm_atomic_helper_check_modeset(9)
• drm_atomic_helper_check_wb_connector_state(9)
• drm_atomic_helper_check_plane_state(9)
• drm_atomic_helper_check_crtc_primary_plane(9)
• drm_atomic_helper_check_planes(9)
• drm_atomic_helper_check(9)
• drm_atomic_helper_commit_encoder_bridge_disable(9)
• drm_atomic_helper_commit_crtc_disable(9)
• drm_atomic_helper_commit_encoder_bridge_post_disable(9)
• drm_atomic_helper_update_legacy_modeset_state(9)
• drm_atomic_helper_calc_timestamping_constants(9)
• drm_atomic_helper_commit_crtc_set_mode(9)
• drm_atomic_helper_commit_modeset_disables(9)
• drm_atomic_helper_commit_writebacks(9)
• drm_atomic_helper_commit_encoder_bridge_pre_enable(9)
• drm_atomic_helper_commit_crtc_enable(9)
• drm_atomic_helper_commit_encoder_bridge_enable(9)
• drm_atomic_helper_commit_modeset_enables(9)
• drm_atomic_helper_wait_for_fences(9)
• drm_atomic_helper_wait_for_vblanks(9)
• drm_atomic_helper_wait_for_flip_done(9)
• drm_atomic_helper_commit_tail(9)
• drm_atomic_helper_commit_tail_rpm(9)
• drm_atomic_helper_async_check(9)
• drm_atomic_helper_async_commit(9)
• drm_atomic_helper_commit(9)
• implementing nonblocking commit(9)
• drm_atomic_helper_setup_commit(9)
• drm_atomic_helper_wait_for_dependencies(9)
• drm_atomic_helper_fake_vblank(9)
• drm_atomic_helper_commit_hw_done(9)
• drm_atomic_helper_commit_cleanup_done(9)
• drm_atomic_helper_prepare_planes(9)
• drm_atomic_helper_commit_planes(9)
• drm_atomic_helper_commit_planes_on_crtc(9)
• drm_atomic_helper_disable_planes_on_crtc(9)
• drm_atomic_helper_cleanup_planes(9)
• drm_atomic_helper_swap_state(9)
• drm_atomic_helper_update_plane(9)
• drm_atomic_helper_disable_plane(9)
• drm_atomic_helper_set_config(9)
• drm_atomic_helper_disable_all(9)
• drm_atomic_helper_reset_crtc(9)
• drm_atomic_helper_shutdown(9)
• drm_atomic_helper_duplicate_state(9)
• drm_atomic_helper_suspend(9)
• drm_atomic_helper_commit_duplicated_state(9)
• drm_atomic_helper_resume(9)
• drm_atomic_helper_page_flip(9)
• drm_atomic_helper_page_flip_target(9)
• drm_atomic_helper_bridge_propagate_bus_fmt(9)
• drm_atomic_helper_bridge_get_hdmi_output_bus_fmts(9)

like I said. family reunion 🌈✨

---

and that's the page bestie!! mwah 💋 one last thing for the receipts: this whole thing lives over in ./drivers/gpu/drm, and the date on it is October 2026 ⭐ so yeah, future girlie energy. slay. you're welcome 🎀💜