ice_reserve_sf_num(9)

💅 ice_reserve_sf_num — Kernel API Manual ✨

okay bestie, welcome to the group chat where we learn kernel APIs 💖 you're in the Kernel API Manual section, and today's main character is ice_reserve_sf_num. she's the one who gets you a subfunction number for your port. no cap. 🎀

---

✨ NAME ✨

ice_reserve_sf_num — reserve a subfunction number for this port 🦋

---

🌸 SYNOPSIS 🌸

int ice_reserve_sf_num (struct ice_pf *pf , const struct
devlink_port_new_attrs *new_attr , struct netlink_ext_ack *extack , u32
*sfnum );

---

👑 ARGUMENTS 👑

• pf — pointer to the pf structure 🫶 literally just a pointer to the pf, that's it
• new_attr — the devlink port attributes that got requested 💅
• extack — the extack, and it's here for reporting error messages 😭 so when things go sideways, this is who tells you
• sfnum — on success, this is where the sf number that got reserved shows up ⭐

---

💖 DESCRIPTION 💖

So the whole vibe: this function reserves a subfunction number for this port. That's the moment. ✨

and like, huge caveat incoming — it's only called for DEVLINK_PORT_FLAVOUR_PCI_SF ports. not the other flavours. just that one. iykyk 💅

---

🔥 RETURN 🔥

zero on success, or an error code on failure 🌈 (zero is the slay outcome, an error code is the "we don't talk about it" outcome 💀)

---

🧚 SEE ALSO 🧚

the kernel file herself lives at ./drivers/net/ethernet/intel/ice/devlink/port.c — go say hi 🍓

and here's the whole friend group, no one gets left out 🫶:

• ice_devlink_port_opt_speed_str(9)
• ice_devlink_port_options_print(9)
• ice_devlink_aq_set_port_option(9)
• ice_devlink_port_split(9)
• ice_devlink_port_unsplit(9)
• ice_devlink_set_port_split_options(9)
• ice_devlink_set_switch_id(9)
• ice_devlink_create_pf_port(9)
• ice_devlink_destroy_pf_port(9)
• ice_devlink_port_get_vf_fn_mac(9)
• ice_devlink_port_set_vf_fn_mac(9)
• ice_devlink_create_vf_port(9)
• ice_devlink_destroy_vf_port(9)
• ice_devlink_create_sf_dev_port(9)
• ice_devlink_destroy_sf_dev_port(9)
• ice_activate_dynamic_port(9)
• ice_deactivate_dynamic_port(9)
• ice_dealloc_dynamic_port(9)
• ice_dealloc_all_dynamic_ports(9)
• ice_devlink_port_new_check_attr(9)
• ice_devlink_port_del(9)
• ice_devlink_port_fn_hw_addr_set(9)
• ice_devlink_port_fn_hw_addr_get(9)
• ice_devlink_port_fn_state_set(9)
• ice_devlink_port_fn_state_get(9)
• ice_devlink_create_sf_port(9)
• ice_devlink_destroy_sf_port(9)
• ice_alloc_dynamic_port(9)
• ice_devlink_port_new(9)

---

anyway that's the page 💜 this one came from ./drivers/net/ethernet/intel/i... and she's dated October 2026, so jot that down bestie, it's giving archival queen 👑✨ periodt.