xref: /linux/Documentation/networking/net_cachelines/net_device.rst (revision 9410645520e9b820069761f3450ef6661418e279)
1.. SPDX-License-Identifier: GPL-2.0
2.. Copyright (C) 2023 Google LLC
3
4===========================================
5net_device struct fast path usage breakdown
6===========================================
7
8Type                                Name                    fastpath_tx_access  fastpath_rx_access  Comments
9..struct                            ..net_device
10unsigned_long:32                    priv_flags              read_mostly         -                   __dev_queue_xmit(tx)
11unsigned_long:1                     lltx                    read_mostly         -                   HARD_TX_LOCK,HARD_TX_TRYLOCK,HARD_TX_UNLOCK(tx)
12char                                name[16]                -                   -
13struct_netdev_name_node*            name_node
14struct_dev_ifalias*                 ifalias
15unsigned_long                       mem_end
16unsigned_long                       mem_start
17unsigned_long                       base_addr
18unsigned_long                       state                   read_mostly         read_mostly         netif_running(dev)
19struct_list_head                    dev_list
20struct_list_head                    napi_list
21struct_list_head                    unreg_list
22struct_list_head                    close_list
23struct_list_head                    ptype_all               read_mostly         -                   dev_nit_active(tx)
24struct_list_head                    ptype_specific                              read_mostly         deliver_ptype_list_skb/__netif_receive_skb_core(rx)
25struct                              adj_list
26unsigned_int                        flags                   read_mostly         read_mostly         __dev_queue_xmit,__dev_xmit_skb,ip6_output,__ip6_finish_output(tx);ip6_rcv_core(rx)
27xdp_features_t                      xdp_features
28struct_net_device_ops*              netdev_ops              read_mostly         -                   netdev_core_pick_tx,netdev_start_xmit(tx)
29struct_xdp_metadata_ops*            xdp_metadata_ops
30int                                 ifindex                 -                   read_mostly         ip6_rcv_core
31unsigned_short                      gflags
32unsigned_short                      hard_header_len         read_mostly         read_mostly         ip6_xmit(tx);gro_list_prepare(rx)
33unsigned_int                        mtu                     read_mostly         -                   ip_finish_output2
34unsigned_short                      needed_headroom         read_mostly         -                   LL_RESERVED_SPACE/ip_finish_output2
35unsigned_short                      needed_tailroom
36netdev_features_t                   features                read_mostly         read_mostly         HARD_TX_LOCK,netif_skb_features,sk_setup_caps(tx);netif_elide_gro(rx)
37netdev_features_t                   hw_features
38netdev_features_t                   wanted_features
39netdev_features_t                   vlan_features
40netdev_features_t                   hw_enc_features         -                   -                   netif_skb_features
41netdev_features_t                   mpls_features
42netdev_features_t                   gso_partial_features    read_mostly                             gso_features_check
43unsigned_int                        min_mtu
44unsigned_int                        max_mtu
45unsigned_short                      type
46unsigned_char                       min_header_len
47unsigned_char                       name_assign_type
48int                                 group
49struct_net_device_stats             stats
50struct_net_device_core_stats*       core_stats
51atomic_t                            carrier_up_count
52atomic_t                            carrier_down_count
53struct_iw_handler_def*              wireless_handlers
54struct_iw_public_data*              wireless_data
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_inet6_dev*                   ip6_ptr                 read_mostly         read_mostly         __in6_dev_get
87struct_vlan_info*                   vlan_info
88struct_dsa_port*                    dsa_ptr
89struct_tipc_bearer*                 tipc_ptr
90void*                               atalk_ptr
91void*                               ax25_ptr
92struct_wireless_dev*                ieee80211_ptr
93struct_wpan_dev*                    ieee802154_ptr
94struct_mpls_dev*                    mpls_ptr
95struct_mctp_dev*                    mctp_ptr
96unsigned_char*                      dev_addr
97struct_netdev_queue*                _rx                     read_mostly         -                   netdev_get_rx_queue(rx)
98unsigned_int                        num_rx_queues
99unsigned_int                        real_num_rx_queues      -                   read_mostly         get_rps_cpu
100struct_bpf_prog*                    xdp_prog                -                   read_mostly         netif_elide_gro()
101unsigned_long                       gro_flush_timeout       -                   read_mostly         napi_complete_done
102u32                                 napi_defer_hard_irqs    -                   read_mostly         napi_complete_done
103unsigned_int                        gro_max_size            -                   read_mostly         skb_gro_receive
104unsigned_int                        gro_ipv4_max_size       -                   read_mostly         skb_gro_receive
105rx_handler_func_t*                  rx_handler              read_mostly         -                   __netif_receive_skb_core
106void*                               rx_handler_data         read_mostly         -
107struct_netdev_queue*                ingress_queue           read_mostly         -
108struct_bpf_mprog_entry              tcx_ingress             -                   read_mostly         sch_handle_ingress
109struct_nf_hook_entries*             nf_hooks_ingress
110unsigned_char                       broadcast[32]
111struct_cpu_rmap*                    rx_cpu_rmap
112struct_hlist_node                   index_hlist
113struct_netdev_queue*                _tx                     read_mostly         -                   netdev_get_tx_queue(tx)
114unsigned_int                        num_tx_queues           -                   -
115unsigned_int                        real_num_tx_queues      read_mostly         -                   skb_tx_hash,netdev_core_pick_tx(tx)
116unsigned_int                        tx_queue_len
117spinlock_t                          tx_global_lock
118struct_xdp_dev_bulk_queue__percpu*  xdp_bulkq
119struct_xps_dev_maps*                xps_maps[2]             read_mostly         -                   __netif_set_xps_queue
120struct_bpf_mprog_entry              tcx_egress              read_mostly         -                   sch_handle_egress
121struct_nf_hook_entries*             nf_hooks_egress         read_mostly         -
122struct_hlist_head                   qdisc_hash[16]
123struct_timer_list                   watchdog_timer
124int                                 watchdog_timeo
125u32                                 proto_down_reason
126struct_list_head                    todo_list
127int__percpu*                        pcpu_refcnt
128refcount_t                          dev_refcnt
129struct_ref_tracker_dir              refcnt_tracker
130struct_list_head                    link_watch_list
131enum:8                              reg_state
132bool                                dismantle
133enum:16                             rtnl_link_state
134bool                                needs_free_netdev
135void*priv_destructor                struct_net_device
136struct_netpoll_info*                npinfo                  -                   read_mostly         napi_poll/napi_poll_lock
137possible_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
138void*                               ml_priv
139enum_netdev_ml_priv_type            ml_priv_type
140struct_pcpu_lstats__percpu*         lstats                  read_mostly                             dev_lstats_add()
141struct_pcpu_sw_netstats__percpu*    tstats                  read_mostly                             dev_sw_netstats_tx_add()
142struct_pcpu_dstats__percpu*         dstats
143struct_garp_port*                   garp_port
144struct_mrp_port*                    mrp_port
145struct_dm_hw_stat_delta*            dm_private
146struct_device                       dev                     -                   -
147struct_attribute_group*             sysfs_groups[4]
148struct_attribute_group*             sysfs_rx_queue_group
149struct_rtnl_link_ops*               rtnl_link_ops
150unsigned_int                        gso_max_size            read_mostly         -                   sk_dst_gso_max_size
151unsigned_int                        tso_max_size
152u16                                 gso_max_segs            read_mostly         -                   gso_max_segs
153u16                                 tso_max_segs
154unsigned_int                        gso_ipv4_max_size       read_mostly         -                   sk_dst_gso_max_size
155struct_dcbnl_rtnl_ops*              dcbnl_ops
156s16                                 num_tc                  read_mostly         -                   skb_tx_hash
157struct_netdev_tc_txq                tc_to_txq[16]           read_mostly         -                   skb_tx_hash
158u8                                  prio_tc_map[16]
159unsigned_int                        fcoe_ddp_xid
160struct_netprio_map*                 priomap
161struct_phy_device*                  phydev
162struct_sfp_bus*                     sfp_bus
163struct_lock_class_key*              qdisc_tx_busylock
164bool                                proto_down
165unsigned:1                          wol_enabled
166unsigned:1                          threaded                -                   -                   napi_poll(napi_enable,dev_set_threaded)
167unsigned_long:1                     see_all_hwtstamp_requests
168unsigned_long:1                     change_proto_down
169unsigned_long:1                     netns_local
170unsigned_long:1                     fcoe_mtu
171struct_list_head                    net_notifier_list
172struct_macsec_ops*                  macsec_ops
173struct_udp_tunnel_nic_info*         udp_tunnel_nic_info
174struct_udp_tunnel_nic*              udp_tunnel_nic
175unsigned_int                        xdp_zc_max_segs
176struct_bpf_xdp_entity               xdp_state[3]
177u8                                  dev_addr_shadow[32]
178netdevice_tracker                   linkwatch_dev_tracker
179netdevice_tracker                   watchdog_dev_tracker
180netdevice_tracker                   dev_registered_tracker
181struct_rtnl_hw_stats64*             offload_xstats_l3
182struct_devlink_port*                devlink_port
183struct_dpll_pin*                    dpll_pin
184struct hlist_head                   page_pools
185struct dim_irq_moder*               irq_moder
186