STRUCT NET_LOCAL(9)

💖 struct net_local(9) 💖

okay so this is a page from the Kernel API Manual, and it's all about struct net_local — literally our private per device data. yes bestie, "our" — it's the driver's own lil stash of stuff it needs to remember about each device 🎀

✨ SYNOPSIS ✨

struct net_local {
    struct net_device *ndev;
    bool tx_ping_pong;
    bool rx_ping_pong;
    u32 next_tx_buf_to_use;
    u32 next_rx_buf_to_use;
    void __iomem *base_addr;
    spinlock_t reset_lock;
    struct sk_buff *deferred_skb;
    struct phy_device *phy_dev;
    struct device_node *phy_node;
    struct mii_bus *mii_bus;
    int last_link;
 };

like, that's the whole struct, she's not huge but she's doing a LOT 💅

🌸 Members 🌸

• ndev — the instance of the network device. the main character, fr fr 👑
• tx_ping_pong — tells you whether the Tx Pong buffer is configured in HW 🏓
• rx_ping_pong — tells you whether the Rx Pong buffer is configured in HW. yep, matching energy 🏓
• next_tx_buf_to_use — the next Tx buffer to write to ✍️
• next_rx_buf_to_use — the next Rx buffer to read from 👀
• base_addr — base address of the Emaclite device 📍
• reset_lock — lock to serialize xmit and tx_timeout execution. no cap, nobody's cutting in line 🔒
• deferred_skb — holds an skb (for transmission at a later time) when the Tx buffer is not free 😭 like sorry babe, you're gonna have to wait
• phy_dev — pointer to the PHY device 🦋
• phy_node — pointer to the PHY device node 🌸
• mii_bus — pointer to the MII bus 🚌
• last_link — last link status. keeping receipts on the link, always 📝

🌈 SEE ALSO 🌈

Kernel file ./drivers/net/ethernet/xilinx/xilinx_emaclite.c — that's the whole vibe, iykyk 💜

and then, in no particular order but like, ALL of them (do not skip, we don't do that here):

• xemaclite_enable_interrupts(9)
• xemaclite_disable_interrupts(9)
• xemaclite_aligned_write(9)
• xemaclite_aligned_read(9)
• xemaclite_send_data(9)
• xemaclite_recv_data(9)
• xemaclite_update_address(9)
• xemaclite_set_mac_address(9)
• xemaclite_tx_timeout(9)
• xemaclite_tx_handler(9)
• xemaclite_rx_handler(9)
• xemaclite_interrupt(9)
• xemaclite_mdio_wait(9)
• xemaclite_mdio_read(9)
• xemaclite_mdio_write(9)
• xemaclite_mdio_setup(9)
• xemaclite_adjust_link(9)
• xemaclite_open(9)
• xemaclite_close(9)
• xemaclite_send(9)
• get_bool(9)
• xemaclite_ethtools_get_drvinfo(9)
• xemaclite_of_probe(9)
• xemaclite_of_remove(9)

like, that's the entire friend group right there 🫶

ok that's the page!! 💖 it came from ./drivers/net/ethernet/xilinx, dated October 2026, and it's page struct net_local(9) of the Kernel API Manual. go forth and slay ur network driver bestie ✨🎀🦋