ice_find_vsi_list_entry(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_find_vsi_list_entry(9) — like, the VSI list lookup girlie 💅

okay so this one lives in the Kernel API Manual, section 9 (that's the kernel-API section bestie, we love her), and the whole page is literally just about finding one thing in one list. tiny function, big energy. ✨

🌸 NAME 🌸

ice_find_vsi_list_entry — search a VSI list map where the VSI count is 1, no cap 🫶

🦋 SYNOPSIS 🦋

struct ice_vsi_list_map_info * ice_find_vsi_list_entry (struct ice_hw
*hw , u8 recp_id , u16 vsi_handle , u16 *vsi_list_id );

she returns a pointer to struct ice_vsi_list_map_info, and honestly that signature ate 💀

🎀 ARGUMENTS 🎀

  • hw — pointer to the hardware structure. yes the actual HW, main character energy 👑
  • recp_id — the lookup type you wanna search VSI lists for. it's a u8, she's smol but she matters 🍓
  • vsi_handle — the VSI handle we're trying to find in the VSI list. this is the whole point of the whole function ngl 🔥
  • vsi_list_id — out-param city: it gets filled with the VSI list ID that was found containing vsi_handle 💖

✨ DESCRIPTION ✨

so this is a helper function (a helper, like the bestie who holds your bag) that searches a VSI list with a single entry containing the given VSI handle element. one entry. count = 1. that's the vibe check she passes 🧚

and here's the cute part: she's extendable — the original literally says this can be extended further to search a VSI list with more than one vsi_count. room to grow, we love a girl with potential 🌱

if she finds it? you get a pointer to the VSI list entry. if not? no entry for you 😭

heads up: the manpage doesn't spell out the failure return here, so don't @ me with guesses — the doc only promises "returns pointer to VSI list entry if found." 💀

🌈 SEE ALSO 🌈

first up, the kernel file this whole saga lives in:

  • ./drivers/net/ethernet/intel/ice/ice_switch.c

and now the full friend group, in order, all of them, yes every single one 💜:

periodt. that's the entire list, i counted, don't make me count again 😤

k that's the whole page bestie 💅 this cutie is from ./drivers/net/ethernet/intel/ice, dated October 2026 — go drink some water and go read ice_switch.c 🫶✨

📦 where this page comes from