iavf_set_mac_sync(9)

📦 version 7.3.1, in nixpkgs unstable

💅 iavf_set_mac_sync — the "change my MAC, and wait for it" girlie

okay so this is iavf_set_mac_sync(9) from the Kernel API Manual, and honestly? she's a synchronous icon. no cap.

✨ NAME ✨

iavf_set_mac_sync — Synchronously change MAC address 🎀

🦋 SYNOPSIS 🦋

int iavf_set_mac_sync (struct iavf_adapter *adapter , const u8 *addr );

🌸 ARGUMENTS 🌸

  • adapter — board private structure. it's giving "the whole personality of the board", lowkey.
  • addr — MAC address to set. the new look. the rebrand. ✨

💖 DESCRIPTION 💖

bestie, here's the tea ☕: this function sends a MAC change request to the PF and then polls the admin queue for the response. she doesn't just fire-and-forget — she stays and waits for an answer. main character energy fr.

⚠️ ok important stuff, listen up: the caller must hold netdev_lock. no exceptions, no shortcuts, no "but it worked on my machine". please.

also — and I need you to hear me on this — this can sleep for up to 2.5 seconds 😭😭 like, an actual nap. so don't be calling her from somewhere spicy where sleeping is illegal.

and the cute part: the event buffer is allocated before sending, so you don't get a state mismatch if the allocation fails after the message already went to the PF. forward thinking queen 👑 that's what we call not creating chaos.

⭐ RETURN ⭐

  • 0 on success 💚
  • negative on failure 💀

🧚 SEE ALSO 🧚

the whole friend group, and yes, we're tagging everyone — the kernel file first:

  • Kernel file ./drivers/net/ethernet/intel/iavf/iavf_main.c

and now the group chat 💬 (all of these are (9) pages):

and that's the whole page, bestie 🫶 go forth, hold that lock, and don't sleep anywhere you're not allowed to sleep 💜

signed off from ./drivers/net/ethernet/intel/iavf, dated October 2026 — mwah 💋

📦 where this page comes from