drm_atomic_h...mmit_hw_done(9)
π drm_atomic_helper_commit_hw_done β Kernel API Manual β¨
okay bestie, welcome to the group chat π«Ά you're looking at drm_atomic_h...mmit_hw_done(9) from the Kernel API Manual, and honestly? it's giving "short page, big responsibilities." let's get into it π
β¨ NAME β¨
drm_atomic_helper_commit_hw_done β setup possible nonblocking commit π
πΈ SYNOPSIS πΈ
void drm_atomic_helper_commit_hw_done (struct drm_atomic_commit *state
);
like, that's the whole signature. one arg, void return, no drama π
π¦ ARGUMENTS π¦
stateβ the atomic state object that's being committed, aka the main character of this whole operation π
π₯ DESCRIPTION π₯
so, what does this function actually do? it's the "we're done with the hardware part, bestie" signal π¦ you call it to signal completion of the hardware commit step. like ringing the little bell at the counter β hardware's done, move along π
okay but here's the part where you gotta pay attention, no cap π after this step the driver is not allowed to read or change any permanent software or hardware modeset state. not read it, not touch it, not even look at it funny π
the one exception? state that's protected by other means than drm_modeset_lock locks. that's it. that's the loophole π³οΈ
and a lil tip from me to you: drivers should try to postpone any expensive or delayed cleanup work until after this function is called. like, don't do your heavy lifting before the bell rings, that's just chaotic energy π
fr fr this is part of the atomic helper support for nonblocking commits β for the full picture check out drm_atomic_helper_setup_commit π
π§ SEE ALSO π§
so many icons in this list, i'm obsessed π go read them all, iykyk:
- the Kernel file
./drivers/gpu/drm/drm_atomic_helper.coverview(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_cleanup_done(9)drm_atomic_helper_prepare_planes(9)drm_atomic_helper_unprepare_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)
okay that's the whole page, you ate that π
before you go β this lil baddie lives in ./drivers/gpu/drm, and it's dated October 2026. mwah, go commit some atoms responsibly π§ββοΈβ¨π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms