octep_ctrl_net_set_mac_addr(9)

📦 version 7.3.1, in nixpkgs unstable

💅 octep_ctrl_net_set_mac_addr — Kernel API Manual, bestie edition ✨

okay so real talk: you're looking at octep_ctrl_net_set_mac_addr(9), live from the Kernel API Manual section 9, and she is exactly what it says on the tin — this is the function that slides a MAC address into the firmware. no cap. 🎀

🌸 NAME 🌸

octep_ctrl_net_set_mac_addr — set the MAC address in the firmware. that's the whole job, and she does it. 🦋

✨ SYNOPSIS ✨

int octep_ctrl_net_set_mac_addr (struct octep_device *oct , int vfid ,
       u8 *addr , bool wait_for_response );

like, copy that exactly, don't get creative with it 🙈

🫶 ARGUMENTS 🫶

  • oct — non-null pointer to struct octep_device. non-null, bestie, I'm serious, she said non-null.
  • vfid — index of the virtual function. it's giving "which VF are we talking about" energy 🔥
  • addr — non-null pointer to the MAC address. also non-null. two non-nulls in one function, we love a consistent queen 👑
  • wait_for_response — poll for response. yes, it's a bool, yes, it does the thing it says 🌈

💖 DESCRIPTION 💖

return value: 0 on success, -errno on failure. that's it, that's the description, she's short and iconic 💅

ngl the whole spec is basically "give me a valid device, a valid address pointer, and tell me whether to poll" — and if it goes sideways you get a negative errno back. periodt.

🔥 SEE ALSO 🔥

the kernel file in question, for the curious:

  • ./drivers/net/ethernet/marvell/octeon_ep/octep_ctrl_net.h

and the whole friend group, alphabetically-ish, all in section 9 because they're a package deal 🧚:

and that's the page!! 🍓 sign-off time: this one came from ./drivers/net/ethernet/marvell..., dated October 2026, and it's literally titled octep_ctrl_net_set_mac_addr(9). slay, go set some MAC addresses, ily, bye 💜

📦 where this page comes from