dc_update_state_init(9)

✨ NAME ✨

okay so bestie, welcome to the manual page for dc_update_state_init(9) in the Kernel API Manual — this is the function that acquires and initialises a commit scratch buffer. Literally its whole job. 💅

🎀 SYNOPSIS 🎀

struct dc_update_scratch_space * dc_update_state_init (struct dc *dc ,
const struct dc_state_update *updates );

🌸 ARGUMENTS 🌸

• dc — the DC structure. That's the vibe. 🫶
• updates — the update descriptor. Heads up: it gets validated before the slot is acquired. No skipping the vibe check. ✨

💖 RETURN 💖

On success you get a scratch slot, and it's giving iconic. 😌 If validation fails or the pool is exhausted, you get NULL. No slot, no sparkle. 💀

Also important, bestie: the slot must be released via dc_update_state_cleanup on success, or automatically by dc_update_state_prepare on failure. That's the cleanup lore. 🧚

🦋 SEE ALSO 🦋

Kernel file ./drivers/gpu/drm/amd/display/dc/dc.h is in the group chat, and so is the whole squad:

• 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_prepare(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 bye bestie 💜 — this cutie came from source/version ./drivers/gpu/drm/amd/display/dc, dated October 2026, and it's the manual page for dc_update_state_init(9). slay your commits responsibly! 🌈🎀