Quelle  ice.h   Sprache: C

/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (c) 2018, Intel Corporation. */

#ifndef _ICE_H_
#define _ICE_H_

#include <linux/types.h>
#include <linux/errno.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/firmware.h>
#include <linux/netdevice.h>
#include <linux/compiler.h>
#include <linux/etherdevice.h>
#include <linux/skbuff.h>
#include <linux/cpumask.h>
#include <linux/rtnetlink.h>
#include <linux/if_vlan.h>
#include <linux/dma-mapping.h>
#include <linux/pci.h>
#include <linux/workqueue.h>
#include <linux/wait.h>
#include <linux/interrupt.h>
#include <linux/ethtool.h>
#include <linux/timer.h>
#include <linux/delay.h>
#include <linux/bitmap.h>
#include <linux/log2.h>
#include <linux/ip.h>
#include <linux/sctp.h>
#include <linux/ipv6.h>
#include <linux/pkt_sched.h>
#include <linux/if_bridge.h>
#include <linux/ctype.h>
#include <linux/linkmode.h>
#include <linux/bpf.h>
#include <linux/btf.h>
#include <linux/auxiliary_bus.h>
#include <linux/avf/virtchnl.h>
#include <linux/cpu_rmap.h>
#include <linux/dim.h>
#include <linux/gnss.h>
#include <net/pkt_cls.h>
#include <net/pkt_sched.h>
#include <net/tc_act/tc_mirred.h>
#include <net/tc_act/tc_gact.h>
#include <net/ip.h>
#include <net/devlink.h>
#include <net/ipv6.h>
#include <net/xdp_sock.h>
#include <net/xdp_sock_drv.h>
#include <net/geneve.h>
#include <net/gre.h>
#include <net/udp_tunnel.h>
#include <net/vxlan.h>
#include <net/gtp.h>
#include <linux/ppp_defs.h>
#include "ice_devids.h"
#include "ice_type.h"
#include "ice_txrx.h"
#include "ice_dcb.h"
#include "ice_switch.h"
#include "ice_common.h"
#include "ice_flow.h"
#include "ice_sched.h"
#include "ice_idc_int.h"
#include "ice_sriov.h"
#include "ice_vf_mbx.h"
#include "ice_ptp.h"
#include "ice_tspll.h"
#include "ice_fdir.h"
#include "ice_xsk.h"
#include "ice_arfs.h"
#include "ice_repr.h"
#include "ice_eswitch.h"
#include "ice_lag.h"
#include "ice_vsi_vlan_ops.h"
#include "ice_gnss.h"
#include "ice_irq.h"
#include "ice_dpll.h"
#include "ice_adapter.h"
#include "devlink/health.h"

#define ICE_BAR0  0
#define ICE_REQ_DESC_MULTIPLE 32
#define ICE_MIN_NUM_DESC 64
#define ICE_MAX_NUM_DESC 8160
#define ICE_DFLT_MIN_RX_DESC 512
#define ICE_DFLT_NUM_TX_DESC 256
#define ICE_DFLT_NUM_RX_DESC 2048

#define ICE_DFLT_TRAFFIC_CLASS BIT(0)
#define ICE_INT_NAME_STR_LEN (IFNAMSIZ + 16)
#define ICE_AQ_LEN  192
#define ICE_MBXSQ_LEN  64
#define ICE_SBQ_LEN  64
#define ICE_MIN_LAN_TXRX_MSIX 1
#define ICE_MIN_LAN_OICR_MSIX 1
#define ICE_MIN_MSIX  (ICE_MIN_LAN_TXRX_MSIX + ICE_MIN_LAN_OICR_MSIX)
#define ICE_FDIR_MSIX  2
#define ICE_NO_VSI  0xffff
#define ICE_VSI_MAP_CONTIG 0
#define ICE_VSI_MAP_SCATTER 1
#define ICE_MAX_SCATTER_TXQS 16
#define ICE_MAX_SCATTER_RXQS 16
#define ICE_Q_WAIT_RETRY_LIMIT 10
#define ICE_Q_WAIT_MAX_RETRY (5 * ICE_Q_WAIT_RETRY_LIMIT)
#define ICE_MAX_LG_RSS_QS 256
#define ICE_INVAL_Q_INDEX 0xffff

#define ICE_MAX_RXQS_PER_TC  256 /* Used when setting VSI context per TC Rx queues */

#define ICE_CHNL_START_TC  1

#define ICE_MAX_RESET_WAIT  20

#define ICE_VSIQF_HKEY_ARRAY_SIZE ((VSIQF_HKEY_MAX_INDEX + 1) * 4)

#define ICE_DFLT_NETIF_M (NETIF_MSG_DRV | NETIF_MSG_PROBE | NETIF_MSG_LINK)

#define ICE_MAX_MTU (ICE_AQ_SET_MAC_FRAME_SIZE_MAX - ICE_ETH_PKT_HDR_PAD)

#define ICE_MAX_TSO_SIZE 131072

#define ICE_UP_TABLE_TRANSLATE(val, i) \
  (((val) << ICE_AQ_VSI_UP_TABLE_UP##i##_S) & \
    ICE_AQ_VSI_UP_TABLE_UP##i##_M)

#define ICE_TX_DESC(R, i) (&(((struct ice_tx_desc *)((R)->desc))[i]))
#define ICE_RX_DESC(R, i) (&(((union ice_32b_rx_flex_desc *)((R)->desc))[i]))
#define ICE_TX_CTX_DESC(R, i) (&(((struct ice_tx_ctx_desc *)((R)->desc))[i]))
#define ICE_TX_FDIRDESC(R, i) (&(((struct ice_fltr_desc *)((R)->desc))[i]))

/* Minimum BW limit is 500 Kbps for any scheduler node */
#define ICE_MIN_BW_LIMIT  500
/* User can specify BW in either Kbit/Mbit/Gbit and OS converts it in bytes.
 * use it to convert user specified BW limit into Kbps
 */
#define ICE_BW_KBPS_DIVISOR  125

/* Default recipes have priority 4 and below, hence priority values between 5..7
 * can be used as filter priority for advanced switch filter (advanced switch
 * filters need new recipe to be created for specified extraction sequence
 * because default recipe extraction sequence does not represent custom
 * extraction)
 */
#define ICE_SWITCH_FLTR_PRIO_QUEUE 7
/* prio 6 is reserved for future use (e.g. switch filter with L3 fields +
 * (Optional: IP TOS/TTL) + L4 fields + (optionally: TCP fields such as
 * SYN/FIN/RST))
 */
#define ICE_SWITCH_FLTR_PRIO_RSVD 6
#define ICE_SWITCH_FLTR_PRIO_VSI 5
#define ICE_SWITCH_FLTR_PRIO_QGRP ICE_SWITCH_FLTR_PRIO_VSI

/* Macro for each VSI in a PF */
#define ice_for_each_vsi(pf, i) \
 for ((i) = 0; (i) < (pf)->num_alloc_vsi; (i)++)

/* Macros for each Tx/Xdp/Rx ring in a VSI */
#define ice_for_each_txq(vsi, i) \
 for ((i) = 0; (i) < (vsi)->num_txq; (i)++)

#define ice_for_each_xdp_txq(vsi, i) \
 for ((i) = 0; (i) < (vsi)->num_xdp_txq; (i)++)

#define ice_for_each_rxq(vsi, i) \
 for ((i) = 0; (i) < (vsi)->num_rxq; (i)++)

/* Macros for each allocated Tx/Rx ring whether used or not in a VSI */
#define ice_for_each_alloc_txq(vsi, i) \
 for ((i) = 0; (i) < (vsi)->alloc_txq; (i)++)

#define ice_for_each_alloc_rxq(vsi, i) \
 for ((i) = 0; (i) < (vsi)->alloc_rxq; (i)++)

#define ice_for_each_q_vector(vsi, i) \
 for ((i) = 0; (i) < (vsi)->num_q_vectors; (i)++)

#define ice_for_each_chnl_tc(i) \
 for ((i) = ICE_CHNL_START_TC; (i) < ICE_CHNL_MAX_TC; (i)++)

#define ICE_UCAST_PROMISC_BITS ICE_PROMISC_UCAST_RX

#define ICE_UCAST_VLAN_PROMISC_BITS (ICE_PROMISC_UCAST_RX | \
         ICE_PROMISC_VLAN_RX)

#define ICE_MCAST_PROMISC_BITS (ICE_PROMISC_MCAST_TX | ICE_PROMISC_MCAST_RX)

#define ICE_MCAST_VLAN_PROMISC_BITS (ICE_PROMISC_MCAST_TX | \
         ICE_PROMISC_MCAST_RX | \
         ICE_PROMISC_VLAN_TX  | \
         ICE_PROMISC_VLAN_RX)

#define ice_pf_to_dev(pf) (&((pf)->pdev->dev))

enum ice_feature {
 ICE_F_DSCP,
 ICE_F_PHY_RCLK,
 ICE_F_SMA_CTRL,
 ICE_F_CGU,
 ICE_F_GNSS,
 ICE_F_GCS,
 ICE_F_ROCE_LAG,
 ICE_F_SRIOV_LAG,
 ICE_F_MBX_LIMIT,
 ICE_F_MAX
};

DECLARE_STATIC_KEY_FALSE(ice_xdp_locking_key);

struct ice_channel {
 struct list_head list;
 u8 type;
 u16 sw_id;
 u16 base_q;
 u16 num_rxq;
 u16 num_txq;
 u16 vsi_num;
 u8 ena_tc;
 struct ice_aqc_vsi_props info;
 u64 max_tx_rate;
 u64 min_tx_rate;
 atomic_t num_sb_fltr;
 struct ice_vsi *ch_vsi;
};

struct ice_txq_meta {
 u32 q_teid; /* Tx-scheduler element identifier */
 u16 q_id; /* Entry in VSI's txq_map bitmap */
 u16 q_handle; /* Relative index of Tx queue within TC */
 u16 vsi_idx; /* VSI index that Tx queue belongs to */
 u8 tc;  /* TC number that Tx queue belongs to */
};

struct ice_tc_info {
 u16 qoffset;
 u16 qcount_tx;
 u16 qcount_rx;
 u8 netdev_tc;
};

struct ice_tc_cfg {
 u8 numtc; /* Total number of enabled TCs */
 u16 ena_tc; /* Tx map */
 struct ice_tc_info tc_info[ICE_MAX_TRAFFIC_CLASS];
};

struct ice_qs_cfg {
 struct mutex *qs_mutex;  /* will be assigned to &pf->avail_q_mutex */
 unsigned long *pf_map;
 unsigned long pf_map_size;
 unsigned int q_count;
 unsigned int scatter_count;
 u16 *vsi_map;
 u16 vsi_map_offset;
 u8 mapping_mode;
};

struct ice_sw {
 struct ice_pf *pf;
 u16 sw_id;  /* switch ID for this switch */
 u16 bridge_mode; /* VEB/VEPA/Port Virtualizer */
};

enum ice_pf_state {
 ICE_TESTING,
 ICE_DOWN,
 ICE_NEEDS_RESTART,
 ICE_PREPARED_FOR_RESET, /* set by driver when prepared */
 ICE_RESET_OICR_RECV,  /* set by driver after rcv reset OICR */
 ICE_PFR_REQ,  /* set by driver */
 ICE_CORER_REQ,  /* set by driver */
 ICE_GLOBR_REQ,  /* set by driver */
 ICE_CORER_RECV,  /* set by OICR handler */
 ICE_GLOBR_RECV,  /* set by OICR handler */
 ICE_EMPR_RECV,  /* set by OICR handler */
 ICE_SUSPENDED,  /* set on module remove path */
 ICE_RESET_FAILED,  /* set by reset/rebuild */
 /* When checking for the PF to be in a nominal operating state, the
  * bits that are grouped at the beginning of the list need to be
  * checked. Bits occurring before ICE_STATE_NOMINAL_CHECK_BITS will
  * be checked. If you need to add a bit into consideration for nominal
  * operating state, it must be added before
  * ICE_STATE_NOMINAL_CHECK_BITS. Do not move this entry's position
  * without appropriate consideration.
 */
 ICE_STATE_NOMINAL_CHECK_BITS,
 ICE_ADMINQ_EVENT_PENDING,
 ICE_MAILBOXQ_EVENT_PENDING,
 ICE_SIDEBANDQ_EVENT_PENDING,
 ICE_MDD_EVENT_PENDING,
 ICE_VFLR_EVENT_PENDING,
 ICE_FLTR_OVERFLOW_PROMISC,
 ICE_VF_DIS,
 ICE_CFG_BUSY,
 ICE_SERVICE_SCHED,
 ICE_SERVICE_DIS,
 ICE_FD_FLUSH_REQ,
 ICE_OICR_INTR_DIS,  /* Global OICR interrupt disabled */
 ICE_MDD_VF_PRINT_PENDING, /* set when MDD event handle */
 ICE_VF_RESETS_DISABLED, /* disable resets during ice_remove */
 ICE_LINK_DEFAULT_OVERRIDE_PENDING,
 ICE_PHY_INIT_COMPLETE,
 ICE_FD_VF_FLUSH_CTX,  /* set at FD Rx IRQ or timeout */
 ICE_AUX_ERR_PENDING,
 ICE_STATE_NBITS  /* must be last */
};

enum ice_vsi_state {
 ICE_VSI_DOWN,
 ICE_VSI_NEEDS_RESTART,
 ICE_VSI_NETDEV_ALLOCD,
 ICE_VSI_NETDEV_REGISTERED,
 ICE_VSI_UMAC_FLTR_CHANGED,
 ICE_VSI_MMAC_FLTR_CHANGED,
 ICE_VSI_PROMISC_CHANGED,
 ICE_VSI_REBUILD_PENDING,
 ICE_VSI_STATE_NBITS  /* must be last */
};

struct ice_vsi_stats {
 struct ice_ring_stats **tx_ring_stats;  /* Tx ring stats array */
 struct ice_ring_stats **rx_ring_stats;  /* Rx ring stats array */
};

/* struct that defines a VSI, associated with a dev */
struct ice_vsi {
 struct net_device *netdev;
 struct ice_sw *vsw;   /* switch this VSI is on */
 struct ice_pf *back;   /* back pointer to PF */
 struct ice_rx_ring **rx_rings;  /* Rx ring array */
 struct ice_tx_ring **tx_rings;  /* Tx ring array */
 struct ice_q_vector **q_vectors; /* q_vector array */

 irqreturn_t (*irq_handler)(int irq, void *data);

 u64 tx_linearize;
 DECLARE_BITMAP(state, ICE_VSI_STATE_NBITS);
 unsigned int current_netdev_flags;
 u32 tx_restart;
 u32 tx_busy;
 u32 rx_buf_failed;
 u32 rx_page_failed;
 u16 num_q_vectors;
 /* tell if only dynamic irq allocation is allowed */
 bool irq_dyn_alloc;

 u16 vsi_num;   /* HW (absolute) index of this VSI */
 u16 idx;   /* software index in pf->vsi[] */

 u16 num_gfltr;
 u16 num_bfltr;

 /* RSS config */
 u16 rss_table_size; /* HW RSS table size */
 u16 rss_size;  /* Allocated RSS queues */
 u8 rss_hfunc;  /* User configured hash type */
 u8 *rss_hkey_user; /* User configured hash keys */
 u8 *rss_lut_user; /* User configured lookup table entries */
 u8 rss_lut_type; /* used to configure Get/Set RSS LUT AQ call */

 /* aRFS members only allocated for the PF VSI */
#define ICE_MAX_ARFS_LIST 1024
#define ICE_ARFS_LST_MASK (ICE_MAX_ARFS_LIST - 1)
 struct hlist_head *arfs_fltr_list;
 struct ice_arfs_active_fltr_cntrs *arfs_fltr_cntrs;
 spinlock_t arfs_lock; /* protects aRFS hash table and filter state */
 atomic_t *arfs_last_fltr_id;

 struct ice_aqc_vsi_props info;  /* VSI properties */
 struct ice_vsi_vlan_info vlan_info; /* vlan config to be restored */

 /* VSI stats */
 struct rtnl_link_stats64 net_stats;
 struct rtnl_link_stats64 net_stats_prev;
 struct ice_eth_stats eth_stats;
 struct ice_eth_stats eth_stats_prev;

 struct list_head tmp_sync_list;  /* MAC filters to be synced */
 struct list_head tmp_unsync_list; /* MAC filters to be unsynced */

 u8 irqs_ready:1;
 u8 current_isup:1;   /* Sync 'link up' logging */
 u8 stat_offsets_loaded:1;
 struct ice_vsi_vlan_ops inner_vlan_ops;
 struct ice_vsi_vlan_ops outer_vlan_ops;
 u16 num_vlan;

 /* queue information */
 u8 tx_mapping_mode;   /* ICE_MAP_MODE_[CONTIG|SCATTER] */
 u8 rx_mapping_mode;   /* ICE_MAP_MODE_[CONTIG|SCATTER] */
 u16 *txq_map;    /* index in pf->avail_txqs */
 u16 *rxq_map;    /* index in pf->avail_rxqs */
 u16 alloc_txq;    /* Allocated Tx queues */
 u16 num_txq;    /* Used Tx queues */
 u16 alloc_rxq;    /* Allocated Rx queues */
 u16 num_rxq;    /* Used Rx queues */
 u16 req_txq;    /* User requested Tx queues */
 u16 req_rxq;    /* User requested Rx queues */
 u16 num_rx_desc;
 u16 num_tx_desc;
 struct ice_tc_cfg tc_cfg;
 struct bpf_prog *xdp_prog;
 struct ice_tx_ring **xdp_rings;  /* XDP ring array */
 u16 num_xdp_txq;   /* Used XDP queues */
 u8 xdp_mapping_mode;   /* ICE_MAP_MODE_[CONTIG|SCATTER] */
 struct mutex xdp_state_lock;

