STRUCT PRUETH(9)

💖 struct prueth(9) — the kernel API manual, bestie edition 💖

Okay so this page is from the struct prueth(9) manual, and it's literally the whole glow-up tour of struct prueth — the PRUeth structure. Yes, that's the NAME, and yes, it's an icon 👑

---

✨ NAME ✨

struct prueth — the PRUeth structure. That's it, that's the whole vibe. Main character energy for the TI ICSSG Ethernet driver 🦋

---

🌸 SYNOPSIS 🌸

Bestie, here's the whole struct, character for character. Don't touch anything, just look at it respectfully:

struct prueth {
    struct device *dev;
    struct pruss *pruss;
    struct rproc *pru[PRUSS_NUM_PRUS];
    struct rproc *rtu[PRUSS_NUM_PRUS];
    struct rproc *txpru[PRUSS_NUM_PRUS];
    struct pruss_mem_region shram;
    struct gen_pool *sram_pool;
    struct pruss_mem_region msmcram;
    struct device_node *eth_node[PRUETH_NUM_MACS];
    struct prueth_emac *emac[PRUETH_NUM_MACS];
    struct net_device *registered_netdevs[PRUETH_NUM_MACS];
    struct regmap *miig_rt;
    struct regmap *mii_rt;
    struct regmap *pa_stats;
    enum pruss_pru_id pru_id[PRUSS_NUM_PRUS];
    struct platform_device *pdev;
    struct prueth_pdata pdata;
    u8 icssg_hwcmdseq;
    int emacs_initialized;
    struct icss_iep *iep0;
    struct icss_iep *iep1;
    struct prueth_vlan_tbl *vlan_tbl;
    struct net_device *hw_bridge_dev;
    struct net_device *hsr_dev;
    enum hsr_version hsr_prp_version;
    u8 br_members;
    u8 hsr_members;
    struct notifier_block prueth_netdevice_nb;
    struct notifier_block prueth_switchdev_nb;
    struct notifier_block prueth_switchdev_bl_nb;
    bool is_switch_mode;
    bool is_hsr_offload_mode;
    bool is_switchmode_supported;
    unsigned char switch_id[MAX_PHYS_ITEM_ID_LEN];
    int default_vlan;
    spinlock_t vtbl_lock;
    spinlock_t stats_lock;
    struct icssg_firmwares icssg_emac_firmwares[PRUETH_NUM_MACS];
    struct icssg_firmwares icssg_switch_firmwares[PRUETH_NUM_MACS];
    struct icssg_firmwares icssg_hsr_firmwares[PRUETH_NUM_MACS];
    struct icssg_firmwares icssg_prp_firmwares[PRUETH_NUM_MACS];
 };

That's 40-ish fields of pure slay. Let's go through every single one 💅

---

🎀 Members 🎀

Every field, one by one. No skipping, no cap, we're doing the full tour:

• dev — the device. Yeah, that one.
• pruss — the pruss handle.
• pru — rproc instances of PRUs.
• rtu — rproc instances of RTUs.
• txpru — rproc instances of TX_PRUs. (Yes bestie, TX_PRUs are their own thing, don't @ me.)
• shram — the PRUSS shared RAM region.
• sram_pool — the MSMC RAM pool for buffers.
• msmcram — the MSMC RAM region.
• eth_node — DT node for the port.
• emac — the private EMAC data structure. It's giving private. 🙈
• registered_netdevs — list of registered netdevs.
• miig_rt — regmap to the mii_g_rt block.
• mii_rt — regmap to the mii_rt block.
• pa_stats — regmap to the pa_stats block.
• pru_id — ID for each of the PRUs.
• pdev — pointer to the ICSSG platform device.
• pdata — pointer to platform data for the ICSSG driver.
• icssg_hwcmdseq — seq counter or HWQ messages. (That's what it says, fr fr.)
• emacs_initialized — num of EMACs/ext ports that are up/running. Count 'em 👑
• iep0 — pointer to the IEP0 device.
• iep1 — pointer to the IEP1 device. (Sibling energy ✨)
• vlan_tbl — VLAN-FID table pointer.
• hw_bridge_dev — pointer to the HW bridge net device.
• hsr_dev — pointer to the HSR net device.
• hsr_prp_version — enum to store the protocol version of the hsr master.
• br_members — bitmask of bridge member ports.
• hsr_members — bitmask of hsr member ports.
• prueth_netdevice_nb — netdevice notifier block.
• prueth_switchdev_nb — switchdev notifier block.
• prueth_switchdev_bl_nb — switchdev blocking notifier block. (Blocking! Not like that, it's the notifier type 💀)
• is_switch_mode — flag to indicate if the device is in Switch mode.
• is_hsr_offload_mode — flag to indicate if the device is in hsr offload mode.
• is_switchmode_supported — indicates platform support for switch mode.
• switch_id — ID for mapping switch ports to bridge. Sized MAX_PHYS_ITEM_ID_LEN, iykyk.
• default_vlan — Default VLAN for host.
• vtbl_lock — Lock for vtbl in shared memory.
• stats_lock — Lock for reading icssg stats.
• icssg_emac_firmwares — Firmware names for EMAC mode, indexed per MAC.
• icssg_switch_firmwares — Firmware names for SWITCH mode, indexed per MAC.
• icssg_hsr_firmwares — Firmware names for HSR mode, indexed per MAC.
• icssg_prp_firmwares — Firmware names for PRP mode, indexed per MAC.

Not me listing every single field 😭 but that's literally the whole point of this page — every member matters, bestie. No gatekeeping the struct.

---

🦋 SEE ALSO 🦋

Go peek at these, they're lowkey essential:

• Kernel file ./drivers/net/ethernet/ti/icssg/icssg_prueth.h
• struct prueth_pdata(9)

---

✨ That's the whole page, bestie ✨ This one came from ./drivers/net/ethernet/ti/icssg, dated October 2026, and it's filed under struct prueth(9). Periodt. 🫶💜