dpni_get_primary_mac_addr(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dpni_get_primary_mac_addr(9) — kernel API manual, but make it make sense

okay bestie, so we're deep in the kernel API manual today (section 9, the fancy kernel-doc one, not the "type man ls" one) and the function we're vibing with is dpni_get_primary_mac_addr. Yes that's a mouthful. Yes it's iconic. Let's get into it 🎀

✨ NAME ✨

dpni_get_primary_mac_addr — get the primary MAC address 💌

That's it. That's the whole name section. It does exactly what it says on the tin, no cap.

✨ SYNOPSIS ✨

int dpni_get_primary_mac_addr (struct fsl_mc_io *mc_io , u32 cmd_flags ,
u16 token , u8 mac_addr[6] );

look at her. four arguments, returns an int, living her best life 🔥

✨ ARGUMENTS ✨

  • mc_io — pointer to the MC portal's I/O object 🌀 like, this is your portal handle, the whole connection vibe.
  • cmd_flags — command flags; one or more of 'MC_CMD_FLAG_' 🚩 (yes, plural girlies, you can stack 'em)
  • token — token of the DPNI object 🎫 your little ticket that says "yes, this DPNI, the one right here"
  • mac_addr — returned MAC address 👑 note the [6] — six whole bytes of MAC-address goodness get written back into this array, so have it ready, okay?
🫶 quick reminder: mac_addr is the returned value, it's an output, so don't be out here expecting your old contents to survive. It's giving "makeover" 💅

✨ RETURN ✨

okay so… the original page literally has nothing under RETURN 😭🙈 like the heading is there, the section is there, and then it's just vibes and empty space. So we're not gonna invent a return value for you — the docs said nothing and I'm not about to make something up. If you need to know what the int means, go read the source, bestie, that's the assignment 📚

✨ SEE ALSO ✨

first up, the actual code lives here — go thank her:

  • Kernel file ./drivers/net/ethernet/freescale/dpaa2/dpni.c 📂

and now the whole entire friend group 🙌 every single one of these, in order, no skips:

like, that's the whole extended universe, iykyk 🌈

🦋 and that's the page!! shoutout to the source/version line, which reads ./drivers/net/ethernet/freesca... (yes it's truncated in the original, we don't fix what we didn't break 💀), dated October 2026, all wrapped up under the title dpni_get_primary_mac_addr(9). mwah, go get that MAC address bestie 💖🌸
📦 where this page comes from