 struct net_device **target_netdevs;

 struct tc_mqprio_qopt_offload mqprio_qopt; /* queue parameters */

 /* Channel Specific Fields */
 struct ice_vsi *tc_map_vsi[ICE_CHNL_MAX_TC];
 u16 cnt_q_avail;
 u16 next_base_q; /* next queue to be used for channel setup */
 struct list_head ch_list;
 u16 num_chnl_rxq;
 u16 num_chnl_txq;
 u16 ch_rss_size;
 u16 num_chnl_fltr;
 /* store away rss size info before configuring ADQ channels so that,
  * it can be used after tc-qdisc delete, to get back RSS setting as
  * they were before
 */
 u16 orig_rss_size;
 /* this keeps tracks of all enabled TC with and without DCB
  * and inclusive of ADQ, vsi->mqprio_opt keeps track of queue
  * information
 */
 u8 all_numtc;
 u16 all_enatc;

 /* store away TC info, to be used for rebuild logic */
 u8 old_numtc;
 u16 old_ena_tc;

 /* setup back reference, to which aggregator node this VSI
  * corresponds to
 */
 struct ice_agg_node *agg_node;

 struct_group_tagged(ice_vsi_cfg_params, params,
  struct ice_port_info *port_info; /* back pointer to port_info */
  struct ice_channel *ch; /* VSI's channel structure, may be NULL */
  union {
   /* VF associated with this VSI, may be NULL */
   struct ice_vf *vf;
   /* SF associated with this VSI, may be NULL */
   struct ice_dynamic_port *sf;
  };
  u32 flags; /* VSI flags used for rebuild and configuration */
  enum ice_vsi_type type; /* the type of the VSI */
 );
} ____cacheline_internodealigned_in_smp;

/* struct that defines an interrupt vector */
struct ice_q_vector {
 struct ice_vsi *vsi;

 u16 v_idx;   /* index in the vsi->q_vector array. */
 u16 reg_idx;   /* PF relative register index */
 u8 num_ring_rx;   /* total number of Rx rings in vector */
 u8 num_ring_tx;   /* total number of Tx rings in vector */
 u8 wb_on_itr:1;   /* if true, WB on ITR is enabled */
 /* in usecs, need to use ice_intrl_to_usecs_reg() before writing this
  * value to the device
 */
 u8 intrl;

 struct napi_struct napi;

 struct ice_ring_container rx;
 struct ice_ring_container tx;

 struct ice_channel *ch;

 char name[ICE_INT_NAME_STR_LEN];

 u16 total_events; /* net_dim(): number of interrupts processed */
 u16 vf_reg_idx;  /* VF relative register index */
 struct msi_map irq;
} ____cacheline_internodealigned_in_smp;

enum ice_pf_flags {
 ICE_FLAG_FLTR_SYNC,
 ICE_FLAG_RDMA_ENA,
 ICE_FLAG_RSS_ENA,
 ICE_FLAG_SRIOV_ENA,
 ICE_FLAG_SRIOV_CAPABLE,
 ICE_FLAG_DCB_CAPABLE,
 ICE_FLAG_DCB_ENA,
 ICE_FLAG_FD_ENA,
 ICE_FLAG_PTP_SUPPORTED,  /* PTP is supported by NVM */
 ICE_FLAG_ADV_FEATURES,
 ICE_FLAG_TC_MQPRIO,  /* support for Multi queue TC */
 ICE_FLAG_CLS_FLOWER,
 ICE_FLAG_LINK_DOWN_ON_CLOSE_ENA,
 ICE_FLAG_TOTAL_PORT_SHUTDOWN_ENA,
 ICE_FLAG_NO_MEDIA,
 ICE_FLAG_FW_LLDP_AGENT,
 ICE_FLAG_MOD_POWER_UNSUPPORTED,
 ICE_FLAG_PHY_FW_LOAD_FAILED,
 ICE_FLAG_ETHTOOL_CTXT,  /* set when ethtool holds RTNL lock */
 ICE_FLAG_LEGACY_RX,
 ICE_FLAG_VF_TRUE_PROMISC_ENA,
 ICE_FLAG_MDD_AUTO_RESET_VF,
 ICE_FLAG_VF_VLAN_PRUNING,
 ICE_FLAG_LINK_LENIENT_MODE_ENA,
 ICE_FLAG_PLUG_AUX_DEV,
 ICE_FLAG_UNPLUG_AUX_DEV,
 ICE_FLAG_AUX_DEV_CREATED,
 ICE_FLAG_MTU_CHANGED,
 ICE_FLAG_GNSS,   /* GNSS successfully initialized */
 ICE_FLAG_DPLL,   /* SyncE/PTP dplls initialized */
 ICE_FLAG_LLDP_AQ_FLTR,
 ICE_PF_FLAGS_NBITS  /* must be last */
};

enum ice_misc_thread_tasks {
 ICE_MISC_THREAD_TX_TSTAMP,
 ICE_MISC_THREAD_NBITS  /* must be last */
};

struct ice_eswitch {
 struct ice_vsi *uplink_vsi;
 struct ice_esw_br_offloads *br_offloads;
 struct xarray reprs;
 bool is_running;
};

struct ice_agg_node {
 u32 agg_id;
#define ICE_MAX_VSIS_IN_AGG_NODE 64
 u32 num_vsis;
 u8 valid;
};

struct ice_pf_msix {
 u32 cur;
 u32 min;
 u32 max;
 u32 total;
 u32 rest;
};

