STRUCT MACSEC_CONTEXT(9)

✨ struct macsec_context(9) ✨

okay so bestie, welcome to struct macsec_context — this is the page from the Kernel API Manual and it's giving "the little struct that carries all your MACsec offloading vibes." 🎀 It's the context struct for MACsec hardware offloading. Like, it's the bag you hand to your driver so it knows what's up. Periodt. 💅

---

🌸 NAME 🌸

struct macsec_context — MACsec context for hardware offloading 💖

---

🦋 SYNOPSIS 🦋

struct macsec_context {
    union {
      struct net_device *netdev;
      struct phy_device *phydev;
    };
    enum macsec_offload offload;
    struct macsec_secy *secy;
    struct macsec_rx_sc *rx_sc;
    struct {
      bool update_pn;
      unsigned char assoc_num;
      u8 key[MACSEC_MAX_KEY_LEN];
      union {
        struct macsec_rx_sa *rx_sa;
        struct macsec_tx_sa *tx_sa;
      };
    } sa;
    union {
      struct macsec_tx_sc_stats *tx_sc_stats;
      struct macsec_tx_sa_stats *tx_sa_stats;
      struct macsec_rx_sc_stats *rx_sc_stats;
      struct macsec_rx_sa_stats *rx_sa_stats;
      struct macsec_dev_stats  *dev_stats;
    } stats;
 };

like… look at her. iconic layout, no notes. 🔥

---

🎀 Members 🎀

so here's the member-by-member vibe check, bestie — every single one, no skips:

• {unnamed_union} — anonymous 🙈 (yes, the page literally just says "anonymous" and honestly? same energy)
• netdev — a valid pointer to a struct net_device if offload == MACSEC_OFFLOAD_MAC ✨
• phydev — a valid pointer to a struct phy_device if offload == MACSEC_OFFLOAD_PHY ✨
• offload — MACsec offload status 💫
• secy — pointer to a MACsec SecY 👑
• rx_sc — pointer to a RX SC 🌈
• {unnamed_union} — anonymous 🙈 (round two, she's back)

ngl the takeaway is: the union up top is a pick-your-fighter between netdev and phydev, and which one you get is literally decided by offload. iykyk 💀

heads up bestie: the doc as written only spells out the members above — the sa bit and the stats union are right there in the struct, so read 'em straight from the synopsis and don't let anyone tell you otherwise 🫶

---

🌟 SEE ALSO 🌟

• Kernel file ./include/net/macsec.h
• struct macsec_key(9)
• struct macsec_rx_sa(9)
• struct macsec_rx_sc(9)
• struct macsec_tx_sa(9)
• struct macsec_tx_sc(9)
• struct macsec_secy(9)
• struct macsec_ops(9)

like a whole friend group of structs, and you should absolutely go meet all of them 💜

---

and that's the whole page, bestie — sourced from ./include/net, dated October 2026, and filed under struct macsec_context(9) forever and ever. slay, drink water, go offload something safely 🧚💖✨