i40e_aq_erase_nvm(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’Ύ i40e_aq_erase_nvm β€” bestie's guide to nuking an NVM sector ✨

okay so this is a page from the Kernel API Manual (section 9, the kernel-api girlies πŸŽ€) and it's all about i40e_aq_erase_nvm. Deep breath, it's literally just one function, you got this 🫢

πŸ“› NAME

so the original manpage leaves this completely blank after i40e_aq_erase_nvm - 😭 which is giving "left on read" energy, but ngl the function name tells you everything: it erases a chunk of NVM. That's the vibe. Periodt.

✨ SYNOPSIS

int i40e_aq_erase_nvm (struct i40e_hw *hw , u8 module_pointer , u32
offset , u16 length , bool last_command , struct i40e_asq_cmd_details
*cmd_details );

that's the whole signature, copy it exactly, do not freestyle it πŸ’…

🧸 ARGUMENTS

  • hw β€” pointer to the hw struct. yes, the whole hardware struct. she's the main character of this entire driver πŸ”₯
  • module_pointer β€” the module pointer location, measured in words from the beginning of the NVM. words, not bytes, ok bestie? don't come at me with bytes πŸ™ˆ
  • offset β€” the offset within the module, and it's expressed in 4 KB units from the module's beginning. so it's giving chunky granularity, everything moves in 4 KB steps πŸ¦‹
  • length β€” how long the section you're erasing is, also expressed in 4 KB. so length Γ— 4 KB = how much NVM is about to get got πŸ’€
  • last_command β€” a bool that tells the firmware if this is the last command in a series. it's the "and that's a wrap" flag 🎬
  • cmd_details β€” pointer to the command details structure, or NULL. both are valid, we love options ✨

🌸 DESCRIPTION

Erase the NVM sector using the admin queue commands.

that's it. that's the whole description. short and iconic πŸ‘‘

real talk though: this is an erase, not a read. once that sector is gone it's gone, so make sure your module_pointer, offset, and length math is actually correct before you send this one 🚨

πŸ‘€ SEE ALSO

look, this girl knows everyone. the whole friend group, in the original order, no cap 🫢


and that's the whole page bestie πŸ’– this one lives in ./drivers/net/ethernet/intel/i40e, it's dated October 2026, and it still answers to i40e_aq_erase_nvm(9) β€” go erase responsibly, mwah πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from