STRUCT MACSEC_RX_SA(9)

💖 struct macsec_rx_sa(9) 💖

okay bestie, so this is a page from the Kernel API Manual, and it's all about struct macsec_rx_sa — literally the receive secure association. yes it's a struct, yes it's networking kernel stuff, and yes we're gonna get through it together 🫶

---

🌸 NAME 🌸

struct macsec_rx_sa — receive secure association. that's it, that's the whole name. iconic brevity ✨

---

🦋 SYNOPSIS 🦋

here's the whole shape of her, no cap, copy it exactly:

struct macsec_rx_sa {
    struct macsec_key key;
    ssci_t ssci;
    spinlock_t lock;
    union {
      pn_t next_pn_halves;
      u64 next_pn;
    };
    refcount_t refcnt;
    bool active;
    struct macsec_rx_sa_stats __percpu *stats;
    struct macsec_rx_sc *sc;
    struct rcu_work destroy_work;
 };

look at that anonymous union just vibing in the middle, main character energy fr fr 💅

---

🎀 Members 🎀

• key — the key structure. literally the key to the whole situation 🔑
• ssci — short secure channel identifier. short king behavior.
• lock — this one protects next_pn manipulations. she's the bodyguard, do not touch next_pn without her 💀
• {unnamed_union} — anonymous. that's it, that's the note. she simply has no name and we respect that 🙈
• next_pn — the packet number expected for the next packet. lowkey the most important field here, the anticipation is real 😭
• active — (no description given, she's mysterious, she contains multitudes ✨)
• stats — per-SA stats. numbers! we love a data girlie 🍓
• destroy_work — deferred work to free the SA in process context after the RCU grace period. okay so she doesn't just disappear immediately, she waits her turn politely after the RCU grace period, and then frees the SA in process context. so organized 👑

---

🌈 SEE ALSO 🌈

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

like a whole friend group honestly, go read them all, iykyk 🧚

---

ngl, if you skip the lock note you're gonna have a bad time. that's the vibe check. 💜

and that's the page bestie!! this one lives in ./include/net, dated October 2026, and it's filed under struct macsec_rx_sa(9) in the Kernel API Manual — slay, go read a struct, mwah 🎀💖🌸