struct ice_pf {
 struct pci_dev *pdev;
 struct ice_adapter *adapter;

 struct devlink_region *nvm_region;
 struct devlink_region *sram_region;
 struct devlink_region *devcaps_region;

 /* devlink port data */
 struct devlink_port devlink_port;

 /* OS reserved IRQ details */
 struct ice_irq_tracker irq_tracker;
 struct ice_virt_irq_tracker virt_irq_tracker;

 u16 ctrl_vsi_idx;  /* control VSI index in pf->vsi array */

 struct ice_vsi **vsi;  /* VSIs created by the driver */
 struct ice_vsi_stats **vsi_stats;
 struct ice_sw *first_sw; /* first switch created by firmware */
 u16 eswitch_mode;  /* current mode of eswitch */
 struct dentry *ice_debugfs_pf;
 struct dentry *ice_debugfs_pf_fwlog;
 /* keep track of all the dentrys for FW log modules */
 struct dentry **ice_debugfs_pf_fwlog_modules;
 struct ice_vfs vfs;
 DECLARE_BITMAP(features, ICE_F_MAX);
 DECLARE_BITMAP(state, ICE_STATE_NBITS);
 DECLARE_BITMAP(flags, ICE_PF_FLAGS_NBITS);
 DECLARE_BITMAP(misc_thread, ICE_MISC_THREAD_NBITS);
 unsigned long *avail_txqs; /* bitmap to track PF Tx queue usage */
 unsigned long *avail_rxqs; /* bitmap to track PF Rx queue usage */
 unsigned long serv_tmr_period;
 unsigned long serv_tmr_prev;
 struct timer_list serv_tmr;
 struct work_struct serv_task;
 struct mutex avail_q_mutex; /* protects access to avail_[rx|tx]qs */
 struct mutex sw_mutex;  /* lock for protecting VSI alloc flow */
 struct mutex tc_mutex;  /* lock to protect TC changes */
 struct mutex adev_mutex; /* lock to protect aux device access */
 struct mutex lag_mutex;  /* protect ice_lag struct in PF */
 u32 msg_enable;
 struct ice_ptp ptp;
 struct gnss_serial *gnss_serial;
 struct gnss_device *gnss_dev;
 u16 num_rdma_msix;  /* Total MSIX vectors for RDMA driver */

 /* spinlock to protect the AdminQ wait list */
 spinlock_t aq_wait_lock;
 struct hlist_head aq_wait_list;
 wait_queue_head_t aq_wait_queue;
 bool fw_emp_reset_disabled;

 wait_queue_head_t reset_wait_queue;

 u32 hw_csum_rx_error;
 u32 hw_rx_eipe_error;
 u32 oicr_err_reg;
 struct msi_map oicr_irq; /* Other interrupt cause MSIX vector */
 struct msi_map ll_ts_irq; /* LL_TS interrupt MSIX vector */
 u16 max_pf_txqs; /* Total Tx queues PF wide */
 u16 max_pf_rxqs; /* Total Rx queues PF wide */
 struct ice_pf_msix msix;
 u16 num_lan_tx;  /* num LAN Tx queues setup */
 u16 num_lan_rx;  /* num LAN Rx queues setup */
 u16 next_vsi;  /* Next free slot in pf->vsi[] - 0-based! */
 u16 num_alloc_vsi;
 u16 corer_count; /* Core reset count */
 u16 globr_count; /* Global reset count */
 u16 empr_count;  /* EMP reset count */
 u16 pfr_count;  /* PF reset count */
 u32 link_down_events;

 u8 wol_ena : 1;  /* software state of WoL */
 u32 wakeup_reason; /* last wakeup reason */
 struct ice_hw_port_stats stats;
 struct ice_hw_port_stats stats_prev;
 struct ice_hw hw;
 u8 stat_prev_loaded:1; /* has previous stats been loaded */
 u16 dcbx_cap;
 u32 tx_timeout_count;
 unsigned long tx_timeout_last_recovery;
 u32 tx_timeout_recovery_level;
 char int_name[ICE_INT_NAME_STR_LEN];
 char int_name_ll_ts[ICE_INT_NAME_STR_LEN];
 int aux_idx;
 u32 sw_int_count;
 /* count of tc_flower filters specific to channel (aka where filter
  * action is "hw_tc <tc_num>")
 */
 u16 num_dmac_chnl_fltrs;
 struct hlist_head tc_flower_fltr_list;

 u64 supported_rxdids;

 __le64 nvm_phy_type_lo; /* NVM PHY type low */
 __le64 nvm_phy_type_hi; /* NVM PHY type high */
 struct ice_link_default_override_tlv link_dflt_override;
 struct ice_lag *lag; /* Link Aggregation information */

 struct ice_eswitch eswitch;
 struct ice_esw_br_port *br_port;

 struct xarray dyn_ports;
 struct xarray sf_nums;

#define ICE_INVALID_AGG_NODE_ID  0
#define ICE_PF_AGG_NODE_ID_START 1
#define ICE_MAX_PF_AGG_NODES  32
 struct ice_agg_node pf_agg_node[ICE_MAX_PF_AGG_NODES];
#define ICE_VF_AGG_NODE_ID_START 65
#define ICE_MAX_VF_AGG_NODES  32
 struct ice_agg_node vf_agg_node[ICE_MAX_VF_AGG_NODES];
 struct ice_dplls dplls;
 struct device *hwmon_dev;
 struct ice_health health_reporters;
 struct iidc_rdma_core_dev_info *cdev_info;

 u8 num_quanta_prof_used;
};

extern struct workqueue_struct *ice_lag_wq;

struct ice_netdev_priv {
 struct ice_vsi *vsi;
 struct ice_repr *repr;
 /* indirect block callbacks on registered higher level devices
  * (e.g. tunnel devices)
  *
  * tc_indr_block_cb_priv_list is used to look up indirect callback
  * private data
 */
 struct list_head tc_indr_block_priv_list;
};

