dc_update_state_prepare(9)

💖 dc_update_state_prepare(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ this one's all about dc_update_state_prepare, and it is literally the prep step, the getting-ready-with-me era, the "let me just fix my hair before we go out" of the commit lifecycle 🎀

🌸 NAME 🌸

dc_update_state_prepare — Prepare the commit under the global lock. 💅

✨ SYNOPSIS ✨

bool dc_update_state_prepare (struct dc_update_scratch_space *scratch );

🦋 ARGUMENTS 🦋

• scratch — the commit scratch from dc_update_state_init. that's the one, the icon, the origin story 🫶

🔥 DESCRIPTION 🔥

So here's the tea: if this fails, the scratch slot gets released and false comes back at you 😭 which means — and this is the important part, no cap — the caller must not call execute or cleanup. like, don't. do not. it's giving boundaries 💀

bestie pls respect this one, it's not a vibe suggestion, the failure path has already cleaned up its side of things 🙈

👑 SEE ALSO 👑

all my besties in one place, kernel file ./drivers/gpu/drm/amd/display/dc/dc.h and friends 💜:

• MAX_SURFACES(9)
• MAX_PLANES(9)
• color-management-caps(9)
• struct rom_curve_caps(9)
• struct dpp_color_caps(9)
• struct mpc_color_caps(9)
• struct dc_color_caps(9)
• enum pipe_split_policy(9)
• dc_check_state_update(9)
• dc_update_state(9)
• dc_update_state_init(9)
• dc_update_state_execute(9)
• dc_update_state_cleanup(9)
• struct dc_probe_latencies(9)
• struct dc_probe_status(9)
• enum dc_get_status_type(9)
• struct dc_get_status_options(9)
• struct dc_state_status(9)
• dc_state_get_status(9)
• struct dc_validation_stream(9)
• struct dc_validation_set(9)
• dc_get_underflow_debug_data_for_otg(9)
• dc_capture_register_software_state(9)
• dc_get_qos_info(9)
• dc_override_memory_bandwidth_request(9)

okay that's the whole page, you ate that 🍓 and before I go — this little masterpiece lives in ./drivers/gpu/drm/amd/display/dc, dated October 2026, and yeah, it's dc_update_state_prepare(9) in the Kernel API Manual ⭐ mwah, go read the next one 💖🧚‍♀️