ice_init_rq(9)

✨ ice_init_rq(9) ✨

okay so bestie, this one’s from the Kernel API Manual, and it’s all about getting the receive side of a control queue ready 💅

---

🎀 NAME 🎀

ice_init_rq — initialize receive side of a control queue

🌸 SYNOPSIS 🌸

int ice_init_rq (struct ice_hw *hw , struct ice_ctl_q_info *cq );

🦋 ARGUMENTS 🦋

• hw — pointer to the hardware structure
• cq — pointer to the specific Control queue

✨ DESCRIPTION ✨

okay so this is the main initialization routine for the Receive side of a control queue. literally the setup moment for that receive side 🫶

Before you call this function, the driver MUST set these fields in the cq->structure:

• cq->num_rq_entries
• cq->rq_buf_size

do NOT hold the lock when calling this, because the memory allocation routines called are not going to be atomic context safe 😭 like, seriously, not the move.

👑 SEE ALSO 👑

Kernel file: ./drivers/net/ethernet/intel/ice/ice_controlq.c

then all the sibling functions, no cap:

• ice_adminq_init_regs(9)
• ice_mailbox_init_regs(9)
• ice_sb_init_regs(9)
• ice_check_sq_alive(9)
• ice_alloc_ctrlq_sq_ring(9)
• ice_alloc_ctrlq_rq_ring(9)
• ice_free_cq_ring(9)
• ice_alloc_rq_bufs(9)
• ice_alloc_sq_bufs(9)
• ice_cfg_sq_regs(9)
• ice_cfg_rq_regs(9)
• ice_init_sq(9)
• ice_shutdown_sq(9)
• ice_aq_ver_check(9)
• ice_shutdown_rq(9)
• ice_init_check_adminq(9)
• ice_init_ctrlq(9)
• ice_is_sbq_supported(9)
• ice_get_sbq(9)
• ice_shutdown_ctrlq(9)
• ice_shutdown_all_ctrlq(9)
• ice_init_all_ctrlq(9)
• ice_init_ctrlq_locks(9)
• ice_create_all_ctrlq(9)
• ice_destroy_ctrlq_locks(9)
• ice_destroy_all_ctrlq(9)
• ice_clean_sq(9)
• ice_ctl_q_str(9)
• ice_debug_cq(9)
• ice_sq_done(9)
• ice_sq_send_cmd(9)
• ice_fill_dflt_direct_cmd_desc(9)
• ice_clean_rq_elem(9)

---

that’s the whole vibe from the Kernel API Manual, source/version ./drivers/net/ethernet/intel/ice, dated October 2026 — slay and stay safe 💖