xref: /linux/Documentation/networking/net_cachelines/net_device.rst (revision f72aa1b276281b4e4f75261af8425bc99d903f3e)
1.. SPDX-License-Identifier: GPL-2.0
2.. Copyright (C) 2023 Google LLC
3
4===========================================
5net_device struct fast path usage breakdown
6===========================================
7
8=================================== =========================== =================== =================== ===================================================================================
9Type                                Name                        fastpath_tx_access  fastpath_rx_access  Comments
10=================================== =========================== =================== =================== ===================================================================================
11unsigned_long:32                    priv_flags                  read_mostly                             __dev_queue_xmit(tx)
12unsigned_long:1                     lltx                        read_mostly                             HARD_TX_LOCK,HARD_TX_TRYLOCK,HARD_TX_UNLOCK(tx)
13char                                name[16]
14struct netdev_name_node*            name_node
15struct dev_ifalias*                 ifalias
16unsigned_long                       mem_end
17unsigned_long                       mem_start
18unsigned_long                       base_addr
19unsigned_long                       state                       read_mostly         read_mostly         netif_running(dev)
20struct list_head                    dev_list
21struct list_head                    napi_list
22struct list_head                    unreg_list
23struct list_head                    close_list
24struct list_head                    ptype_all                   read_mostly                             dev_nit_active(tx)
25struct list_head                    ptype_specific                                  read_mostly         deliver_ptype_list_skb/__netif_receive_skb_core(rx)
26struct                              adj_list
27unsigned_int                        flags                       read_mostly         read_mostly         __dev_queue_xmit,__dev_xmit_skb,ip6_output,__ip6_finish_output(tx);ip6_rcv_core(rx)
28xdp_features_t                      xdp_features
29struct net_device_ops*              netdev_ops                  read_mostly                             netdev_core_pick_tx,netdev_start_xmit(tx)
30struct xdp_metadata_ops*            xdp_metadata_ops
31int                                 ifindex                                         read_mostly         ip6_rcv_core
32unsigned_short                      gflags
33unsigned_short                      hard_header_len             read_mostly         read_mostly         ip6_xmit(tx);gro_list_prepare(rx)
34unsigned_int                        mtu                         read_mostly                             ip_finish_output2
35unsigned_short                      needed_headroom             read_mostly                             LL_RESERVED_SPACE/ip_finish_output2
36unsigned_short                      needed_tailroom
37netdev_features_t                   features                    read_mostly         read_mostly         HARD_TX_LOCK,netif_skb_features,sk_setup_caps(tx);netif_elide_gro(rx)
38netdev_features_t                   hw_features
39netdev_features_t                   wanted_features
40netdev_features_t                   vlan_features
41netdev_features_t                   hw_enc_features                                                     netif_skb_features
42netdev_features_t                   mpls_features
43netdev_features_t                   gso_partial_features        read_mostly                             gso_features_check
44unsigned_int                        min_mtu
45unsigned_int                        max_mtu
46unsigned_short                      type
47unsigned_char                       min_header_len
48unsigned_char                       name_assign_type
49int                                 group
50struct net_device_stats             stats
51struct net_device_core_stats*       core_stats
52atomic_t                            carrier_up_count
53atomic_t                            carrier_down_count
54struct iw_handler_def*              wireless_handlers
55struct ethtool_ops*                 ethtool_ops
56struct l3mdev_ops*                  l3mdev_ops
57struct ndisc_ops*                   ndisc_ops
58struct xfrmdev_ops*                 xfrmdev_ops
59struct tlsdev_ops*                  tlsdev_ops
60struct header_ops*                  header_ops                  read_mostly                             ip_finish_output2,ip6_finish_output2(tx)
61unsigned_char                       operstate
62unsigned_char                       link_mode
63unsigned_char                       if_port
64unsigned_char                       dma
65unsigned_char                       perm_addr[32]
66unsigned_char                       addr_assign_type
67unsigned_char                       addr_len
68unsigned_char                       upper_level
69unsigned_char                       lower_level
70unsigned_short                      neigh_priv_len
71unsigned_short                      padded
72unsigned_short                      dev_id
73unsigned_short                      dev_port
74spinlock_t                          addr_list_lock
75int                                 irq
76struct netdev_hw_addr_list          uc
77struct netdev_hw_addr_list          mc
78struct netdev_hw_addr_list          dev_addrs
79struct kset*                        queues_kset
80struct list_head                    unlink_list
81unsigned_int                        promiscuity
82unsigned_int                        allmulti
83bool                                uc_promisc
84unsigned_char                       nested_level
85struct in_device*                   ip_ptr                      read_mostly         read_mostly         __in_dev_get
86struct hlist_head                   fib_nh_head
87struct inet6_dev*                   ip6_ptr                     read_mostly         read_mostly         __in6_dev_get
88struct vlan_info*                   vlan_info
89struct dsa_port*                    dsa_ptr
90struct tipc_bearer*                 tipc_ptr
91void*                               atalk_ptr
92void*                               ax25_ptr
93struct wireless_dev*                ieee80211_ptr
94struct wpan_dev*                    ieee802154_ptr
95struct mpls_dev*                    mpls_ptr
96struct mctp_dev*                    mctp_ptr
97unsigned_char*                      dev_addr
98struct netdev_queue*                _rx                         read_mostly                             netdev_get_rx_queue(rx)
99unsigned_int                        num_rx_queues
100unsigned_int                        real_num_rx_queues                              read_mostly         get_rps_cpu
101struct bpf_prog*                    xdp_prog                                        read_mostly         netif_elide_gro()
102unsigned_long                       gro_flush_timeout                               read_mostly         napi_complete_done
103u32                                 napi_defer_hard_irqs                            read_mostly         napi_complete_done
104unsigned_int                        gro_max_size                                    read_mostly         skb_gro_receive
105unsigned_int                        gro_ipv4_max_size                               read_mostly         skb_gro_receive
106rx_handler_func_t*                  rx_handler                  read_mostly                             __netif_receive_skb_core
107void*                               rx_handler_data             read_mostly
108struct netdev_queue*                ingress_queue               read_mostly
109struct bpf_mprog_entry              tcx_ingress                                     read_mostly         sch_handle_ingress
110struct nf_hook_entries*             nf_hooks_ingress
111unsigned_char                       broadcast[32]
112struct cpu_rmap*                    rx_cpu_rmap
113struct hlist_node                   index_hlist
114struct netdev_queue*                _tx                         read_mostly                             netdev_get_tx_queue(tx)
115unsigned_int                        num_tx_queues
116unsigned_int                        real_num_tx_queues          read_mostly                             skb_tx_hash,netdev_core_pick_tx(tx)
117unsigned_int                        tx_queue_len
118spinlock_t                          tx_global_lock
119struct xdp_dev_bulk_queue__percpu*  xdp_bulkq
120struct xps_dev_maps*                xps_maps[2]                 read_mostly                             __netif_set_xps_queue
121struct bpf_mprog_entry              tcx_egress                  read_mostly                             sch_handle_egress
122struct nf_hook_entries*             nf_hooks_egress             read_mostly
123struct hlist_head                   qdisc_hash[16]
124struct timer_list                   watchdog_timer
125int                                 watchdog_timeo
126u32                                 proto_down_reason
127struct list_head                    todo_list
128int__percpu*                        pcpu_refcnt
129refcount_t                          dev_refcnt
130struct ref_tracker_dir              refcnt_tracker
131struct list_head                    link_watch_list
132enum:8                              reg_state
133bool                                dismantle
134enum:16                             rtnl_link_state
135bool                                needs_free_netdev
136void*priv_destructor                struct net_device
137struct netpoll_info*                npinfo                                          read_mostly         napi_poll/napi_poll_lock
138possible_net_t                      nd_net                                          read_mostly         (dev_net)napi_busy_loop,tcp_v(4/6)_rcv,ip(v6)_rcv,ip(6)_input,ip(6)_input_finish
139void*                               ml_priv
140enum_netdev_ml_priv_type            ml_priv_type
141struct pcpu_lstats__percpu*         lstats                      read_mostly                             dev_lstats_add()
142struct pcpu_sw_netstats__percpu*    tstats                      read_mostly                             dev_sw_netstats_tx_add()
143struct pcpu_dstats__percpu*         dstats
144struct garp_port*                   garp_port
145struct mrp_port*                    mrp_port
146struct dm_hw_stat_delta*            dm_private
147struct device                       dev
148struct attribute_group*             sysfs_groups[4]
149struct attribute_group*             sysfs_rx_queue_group
150struct rtnl_link_ops*               rtnl_link_ops
151unsigned_int                        gso_max_size                read_mostly                             sk_dst_gso_max_size
152unsigned_int                        tso_max_size
153u16                                 gso_max_segs                read_mostly                             gso_max_segs
154u16                                 tso_max_segs
155unsigned_int                        gso_ipv4_max_size           read_mostly                             sk_dst_gso_max_size
156struct dcbnl_rtnl_ops*              dcbnl_ops
157s16                                 num_tc                      read_mostly                             skb_tx_hash
158struct netdev_tc_txq                tc_to_txq[16]               read_mostly                             skb_tx_hash
159u8                                  prio_tc_map[16]
160unsigned_int                        fcoe_ddp_xid
161struct netprio_map*                 priomap
162struct phy_device*                  phydev
163struct sfp_bus*                     sfp_bus
164struct lock_class_key*              qdisc_tx_busylock
165bool                                proto_down
166unsigned:1                          wol_enabled
167unsigned:1                          threaded                                                            napi_poll(napi_enable,dev_set_threaded)
168unsigned_long:1                     see_all_hwtstamp_requests
169unsigned_long:1                     change_proto_down
170unsigned_long:1                     netns_local
171unsigned_long:1                     fcoe_mtu
172struct list_head                    net_notifier_list
173struct macsec_ops*                  macsec_ops
174struct udp_tunnel_nic_info*         udp_tunnel_nic_info
175struct udp_tunnel_nic*              udp_tunnel_nic
176unsigned_int                        xdp_zc_max_segs
177struct bpf_xdp_entity               xdp_state[3]
178u8                                  dev_addr_shadow[32]
179netdevice_tracker                   linkwatch_dev_tracker
180netdevice_tracker                   watchdog_dev_tracker
181netdevice_tracker                   dev_registered_tracker
182struct rtnl_hw_stats64*             offload_xstats_l3
183struct devlink_port*                devlink_port
184struct dpll_pin*                    dpll_pin
185struct hlist_head                   page_pools
186struct dim_irq_moder*               irq_moder
187u64                                 max_pacing_offload_horizon
188struct_napi_config*                 napi_config
189unsigned_long                       gro_flush_timeout
190u32                                 napi_defer_hard_irqs
191=================================== =========================== =================== =================== ===================================================================================
192