ice_sched_get_free_qgrp(9)

💅 ice_sched_get_free_qgrp 💅

okay bestie, welcome to the Kernel API Manual, section 9 — yes this is a kernel function page and yes it's about to be the most fun you've ever had with queue groups ✨

---

🌸 NAME 🌸

ice_sched_get_free_qgrp — scan all queue group siblings and find a free node 👑

---

🎀 SYNOPSIS 🎀

struct ice_sched_node * ice_sched_get_free_qgrp (struct ice_port_info
*pi , struct ice_sched_node *vsi_node , struct ice_sched_node *qgrp_node
, u8 owner );

---

🦋 ARGUMENTS 🦋

• pi — the port information structure, aka the whole vibe of this port 🫶
• vsi_node — the software VSI handle, your main character node 💫
• qgrp_node — the first queue group node that got picked for scanning — the starting point of the search, not the winner (yet) 👀
• owner — LAN or RDMA, pick your fighter 🥊

---

💖 DESCRIPTION 💖

so what this function does is it goes and retrieves a free LAN or RDMA queue group node 🔥 and the way it does that is iconic: it scans qgrp_node and its siblings and picks the queue group with the fewest number of queues currently assigned to it. literally the least-busy sibling wins. lowkey a popularity contest but in reverse 💀

so if you're like "which queue group is the most free rn", this is the function you call, no cap 🧚

---

🌈 SEE ALSO 🌈

first up, the kernel file itself lives right here, go read the source bestie:

• Kernel file ./drivers/net/ethernet/intel/ice/ice_sched.c

and then the entire ice_sched extended family showed up to the group chat, in this exact order, don't @ me:

• ice_sched_add_root_node(9), ice_sched_find_node_by_teid(9), ice_sched_find_next_vsi_node(9), ice_aqc_send_sched_elem_cmd(9), ice_aq_query_sched_elems(9), ice_sched_add_node(9), ice_aq_delete_sched_elems(9), ice_sched_remove_elems(9)
• ice_sched_get_first_node(9), ice_sched_get_tc_node(9), ice_free_sched_node(9), ice_aq_get_dflt_topo(9), ice_aq_add_sched_elems(9), ice_aq_cfg_sched_elems(9), ice_aq_move_sched_elems(9), ice_aq_suspend_sched_elems(9)
• ice_aq_resume_sched_elems(9), ice_aq_query_sched_res(9), ice_sched_suspend_resume_elems(9), ice_alloc_lan_q_ctx(9), ice_alloc_rdma_q_ctx(9), ice_aq_rl_profile(9), ice_aq_add_rl_profile(9), ice_aq_remove_rl_profile(9)
• ice_sched_del_rl_profile(9), ice_sched_clear_rl_prof(9), ice_sched_clear_agg(9), ice_sched_clear_tx_topo(9), ice_sched_clear_port(9), ice_sched_cleanup_all(9), ice_sched_add_elems(9), ice_sched_add_nodes_to_hw_layer(9)
• ice_sched_add_nodes_to_layer(9), ice_sched_get_qgrp_layer(9), ice_sched_get_vsi_layer(9), ice_sched_get_agg_layer(9), ice_rm_dflt_leaf_node(9), ice_sched_rm_dflt_nodes(9), ice_sched_init_port(9), ice_sched_query_res_alloc(9)
• ice_sched_get_psm_clk_freq(9), ice_sched_find_node_in_subtree(9), ice_sched_get_free_qparent(9), ice_sched_get_vsi_node(9), ice_sched_get_agg_node(9), ice_sched_calc_vsi_child_nodes(9), ice_sched_add_vsi_child_nodes(9), ice_sched_calc_vsi_support_nodes(9)
• ice_sched_add_vsi_support_nodes(9), ice_sched_add_vsi_to_topo(9), ice_sched_recalc_vsi_support_nodes(9), ice_sched_update_vsi_child_nodes(9), ice_sched_cfg_vsi(9), ice_sched_rm_agg_vsi_info(9), ice_sched_is_leaf_node_present(9), ice_sched_rm_vsi_subtree(9)
• ice_sched_rm_vsi_cfg(9), ice_rm_vsi_lan_cfg(9), ice_rm_vsi_rdma_cfg(9), ice_get_agg_info(9), ice_sched_get_free_vsi_parent(9), ice_sched_update_parent(9), ice_sched_move_nodes(9), ice_sched_move_vsi_to_agg(9)
• ice_move_all_vsi_to_dflt_agg(9), ice_sched_is_agg_inuse(9), ice_sched_rm_agg_cfg(9), ice_rm_agg_cfg_tc(9), ice_save_agg_tc_bitmap(9), ice_sched_add_agg_cfg(9), ice_sched_cfg_agg(9), ice_cfg_agg(9)
• ice_get_agg_vsi_info(9), ice_get_vsi_agg_info(9), ice_save_agg_vsi_tc_bitmap(9), ice_sched_assoc_vsi_to_agg(9), ice_sched_rm_unused_rl_prof(9), ice_sched_update_elem(9), ice_sched_cfg_node_bw_alloc(9), ice_move_vsi_to_agg(9)
• ice_set_clear_cir_bw(9), ice_set_clear_eir_bw(9), ice_set_clear_shared_bw(9), ice_sched_save_vsi_bw(9), ice_sched_calc_wakeup(9), ice_sched_bw_to_rl_profile(9), ice_sched_add_rl_profile(9), ice_sched_cfg_node_bw_lmt(9)
• ice_sched_get_node_rl_prof_id(9), ice_sched_get_rl_prof_layer(9), ice_sched_get_srl_node(9), ice_sched_rm_rl_profile(9), ice_sched_set_node_bw_dflt(9), ice_sched_set_eir_srl_excl(9), ice_sched_set_node_bw(9), ice_sched_set_node_priority(9)
• ice_sched_set_node_weight(9), ice_sched_set_node_bw_lmt(9), ice_sched_set_node_bw_dflt_lmt(9), ice_sched_validate_srl_node(9), ice_sched_save_q_bw(9), ice_sched_set_q_bw_lmt(9), ice_cfg_q_bw_lmt(9), ice_cfg_q_bw_dflt_lmt(9)
• ice_sched_get_node_by_id_type(9), ice_sched_set_node_bw_lmt_per_tc(9), ice_cfg_vsi_bw_lmt_per_tc(9), ice_cfg_vsi_bw_dflt_lmt_per_tc(9), ice_cfg_rl_burst_size(9), ice_sched_replay_node_prio(9), ice_sched_replay_node_bw(9), ice_sched_get_ena_tc_bitmap(9)
• ice_sched_replay_agg(9), ice_sched_replay_agg_vsi_preinit(9), ice_sched_replay_vsi_agg(9), ice_replay_vsi_agg(9), ice_sched_replay_q_bw(9)

---

okay that's the whole page, you ate that 💅 mwah 🫶

so cute, so official: this one's from ./drivers/net/ethernet/intel/ice, dated October 2026. the manual calls itself ice_sched_get_free_qgrp(9) in the corner, but we already knew that 💖 byeee 🦋✨