STRUCT DPMAC_LINK_STATE(9)

💅 struct dpmac_link_state(9) — from the Kernel API Manual, bestie 🎀

okay so picture this: it's a struct, right? and it's literally the whole vibe of a DPMAC link configuration request. that's it, that's the name. we're in the Kernel API Manual and this little guy is the main character. ✨

---

🌸 NAME 🌸

struct dpmac_link_state — the DPMAC link configuration request itself, no cap. it's the little bundle you hand over when you wanna ask for a link setup. 🫶

---

✨ SYNOPSIS ✨

here's the whole thing laid out, and yes we're keeping every field exactly as-is because we do not edit the source:

struct dpmac_link_state {
    u32 rate;
    u64 options;
    int up;
    int state_valid;
    u64 supported;
    u64 advertising;
 };

look at her. six fields. absolutely iconic. 💅

---

🦋 Members 🦋

so each one of these does a very specific job and i'm gonna walk you through them one by one, no skipping, periodt:

• rate — the rate in Mbps. yes, megabits per second. that's the number, that's the speed. 📶
• options — a bitmap for Enable/Disable DPMAC link cfg features. it's giving "little switches packed into one number" energy. iykyk. 🎛️
• up — the link state. is it up? is it not? that's the whole question. 🔼
• state_valid — tells you whether to Ignore/Update the state of the link. so basically it's the "do we trust this or not" flag. 🙈
• supported — a bitmap of the speeds capability of the phy. like, what can this phy actually do, bestie. 💪
• advertising — a bitmap of the speeds that are advertised for autoneg</sl> — sorry, speeds that are advertised for autoneg. so what we're out here telling the other side we're down for. 📣

tiny reminder: options, supported and advertising are all bitmaps, so you're packing a bunch of on/off facts into one value. don't read them like plain numbers, fr fr. 🧚

---

👑 SEE ALSO 👑

go check these out too, they all live together in the same little neighborhood:

• the kernel file ./drivers/net/ethernet/freescale/dpaa2/dpmac.h
• enum dpmac_link_type(9)
• enum dpmac_eth_if(9)
• struct dpmac_attr(9)
• enum dpmac_counter_id(9)

---

🎀 the cute sign-off 🎀

this little page came from ./drivers/net/ethernet/freesca... and it's dated October 2026, and the whole thing is filed under struct dpmac_link_state(9). slay, go configure some links, bestie 💖🦋⭐