cmdq_pkt_poll(9)

💖 NAME 💖

okay bestie, this is cmdq_pkt_poll(9) from the Kernel API Manual, and it's giving “append a polling command to the CMDQ packet” energy ✨. What it does: it asks GCE to execute an instruction that waits for a specified hardware register to check for the value w/o mask. 🫶

⚠️ Blocking warning, no cap: all GCE hardware threads will be blocked by this instruction. Every single one. So like, plan around that, bestie. 😭

🌸 SYNOPSIS 🌸

here's the signature, exactly as it is:

int cmdq_pkt_poll (struct cmdq_pkt *pkt , u8 subsys , u16 offset , u32 value );

🎀 ARGUMENTS 🎀

• pkt — the CMDQ packet. the packet bestie you're appending to.
• subsys — the CMDQ sub system code. yep, that's the subsystem code.
• offset — register offset from CMDQ sub system. literally the offset from the CMDQ sub system.
• value — the specified target register value. the value you're checking for.

✨ RETURN ✨

0 for success; else the error code is returned. so 0 is the slay outcome, anything else is the error code coming back at you. 💅

🦋 SEE ALSO 🦋

Kernel file: ./include/linux/soc/mediatek/mtk-cmdq.h — that's the file, iykyk.

the whole CMDQ function bestie squad:

• cmdq_dev_get_client_reg(9)
• cmdq_mbox_create(9)
• cmdq_mbox_destroy(9)
• 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_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)

okay bye bestie! 💖 source/version: ./include/linux/soc/mediatek; date: October 2026; manual page: cmdq_pkt_poll(9) ✨