/**
 * ice_vector_ch_enabled
 * @qv: pointer to q_vector, can be NULL
 *
 * This function returns true if vector is channel enabled otherwise false
 */
static inline bool ice_vector_ch_enabled(struct ice_q_vector *qv)
{
 return !!qv->ch; /* Enable it to run with TC */
}

/**
 * ice_ptp_pf_handles_tx_interrupt - Check if PF handles Tx interrupt
 * @pf: Board private structure
 *
 * Return true if this PF should respond to the Tx timestamp interrupt
 * indication in the miscellaneous OICR interrupt handler.
 */
static inline bool ice_ptp_pf_handles_tx_interrupt(struct ice_pf *pf)
{
 return pf->ptp.tx_interrupt_mode != ICE_PTP_TX_INTERRUPT_NONE;
}

/**
 * ice_irq_dynamic_ena - Enable default interrupt generation settings
 * @hw: pointer to HW struct
 * @vsi: pointer to VSI struct, can be NULL
 * @q_vector: pointer to q_vector, can be NULL
 */
static inline void
ice_irq_dynamic_ena(struct ice_hw *hw, struct ice_vsi *vsi,
      struct ice_q_vector *q_vector)
{
 u32 vector = (vsi && q_vector) ? q_vector->reg_idx :
    ((struct ice_pf *)hw->back)->oicr_irq.index;
 int itr = ICE_ITR_NONE;
 u32 val;

 /* clear the PBA here, as this function is meant to clean out all
  * previous interrupts and enable the interrupt
 */
 val = GLINT_DYN_CTL_INTENA_M | GLINT_DYN_CTL_CLEARPBA_M |
       (itr << GLINT_DYN_CTL_ITR_INDX_S);
 if (vsi)
  if (test_bit(ICE_VSI_DOWN, vsi->state))
   return;
 wr32(hw, GLINT_DYN_CTL(vector), val);
}

/**
 * ice_netdev_to_pf - Retrieve the PF struct associated with a netdev
 * @netdev: pointer to the netdev struct
 */
static inline struct ice_pf *ice_netdev_to_pf(struct net_device *netdev)
{
 struct ice_netdev_priv *np = netdev_priv(netdev);

 return np->vsi->back;
}

static inline bool ice_is_xdp_ena_vsi(struct ice_vsi *vsi)
{
 return !!READ_ONCE(vsi->xdp_prog);
}

static inline void ice_set_ring_xdp(struct ice_tx_ring *ring)
{
 ring->flags |= ICE_TX_FLAGS_RING_XDP;
}

/**
 * ice_get_xp_from_qid - get ZC XSK buffer pool bound to a queue ID
 * @vsi: pointer to VSI
 * @qid: index of a queue to look at XSK buff pool presence
 *
 * Return: A pointer to xsk_buff_pool structure if there is a buffer pool
 * attached and configured as zero-copy, NULL otherwise.
 */
static inline struct xsk_buff_pool *ice_get_xp_from_qid(struct ice_vsi *vsi,
       u16 qid)
{
 struct xsk_buff_pool *pool = xsk_get_pool_from_qid(vsi->netdev, qid);

 if (!ice_is_xdp_ena_vsi(vsi))
  return NULL;

 return (pool && pool->dev) ? pool : NULL;
}

/**
 * ice_rx_xsk_pool - assign XSK buff pool to Rx ring
 * @ring: Rx ring to use
 *
 * Sets XSK buff pool pointer on Rx ring.
 */
static inline void ice_rx_xsk_pool(struct ice_rx_ring *ring)
{
 struct ice_vsi *vsi = ring->vsi;
 u16 qid = ring->q_index;

 WRITE_ONCE(ring->xsk_pool, ice_get_xp_from_qid(vsi, qid));
}

/**
 * ice_tx_xsk_pool - assign XSK buff pool to XDP ring
 * @vsi: pointer to VSI
 * @qid: index of a queue to look at XSK buff pool presence
 *
 * Sets XSK buff pool pointer on XDP ring.
 *
 * XDP ring is picked from Rx ring, whereas Rx ring is picked based on provided
 * queue id. Reason for doing so is that queue vectors might have assigned more
 * than one XDP ring, e.g. when user reduced the queue count on netdev; Rx ring
 * carries a pointer to one of these XDP rings for its own purposes, such as
 * handling XDP_TX action, therefore we can piggyback here on the
 * rx_ring->xdp_ring assignment that was done during XDP rings initialization.
 */
static inline void ice_tx_xsk_pool(struct ice_vsi *vsi, u16 qid)
{
 struct ice_tx_ring *ring;

 ring = vsi->rx_rings[qid]->xdp_ring;
 if (!ring)
  return;

 WRITE_ONCE(ring->xsk_pool, ice_get_xp_from_qid(vsi, qid));
}

/**
 * ice_get_main_vsi - Get the PF VSI
 * @pf: PF instance
 *
 * returns pf->vsi[0], which by definition is the PF VSI
 */
static inline struct ice_vsi *ice_get_main_vsi(struct ice_pf *pf)
{
 if (pf->vsi)
  return pf->vsi[0];

 return NULL;
}

/**
 * ice_get_netdev_priv_vsi - return VSI associated with netdev priv.
 * @np: private netdev structure
 */
static inline struct ice_vsi *ice_get_netdev_priv_vsi(struct ice_netdev_priv *np)
{
 /* In case of port representor return source port VSI. */
 if (np->repr)
  return np->repr->src_vsi;
 else
  return np->vsi;
}

/**
 * ice_get_ctrl_vsi - Get the control VSI
 * @pf: PF instance
 */
static inline struct ice_vsi *ice_get_ctrl_vsi(struct ice_pf *pf)
{
 /* if pf->ctrl_vsi_idx is ICE_NO_VSI, control VSI was not set up */
 if (!pf->vsi || pf->ctrl_vsi_idx == ICE_NO_VSI)
  return NULL;

 return pf->vsi[pf->ctrl_vsi_idx];
}

