dc_wake_and...mub_cmd_list(9)

💅 dc_wake_and_execute_dmub_cmd_list(9) 💅

okay so bestie, welcome to the Kernel API Manual, section 9 (kernel functions, iykyk). today's main character is dc_wake_and_execute_dmub_cmd_list — say that five times fast, I dare you 😭 she's a wrapper, she's a whole vibe, she handles a list of DMUB commands and wakes the hardware up first. iconic behavior honestly 🫶

---

✨ SYNOPSIS ✨

bool dc_wake_and_execute_dmub_cmd_list (const struct dc_context *ctx ,
unsigned int count , union dmub_rb_cmd *cmd , enum dm_dmub_wait_type
wait_type );

she returns a bool, she takes four args, she's lowkey doing the most 💅

---

🎀 ARGUMENTS 🎀

• ctx — the DC context, aka the whole situation you're operating in 🌸
• count — how many commands you're sending and/or receiving, like a little headcount for your command party 🎉
• cmd — the actual array of commands to send. yes bestie, an array — this is the list version, we're not doing just one 🦋
• wait_type — tells her how to wait for the execution to finish, aka the vibe of the waiting portion ⏳

---

💖 DESCRIPTION 💖

so here's the tea ☕ — if the DMCUB hardware was asleep, she wakes the DMUB up before running the command, and then she attempts to re-enter the sleep state if the command submission went through successfully. like, she wakes it, does the thing, and tucks it back in 😴✨ no cap.

she's the preferred command submission interface provided the DC lock is acquired — that caveat is doing heavy lifting, don't skip it, bestie 🔒

and real talk: if you don't use her, entering and exiting out of idle power optimizations would need to be performed manually through dc_allow_idle_optimizations. so like… just use her fr fr 🙈

---

⭐ RETURN ⭐

• true — command submission succeeded, slay 👑
• false — it did not, and we simply do not talk about it 💀

---

🌈 SEE ALSO 🌈

the whole friend group, gathered for the group chat 🫶 the kernel file lives at ./drivers/gpu/drm/amd/display/dc/dc_dmub_srv.h, and here's everyone else:

• dc_dmub_srv_set_power_state(9)
• dc_dmub_srv_notify_fw_dc_power_state(9)
• dc_wake_and_execute_dmub_cmd(9)
• dc_wake_and_execute_gpint(9)
• struct ips_residency_info(9)
• dc_dmub_srv_cursor_offload_init(9)
• dc_dmub_srv_control_cursor_offload(9)
• dc_dmub_srv_program_cursor_now(9)
• dc_dmub_srv_is_cursor_offload_enabled(9)
• dc_dmub_srv_boot_time_crc_init(9)
• dc_dmub_srv_release_hw(9)
• dc_dmub_srv_log_preos_dmcub_info(9)
• dc_dmub_srv_ihc_set_dig_hdcp_interrupt_dest(9)
• dc_dmub_srv_get_fams2_debug_meta(9)

---

🧚 sign-off time: this page lives in ./drivers/gpu/drm/amd/display/dc, dated October 2026, and it's page dc_wake_and...mub_cmd_list(9) of the Kernel API Manual. mwah, go read the source bestie 💜