STRUCT IDPF_PTP_SECONDARY_MBX(9)

💌 struct idpf_ptp_secondary_mbx(9) — from the Kernel API Manual, bestie

okay so picture this: it's a man page, it's living in the Kernel API Manual, and its whole entire personality is being the struct that holds the PTP secondary mailbox info. that's it. that's the vibe. it's giving "small but crucial" and honestly? iconic. ✨

---

🌸 NAME 🌸

struct idpf_ptp_secondary_mbx — the PTP secondary mailbox, no cap 💅

🎀 SYNOPSIS 🎀

here's the whole glow-up, copied exactly because we do not play with code:

struct idpf_ptp_secondary_mbx {
    u16 peer_mbx_q_id;
    u16 peer_id;
    bool valid:1;
 };

she's short, she's sweet, she's three fields and a dream 🦋

✨ Members ✨

bestie, let me introduce you to the cast 👑

• peer_mbx_q_id — the PTP mailbox queue ID. literally just the queue ID for the PTP mailbox. that's her job. 🎀
• peer_id — the Peer ID, and it's for the PTP Device Control daemon. so like, when the daemon needs to know who its peer is, this is the field it's looking at. iykyk 💖
• valid — a bool:1 that indicates whether the secondary mailbox is supported by the Control Plane. so basically it's the little flag that goes "yes bestie, Control Plane's got us" or "nope, not supported." (also yes, the original spells it "mailblox" and honestly? we stan a typo that ate 🙈💀 — the meaning is still mailbox.)

quick vibe check: valid is a 1-bit field, so she is tiny but she is load-bearing. do not sleep on her. 🫶

---

🔥 SEE ALSO 🔥

go read these next, they're all in the same friend group, all from the kernel file ./drivers/net/ethernet/intel/idpf/idpf_ptp.h:

• struct idpf_ptp_cmd(9)
• enum idpf_ptp_access(9)
• enum idpf_ptp_tx_tstamp_state(9)
• struct idpf_ptp_tx_tstamp_status(9)
• struct idpf_ptp_tx_tstamp(9)
• struct idpf_ptp_vport_tx_tstamp_caps(9)
• struct idpf_ptp(9)
• idpf_ptp_info_to_adapter(9)
• struct idpf_ptp_dev_timers(9)
• idpf_ptp_is_vport_tx_tstamp_ena(9)
• idpf_ptp_is_vport_rx_tstamp_ena(9)

like, the whole PTP cinematic universe fr fr 🌈⭐

---

and that's the page, bestie!! 💜 this little beauty lives over in ./drivers/net/ethernet/intel/idpf, and this edition of the Kernel API Manual is dated October 2026 — so like, future energy but make it Linux 🧚✨ mwah, go read the source, ily, bye!! 🎀💖