ice_vsi_ctrl_one_rx_ring(9)

💖 ice_vsi_ctrl_one_rx_ring — NAME ✨

okay so bestie, ice_vsi_ctrl_one_rx_ring — like, the actual name — does exactly what it says on the tin: it starts or stops a VSI's Rx ring, and the whole ~lewk~ is that there is no busy wait. no spinning, no burning CPU staring at a register like it's a text from your crush. iconic behavior, honestly.

it lives in the Kernel API Manual, section 9, and we're gonna get into it 💅

---

🦋 SYNOPSIS

int ice_vsi_ctrl_one_rx_ring (struct ice_vsi *vsi , bool ena , u16
rxq_idx , bool wait );

returns an int, takes four things, that's the whole vibe 🎀

---

🌸 ARGUMENTS

• vsi — the VSI that's getting configured. this is the main character of the whole call, everything's happening to this VSI 🫶
• ena — a bool that says whether you're starting or stopping the Rx ring. pick a lane, gorl 💅
• rxq_idx — the Rx queue index for the VSI you passed in, and it's 0-based so the first one is 0, not 1. no cap ✨
• wait — whether to wait for the configuration to actually finish in hardware, or to just ~not~ do that. literally the fork in the road for this whole function 🔥

---

⭐ DESCRIPTION

Return 0 on success and negative on error. that's it, that's the description 😭 short and sweet, like a good iced coffee order.

ngl, the name is the real tea here: this one does its thing with no busy wait — don't go assuming it polls in a loop, that's not the vibe this function is giving.

---

🧚 SEE ALSO

okay this list is long but they're all family, we don't skip family 🌈

• Kernel file ./drivers/net/ethernet/intel/ice/ice_base.c — the file, in the kernel source, that you wanna peek at 👀
• __ice_vsi_get_qs_contig(9)
• __ice_vsi_get_qs_sc(9)
• ice_pf_rxq_wait(9)
• ice_vsi_alloc_q_vector(9)
• ice_free_q_vector(9)
• ice_cfg_itr_gran(9)
• ice_calc_txq_handle(9)
• ice_cfg_xps_tx_ring(9)
• ice_set_txq_ctx_vmvf(9)
• ice_setup_tx_ctx(9)
• ice_setup_txtime_ctx(9)
• ice_calc_ts_ring_count(9)
• ice_setup_rx_ctx(9)
• ice_vsi_cfg_rxq(9)
• ice_vsi_cfg_frame_size(9)
• ice_vsi_cfg_rxqs(9)
• __ice_vsi_get_qs(9)
• ice_vsi_wait_one_rx_ring(9)
• ice_vsi_alloc_q_vectors(9)
• ice_vsi_map_rings_to_vectors(9)
• ice_vsi_free_q_vectors(9)
• ice_cfg_tstamp(9)
• ice_vsi_cfg_txq(9)
• ice_vsi_cfg_txqs(9)
• ice_vsi_cfg_lan_txqs(9)
• ice_vsi_cfg_xdp_txqs(9)
• ice_cfg_itr(9)
• ice_cfg_txq_interrupt(9)
• ice_cfg_rxq_interrupt(9)
• ice_trigger_sw_intr(9)
• ice_vsi_stop_tx_ring(9)
• ice_fill_txq_meta(9)
• ice_qp_reset_stats(9)
• ice_qp_clean_rings(9)
• ice_qp_dis(9)
• ice_qp_ena(9)

---

like, that's the whole page bestie, we ate and left no crumbs 🍓

and for the ~receipts~: this one comes from ./drivers/net/ethernet/intel/ice, dated October 2026, and it's the ice_vsi_ctrl_one_rx_ring(9) page. mwah, love u, go start a ring 💜✨