cmdq_mbox_create(9)

💖 cmdq_mbox_create(9) — the Kernel API Manual glow-up 🎀

okay bestie, so this is a page from the Kernel API Manual, and honestly? It's a little one but it's iconic. Sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

cmdq_mbox_create — literally creates a CMDQ mailbox client and channel, both at once, no cap 💅

---

🌸 SYNOPSIS 🌸

struct cmdq_client * cmdq_mbox_create (struct device *dev , int index );

that's the whole vibe. two arguments, one struct cmdq_client * coming back at you 🫶

---

🦋 ARGUMENTS 🦋

• dev — the device of the CMDQ mailbox client, aka who this whole thing belongs to 👑
• index — the index of the CMDQ mailbox channel. it's a number, it picks which channel, that's the tea 🎀

---

⭐ RETURN ⭐

a CMDQ mailbox client pointer 💀 that's it, that's the return value. main character pointer energy, fr fr.

---

🌈 SEE ALSO 🌈

okay so this is the part where the page just spills the whole friend group, and honestly? obsessed. all of these are (9) sections, all of them are in the group chat:

• the Kernel file ./include/linux/soc/mediatek/mtk-cmdq.h — the source of truth, iykyk
• cmdq_dev_get_client_reg(9)
• cmdq_mbox_destroy(9) — yes bestie, there's a destroy, you can't just create things and leave them 😭
• cmdq_pkt_create(9)
• cmdq_pkt_destroy(9)
• cmdq_pkt_write(9)
• cmdq_pkt_write_pa(9)
• cmdq_pkt_write_subsys(9)
• cmdq_pkt_write_mask(9)
• cmdq_pkt_write_mask_pa(9)
• cmdq_pkt_write_mask_subsys(9)
• cmdq_pkt_write_s(9)
• cmdq_pkt_write_s_mask(9)
• cmdq_pkt_write_s_value(9)
• cmdq_pkt_write_s_mask_value(9)
• cmdq_pkt_mem_move(9)
• cmdq_pkt_wfe(9)
• cmdq_pkt_acquire_event(9)
• cmdq_pkt_clear_event(9)
• cmdq_pkt_set_event(9)
• cmdq_pkt_poll(9)
• cmdq_pkt_poll_mask(9)
• cmdq_pkt_logic_command(9)
• cmdq_pkt_assign(9)
• cmdq_pkt_poll_addr(9)
• cmdq_pkt_jump_abs(9)
• cmdq_pkt_jump_rel(9)
• cmdq_pkt_jump_rel_temp(9)
• cmdq_pkt_eoc(9)

like, that's the whole cmdq_pkt_* squad and they all ate 🔥 go read them if you want the full lore.

lowkey reminder: this page only tells you what cmdq_mbox_create does — create the client and channel. everything else lives in the pages above, so don't come for me for details that aren't here 🙈

---

and that's the page!! 💜 this whole thing lives over in ./include/linux/soc/mediatek, dated October 2026, so slay, go forth and create your mailbox client. periodt. 🧚✨