/**
 * ice_find_vsi - Find the VSI from VSI ID
 * @pf: The PF pointer to search in
 * @vsi_num: The VSI ID to search for
 */
static inline struct ice_vsi *ice_find_vsi(struct ice_pf *pf, u16 vsi_num)
{
 int i;

 ice_for_each_vsi(pf, i)
  if (pf->vsi[i] && pf->vsi[i]->vsi_num == vsi_num)
   return  pf->vsi[i];
 return NULL;
}

/**
 * ice_is_switchdev_running - check if switchdev is configured
 * @pf: pointer to PF structure
 *
 * Returns true if eswitch mode is set to DEVLINK_ESWITCH_MODE_SWITCHDEV
 * and switchdev is configured, false otherwise.
 */
static inline bool ice_is_switchdev_running(struct ice_pf *pf)
{
 return pf->eswitch.is_running;
}

#define ICE_FD_STAT_CTR_BLOCK_COUNT 256
#define ICE_FD_STAT_PF_IDX(base_idx) \
   ((base_idx) * ICE_FD_STAT_CTR_BLOCK_COUNT)
#define ICE_FD_SB_STAT_IDX(base_idx) ICE_FD_STAT_PF_IDX(base_idx)
#define ICE_FD_STAT_CH   1
#define ICE_FD_CH_STAT_IDX(base_idx) \
   (ICE_FD_STAT_PF_IDX(base_idx) + ICE_FD_STAT_CH)

/**
 * ice_is_adq_active - any active ADQs
 * @pf: pointer to PF
 *
 * This function returns true if there are any ADQs configured (which is
 * determined by looking at VSI type (which should be VSI_PF), numtc, and
 * TC_MQPRIO flag) otherwise return false
 */
static inline bool ice_is_adq_active(struct ice_pf *pf)
{
 struct ice_vsi *vsi;

 vsi = ice_get_main_vsi(pf);
 if (!vsi)
  return false;

 /* is ADQ configured */
 if (vsi->tc_cfg.numtc > ICE_CHNL_START_TC &&
     test_bit(ICE_FLAG_TC_MQPRIO, pf->flags))
  return true;

 return false;
}

void ice_debugfs_fwlog_init(struct ice_pf *pf);
void ice_debugfs_pf_deinit(struct ice_pf *pf);
void ice_debugfs_init(void);
void ice_debugfs_exit(void);
void ice_pf_fwlog_update_module(struct ice_pf *pf, int log_level, int module);

bool netif_is_ice(const struct net_device *dev);
int ice_vsi_setup_tx_rings(struct ice_vsi *vsi);
int ice_vsi_setup_rx_rings(struct ice_vsi *vsi);
int ice_vsi_open_ctrl(struct ice_vsi *vsi);
int ice_vsi_open(struct ice_vsi *vsi);
void ice_set_ethtool_ops(struct net_device *netdev);
void ice_set_ethtool_repr_ops(struct net_device *netdev);
void ice_set_ethtool_safe_mode_ops(struct net_device *netdev);
void ice_set_ethtool_sf_ops(struct net_device *netdev);
u16 ice_get_avail_txq_count(struct ice_pf *pf);
u16 ice_get_avail_rxq_count(struct ice_pf *pf);
int ice_vsi_recfg_qs(struct ice_vsi *vsi, int new_rx, int new_tx, bool locked);
void ice_update_vsi_stats(struct ice_vsi *vsi);
void ice_update_pf_stats(struct ice_pf *pf);
void
ice_fetch_u64_stats_per_ring(struct u64_stats_sync *syncp,
        struct ice_q_stats stats, u64 *pkts, u64 *bytes);
int ice_up(struct ice_vsi *vsi);
int ice_down(struct ice_vsi *vsi);
int ice_down_up(struct ice_vsi *vsi);
int ice_vsi_cfg_lan(struct ice_vsi *vsi);
struct ice_vsi *ice_lb_vsi_setup(struct ice_pf *pf, struct ice_port_info *pi);

enum ice_xdp_cfg {
 ICE_XDP_CFG_FULL, /* Fully apply new config in .ndo_bpf() */
 ICE_XDP_CFG_PART, /* Save/use part of config in VSI rebuild */
};

int ice_vsi_determine_xdp_res(struct ice_vsi *vsi);
int ice_prepare_xdp_rings(struct ice_vsi *vsi, struct bpf_prog *prog,
     enum ice_xdp_cfg cfg_type);
int ice_destroy_xdp_rings(struct ice_vsi *vsi, enum ice_xdp_cfg cfg_type);
void ice_map_xdp_rings(struct ice_vsi *vsi);
int
ice_xdp_xmit(struct net_device *dev, int n, struct xdp_frame **frames,
      u32 flags);
int ice_set_rss_lut(struct ice_vsi *vsi, u8 *lut, u16 lut_size);
int ice_get_rss_lut(struct ice_vsi *vsi, u8 *lut, u16 lut_size);
int ice_set_rss_key(struct ice_vsi *vsi, u8 *seed);
int ice_get_rss_key(struct ice_vsi *vsi, u8 *seed);
int ice_set_rss_hfunc(struct ice_vsi *vsi, u8 hfunc);
void ice_fill_rss_lut(u8 *lut, u16 rss_table_size, u16 rss_size);
int ice_schedule_reset(struct ice_pf *pf, enum ice_reset_req reset);
void ice_print_link_msg(struct ice_vsi *vsi, bool isup);
int ice_plug_aux_dev(struct ice_pf *pf);
void ice_unplug_aux_dev(struct ice_pf *pf);
int ice_init_rdma(struct ice_pf *pf);
void ice_deinit_rdma(struct ice_pf *pf);
bool ice_is_wol_supported(struct ice_hw *hw);
void ice_fdir_del_all_fltrs(struct ice_vsi *vsi);
int
ice_fdir_write_fltr(struct ice_pf *pf, struct ice_fdir_fltr *input, bool add,
      bool is_tun);
