drm_atomic_...anes_on_crtc(9)

💖 drm_atomic_...anes_on_crtc(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ — this is the page for drm_atomic_...anes_on_crtc, and yes the title is literally abbreviated with dots because kernel function names are like that sometimes 🫶. buckle up, it's a short one but the caveats are real.

---

🌸 NAME 🌸

drm_atomic_helper_commit_planes_on_crtc — commit plane state for a CRTC 👑

So like, it's the "hey, push the new plane state through for this specific CRTC" function. main character energy, but scoped to one CRTC.

---

✨ SYNOPSIS ✨

void drm_atomic_helper_commit_planes_on_crtc (struct drm_crtc_state
*old_crtc_state );

literally one argument, we love a low-effort signature 💅

---

🎀 ARGUMENTS 🎀

• old_crtc_state — atomic state object with the old CRTC state. yes, old. that's not a typo, bestie, that's the assignment 🫶

---

🦋 DESCRIPTION 🦋

So what's the vibe? This function commits the new plane state using the plane and atomic helper functions — but only for the planes on the specific CRTC you're dealing with 💫.

It assumes that the atomic state has already been pushed into the relevant object state pointers, because this step can no longer fail. ngl that's the whole reason it's allowed to be this chill. no failure path, no drama, no cleanup 😌

This function is useful when plane updates should be done CRTC-by-CRTC instead of one global step — i.e. instead of doing it the way drm_atomic_helper_commit_planes does. one at a time, cute and controlled 🎀

⚠️ caveat time, and it's a big one: this function can only be savely used when planes are not allowed to move between different CRTCs, because this function doesn't handle inter-CRTC dependencies. (yes, "savely" — that's the manual's spelling, we're keeping it, it's iconic 😭💀)

So the callers have to make sure of one of these:

1. no such dependencies exist at all, or
2. they resolve them through ordering of commit calls, or
3. they resolve them through some other means 🙈

basically: you own the dependency problem, not this function. it will not save you. periodt 💅

---

🌈 SEE ALSO 🌈

okay this list is enormous and honestly it ate 🔥. here's the whole thing, every single reference, no skips:

• 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_unprepare_planes(9)
• drm_atomic_helper_commit_planes(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, go read all of them. iykyk 🧚

---

and that's the page, bestie!! 🍓 lil sign-off from the source at ./drivers/gpu/drm, dated October 2026 — same date on both ends, cute. stay atomic, don't cross the CRTCs, and slay your commit ordering 💜👑