dmub_srv_wait_for_pending(9)

💅 dmub_srv_wait_for_pending(9) — Kernel API Manual, but make it cute

okay so bestie, welcome to the dmub_srv_wait_for_pending(9) page ✨ this is the kernel API manual entry, and honestly? it's a little icon and you're gonna get along great.

---

🌸 NAME 🌸

dmub_srv_wait_for_pending — a re-entrant wait for the messages that are currently pending 🫶 like, it waits for the stuff that's already in the queue, and yes you can call it again, that's the whole re-entrant vibe.

---

✨ SYNOPSIS ✨

enum dmub_status dmub_srv_wait_for_pending (struct dmub_srv *dmub ,
       uint32_t timeout_us );

that's the whole signature, no cap. two args, one return, done. 💅

---

🎀 ARGUMENTS 🎀

• dmub — the dmub service. the main character of this whole operation 👑
• timeout_us — the maximum number of microseconds to wait. so like, the patience budget ⏳ if it runs out, that's a you problem (jk, it's a DMUB_STATUS_TIMEOUT, we'll get there).

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ this function waits until the commands that were queued prior to this call are complete. basically: "hey, everything I lined up before now — is it done? lmk." and it waits for exactly that.

but lowkey, there's a catch: if the interfaces stay busy because additional work is being submitted concurrently, this function will not continue to wait. it's not gonna sit there forever chasing new stuff. it's giving "I said what I said, my job is the old queue" energy 🙈 so don't expect it to hang around for the fresh work too — that's not its lane.

---

🔥 RETURN 🔥

• DMUB_STATUS_OK — success 🎉 slay, it worked.
• DMUB_STATUS_TIMEOUT — the wait for the buffer to flush timed out 💀 it ran out of microseconds.
• DMUB_STATUS_INVALID — an unspecified error. vague, mysterious, not iconic 😭

---

🌈 SEE ALSO 🌈

okay this part is genuinely a list, buckle up bestie, the whole dmub family reunion is here 🫶

kernel file ./drivers/gpu/drm/amd/display/dmub/dmub_srv.h — DMUB interface and operation(9), then:

• struct dmub_region(9)
• struct dmub_window(9)
• struct dmub_fb(9)
• struct dmub_srv_region_params(9)
• struct dmub_srv_fw_meta_info_params(9)
• struct dmub_srv_region_info(9)
• struct dmub_srv_memory_params(9)
• struct dmub_srv_fb_info(9)
• struct dmub_soc_fb_info(9)
• struct dmub_diagnostic_data(9)
• struct dmub_preos_info(9)
• struct dmub_srv_base_funcs(9)
• struct dmub_srv_hw_funcs(9)
• struct dmub_srv_create_params(9)
• struct dmub_srv(9)
• struct dmub_notification(9)
• dmub_srv_create(9)
• dmub_srv_destroy(9)
• dmub_srv_calc_region_info(9)
• dmub_srv_has_hw_support(9)
• dmub_srv_is_hw_init(9)
• dmub_srv_hw_init(9)
• dmub_srv_hw_reset(9)
• dmub_srv_fb_cmd_queue(9)
• dmub_srv_fb_cmd_execute(9)
• dmub_srv_wait_for_hw_pwr_up(9)
• dmub_srv_wait_for_auto_load(9)
• dmub_srv_wait_for_phy_init(9)
• dmub_srv_wait_for_idle(9)
• dmub_srv_send_gpint_command(9)
• dmub_srv_get_gpint_response(9)
• dmub_srv_get_gpint_dataout(9)
• dmub_srv_flush_buffer_mem(9)
• dmub_srv_get_fw_boot_status(9)
• dmub_srv_send_inbox0_cmd(9)
• dmub_srv_wait_for_inbox0_ack(9)
• dmub_srv_subvp_save_surf_addr(9)
• dmub_srv_set_power_state(9)
• dmub_srv_reg_cmd_execute(9)
• dmub_srv_cmd_get_response(9)
• dmub_srv_sync_inboxes(9)
• dmub_srv_wait_for_inbox_free(9)
• dmub_srv_update_inbox_status(9)
• dmub_srv_get_preos_info(9)
• dmub_srv_get_fw_meta_info_from_raw_fw(9)

fr fr, that's every single one, not skipping a single bestie 💖

---

ngl, the "won't keep waiting for new concurrent work" bit is the one thing to actually remember here. that's the whole personality of this function, iykyk 🌟

---

and that's the page, bestie 🎀 source is ./drivers/gpu/drm/amd/display/..., dated October 2026, and it's all filed under dmub_srv_wait_for_pending(9) — go forth and wait for exactly the pending stuff you signed up for, periodt 💜