void ice_vsi_manage_fdir(struct ice_vsi *vsi, bool ena);
int ice_add_fdir_ethtool(struct ice_vsi *vsi, struct ethtool_rxnfc *cmd);
int ice_del_fdir_ethtool(struct ice_vsi *vsi, struct ethtool_rxnfc *cmd);
int ice_get_ethtool_fdir_entry(struct ice_hw *hw, struct ethtool_rxnfc *cmd);
int
ice_get_fdir_fltr_ids(struct ice_hw *hw, struct ethtool_rxnfc *cmd,
        u32 *rule_locs);
void ice_fdir_rem_adq_chnl(struct ice_hw *hw, u16 vsi_idx);
void ice_fdir_release_flows(struct ice_hw *hw);
void ice_fdir_replay_flows(struct ice_hw *hw);
void ice_fdir_replay_fltrs(struct ice_pf *pf);
int ice_fdir_create_dflt_rules(struct ice_pf *pf);

enum ice_aq_task_state {
 ICE_AQ_TASK_NOT_PREPARED,
 ICE_AQ_TASK_WAITING,
 ICE_AQ_TASK_COMPLETE,
 ICE_AQ_TASK_CANCELED,
};

struct ice_aq_task {
 struct hlist_node entry;
 struct ice_rq_event_info event;
 enum ice_aq_task_state state;
 u16 opcode;
};

void ice_aq_prep_for_event(struct ice_pf *pf, struct ice_aq_task *task,
      u16 opcode);
int ice_aq_wait_for_event(struct ice_pf *pf, struct ice_aq_task *task,
     unsigned long timeout);
int ice_open(struct net_device *netdev);
int ice_open_internal(struct net_device *netdev);
int ice_stop(struct net_device *netdev);
void ice_service_task_schedule(struct ice_pf *pf);
int ice_load(struct ice_pf *pf);
void ice_unload(struct ice_pf *pf);
void ice_adv_lnk_speed_maps_init(void);
int ice_init_dev(struct ice_pf *pf);
void ice_deinit_dev(struct ice_pf *pf);
int ice_change_mtu(struct net_device *netdev, int new_mtu);
void ice_tx_timeout(struct net_device *netdev, unsigned int txqueue);
int ice_xdp(struct net_device *dev, struct netdev_bpf *xdp);
void ice_set_netdev_features(struct net_device *netdev);
int ice_vlan_rx_add_vid(struct net_device *netdev, __be16 proto, u16 vid);
int ice_vlan_rx_kill_vid(struct net_device *netdev, __be16 proto, u16 vid);
void ice_get_stats64(struct net_device *netdev,
       struct rtnl_link_stats64 *stats);

/**
 * ice_set_rdma_cap - enable RDMA support
 * @pf: PF struct
 */
static inline void ice_set_rdma_cap(struct ice_pf *pf)
{
 if (pf->hw.func_caps.common_cap.rdma && pf->num_rdma_msix) {
  set_bit(ICE_FLAG_RDMA_ENA, pf->flags);
  set_bit(ICE_FLAG_PLUG_AUX_DEV, pf->flags);
 }
}

/**
 * ice_clear_rdma_cap - disable RDMA support
 * @pf: PF struct
 */
static inline void ice_clear_rdma_cap(struct ice_pf *pf)
{
 /* defer unplug to service task to avoid RTNL lock and
  * clear PLUG bit so that pending plugs don't interfere
 */
 clear_bit(ICE_FLAG_PLUG_AUX_DEV, pf->flags);
 set_bit(ICE_FLAG_UNPLUG_AUX_DEV, pf->flags);
 clear_bit(ICE_FLAG_RDMA_ENA, pf->flags);
}

extern const struct xdp_metadata_ops ice_xdp_md_ops;

/**
 * ice_is_dual - Check if given config is multi-NAC
 * @hw: pointer to HW structure
 *
 * Return: true if the device is running in mutli-NAC (Network
 * Acceleration Complex) configuration variant, false otherwise
 * (always false for non-E825 devices).
 */
static inline bool ice_is_dual(struct ice_hw *hw)
{
 return hw->mac_type == ICE_MAC_GENERIC_3K_E825 &&
        (hw->dev_caps.nac_topo.mode & ICE_NAC_TOPO_DUAL_M);
}

/**
 * ice_is_primary - Check if given device belongs to the primary complex
 * @hw: pointer to HW structure
 *
 * Check if given PF/HW is running on primary complex in multi-NAC
 * configuration.
 *
 * Return: true if the device is dual, false otherwise (always true
 * for non-E825 devices).
 */
static inline bool ice_is_primary(struct ice_hw *hw)
{
 return hw->mac_type != ICE_MAC_GENERIC_3K_E825 ||
        !ice_is_dual(hw) ||
        (hw->dev_caps.nac_topo.mode & ICE_NAC_TOPO_PRIMARY_M);
}

/**
 * ice_pf_src_tmr_owned - Check if a primary timer is owned by PF
 * @pf: pointer to PF structure
 *
 * Return: true if PF owns primary timer, false otherwise.
 */
static inline bool ice_pf_src_tmr_owned(struct ice_pf *pf)
{
 return pf->hw.func_caps.ts_func_info.src_tmr_owned &&
        ice_is_primary(&pf->hw);
}

/**
 * ice_get_primary_hw - Get pointer to primary ice_hw structure
 * @pf: pointer to PF structure
 *
 * Return: A pointer to ice_hw structure with access to timesync
 * register space.
 */
static inline struct ice_hw *ice_get_primary_hw(struct ice_pf *pf)
{
 if (!pf->adapter->ctrl_pf)
  return &pf->hw;
 else
  return &pf->adapter->ctrl_pf->hw;
}
#endif /* _ICE_H_ */