i40e_aq_set_link_restart_an(9)

📦 version 7.3.1, in nixpkgs unstable

okay so this is a page straight out of the Kernel API Manual, and it's about one very specific little function: i40e_aq_set_link_restart_an. It's giving "niche Intel NIC lore" and honestly? we love her for it. 🎀

✨ NAME ✨

i40e_aq_set_link_restart_an —

and that's it. that's the whole description. the manpage really said "she's self-explanatory, figure it out" 💀 no cap, the original has nothing after the dash. iconic minimalism, i guess. 🫶

🌸 SYNOPSIS 🌸

int i40e_aq_set_link_restart_an (struct i40e_hw *hw , bool enable_link ,
       struct i40e_asq_cmd_details *cmd_details );

three args, one int coming back atcha. copy it exactly, bestie, don't get cute with the spacing. 💅

🦋 ARGUMENTS 🦋

  • hw — pointer to the hw struct. it's the hardware handle, the main character, the one who knows things. 👑
  • enable_link — a bool, and it's literally just a switch: if true, you're enabling the link; if false, you're disabling the link. no in-between, no "it depends", no vibes. 🔥
  • cmd_details — pointer to the command details structure, or NULL. your call, babe. 🫶

💖 DESCRIPTION 💖

So what does she do? Two things, and the manpage says them in one sentence:

Sets up the link and restarts the Auto-Negotiation over the link.

that's the whole bit. link gets set up, Auto-Negotiation gets restarted over that same link. Auto-Negotiation is doing its little handshake dance again and we're here for it. ✨🤝

🌈 SEE ALSO 🌈

first up, the source itself lives in the kernel file ./drivers/net/ethernet/intel/i40e/i40e_common.c — go say hi to her. 📁

and then there is... a list. and when i say a list, i mean a LIST. buckle up bestie, we're going through all of them, no skips, no summarising, because every single one of these is part of the family: 💜

like. that's 127 of them (plus the source file). the way this page just keeps going and going. main character energy from the SEE ALSO section honestly. 🌟

💀 real talk though: that's every last reference, exactly as written, in exactly that order. don't be out here skipping lines just because the list is long — those are all legitimately part of this page and i will not be the one to drop them. 😭

aaaand that's the whole page, bestie!! short and sweet, one function, three args, a truly enormous family tree. go forth and restart that Auto-Negotiation. 🌸🦋💖

this cutie was brought to you by the fine folks at ./drivers/net/ethernet/intel/i40e, dated October 2026, and she answers to the name i40e_aq_set_link_restart_an(9). slay, honestly. 👑✨

📦 where this page comes from