drm_atomic_h...check_planes(9)

💅 NAME 💅

okay so bestie, welcome to the drm_atomic_h...check_planes(9) page from the Kernel API Manual ✨ this is the function that does a vibe check on your state object specifically for plane changes — validate state object for planes changes, periodt.

✨ SYNOPSIS ✨

int drm_atomic_helper_check_planes (struct drm_device *dev , struct
drm_atomic_commit *state );

🫶 ARGUMENTS 🫶

• dev — the DRM device. It's the main-character device context for this check 🎀
• state — the driver state object, aka the thing we're about to inspect and validate.

🧚 DESCRIPTION 🧚

So the whole assignment is checking the state object to see if the requested state is physically possible. Not "wouldn't it be cute if this worked" — physically possible, bestie. It does all the plane update related checks by calling into the drm_crtc_helper_funcs.atomic_check and drm_plane_helper_funcs.atomic_check hooks provided by the driver 💅

It also sets drm_crtc_state.planes_changed to indicate that a CRTC has updated planes. Yes, that's the little flag situation — it literally says a CRTC has updated planes.

🌈 RETURN 🌈

Zero for success, or -errno. That's the whole return vibe check, no cap 😌

🔥 SEE ALSO 🔥

these besties are also serving manpage realness ✨

• 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(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_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)

byeee bestie 🎀 this page is brought to you by the source/version corner: ./drivers/gpu/drm, dated October 2026, and the footer flex is literally drm_atomic_h...check_planes(9). mwah 💖