48fbc1be82
Currently when creating meter policy, a src port_id match item will
always be added in switch domain. So if one meter is used by another
port, it will not work correctly.
This issue is solved:
1. If policy fate action is port_id, add the src port_id match item,
and the meter cannot be shared by another port.
2. If policy fate action isn't port_id, don't add the src port_id
match, meter can be shared by another port.
This fix enables one meter being shared by different ports. User can
create a meter flow using a port_id match item to make this meter
shared by other port.
Fixes: afb4aa4f12
("net/mlx5: support meter policy operations")
Cc: stable@dpdk.org
Signed-off-by: Shun Hao <shunh@nvidia.com>
Acked-by: Matan Azrad <matan@nvidia.com>
1743 lines
64 KiB
C
1743 lines
64 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright 2015 6WIND S.A.
|
|
* Copyright 2015 Mellanox Technologies, Ltd
|
|
*/
|
|
|
|
#ifndef RTE_PMD_MLX5_H_
|
|
#define RTE_PMD_MLX5_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <limits.h>
|
|
#include <sys/queue.h>
|
|
|
|
#include <rte_pci.h>
|
|
#include <rte_ether.h>
|
|
#include <ethdev_driver.h>
|
|
#include <rte_rwlock.h>
|
|
#include <rte_interrupts.h>
|
|
#include <rte_errno.h>
|
|
#include <rte_flow.h>
|
|
#include <rte_mtr.h>
|
|
|
|
#include <mlx5_glue.h>
|
|
#include <mlx5_devx_cmds.h>
|
|
#include <mlx5_prm.h>
|
|
#include <mlx5_common_mp.h>
|
|
#include <mlx5_common_mr.h>
|
|
#include <mlx5_common_devx.h>
|
|
|
|
#include "mlx5_defs.h"
|
|
#include "mlx5_utils.h"
|
|
#include "mlx5_os.h"
|
|
#include "mlx5_autoconf.h"
|
|
|
|
|
|
#define MLX5_SH(dev) (((struct mlx5_priv *)(dev)->data->dev_private)->sh)
|
|
|
|
enum mlx5_ipool_index {
|
|
#if defined(HAVE_IBV_FLOW_DV_SUPPORT) || !defined(HAVE_INFINIBAND_VERBS_H)
|
|
MLX5_IPOOL_DECAP_ENCAP = 0, /* Pool for encap/decap resource. */
|
|
MLX5_IPOOL_PUSH_VLAN, /* Pool for push vlan resource. */
|
|
MLX5_IPOOL_TAG, /* Pool for tag resource. */
|
|
MLX5_IPOOL_PORT_ID, /* Pool for port id resource. */
|
|
MLX5_IPOOL_JUMP, /* Pool for jump resource. */
|
|
MLX5_IPOOL_SAMPLE, /* Pool for sample resource. */
|
|
MLX5_IPOOL_DEST_ARRAY, /* Pool for destination array resource. */
|
|
MLX5_IPOOL_TUNNEL_ID, /* Pool for tunnel offload context */
|
|
MLX5_IPOOL_TNL_TBL_ID, /* Pool for tunnel table ID. */
|
|
#endif
|
|
MLX5_IPOOL_MTR, /* Pool for meter resource. */
|
|
MLX5_IPOOL_MCP, /* Pool for metadata resource. */
|
|
MLX5_IPOOL_HRXQ, /* Pool for hrxq resource. */
|
|
MLX5_IPOOL_MLX5_FLOW, /* Pool for mlx5 flow handle. */
|
|
MLX5_IPOOL_RTE_FLOW, /* Pool for rte_flow. */
|
|
MLX5_IPOOL_RSS_EXPANTION_FLOW_ID, /* Pool for Queue/RSS flow ID. */
|
|
MLX5_IPOOL_RSS_SHARED_ACTIONS, /* Pool for RSS shared actions. */
|
|
MLX5_IPOOL_MTR_POLICY, /* Pool for meter policy resource. */
|
|
MLX5_IPOOL_MAX,
|
|
};
|
|
|
|
/*
|
|
* There are three reclaim memory mode supported.
|
|
* 0(none) means no memory reclaim.
|
|
* 1(light) means only PMD level reclaim.
|
|
* 2(aggressive) means both PMD and rdma-core level reclaim.
|
|
*/
|
|
enum mlx5_reclaim_mem_mode {
|
|
MLX5_RCM_NONE, /* Don't reclaim memory. */
|
|
MLX5_RCM_LIGHT, /* Reclaim PMD level. */
|
|
MLX5_RCM_AGGR, /* Reclaim PMD and rdma-core level. */
|
|
};
|
|
|
|
/* Hash and cache list callback context. */
|
|
struct mlx5_flow_cb_ctx {
|
|
struct rte_eth_dev *dev;
|
|
struct rte_flow_error *error;
|
|
void *data;
|
|
};
|
|
|
|
/* Device attributes used in mlx5 PMD */
|
|
struct mlx5_dev_attr {
|
|
uint64_t device_cap_flags_ex;
|
|
int max_qp_wr;
|
|
int max_sge;
|
|
int max_cq;
|
|
int max_qp;
|
|
int max_cqe;
|
|
uint32_t max_pd;
|
|
uint32_t max_mr;
|
|
uint32_t max_srq;
|
|
uint32_t max_srq_wr;
|
|
uint32_t raw_packet_caps;
|
|
uint32_t max_rwq_indirection_table_size;
|
|
uint32_t max_tso;
|
|
uint32_t tso_supported_qpts;
|
|
uint64_t flags;
|
|
uint64_t comp_mask;
|
|
uint32_t sw_parsing_offloads;
|
|
uint32_t min_single_stride_log_num_of_bytes;
|
|
uint32_t max_single_stride_log_num_of_bytes;
|
|
uint32_t min_single_wqe_log_num_of_strides;
|
|
uint32_t max_single_wqe_log_num_of_strides;
|
|
uint32_t stride_supported_qpts;
|
|
uint32_t tunnel_offloads_caps;
|
|
char fw_ver[64];
|
|
};
|
|
|
|
/** Data associated with devices to spawn. */
|
|
struct mlx5_dev_spawn_data {
|
|
uint32_t ifindex; /**< Network interface index. */
|
|
uint32_t max_port; /**< Device maximal port index. */
|
|
uint32_t phys_port; /**< Device physical port index. */
|
|
int pf_bond; /**< bonding device PF index. < 0 - no bonding */
|
|
struct mlx5_switch_info info; /**< Switch information. */
|
|
void *phys_dev; /**< Associated physical device. */
|
|
struct rte_eth_dev *eth_dev; /**< Associated Ethernet device. */
|
|
struct rte_pci_device *pci_dev; /**< Backend PCI device. */
|
|
struct mlx5_bond_info *bond_info;
|
|
};
|
|
|
|
/** Data associated with socket messages. */
|
|
struct mlx5_flow_dump_req {
|
|
uint32_t port_id; /**< There are plans in DPDK to extend port_id. */
|
|
uint64_t flow_id;
|
|
} __rte_packed;
|
|
|
|
struct mlx5_flow_dump_ack {
|
|
int rc; /**< Return code. */
|
|
};
|
|
|
|
/** Key string for IPC. */
|
|
#define MLX5_MP_NAME "net_mlx5_mp"
|
|
|
|
|
|
LIST_HEAD(mlx5_dev_list, mlx5_dev_ctx_shared);
|
|
|
|
/* Shared data between primary and secondary processes. */
|
|
struct mlx5_shared_data {
|
|
rte_spinlock_t lock;
|
|
/* Global spinlock for primary and secondary processes. */
|
|
int init_done; /* Whether primary has done initialization. */
|
|
unsigned int secondary_cnt; /* Number of secondary processes init'd. */
|
|
struct mlx5_dev_list mem_event_cb_list;
|
|
rte_rwlock_t mem_event_rwlock;
|
|
};
|
|
|
|
/* Per-process data structure, not visible to other processes. */
|
|
struct mlx5_local_data {
|
|
int init_done; /* Whether a secondary has done initialization. */
|
|
};
|
|
|
|
extern struct mlx5_shared_data *mlx5_shared_data;
|
|
|
|
/* Dev ops structs */
|
|
extern const struct eth_dev_ops mlx5_dev_ops;
|
|
extern const struct eth_dev_ops mlx5_dev_sec_ops;
|
|
extern const struct eth_dev_ops mlx5_dev_ops_isolate;
|
|
|
|
struct mlx5_counter_ctrl {
|
|
/* Name of the counter. */
|
|
char dpdk_name[RTE_ETH_XSTATS_NAME_SIZE];
|
|
/* Name of the counter on the device table. */
|
|
char ctr_name[RTE_ETH_XSTATS_NAME_SIZE];
|
|
uint32_t dev:1; /**< Nonzero for dev counters. */
|
|
};
|
|
|
|
struct mlx5_xstats_ctrl {
|
|
/* Number of device stats. */
|
|
uint16_t stats_n;
|
|
/* Number of device stats identified by PMD. */
|
|
uint16_t mlx5_stats_n;
|
|
/* Index in the device counters table. */
|
|
uint16_t dev_table_idx[MLX5_MAX_XSTATS];
|
|
uint64_t base[MLX5_MAX_XSTATS];
|
|
uint64_t xstats[MLX5_MAX_XSTATS];
|
|
uint64_t hw_stats[MLX5_MAX_XSTATS];
|
|
struct mlx5_counter_ctrl info[MLX5_MAX_XSTATS];
|
|
};
|
|
|
|
struct mlx5_stats_ctrl {
|
|
/* Base for imissed counter. */
|
|
uint64_t imissed_base;
|
|
uint64_t imissed;
|
|
};
|
|
|
|
/* Default PMD specific parameter value. */
|
|
#define MLX5_ARG_UNSET (-1)
|
|
|
|
#define MLX5_LRO_SUPPORTED(dev) \
|
|
(((struct mlx5_priv *)((dev)->data->dev_private))->config.lro.supported)
|
|
|
|
/* Maximal size of coalesced segment for LRO is set in chunks of 256 Bytes. */
|
|
#define MLX5_LRO_SEG_CHUNK_SIZE 256u
|
|
|
|
/* Maximal size of aggregated LRO packet. */
|
|
#define MLX5_MAX_LRO_SIZE (UINT8_MAX * MLX5_LRO_SEG_CHUNK_SIZE)
|
|
|
|
/* Maximal number of segments to split. */
|
|
#define MLX5_MAX_RXQ_NSEG (1u << MLX5_MAX_LOG_RQ_SEGS)
|
|
|
|
/* LRO configurations structure. */
|
|
struct mlx5_lro_config {
|
|
uint32_t supported:1; /* Whether LRO is supported. */
|
|
uint32_t timeout; /* User configuration. */
|
|
};
|
|
|
|
/*
|
|
* Device configuration structure.
|
|
*
|
|
* Merged configuration from:
|
|
*
|
|
* - Device capabilities,
|
|
* - User device parameters disabled features.
|
|
*/
|
|
struct mlx5_dev_config {
|
|
unsigned int hw_csum:1; /* Checksum offload is supported. */
|
|
unsigned int hw_vlan_strip:1; /* VLAN stripping is supported. */
|
|
unsigned int hw_vlan_insert:1; /* VLAN insertion in WQE is supported. */
|
|
unsigned int hw_fcs_strip:1; /* FCS stripping is supported. */
|
|
unsigned int hw_padding:1; /* End alignment padding is supported. */
|
|
unsigned int vf:1; /* This is a VF. */
|
|
unsigned int tunnel_en:1;
|
|
/* Whether tunnel stateless offloads are supported. */
|
|
unsigned int mpls_en:1; /* MPLS over GRE/UDP is enabled. */
|
|
unsigned int cqe_comp:1; /* CQE compression is enabled. */
|
|
unsigned int cqe_comp_fmt:3; /* CQE compression format. */
|
|
unsigned int tso:1; /* Whether TSO is supported. */
|
|
unsigned int rx_vec_en:1; /* Rx vector is enabled. */
|
|
unsigned int mr_ext_memseg_en:1;
|
|
/* Whether memseg should be extended for MR creation. */
|
|
unsigned int l3_vxlan_en:1; /* Enable L3 VXLAN flow creation. */
|
|
unsigned int vf_nl_en:1; /* Enable Netlink requests in VF mode. */
|
|
unsigned int dv_esw_en:1; /* Enable E-Switch DV flow. */
|
|
unsigned int dv_flow_en:1; /* Enable DV flow. */
|
|
unsigned int dv_xmeta_en:2; /* Enable extensive flow metadata. */
|
|
unsigned int lacp_by_user:1;
|
|
/* Enable user to manage LACP traffic. */
|
|
unsigned int swp:1; /* Tx generic tunnel checksum and TSO offload. */
|
|
unsigned int devx:1; /* Whether devx interface is available or not. */
|
|
unsigned int dest_tir:1; /* Whether advanced DR API is available. */
|
|
unsigned int reclaim_mode:2; /* Memory reclaim mode. */
|
|
unsigned int rt_timestamp:1; /* realtime timestamp format. */
|
|
unsigned int sys_mem_en:1; /* The default memory allocator. */
|
|
unsigned int decap_en:1; /* Whether decap will be used or not. */
|
|
unsigned int dv_miss_info:1; /* restore packet after partial hw miss */
|
|
struct {
|
|
unsigned int enabled:1; /* Whether MPRQ is enabled. */
|
|
unsigned int stride_num_n; /* Number of strides. */
|
|
unsigned int stride_size_n; /* Size of a stride. */
|
|
unsigned int min_stride_size_n; /* Min size of a stride. */
|
|
unsigned int max_stride_size_n; /* Max size of a stride. */
|
|
unsigned int max_memcpy_len;
|
|
/* Maximum packet size to memcpy Rx packets. */
|
|
unsigned int min_rxqs_num;
|
|
/* Rx queue count threshold to enable MPRQ. */
|
|
} mprq; /* Configurations for Multi-Packet RQ. */
|
|
int mps; /* Multi-packet send supported mode. */
|
|
int dbnc; /* Skip doorbell register write barrier. */
|
|
unsigned int flow_prio; /* Number of flow priorities. */
|
|
enum modify_reg flow_mreg_c[MLX5_MREG_C_NUM];
|
|
/* Availibility of mreg_c's. */
|
|
unsigned int tso_max_payload_sz; /* Maximum TCP payload for TSO. */
|
|
unsigned int ind_table_max_size; /* Maximum indirection table size. */
|
|
unsigned int max_dump_files_num; /* Maximum dump files per queue. */
|
|
unsigned int log_hp_size; /* Single hairpin queue data size in total. */
|
|
int txqs_inline; /* Queue number threshold for inlining. */
|
|
int txq_inline_min; /* Minimal amount of data bytes to inline. */
|
|
int txq_inline_max; /* Max packet size for inlining with SEND. */
|
|
int txq_inline_mpw; /* Max packet size for inlining with eMPW. */
|
|
int tx_pp; /* Timestamp scheduling granularity in nanoseconds. */
|
|
int tx_skew; /* Tx scheduling skew between WQE and data on wire. */
|
|
struct mlx5_hca_attr hca_attr; /* HCA attributes. */
|
|
struct mlx5_lro_config lro; /* LRO configuration. */
|
|
};
|
|
|
|
|
|
/* Structure for VF VLAN workaround. */
|
|
struct mlx5_vf_vlan {
|
|
uint32_t tag:12;
|
|
uint32_t created:1;
|
|
};
|
|
|
|
/* Flow drop context necessary due to Verbs API. */
|
|
struct mlx5_drop {
|
|
struct mlx5_hrxq *hrxq; /* Hash Rx queue queue. */
|
|
struct mlx5_rxq_obj *rxq; /* Rx queue object. */
|
|
};
|
|
|
|
/* Loopback dummy queue resources required due to Verbs API. */
|
|
struct mlx5_lb_ctx {
|
|
struct ibv_qp *qp; /* QP object. */
|
|
void *ibv_cq; /* Completion queue. */
|
|
uint16_t refcnt; /* Reference count for representors. */
|
|
};
|
|
|
|
#define MLX5_COUNTERS_PER_POOL 512
|
|
#define MLX5_MAX_PENDING_QUERIES 4
|
|
#define MLX5_CNT_CONTAINER_RESIZE 64
|
|
#define MLX5_CNT_SHARED_OFFSET 0x80000000
|
|
#define IS_LEGACY_SHARED_CNT(cnt) (!!((cnt) & MLX5_CNT_SHARED_OFFSET))
|
|
#define IS_BATCH_CNT(cnt) (((cnt) & (MLX5_CNT_SHARED_OFFSET - 1)) >= \
|
|
MLX5_CNT_BATCH_OFFSET)
|
|
#define MLX5_CNT_SIZE (sizeof(struct mlx5_flow_counter))
|
|
#define MLX5_AGE_SIZE (sizeof(struct mlx5_age_param))
|
|
|
|
#define MLX5_CNT_LEN(pool) \
|
|
(MLX5_CNT_SIZE + \
|
|
((pool)->is_aged ? MLX5_AGE_SIZE : 0))
|
|
#define MLX5_POOL_GET_CNT(pool, index) \
|
|
((struct mlx5_flow_counter *) \
|
|
((uint8_t *)((pool) + 1) + (index) * (MLX5_CNT_LEN(pool))))
|
|
#define MLX5_CNT_ARRAY_IDX(pool, cnt) \
|
|
((int)(((uint8_t *)(cnt) - (uint8_t *)((pool) + 1)) / \
|
|
MLX5_CNT_LEN(pool)))
|
|
/*
|
|
* The pool index and offset of counter in the pool array makes up the
|
|
* counter index. In case the counter is from pool 0 and offset 0, it
|
|
* should plus 1 to avoid index 0, since 0 means invalid counter index
|
|
* currently.
|
|
*/
|
|
#define MLX5_MAKE_CNT_IDX(pi, offset) \
|
|
((pi) * MLX5_COUNTERS_PER_POOL + (offset) + 1)
|
|
#define MLX5_CNT_TO_AGE(cnt) \
|
|
((struct mlx5_age_param *)((cnt) + 1))
|
|
/*
|
|
* The maximum single counter is 0x800000 as MLX5_CNT_BATCH_OFFSET
|
|
* defines. The pool size is 512, pool index should never reach
|
|
* INT16_MAX.
|
|
*/
|
|
#define POOL_IDX_INVALID UINT16_MAX
|
|
|
|
/* Age status. */
|
|
enum {
|
|
AGE_FREE, /* Initialized state. */
|
|
AGE_CANDIDATE, /* Counter assigned to flows. */
|
|
AGE_TMOUT, /* Timeout, wait for rte_flow_get_aged_flows and destroy. */
|
|
};
|
|
|
|
enum mlx5_counter_type {
|
|
MLX5_COUNTER_TYPE_ORIGIN,
|
|
MLX5_COUNTER_TYPE_AGE,
|
|
MLX5_COUNTER_TYPE_MAX,
|
|
};
|
|
|
|
/* Counter age parameter. */
|
|
struct mlx5_age_param {
|
|
uint16_t state; /**< Age state (atomically accessed). */
|
|
uint16_t port_id; /**< Port id of the counter. */
|
|
uint32_t timeout:24; /**< Aging timeout in seconds. */
|
|
uint32_t sec_since_last_hit;
|
|
/**< Time in seconds since last hit (atomically accessed). */
|
|
void *context; /**< Flow counter age context. */
|
|
};
|
|
|
|
struct flow_counter_stats {
|
|
uint64_t hits;
|
|
uint64_t bytes;
|
|
};
|
|
|
|
/* Shared counters information for counters. */
|
|
struct mlx5_flow_counter_shared {
|
|
union {
|
|
uint32_t refcnt; /* Only for shared action management. */
|
|
uint32_t id; /* User counter ID for legacy sharing. */
|
|
};
|
|
};
|
|
|
|
/* Shared counter configuration. */
|
|
struct mlx5_shared_counter_conf {
|
|
struct rte_eth_dev *dev; /* The device shared counter belongs to. */
|
|
uint32_t id; /* The shared counter ID. */
|
|
};
|
|
|
|
struct mlx5_flow_counter_pool;
|
|
/* Generic counters information. */
|
|
struct mlx5_flow_counter {
|
|
union {
|
|
/*
|
|
* User-defined counter shared info is only used during
|
|
* counter active time. And aging counter sharing is not
|
|
* supported, so active shared counter will not be chained
|
|
* to the aging list. For shared counter, only when it is
|
|
* released, the TAILQ entry memory will be used, at that
|
|
* time, shared memory is not used anymore.
|
|
*
|
|
* Similarly to none-batch counter dcs, since it doesn't
|
|
* support aging, while counter is allocated, the entry
|
|
* memory is not used anymore. In this case, as bytes
|
|
* memory is used only when counter is allocated, and
|
|
* entry memory is used only when counter is free. The
|
|
* dcs pointer can be saved to these two different place
|
|
* at different stage. It will eliminate the individual
|
|
* counter extend struct.
|
|
*/
|
|
TAILQ_ENTRY(mlx5_flow_counter) next;
|
|
/**< Pointer to the next flow counter structure. */
|
|
struct {
|
|
struct mlx5_flow_counter_shared shared_info;
|
|
/**< Shared counter information. */
|
|
void *dcs_when_active;
|
|
/*
|
|
* For non-batch mode, the dcs will be saved
|
|
* here when the counter is free.
|
|
*/
|
|
};
|
|
};
|
|
union {
|
|
uint64_t hits; /**< Reset value of hits packets. */
|
|
struct mlx5_flow_counter_pool *pool; /**< Counter pool. */
|
|
};
|
|
union {
|
|
uint64_t bytes; /**< Reset value of bytes. */
|
|
void *dcs_when_free;
|
|
/*
|
|
* For non-batch mode, the dcs will be saved here
|
|
* when the counter is free.
|
|
*/
|
|
};
|
|
void *action; /**< Pointer to the dv action. */
|
|
};
|
|
|
|
TAILQ_HEAD(mlx5_counters, mlx5_flow_counter);
|
|
|
|
/* Generic counter pool structure - query is in pool resolution. */
|
|
struct mlx5_flow_counter_pool {
|
|
TAILQ_ENTRY(mlx5_flow_counter_pool) next;
|
|
struct mlx5_counters counters[2]; /* Free counter list. */
|
|
struct mlx5_devx_obj *min_dcs;
|
|
/* The devx object of the minimum counter ID. */
|
|
uint64_t time_of_last_age_check;
|
|
/* System time (from rte_rdtsc()) read in the last aging check. */
|
|
uint32_t index:30; /* Pool index in container. */
|
|
uint32_t is_aged:1; /* Pool with aging counter. */
|
|
volatile uint32_t query_gen:1; /* Query round. */
|
|
rte_spinlock_t sl; /* The pool lock. */
|
|
rte_spinlock_t csl; /* The pool counter free list lock. */
|
|
struct mlx5_counter_stats_raw *raw;
|
|
struct mlx5_counter_stats_raw *raw_hw;
|
|
/* The raw on HW working. */
|
|
};
|
|
|
|
/* Memory management structure for group of counter statistics raws. */
|
|
struct mlx5_counter_stats_mem_mng {
|
|
LIST_ENTRY(mlx5_counter_stats_mem_mng) next;
|
|
struct mlx5_counter_stats_raw *raws;
|
|
struct mlx5_devx_obj *dm;
|
|
void *umem;
|
|
};
|
|
|
|
/* Raw memory structure for the counter statistics values of a pool. */
|
|
struct mlx5_counter_stats_raw {
|
|
LIST_ENTRY(mlx5_counter_stats_raw) next;
|
|
struct mlx5_counter_stats_mem_mng *mem_mng;
|
|
volatile struct flow_counter_stats *data;
|
|
};
|
|
|
|
TAILQ_HEAD(mlx5_counter_pools, mlx5_flow_counter_pool);
|
|
|
|
/* Counter global management structure. */
|
|
struct mlx5_flow_counter_mng {
|
|
volatile uint16_t n_valid; /* Number of valid pools. */
|
|
uint16_t n; /* Number of pools. */
|
|
uint16_t last_pool_idx; /* Last used pool index */
|
|
int min_id; /* The minimum counter ID in the pools. */
|
|
int max_id; /* The maximum counter ID in the pools. */
|
|
rte_spinlock_t pool_update_sl; /* The pool update lock. */
|
|
rte_spinlock_t csl[MLX5_COUNTER_TYPE_MAX];
|
|
/* The counter free list lock. */
|
|
struct mlx5_counters counters[MLX5_COUNTER_TYPE_MAX];
|
|
/* Free counter list. */
|
|
struct mlx5_flow_counter_pool **pools; /* Counter pool array. */
|
|
struct mlx5_counter_stats_mem_mng *mem_mng;
|
|
/* Hold the memory management for the next allocated pools raws. */
|
|
struct mlx5_counters flow_counters; /* Legacy flow counter list. */
|
|
uint8_t pending_queries;
|
|
uint16_t pool_index;
|
|
uint8_t query_thread_on;
|
|
bool relaxed_ordering_read;
|
|
bool relaxed_ordering_write;
|
|
bool counter_fallback; /* Use counter fallback management. */
|
|
LIST_HEAD(mem_mngs, mlx5_counter_stats_mem_mng) mem_mngs;
|
|
LIST_HEAD(stat_raws, mlx5_counter_stats_raw) free_stat_raws;
|
|
};
|
|
|
|
/* ASO structures. */
|
|
#define MLX5_ASO_QUEUE_LOG_DESC 10
|
|
|
|
struct mlx5_aso_cq {
|
|
uint16_t log_desc_n;
|
|
uint32_t cq_ci:24;
|
|
struct mlx5_devx_cq cq_obj;
|
|
uint64_t errors;
|
|
};
|
|
|
|
struct mlx5_aso_sq_elem {
|
|
union {
|
|
struct {
|
|
struct mlx5_aso_age_pool *pool;
|
|
uint16_t burst_size;
|
|
};
|
|
struct mlx5_aso_mtr *mtr;
|
|
struct {
|
|
struct mlx5_aso_ct_action *ct;
|
|
char *query_data;
|
|
};
|
|
};
|
|
};
|
|
|
|
struct mlx5_aso_sq {
|
|
uint16_t log_desc_n;
|
|
rte_spinlock_t sqsl;
|
|
struct mlx5_aso_cq cq;
|
|
struct mlx5_devx_sq sq_obj;
|
|
volatile uint64_t *uar_addr;
|
|
struct mlx5_pmd_mr mr;
|
|
uint16_t pi;
|
|
uint32_t head;
|
|
uint32_t tail;
|
|
uint32_t sqn;
|
|
struct mlx5_aso_sq_elem elts[1 << MLX5_ASO_QUEUE_LOG_DESC];
|
|
uint16_t next; /* Pool index of the next pool to query. */
|
|
};
|
|
|
|
struct mlx5_aso_age_action {
|
|
LIST_ENTRY(mlx5_aso_age_action) next;
|
|
void *dr_action;
|
|
uint32_t refcnt;
|
|
/* Following fields relevant only when action is active. */
|
|
uint16_t offset; /* Offset of ASO Flow Hit flag in DevX object. */
|
|
struct mlx5_age_param age_params;
|
|
};
|
|
|
|
#define MLX5_ASO_AGE_ACTIONS_PER_POOL 512
|
|
|
|
struct mlx5_aso_age_pool {
|
|
struct mlx5_devx_obj *flow_hit_aso_obj;
|
|
uint16_t index; /* Pool index in pools array. */
|
|
uint64_t time_of_last_age_check; /* In seconds. */
|
|
struct mlx5_aso_age_action actions[MLX5_ASO_AGE_ACTIONS_PER_POOL];
|
|
};
|
|
|
|
LIST_HEAD(aso_age_list, mlx5_aso_age_action);
|
|
|
|
struct mlx5_aso_age_mng {
|
|
struct mlx5_aso_age_pool **pools;
|
|
uint16_t n; /* Total number of pools. */
|
|
uint16_t next; /* Number of pools in use, index of next free pool. */
|
|
rte_spinlock_t resize_sl; /* Lock for resize objects. */
|
|
rte_spinlock_t free_sl; /* Lock for free list access. */
|
|
struct aso_age_list free; /* Free age actions list - ready to use. */
|
|
struct mlx5_aso_sq aso_sq; /* ASO queue objects. */
|
|
};
|
|
|
|
/* Management structure for geneve tlv option */
|
|
struct mlx5_geneve_tlv_option_resource {
|
|
struct mlx5_devx_obj *obj; /* Pointer to the geneve tlv opt object. */
|
|
rte_be16_t option_class; /* geneve tlv opt class.*/
|
|
uint8_t option_type; /* geneve tlv opt type.*/
|
|
uint8_t length; /* geneve tlv opt length. */
|
|
uint32_t refcnt; /* geneve tlv object reference counter */
|
|
};
|
|
|
|
|
|
#define MLX5_AGE_EVENT_NEW 1
|
|
#define MLX5_AGE_TRIGGER 2
|
|
#define MLX5_AGE_SET(age_info, BIT) \
|
|
((age_info)->flags |= (1 << (BIT)))
|
|
#define MLX5_AGE_UNSET(age_info, BIT) \
|
|
((age_info)->flags &= ~(1 << (BIT)))
|
|
#define MLX5_AGE_GET(age_info, BIT) \
|
|
((age_info)->flags & (1 << (BIT)))
|
|
#define GET_PORT_AGE_INFO(priv) \
|
|
(&((priv)->sh->port[(priv)->dev_port - 1].age_info))
|
|
/* Current time in seconds. */
|
|
#define MLX5_CURR_TIME_SEC (rte_rdtsc() / rte_get_tsc_hz())
|
|
|
|
/* Aging information for per port. */
|
|
struct mlx5_age_info {
|
|
uint8_t flags; /* Indicate if is new event or need to be triggered. */
|
|
struct mlx5_counters aged_counters; /* Aged counter list. */
|
|
struct aso_age_list aged_aso; /* Aged ASO actions list. */
|
|
rte_spinlock_t aged_sl; /* Aged flow list lock. */
|
|
};
|
|
|
|
/* Per port data of shared IB device. */
|
|
struct mlx5_dev_shared_port {
|
|
uint32_t ih_port_id;
|
|
uint32_t devx_ih_port_id;
|
|
/*
|
|
* Interrupt handler port_id. Used by shared interrupt
|
|
* handler to find the corresponding rte_eth device
|
|
* by IB port index. If value is equal or greater
|
|
* RTE_MAX_ETHPORTS it means there is no subhandler
|
|
* installed for specified IB port index.
|
|
*/
|
|
struct mlx5_age_info age_info;
|
|
/* Aging information for per port. */
|
|
};
|
|
|
|
/*
|
|
* Max number of actions per DV flow.
|
|
* See CREATE_FLOW_MAX_FLOW_ACTIONS_SUPPORTED
|
|
* in rdma-core file providers/mlx5/verbs.c.
|
|
*/
|
|
#define MLX5_DV_MAX_NUMBER_OF_ACTIONS 8
|
|
|
|
/*ASO flow meter structures*/
|
|
/* Modify this value if enum rte_mtr_color changes. */
|
|
#define RTE_MTR_DROPPED RTE_COLORS
|
|
/* Yellow is not supported. */
|
|
#define MLX5_MTR_RTE_COLORS (RTE_COLOR_GREEN + 1)
|
|
/* table_id 22 bits in mlx5_flow_tbl_key so limit policy number. */
|
|
#define MLX5_MAX_SUB_POLICY_TBL_NUM 0x3FFFFF
|
|
#define MLX5_INVALID_POLICY_ID UINT32_MAX
|
|
/* Suffix table_id on MLX5_FLOW_TABLE_LEVEL_METER. */
|
|
#define MLX5_MTR_TABLE_ID_SUFFIX 1
|
|
/* Drop table_id on MLX5_FLOW_TABLE_LEVEL_METER. */
|
|
#define MLX5_MTR_TABLE_ID_DROP 2
|
|
|
|
enum mlx5_meter_domain {
|
|
MLX5_MTR_DOMAIN_INGRESS,
|
|
MLX5_MTR_DOMAIN_EGRESS,
|
|
MLX5_MTR_DOMAIN_TRANSFER,
|
|
MLX5_MTR_DOMAIN_MAX,
|
|
};
|
|
#define MLX5_MTR_DOMAIN_INGRESS_BIT (1 << MLX5_MTR_DOMAIN_INGRESS)
|
|
#define MLX5_MTR_DOMAIN_EGRESS_BIT (1 << MLX5_MTR_DOMAIN_EGRESS)
|
|
#define MLX5_MTR_DOMAIN_TRANSFER_BIT (1 << MLX5_MTR_DOMAIN_TRANSFER)
|
|
#define MLX5_MTR_ALL_DOMAIN_BIT (MLX5_MTR_DOMAIN_INGRESS_BIT | \
|
|
MLX5_MTR_DOMAIN_EGRESS_BIT | \
|
|
MLX5_MTR_DOMAIN_TRANSFER_BIT)
|
|
|
|
/*
|
|
* Meter sub-policy structure.
|
|
* Each RSS TIR in meter policy need its own sub-policy resource.
|
|
*/
|
|
struct mlx5_flow_meter_sub_policy {
|
|
uint32_t main_policy_id:1;
|
|
/* Main policy id is same as this sub_policy id. */
|
|
uint32_t idx:31;
|
|
/* Index to sub_policy ipool entity. */
|
|
void *main_policy;
|
|
/* Point to struct mlx5_flow_meter_policy. */
|
|
struct mlx5_flow_tbl_resource *tbl_rsc;
|
|
/* The sub-policy table resource. */
|
|
uint32_t rix_hrxq[MLX5_MTR_RTE_COLORS];
|
|
/* Index to TIR resource. */
|
|
struct mlx5_flow_tbl_resource *jump_tbl[MLX5_MTR_RTE_COLORS];
|
|
/* Meter jump/drop table. */
|
|
struct mlx5_flow_dv_matcher *color_matcher[RTE_COLORS];
|
|
/* Matcher for Color. */
|
|
void *color_rule[RTE_COLORS];
|
|
/* Meter green/yellow/drop rule. */
|
|
};
|
|
|
|
struct mlx5_meter_policy_acts {
|
|
uint8_t actions_n;
|
|
/* Number of actions. */
|
|
void *dv_actions[MLX5_DV_MAX_NUMBER_OF_ACTIONS];
|
|
/* Action list. */
|
|
};
|
|
|
|
struct mlx5_meter_policy_action_container {
|
|
uint32_t rix_mark;
|
|
/* Index to the mark action. */
|
|
struct mlx5_flow_dv_modify_hdr_resource *modify_hdr;
|
|
/* Pointer to modify header resource in cache. */
|
|
uint8_t fate_action;
|
|
/* Fate action type. */
|
|
union {
|
|
struct rte_flow_action *rss;
|
|
/* Rss action configuration. */
|
|
uint32_t rix_port_id_action;
|
|
/* Index to port ID action resource. */
|
|
void *dr_jump_action[MLX5_MTR_DOMAIN_MAX];
|
|
/* Jump/drop action per color. */
|
|
uint16_t queue;
|
|
/* Queue action configuration. */
|
|
};
|
|
};
|
|
|
|
/* Flow meter policy parameter structure. */
|
|
struct mlx5_flow_meter_policy {
|
|
struct rte_eth_dev *dev;
|
|
/* The port dev on which policy is created. */
|
|
uint32_t is_rss:1;
|
|
/* Is RSS policy table. */
|
|
uint32_t ingress:1;
|
|
/* Rule applies to ingress domain. */
|
|
uint32_t egress:1;
|
|
/* Rule applies to egress domain. */
|
|
uint32_t transfer:1;
|
|
/* Rule applies to transfer domain. */
|
|
uint32_t is_queue:1;
|
|
/* Is queue action in policy table. */
|
|
rte_spinlock_t sl;
|
|
uint32_t ref_cnt;
|
|
/* Use count. */
|
|
struct mlx5_meter_policy_action_container act_cnt[MLX5_MTR_RTE_COLORS];
|
|
/* Policy actions container. */
|
|
void *dr_drop_action[MLX5_MTR_DOMAIN_MAX];
|
|
/* drop action for red color. */
|
|
uint16_t sub_policy_num;
|
|
/* Count sub policy tables, 3 bits per domain. */
|
|
struct mlx5_flow_meter_sub_policy **sub_policys[MLX5_MTR_DOMAIN_MAX];
|
|
/* Sub policy table array must be the end of struct. */
|
|
};
|
|
|
|
/* The maximum sub policy is relate to struct mlx5_rss_hash_fields[]. */
|
|
#define MLX5_MTR_RSS_MAX_SUB_POLICY 7
|
|
#define MLX5_MTR_SUB_POLICY_NUM_SHIFT 3
|
|
#define MLX5_MTR_SUB_POLICY_NUM_MASK 0x7
|
|
#define MLX5_MTRS_DEFAULT_RULE_PRIORITY 0xFFFF
|
|
|
|
/* Flow meter default policy parameter structure.
|
|
* Policy index 0 is reserved by default policy table.
|
|
* Action per color as below:
|
|
* green - do nothing, yellow - do nothing, red - drop
|
|
*/
|
|
struct mlx5_flow_meter_def_policy {
|
|
struct mlx5_flow_meter_sub_policy sub_policy;
|
|
/* Policy rules jump to other tables. */
|
|
void *dr_jump_action[RTE_COLORS];
|
|
/* Jump action per color. */
|
|
};
|
|
|
|
/* Meter parameter structure. */
|
|
struct mlx5_flow_meter_info {
|
|
uint32_t meter_id;
|
|
/**< Meter id. */
|
|
uint32_t policy_id;
|
|
/* Policy id, the first sub_policy idx. */
|
|
struct mlx5_flow_meter_profile *profile;
|
|
/**< Meter profile parameters. */
|
|
rte_spinlock_t sl; /**< Meter action spinlock. */
|
|
/** Set of stats counters to be enabled.
|
|
* @see enum rte_mtr_stats_type
|
|
*/
|
|
uint32_t bytes_dropped:1;
|
|
/** Set bytes dropped stats to be enabled. */
|
|
uint32_t pkts_dropped:1;
|
|
/** Set packets dropped stats to be enabled. */
|
|
uint32_t active_state:1;
|
|
/**< Meter hw active state. */
|
|
uint32_t shared:1;
|
|
/**< Meter shared or not. */
|
|
uint32_t is_enable:1;
|
|
/**< Meter disable/enable state. */
|
|
uint32_t ingress:1;
|
|
/**< Rule applies to egress traffic. */
|
|
uint32_t egress:1;
|
|
/**
|
|
* Instead of simply matching the properties of traffic as it would
|
|
* appear on a given DPDK port ID, enabling this attribute transfers
|
|
* a flow rule to the lowest possible level of any device endpoints
|
|
* found in the pattern.
|
|
*
|
|
* When supported, this effectively enables an application to
|
|
* re-route traffic not necessarily intended for it (e.g. coming
|
|
* from or addressed to different physical ports, VFs or
|
|
* applications) at the device level.
|
|
*
|
|
* It complements the behavior of some pattern items such as
|
|
* RTE_FLOW_ITEM_TYPE_PHY_PORT and is meaningless without them.
|
|
*
|
|
* When transferring flow rules, ingress and egress attributes keep
|
|
* their original meaning, as if processing traffic emitted or
|
|
* received by the application.
|
|
*/
|
|
uint32_t transfer:1;
|
|
uint32_t def_policy:1;
|
|
/* Meter points to default policy. */
|
|
void *drop_rule[MLX5_MTR_DOMAIN_MAX];
|
|
/* Meter drop rule in drop table. */
|
|
uint32_t drop_cnt;
|
|
/**< Color counter for drop. */
|
|
uint32_t ref_cnt;
|
|
/**< Use count. */
|
|
struct mlx5_indexed_pool *flow_ipool;
|
|
/**< Index pool for flow id. */
|
|
void *meter_action;
|
|
/**< Flow meter action. */
|
|
};
|
|
|
|
/* PPS(packets per second) map to BPS(Bytes per second).
|
|
* HW treat packet as 128bytes in PPS mode
|
|
*/
|
|
#define MLX5_MTRS_PPS_MAP_BPS_SHIFT 7
|
|
|
|
/* RFC2697 parameter structure. */
|
|
struct mlx5_flow_meter_srtcm_rfc2697_prm {
|
|
rte_be32_t cbs_cir;
|
|
/*
|
|
* bit 24-28: cbs_exponent, bit 16-23 cbs_mantissa,
|
|
* bit 8-12: cir_exponent, bit 0-7 cir_mantissa.
|
|
*/
|
|
rte_be32_t ebs_eir;
|
|
/*
|
|
* bit 24-28: ebs_exponent, bit 16-23 ebs_mantissa,
|
|
* bit 8-12: eir_exponent, bit 0-7 eir_mantissa.
|
|
*/
|
|
};
|
|
|
|
/* Flow meter profile structure. */
|
|
struct mlx5_flow_meter_profile {
|
|
TAILQ_ENTRY(mlx5_flow_meter_profile) next;
|
|
/**< Pointer to the next flow meter structure. */
|
|
uint32_t id; /**< Profile id. */
|
|
struct rte_mtr_meter_profile profile; /**< Profile detail. */
|
|
union {
|
|
struct mlx5_flow_meter_srtcm_rfc2697_prm srtcm_prm;
|
|
/**< srtcm_rfc2697 struct. */
|
|
};
|
|
uint32_t ref_cnt; /**< Use count. */
|
|
};
|
|
|
|
/* 2 meters in each ASO cache line */
|
|
#define MLX5_MTRS_CONTAINER_RESIZE 64
|
|
/*
|
|
* The pool index and offset of meter in the pool array makes up the
|
|
* meter index. In case the meter is from pool 0 and offset 0, it
|
|
* should plus 1 to avoid index 0, since 0 means invalid meter index
|
|
* currently.
|
|
*/
|
|
#define MLX5_MAKE_MTR_IDX(pi, offset) \
|
|
((pi) * MLX5_ASO_MTRS_PER_POOL + (offset) + 1)
|
|
|
|
/*aso flow meter state*/
|
|
enum mlx5_aso_mtr_state {
|
|
ASO_METER_FREE, /* In free list. */
|
|
ASO_METER_WAIT, /* ACCESS_ASO WQE in progress. */
|
|
ASO_METER_READY, /* CQE received. */
|
|
};
|
|
|
|
/* Generic aso_flow_meter information. */
|
|
struct mlx5_aso_mtr {
|
|
LIST_ENTRY(mlx5_aso_mtr) next;
|
|
struct mlx5_flow_meter_info fm;
|
|
/**< Pointer to the next aso flow meter structure. */
|
|
uint8_t state; /**< ASO flow meter state. */
|
|
uint8_t offset;
|
|
};
|
|
|
|
/* Generic aso_flow_meter pool structure. */
|
|
struct mlx5_aso_mtr_pool {
|
|
struct mlx5_aso_mtr mtrs[MLX5_ASO_MTRS_PER_POOL];
|
|
/*Must be the first in pool*/
|
|
struct mlx5_devx_obj *devx_obj;
|
|
/* The devx object of the minimum aso flow meter ID. */
|
|
uint32_t index; /* Pool index in management structure. */
|
|
};
|
|
|
|
LIST_HEAD(aso_meter_list, mlx5_aso_mtr);
|
|
/* Pools management structure for ASO flow meter pools. */
|
|
struct mlx5_aso_mtr_pools_mng {
|
|
volatile uint16_t n_valid; /* Number of valid pools. */
|
|
uint16_t n; /* Number of pools. */
|
|
rte_spinlock_t mtrsl; /* The ASO flow meter free list lock. */
|
|
struct aso_meter_list meters; /* Free ASO flow meter list. */
|
|
struct mlx5_aso_sq sq; /*SQ using by ASO flow meter. */
|
|
struct mlx5_aso_mtr_pool **pools; /* ASO flow meter pool array. */
|
|
};
|
|
|
|
/* Meter management structure for global flow meter resource. */
|
|
struct mlx5_flow_mtr_mng {
|
|
struct mlx5_aso_mtr_pools_mng pools_mng;
|
|
/* Pools management structure for ASO flow meter pools. */
|
|
struct mlx5_flow_meter_def_policy *def_policy[MLX5_MTR_DOMAIN_MAX];
|
|
/* Default policy table. */
|
|
uint32_t def_policy_id;
|
|
/* Default policy id. */
|
|
uint32_t def_policy_ref_cnt;
|
|
/** def_policy meter use count. */
|
|
struct mlx5_flow_tbl_resource *drop_tbl[MLX5_MTR_DOMAIN_MAX];
|
|
/* Meter drop table. */
|
|
struct mlx5_flow_dv_matcher *
|
|
drop_matcher[MLX5_MTR_DOMAIN_MAX][MLX5_REG_BITS];
|
|
/* Matcher meter in drop table. */
|
|
struct mlx5_flow_dv_matcher *def_matcher[MLX5_MTR_DOMAIN_MAX];
|
|
/* Default matcher in drop table. */
|
|
void *def_rule[MLX5_MTR_DOMAIN_MAX];
|
|
/* Default rule in drop table. */
|
|
uint8_t max_mtr_bits;
|
|
/* Indicate how many bits are used by meter id at the most. */
|
|
uint8_t max_mtr_flow_bits;
|
|
/* Indicate how many bits are used by meter flow id at the most. */
|
|
};
|
|
|
|
/* Table key of the hash organization. */
|
|
union mlx5_flow_tbl_key {
|
|
struct {
|
|
/* Table ID should be at the lowest address. */
|
|
uint32_t level; /**< Level of the table. */
|
|
uint32_t id:22; /**< ID of the table. */
|
|
uint32_t dummy:1; /**< Dummy table for DV API. */
|
|
uint32_t is_fdb:1; /**< 1 - FDB, 0 - NIC TX/RX. */
|
|
uint32_t is_egress:1; /**< 1 - egress, 0 - ingress. */
|
|
uint32_t reserved:7; /**< must be zero for comparison. */
|
|
};
|
|
uint64_t v64; /**< full 64bits value of key */
|
|
};
|
|
|
|
/* Table structure. */
|
|
struct mlx5_flow_tbl_resource {
|
|
void *obj; /**< Pointer to DR table object. */
|
|
uint32_t refcnt; /**< Reference counter. */
|
|
};
|
|
|
|
#define MLX5_MAX_TABLES UINT16_MAX
|
|
#define MLX5_HAIRPIN_TX_TABLE (UINT16_MAX - 1)
|
|
/* Reserve the last two tables for metadata register copy. */
|
|
#define MLX5_FLOW_MREG_ACT_TABLE_GROUP (MLX5_MAX_TABLES - 1)
|
|
#define MLX5_FLOW_MREG_CP_TABLE_GROUP (MLX5_MAX_TABLES - 2)
|
|
/* Tables for metering splits should be added here. */
|
|
#define MLX5_FLOW_TABLE_LEVEL_METER (MLX5_MAX_TABLES - 3)
|
|
#define MLX5_FLOW_TABLE_LEVEL_POLICY (MLX5_MAX_TABLES - 4)
|
|
#define MLX5_MAX_TABLES_EXTERNAL MLX5_FLOW_TABLE_LEVEL_POLICY
|
|
#define MLX5_MAX_TABLES_FDB UINT16_MAX
|
|
#define MLX5_FLOW_TABLE_FACTOR 10
|
|
|
|
/* ID generation structure. */
|
|
struct mlx5_flow_id_pool {
|
|
uint32_t *free_arr; /**< Pointer to the a array of free values. */
|
|
uint32_t base_index;
|
|
/**< The next index that can be used without any free elements. */
|
|
uint32_t *curr; /**< Pointer to the index to pop. */
|
|
uint32_t *last; /**< Pointer to the last element in the empty arrray. */
|
|
uint32_t max_id; /**< Maximum id can be allocated from the pool. */
|
|
};
|
|
|
|
/* Tx pacing queue structure - for Clock and Rearm queues. */
|
|
struct mlx5_txpp_wq {
|
|
/* Completion Queue related data.*/
|
|
struct mlx5_devx_cq cq_obj;
|
|
uint32_t cq_ci:24;
|
|
uint32_t arm_sn:2;
|
|
/* Send Queue related data.*/
|
|
struct mlx5_devx_sq sq_obj;
|
|
uint16_t sq_size; /* Number of WQEs in the queue. */
|
|
uint16_t sq_ci; /* Next WQE to execute. */
|
|
};
|
|
|
|
/* Tx packet pacing internal timestamp. */
|
|
struct mlx5_txpp_ts {
|
|
uint64_t ci_ts;
|
|
uint64_t ts;
|
|
};
|
|
|
|
/* Tx packet pacing structure. */
|
|
struct mlx5_dev_txpp {
|
|
pthread_mutex_t mutex; /* Pacing create/destroy mutex. */
|
|
uint32_t refcnt; /* Pacing reference counter. */
|
|
uint32_t freq; /* Timestamp frequency, Hz. */
|
|
uint32_t tick; /* Completion tick duration in nanoseconds. */
|
|
uint32_t test; /* Packet pacing test mode. */
|
|
int32_t skew; /* Scheduling skew. */
|
|
struct rte_intr_handle intr_handle; /* Periodic interrupt. */
|
|
void *echan; /* Event Channel. */
|
|
struct mlx5_txpp_wq clock_queue; /* Clock Queue. */
|
|
struct mlx5_txpp_wq rearm_queue; /* Clock Queue. */
|
|
void *pp; /* Packet pacing context. */
|
|
uint16_t pp_id; /* Packet pacing context index. */
|
|
uint16_t ts_n; /* Number of captured timestamps. */
|
|
uint16_t ts_p; /* Pointer to statisticks timestamp. */
|
|
struct mlx5_txpp_ts *tsa; /* Timestamps sliding window stats. */
|
|
struct mlx5_txpp_ts ts; /* Cached completion id/timestamp. */
|
|
uint32_t sync_lost:1; /* ci/timestamp synchronization lost. */
|
|
/* Statistics counters. */
|
|
uint64_t err_miss_int; /* Missed service interrupt. */
|
|
uint64_t err_rearm_queue; /* Rearm Queue errors. */
|
|
uint64_t err_clock_queue; /* Clock Queue errors. */
|
|
uint64_t err_ts_past; /* Timestamp in the past. */
|
|
uint64_t err_ts_future; /* Timestamp in the distant future. */
|
|
};
|
|
|
|
/* Supported flex parser profile ID. */
|
|
enum mlx5_flex_parser_profile_id {
|
|
MLX5_FLEX_PARSER_ECPRI_0 = 0,
|
|
MLX5_FLEX_PARSER_MAX = 8,
|
|
};
|
|
|
|
/* Sample ID information of flex parser structure. */
|
|
struct mlx5_flex_parser_profiles {
|
|
uint32_t num; /* Actual number of samples. */
|
|
uint32_t ids[8]; /* Sample IDs for this profile. */
|
|
uint8_t offset[8]; /* Bytes offset of each parser. */
|
|
void *obj; /* Flex parser node object. */
|
|
};
|
|
|
|
/* Max member ports per bonding device. */
|
|
#define MLX5_BOND_MAX_PORTS 2
|
|
|
|
/* Bonding device information. */
|
|
struct mlx5_bond_info {
|
|
int n_port; /* Number of bond member ports. */
|
|
uint32_t ifindex;
|
|
char ifname[MLX5_NAMESIZE + 1];
|
|
struct {
|
|
char ifname[MLX5_NAMESIZE + 1];
|
|
uint32_t ifindex;
|
|
struct rte_pci_addr pci_addr;
|
|
} ports[MLX5_BOND_MAX_PORTS];
|
|
};
|
|
|
|
/* Number of connection tracking objects per pool: must be a power of 2. */
|
|
#define MLX5_ASO_CT_ACTIONS_PER_POOL 64
|
|
|
|
/* Generate incremental and unique CT index from pool and offset. */
|
|
#define MLX5_MAKE_CT_IDX(pool, offset) \
|
|
((pool) * MLX5_ASO_CT_ACTIONS_PER_POOL + (offset) + 1)
|
|
|
|
/* ASO Conntrack state. */
|
|
enum mlx5_aso_ct_state {
|
|
ASO_CONNTRACK_FREE, /* Inactive, in the free list. */
|
|
ASO_CONNTRACK_WAIT, /* WQE sent in the SQ. */
|
|
ASO_CONNTRACK_READY, /* CQE received w/o error. */
|
|
ASO_CONNTRACK_QUERY, /* WQE for query sent. */
|
|
ASO_CONNTRACK_MAX, /* Guard. */
|
|
};
|
|
|
|
/* Generic ASO connection tracking structure. */
|
|
struct mlx5_aso_ct_action {
|
|
LIST_ENTRY(mlx5_aso_ct_action) next; /* Pointer to the next ASO CT. */
|
|
void *dr_action_orig; /* General action object for original dir. */
|
|
void *dr_action_rply; /* General action object for reply dir. */
|
|
uint32_t refcnt; /* Action used count in device flows. */
|
|
uint16_t offset; /* Offset of ASO CT in DevX objects bulk. */
|
|
uint16_t peer; /* The only peer port index could also use this CT. */
|
|
enum mlx5_aso_ct_state state; /* ASO CT state. */
|
|
bool is_original; /* The direction of the DR action to be used. */
|
|
};
|
|
|
|
/* CT action object state update. */
|
|
#define MLX5_ASO_CT_UPDATE_STATE(c, s) \
|
|
__atomic_store_n(&((c)->state), (s), __ATOMIC_RELAXED)
|
|
|
|
/* ASO connection tracking software pool definition. */
|
|
struct mlx5_aso_ct_pool {
|
|
uint16_t index; /* Pool index in pools array. */
|
|
struct mlx5_devx_obj *devx_obj;
|
|
/* The first devx object in the bulk, used for freeing (not yet). */
|
|
struct mlx5_aso_ct_action actions[MLX5_ASO_CT_ACTIONS_PER_POOL];
|
|
/* CT action structures bulk. */
|
|
};
|
|
|
|
LIST_HEAD(aso_ct_list, mlx5_aso_ct_action);
|
|
|
|
/* Pools management structure for ASO connection tracking pools. */
|
|
struct mlx5_aso_ct_pools_mng {
|
|
struct mlx5_aso_ct_pool **pools;
|
|
uint16_t n; /* Total number of pools. */
|
|
uint16_t next; /* Number of pools in use, index of next free pool. */
|
|
rte_spinlock_t ct_sl; /* The ASO CT free list lock. */
|
|
rte_rwlock_t resize_rwl; /* The ASO CT pool resize lock. */
|
|
struct aso_ct_list free_cts; /* Free ASO CT objects list. */
|
|
struct mlx5_aso_sq aso_sq; /* ASO queue objects. */
|
|
};
|
|
|
|
/*
|
|
* Shared Infiniband device context for Master/Representors
|
|
* which belong to same IB device with multiple IB ports.
|
|
**/
|
|
struct mlx5_dev_ctx_shared {
|
|
LIST_ENTRY(mlx5_dev_ctx_shared) next;
|
|
uint32_t refcnt;
|
|
uint32_t devx:1; /* Opened with DV. */
|
|
uint32_t flow_hit_aso_en:1; /* Flow Hit ASO is supported. */
|
|
uint32_t rq_ts_format:2; /* RQ timestamp formats supported. */
|
|
uint32_t sq_ts_format:2; /* SQ timestamp formats supported. */
|
|
uint32_t qp_ts_format:2; /* QP timestamp formats supported. */
|
|
uint32_t meter_aso_en:1; /* Flow Meter ASO is supported. */
|
|
uint32_t ct_aso_en:1; /* Connection Tracking ASO is supported. */
|
|
uint32_t max_port; /* Maximal IB device port index. */
|
|
struct mlx5_bond_info bond; /* Bonding information. */
|
|
void *ctx; /* Verbs/DV/DevX context. */
|
|
void *pd; /* Protection Domain. */
|
|
uint32_t pdn; /* Protection Domain number. */
|
|
uint32_t tdn; /* Transport Domain number. */
|
|
char ibdev_name[MLX5_FS_NAME_MAX]; /* SYSFS dev name. */
|
|
char ibdev_path[MLX5_FS_PATH_MAX]; /* SYSFS dev path for secondary */
|
|
struct mlx5_dev_attr device_attr; /* Device properties. */
|
|
int numa_node; /* Numa node of backing physical device. */
|
|
LIST_ENTRY(mlx5_dev_ctx_shared) mem_event_cb;
|
|
/**< Called by memory event callback. */
|
|
struct mlx5_mr_share_cache share_cache;
|
|
/* Packet pacing related structure. */
|
|
struct mlx5_dev_txpp txpp;
|
|
/* Shared DV/DR flow data section. */
|
|
uint32_t dv_meta_mask; /* flow META metadata supported mask. */
|
|
uint32_t dv_mark_mask; /* flow MARK metadata supported mask. */
|
|
uint32_t dv_regc0_mask; /* available bits of metatada reg_c[0]. */
|
|
void *fdb_domain; /* FDB Direct Rules name space handle. */
|
|
void *rx_domain; /* RX Direct Rules name space handle. */
|
|
void *tx_domain; /* TX Direct Rules name space handle. */
|
|
#ifndef RTE_ARCH_64
|
|
rte_spinlock_t uar_lock_cq; /* CQs share a common distinct UAR */
|
|
rte_spinlock_t uar_lock[MLX5_UAR_PAGE_NUM_MAX];
|
|
/* UAR same-page access control required in 32bit implementations. */
|
|
#endif
|
|
struct mlx5_hlist *flow_tbls;
|
|
struct mlx5_flow_tunnel_hub *tunnel_hub;
|
|
/* Direct Rules tables for FDB, NIC TX+RX */
|
|
void *dr_drop_action; /* Pointer to DR drop action, any domain. */
|
|
void *pop_vlan_action; /* Pointer to DR pop VLAN action. */
|
|
struct mlx5_hlist *encaps_decaps; /* Encap/decap action hash list. */
|
|
struct mlx5_hlist *modify_cmds;
|
|
struct mlx5_hlist *tag_table;
|
|
struct mlx5_cache_list port_id_action_list; /* Port ID action cache. */
|
|
struct mlx5_cache_list push_vlan_action_list; /* Push VLAN actions. */
|
|
struct mlx5_cache_list sample_action_list; /* List of sample actions. */
|
|
struct mlx5_cache_list dest_array_list;
|
|
/* List of destination array actions. */
|
|
struct mlx5_flow_counter_mng cmng; /* Counters management structure. */
|
|
void *default_miss_action; /* Default miss action. */
|
|
struct mlx5_indexed_pool *ipool[MLX5_IPOOL_MAX];
|
|
/* Memory Pool for mlx5 flow resources. */
|
|
struct mlx5_l3t_tbl *cnt_id_tbl; /* Shared counter lookup table. */
|
|
/* Shared interrupt handler section. */
|
|
struct rte_intr_handle intr_handle; /* Interrupt handler for device. */
|
|
struct rte_intr_handle intr_handle_devx; /* DEVX interrupt handler. */
|
|
void *devx_comp; /* DEVX async comp obj. */
|
|
struct mlx5_devx_obj *tis; /* TIS object. */
|
|
struct mlx5_devx_obj *td; /* Transport domain. */
|
|
void *tx_uar; /* Tx/packet pacing shared UAR. */
|
|
struct mlx5_flex_parser_profiles fp[MLX5_FLEX_PARSER_MAX];
|
|
/* Flex parser profiles information. */
|
|
void *devx_rx_uar; /* DevX UAR for Rx. */
|
|
struct mlx5_aso_age_mng *aso_age_mng;
|
|
/* Management data for aging mechanism using ASO Flow Hit. */
|
|
struct mlx5_geneve_tlv_option_resource *geneve_tlv_option_resource;
|
|
/* Management structure for geneve tlv option */
|
|
rte_spinlock_t geneve_tlv_opt_sl; /* Lock for geneve tlv resource */
|
|
struct mlx5_flow_mtr_mng *mtrmng;
|
|
/* Meter management structure. */
|
|
struct mlx5_aso_ct_pools_mng *ct_mng;
|
|
/* Management data for ASO connection tracking. */
|
|
struct mlx5_lb_ctx self_lb; /* QP to enable self loopback for Devx. */
|
|
struct mlx5_dev_shared_port port[]; /* per device port data array. */
|
|
};
|
|
|
|
/*
|
|
* Per-process private structure.
|
|
* Caution, secondary process may rebuild the struct during port start.
|
|
*/
|
|
struct mlx5_proc_priv {
|
|
size_t uar_table_sz;
|
|
/* Size of UAR register table. */
|
|
void *uar_table[];
|
|
/* Table of UAR registers for each process. */
|
|
};
|
|
|
|
/* MTR profile list. */
|
|
TAILQ_HEAD(mlx5_mtr_profiles, mlx5_flow_meter_profile);
|
|
/* MTR list. */
|
|
TAILQ_HEAD(mlx5_legacy_flow_meters, mlx5_legacy_flow_meter);
|
|
|
|
/* RSS description. */
|
|
struct mlx5_flow_rss_desc {
|
|
uint32_t level;
|
|
uint32_t queue_num; /**< Number of entries in @p queue. */
|
|
uint64_t types; /**< Specific RSS hash types (see ETH_RSS_*). */
|
|
uint64_t hash_fields; /* Verbs Hash fields. */
|
|
uint8_t key[MLX5_RSS_HASH_KEY_LEN]; /**< RSS hash key. */
|
|
uint32_t key_len; /**< RSS hash key len. */
|
|
uint32_t tunnel; /**< Queue in tunnel. */
|
|
uint32_t shared_rss; /**< Shared RSS index. */
|
|
struct mlx5_ind_table_obj *ind_tbl;
|
|
/**< Indirection table for shared RSS hash RX queues. */
|
|
union {
|
|
uint16_t *queue; /**< Destination queues. */
|
|
const uint16_t *const_q; /**< Const pointer convert. */
|
|
};
|
|
};
|
|
|
|
#define MLX5_PROC_PRIV(port_id) \
|
|
((struct mlx5_proc_priv *)rte_eth_devices[port_id].process_private)
|
|
|
|
/* Verbs/DevX Rx queue elements. */
|
|
struct mlx5_rxq_obj {
|
|
LIST_ENTRY(mlx5_rxq_obj) next; /* Pointer to the next element. */
|
|
struct mlx5_rxq_ctrl *rxq_ctrl; /* Back pointer to parent. */
|
|
int fd; /* File descriptor for event channel */
|
|
RTE_STD_C11
|
|
union {
|
|
struct {
|
|
void *wq; /* Work Queue. */
|
|
void *ibv_cq; /* Completion Queue. */
|
|
void *ibv_channel;
|
|
};
|
|
struct mlx5_devx_obj *rq; /* DevX RQ object for hairpin. */
|
|
struct {
|
|
struct mlx5_devx_rq rq_obj; /* DevX RQ object. */
|
|
struct mlx5_devx_cq cq_obj; /* DevX CQ object. */
|
|
void *devx_channel;
|
|
};
|
|
};
|
|
};
|
|
|
|
/* Indirection table. */
|
|
struct mlx5_ind_table_obj {
|
|
LIST_ENTRY(mlx5_ind_table_obj) next; /* Pointer to the next element. */
|
|
uint32_t refcnt; /* Reference counter. */
|
|
RTE_STD_C11
|
|
union {
|
|
void *ind_table; /**< Indirection table. */
|
|
struct mlx5_devx_obj *rqt; /* DevX RQT object. */
|
|
};
|
|
uint32_t queues_n; /**< Number of queues in the list. */
|
|
uint16_t *queues; /**< Queue list. */
|
|
};
|
|
|
|
/* Hash Rx queue. */
|
|
__extension__
|
|
struct mlx5_hrxq {
|
|
struct mlx5_cache_entry entry; /* Cache entry. */
|
|
uint32_t standalone:1; /* This object used in shared action. */
|
|
struct mlx5_ind_table_obj *ind_table; /* Indirection table. */
|
|
RTE_STD_C11
|
|
union {
|
|
void *qp; /* Verbs queue pair. */
|
|
struct mlx5_devx_obj *tir; /* DevX TIR object. */
|
|
};
|
|
#if defined(HAVE_IBV_FLOW_DV_SUPPORT) || !defined(HAVE_INFINIBAND_VERBS_H)
|
|
void *action; /* DV QP action pointer. */
|
|
#endif
|
|
uint64_t hash_fields; /* Verbs Hash fields. */
|
|
uint32_t rss_key_len; /* Hash key length in bytes. */
|
|
uint32_t idx; /* Hash Rx queue index. */
|
|
uint8_t rss_key[]; /* Hash key. */
|
|
};
|
|
|
|
/* Verbs/DevX Tx queue elements. */
|
|
struct mlx5_txq_obj {
|
|
LIST_ENTRY(mlx5_txq_obj) next; /* Pointer to the next element. */
|
|
struct mlx5_txq_ctrl *txq_ctrl; /* Pointer to the control queue. */
|
|
RTE_STD_C11
|
|
union {
|
|
struct {
|
|
void *cq; /* Completion Queue. */
|
|
void *qp; /* Queue Pair. */
|
|
};
|
|
struct {
|
|
struct mlx5_devx_obj *sq;
|
|
/* DevX object for Sx queue. */
|
|
struct mlx5_devx_obj *tis; /* The TIS object. */
|
|
};
|
|
struct {
|
|
struct rte_eth_dev *dev;
|
|
struct mlx5_devx_cq cq_obj;
|
|
/* DevX CQ object and its resources. */
|
|
struct mlx5_devx_sq sq_obj;
|
|
/* DevX SQ object and its resources. */
|
|
};
|
|
};
|
|
};
|
|
|
|
enum mlx5_rxq_modify_type {
|
|
MLX5_RXQ_MOD_ERR2RST, /* modify state from error to reset. */
|
|
MLX5_RXQ_MOD_RST2RDY, /* modify state from reset to ready. */
|
|
MLX5_RXQ_MOD_RDY2ERR, /* modify state from ready to error. */
|
|
MLX5_RXQ_MOD_RDY2RST, /* modify state from ready to reset. */
|
|
};
|
|
|
|
enum mlx5_txq_modify_type {
|
|
MLX5_TXQ_MOD_RST2RDY, /* modify state from reset to ready. */
|
|
MLX5_TXQ_MOD_RDY2RST, /* modify state from ready to reset. */
|
|
MLX5_TXQ_MOD_ERR2RDY, /* modify state from error to ready. */
|
|
};
|
|
|
|
/* HW objects operations structure. */
|
|
struct mlx5_obj_ops {
|
|
int (*rxq_obj_modify_vlan_strip)(struct mlx5_rxq_obj *rxq_obj, int on);
|
|
int (*rxq_obj_new)(struct rte_eth_dev *dev, uint16_t idx);
|
|
int (*rxq_event_get)(struct mlx5_rxq_obj *rxq_obj);
|
|
int (*rxq_obj_modify)(struct mlx5_rxq_obj *rxq_obj, uint8_t type);
|
|
void (*rxq_obj_release)(struct mlx5_rxq_obj *rxq_obj);
|
|
int (*ind_table_new)(struct rte_eth_dev *dev, const unsigned int log_n,
|
|
struct mlx5_ind_table_obj *ind_tbl);
|
|
int (*ind_table_modify)(struct rte_eth_dev *dev,
|
|
const unsigned int log_n,
|
|
const uint16_t *queues, const uint32_t queues_n,
|
|
struct mlx5_ind_table_obj *ind_tbl);
|
|
void (*ind_table_destroy)(struct mlx5_ind_table_obj *ind_tbl);
|
|
int (*hrxq_new)(struct rte_eth_dev *dev, struct mlx5_hrxq *hrxq,
|
|
int tunnel __rte_unused);
|
|
int (*hrxq_modify)(struct rte_eth_dev *dev, struct mlx5_hrxq *hrxq,
|
|
const uint8_t *rss_key,
|
|
uint64_t hash_fields,
|
|
const struct mlx5_ind_table_obj *ind_tbl);
|
|
void (*hrxq_destroy)(struct mlx5_hrxq *hrxq);
|
|
int (*drop_action_create)(struct rte_eth_dev *dev);
|
|
void (*drop_action_destroy)(struct rte_eth_dev *dev);
|
|
int (*txq_obj_new)(struct rte_eth_dev *dev, uint16_t idx);
|
|
int (*txq_obj_modify)(struct mlx5_txq_obj *obj,
|
|
enum mlx5_txq_modify_type type, uint8_t dev_port);
|
|
void (*txq_obj_release)(struct mlx5_txq_obj *txq_obj);
|
|
int (*lb_dummy_queue_create)(struct rte_eth_dev *dev);
|
|
void (*lb_dummy_queue_release)(struct rte_eth_dev *dev);
|
|
};
|
|
|
|
#define MLX5_RSS_HASH_FIELDS_LEN RTE_DIM(mlx5_rss_hash_fields)
|
|
|
|
/* MR operations structure. */
|
|
struct mlx5_mr_ops {
|
|
mlx5_reg_mr_t reg_mr;
|
|
mlx5_dereg_mr_t dereg_mr;
|
|
};
|
|
|
|
struct mlx5_priv {
|
|
struct rte_eth_dev_data *dev_data; /* Pointer to device data. */
|
|
struct mlx5_dev_ctx_shared *sh; /* Shared device context. */
|
|
uint32_t dev_port; /* Device port number. */
|
|
struct rte_pci_device *pci_dev; /* Backend PCI device. */
|
|
struct rte_ether_addr mac[MLX5_MAX_MAC_ADDRESSES]; /* MAC addresses. */
|
|
BITFIELD_DECLARE(mac_own, uint64_t, MLX5_MAX_MAC_ADDRESSES);
|
|
/* Bit-field of MAC addresses owned by the PMD. */
|
|
uint16_t vlan_filter[MLX5_MAX_VLAN_IDS]; /* VLAN filters table. */
|
|
unsigned int vlan_filter_n; /* Number of configured VLAN filters. */
|
|
/* Device properties. */
|
|
uint16_t mtu; /* Configured MTU. */
|
|
unsigned int isolated:1; /* Whether isolated mode is enabled. */
|
|
unsigned int representor:1; /* Device is a port representor. */
|
|
unsigned int master:1; /* Device is a E-Switch master. */
|
|
unsigned int txpp_en:1; /* Tx packet pacing enabled. */
|
|
unsigned int sampler_en:1; /* Whether support sampler. */
|
|
unsigned int mtr_en:1; /* Whether support meter. */
|
|
unsigned int mtr_reg_share:1; /* Whether support meter REG_C share. */
|
|
unsigned int lb_used:1; /* Loopback queue is referred to. */
|
|
uint16_t domain_id; /* Switch domain identifier. */
|
|
uint16_t vport_id; /* Associated VF vport index (if any). */
|
|
uint32_t vport_meta_tag; /* Used for vport index match ove VF LAG. */
|
|
uint32_t vport_meta_mask; /* Used for vport index field match mask. */
|
|
uint16_t representor_id; /* UINT16_MAX if not a representor. */
|
|
int32_t pf_bond; /* >=0, representor owner PF index in bonding. */
|
|
unsigned int if_index; /* Associated kernel network device index. */
|
|
/* RX/TX queues. */
|
|
unsigned int rxqs_n; /* RX queues array size. */
|
|
unsigned int txqs_n; /* TX queues array size. */
|
|
struct mlx5_rxq_data *(*rxqs)[]; /* RX queues. */
|
|
struct mlx5_txq_data *(*txqs)[]; /* TX queues. */
|
|
struct rte_mempool *mprq_mp; /* Mempool for Multi-Packet RQ. */
|
|
struct rte_eth_rss_conf rss_conf; /* RSS configuration. */
|
|
unsigned int (*reta_idx)[]; /* RETA index table. */
|
|
unsigned int reta_idx_n; /* RETA index size. */
|
|
struct mlx5_drop drop_queue; /* Flow drop queues. */
|
|
uint32_t flows; /* RTE Flow rules. */
|
|
uint32_t ctrl_flows; /* Control flow rules. */
|
|
rte_spinlock_t flow_list_lock;
|
|
struct mlx5_obj_ops obj_ops; /* HW objects operations. */
|
|
LIST_HEAD(rxq, mlx5_rxq_ctrl) rxqsctrl; /* DPDK Rx queues. */
|
|
LIST_HEAD(rxqobj, mlx5_rxq_obj) rxqsobj; /* Verbs/DevX Rx queues. */
|
|
struct mlx5_cache_list hrxqs; /* Hash Rx queues. */
|
|
LIST_HEAD(txq, mlx5_txq_ctrl) txqsctrl; /* DPDK Tx queues. */
|
|
LIST_HEAD(txqobj, mlx5_txq_obj) txqsobj; /* Verbs/DevX Tx queues. */
|
|
/* Indirection tables. */
|
|
LIST_HEAD(ind_tables, mlx5_ind_table_obj) ind_tbls;
|
|
/* Pointer to next element. */
|
|
uint32_t refcnt; /**< Reference counter. */
|
|
/**< Verbs modify header action object. */
|
|
uint8_t ft_type; /**< Flow table type, Rx or Tx. */
|
|
uint8_t max_lro_msg_size;
|
|
/* Tags resources cache. */
|
|
uint32_t link_speed_capa; /* Link speed capabilities. */
|
|
struct mlx5_xstats_ctrl xstats_ctrl; /* Extended stats control. */
|
|
struct mlx5_stats_ctrl stats_ctrl; /* Stats control. */
|
|
struct mlx5_dev_config config; /* Device configuration. */
|
|
/* Context for Verbs allocator. */
|
|
int nl_socket_rdma; /* Netlink socket (NETLINK_RDMA). */
|
|
int nl_socket_route; /* Netlink socket (NETLINK_ROUTE). */
|
|
struct mlx5_nl_vlan_vmwa_context *vmwa_context; /* VLAN WA context. */
|
|
struct mlx5_hlist *mreg_cp_tbl;
|
|
/* Hash table of Rx metadata register copy table. */
|
|
uint8_t mtr_sfx_reg; /* Meter prefix-suffix flow match REG_C. */
|
|
uint8_t mtr_color_reg; /* Meter color match REG_C. */
|
|
struct mlx5_legacy_flow_meters flow_meters; /* MTR list. */
|
|
struct mlx5_l3t_tbl *mtr_profile_tbl; /* Meter index lookup table. */
|
|
struct mlx5_l3t_tbl *policy_idx_tbl; /* Policy index lookup table. */
|
|
struct mlx5_l3t_tbl *mtr_idx_tbl; /* Meter index lookup table. */
|
|
uint8_t skip_default_rss_reta; /* Skip configuration of default reta. */
|
|
uint8_t fdb_def_rule; /* Whether fdb jump to table 1 is configured. */
|
|
struct mlx5_mp_id mp_id; /* ID of a multi-process process */
|
|
LIST_HEAD(fdir, mlx5_fdir_flow) fdir_flows; /* fdir flows. */
|
|
rte_spinlock_t shared_act_sl; /* Shared actions spinlock. */
|
|
uint32_t rss_shared_actions; /* RSS shared actions. */
|
|
struct mlx5_devx_obj *q_counters; /* DevX queue counter object. */
|
|
uint32_t counter_set_id; /* Queue counter ID to set in DevX objects. */
|
|
};
|
|
|
|
#define PORT_ID(priv) ((priv)->dev_data->port_id)
|
|
#define ETH_DEV(priv) (&rte_eth_devices[PORT_ID(priv)])
|
|
|
|
struct rte_hairpin_peer_info {
|
|
uint32_t qp_id;
|
|
uint32_t vhca_id;
|
|
uint16_t peer_q;
|
|
uint16_t tx_explicit;
|
|
uint16_t manual_bind;
|
|
};
|
|
|
|
/* mlx5.c */
|
|
|
|
int mlx5_getenv_int(const char *);
|
|
int mlx5_proc_priv_init(struct rte_eth_dev *dev);
|
|
void mlx5_proc_priv_uninit(struct rte_eth_dev *dev);
|
|
int mlx5_udp_tunnel_port_add(struct rte_eth_dev *dev,
|
|
struct rte_eth_udp_tunnel *udp_tunnel);
|
|
uint16_t mlx5_eth_find_next(uint16_t port_id, struct rte_pci_device *pci_dev);
|
|
int mlx5_dev_close(struct rte_eth_dev *dev);
|
|
bool mlx5_is_hpf(struct rte_eth_dev *dev);
|
|
void mlx5_age_event_prepare(struct mlx5_dev_ctx_shared *sh);
|
|
|
|
/* Macro to iterate over all valid ports for mlx5 driver. */
|
|
#define MLX5_ETH_FOREACH_DEV(port_id, pci_dev) \
|
|
for (port_id = mlx5_eth_find_next(0, pci_dev); \
|
|
port_id < RTE_MAX_ETHPORTS; \
|
|
port_id = mlx5_eth_find_next(port_id + 1, pci_dev))
|
|
int mlx5_args(struct mlx5_dev_config *config, struct rte_devargs *devargs);
|
|
struct mlx5_dev_ctx_shared *
|
|
mlx5_alloc_shared_dev_ctx(const struct mlx5_dev_spawn_data *spawn,
|
|
const struct mlx5_dev_config *config);
|
|
void mlx5_free_shared_dev_ctx(struct mlx5_dev_ctx_shared *sh);
|
|
void mlx5_free_table_hash_list(struct mlx5_priv *priv);
|
|
int mlx5_alloc_table_hash_list(struct mlx5_priv *priv);
|
|
void mlx5_set_min_inline(struct mlx5_dev_spawn_data *spawn,
|
|
struct mlx5_dev_config *config);
|
|
void mlx5_set_metadata_mask(struct rte_eth_dev *dev);
|
|
int mlx5_dev_check_sibling_config(struct mlx5_priv *priv,
|
|
struct mlx5_dev_config *config);
|
|
int mlx5_dev_configure(struct rte_eth_dev *dev);
|
|
int mlx5_dev_infos_get(struct rte_eth_dev *dev, struct rte_eth_dev_info *info);
|
|
int mlx5_fw_version_get(struct rte_eth_dev *dev, char *fw_ver, size_t fw_size);
|
|
int mlx5_dev_set_mtu(struct rte_eth_dev *dev, uint16_t mtu);
|
|
int mlx5_hairpin_cap_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_hairpin_cap *cap);
|
|
bool mlx5_flex_parser_ecpri_exist(struct rte_eth_dev *dev);
|
|
int mlx5_flex_parser_ecpri_alloc(struct rte_eth_dev *dev);
|
|
int mlx5_flow_aso_age_mng_init(struct mlx5_dev_ctx_shared *sh);
|
|
int mlx5_aso_flow_mtrs_mng_init(struct mlx5_dev_ctx_shared *sh);
|
|
int mlx5_flow_aso_ct_mng_init(struct mlx5_dev_ctx_shared *sh);
|
|
|
|
/* mlx5_ethdev.c */
|
|
|
|
int mlx5_dev_configure(struct rte_eth_dev *dev);
|
|
int mlx5_representor_info_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_representor_info *info);
|
|
#define MLX5_REPRESENTOR_ID(pf, type, repr) \
|
|
(((pf) << 14) + ((type) << 12) + ((repr) & 0xfff))
|
|
#define MLX5_REPRESENTOR_REPR(repr_id) \
|
|
((repr_id) & 0xfff)
|
|
#define MLX5_REPRESENTOR_TYPE(repr_id) \
|
|
(((repr_id) >> 12) & 3)
|
|
uint16_t mlx5_representor_id_encode(const struct mlx5_switch_info *info,
|
|
enum rte_eth_representor_type hpf_type);
|
|
int mlx5_fw_version_get(struct rte_eth_dev *dev, char *fw_ver,
|
|
size_t fw_size);
|
|
int mlx5_dev_infos_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_dev_info *info);
|
|
const uint32_t *mlx5_dev_supported_ptypes_get(struct rte_eth_dev *dev);
|
|
int mlx5_dev_set_mtu(struct rte_eth_dev *dev, uint16_t mtu);
|
|
int mlx5_hairpin_cap_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_hairpin_cap *cap);
|
|
eth_rx_burst_t mlx5_select_rx_function(struct rte_eth_dev *dev);
|
|
struct mlx5_priv *mlx5_port_to_eswitch_info(uint16_t port, bool valid);
|
|
struct mlx5_priv *mlx5_dev_to_eswitch_info(struct rte_eth_dev *dev);
|
|
int mlx5_dev_configure_rss_reta(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_ethdev_os.c */
|
|
|
|
int mlx5_get_ifname(const struct rte_eth_dev *dev,
|
|
char (*ifname)[MLX5_NAMESIZE]);
|
|
unsigned int mlx5_ifindex(const struct rte_eth_dev *dev);
|
|
int mlx5_get_mac(struct rte_eth_dev *dev, uint8_t (*mac)[RTE_ETHER_ADDR_LEN]);
|
|
int mlx5_get_mtu(struct rte_eth_dev *dev, uint16_t *mtu);
|
|
int mlx5_set_mtu(struct rte_eth_dev *dev, uint16_t mtu);
|
|
int mlx5_read_clock(struct rte_eth_dev *dev, uint64_t *clock);
|
|
int mlx5_link_update(struct rte_eth_dev *dev, int wait_to_complete);
|
|
int mlx5_dev_get_flow_ctrl(struct rte_eth_dev *dev,
|
|
struct rte_eth_fc_conf *fc_conf);
|
|
int mlx5_dev_set_flow_ctrl(struct rte_eth_dev *dev,
|
|
struct rte_eth_fc_conf *fc_conf);
|
|
void mlx5_dev_interrupt_handler(void *arg);
|
|
void mlx5_dev_interrupt_handler_devx(void *arg);
|
|
int mlx5_set_link_down(struct rte_eth_dev *dev);
|
|
int mlx5_set_link_up(struct rte_eth_dev *dev);
|
|
int mlx5_is_removed(struct rte_eth_dev *dev);
|
|
int mlx5_sysfs_switch_info(unsigned int ifindex,
|
|
struct mlx5_switch_info *info);
|
|
void mlx5_translate_port_name(const char *port_name_in,
|
|
struct mlx5_switch_info *port_info_out);
|
|
void mlx5_intr_callback_unregister(const struct rte_intr_handle *handle,
|
|
rte_intr_callback_fn cb_fn, void *cb_arg);
|
|
int mlx5_sysfs_bond_info(unsigned int pf_ifindex, unsigned int *ifindex,
|
|
char *ifname);
|
|
int mlx5_get_module_info(struct rte_eth_dev *dev,
|
|
struct rte_eth_dev_module_info *modinfo);
|
|
int mlx5_get_module_eeprom(struct rte_eth_dev *dev,
|
|
struct rte_dev_eeprom_info *info);
|
|
int mlx5_os_read_dev_stat(struct mlx5_priv *priv,
|
|
const char *ctr_name, uint64_t *stat);
|
|
int mlx5_os_read_dev_counters(struct rte_eth_dev *dev, uint64_t *stats);
|
|
int mlx5_os_get_stats_n(struct rte_eth_dev *dev);
|
|
void mlx5_os_stats_init(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_mac.c */
|
|
|
|
void mlx5_mac_addr_remove(struct rte_eth_dev *dev, uint32_t index);
|
|
int mlx5_mac_addr_add(struct rte_eth_dev *dev, struct rte_ether_addr *mac,
|
|
uint32_t index, uint32_t vmdq);
|
|
int mlx5_mac_addr_set(struct rte_eth_dev *dev, struct rte_ether_addr *mac_addr);
|
|
int mlx5_set_mc_addr_list(struct rte_eth_dev *dev,
|
|
struct rte_ether_addr *mc_addr_set,
|
|
uint32_t nb_mc_addr);
|
|
|
|
/* mlx5_rss.c */
|
|
|
|
int mlx5_rss_hash_update(struct rte_eth_dev *dev,
|
|
struct rte_eth_rss_conf *rss_conf);
|
|
int mlx5_rss_hash_conf_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_rss_conf *rss_conf);
|
|
int mlx5_rss_reta_index_resize(struct rte_eth_dev *dev, unsigned int reta_size);
|
|
int mlx5_dev_rss_reta_query(struct rte_eth_dev *dev,
|
|
struct rte_eth_rss_reta_entry64 *reta_conf,
|
|
uint16_t reta_size);
|
|
int mlx5_dev_rss_reta_update(struct rte_eth_dev *dev,
|
|
struct rte_eth_rss_reta_entry64 *reta_conf,
|
|
uint16_t reta_size);
|
|
|
|
/* mlx5_rxmode.c */
|
|
|
|
int mlx5_promiscuous_enable(struct rte_eth_dev *dev);
|
|
int mlx5_promiscuous_disable(struct rte_eth_dev *dev);
|
|
int mlx5_allmulticast_enable(struct rte_eth_dev *dev);
|
|
int mlx5_allmulticast_disable(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_stats.c */
|
|
|
|
int mlx5_stats_get(struct rte_eth_dev *dev, struct rte_eth_stats *stats);
|
|
int mlx5_stats_reset(struct rte_eth_dev *dev);
|
|
int mlx5_xstats_get(struct rte_eth_dev *dev, struct rte_eth_xstat *stats,
|
|
unsigned int n);
|
|
int mlx5_xstats_reset(struct rte_eth_dev *dev);
|
|
int mlx5_xstats_get_names(struct rte_eth_dev *dev __rte_unused,
|
|
struct rte_eth_xstat_name *xstats_names,
|
|
unsigned int n);
|
|
|
|
/* mlx5_vlan.c */
|
|
|
|
int mlx5_vlan_filter_set(struct rte_eth_dev *dev, uint16_t vlan_id, int on);
|
|
void mlx5_vlan_strip_queue_set(struct rte_eth_dev *dev, uint16_t queue, int on);
|
|
int mlx5_vlan_offload_set(struct rte_eth_dev *dev, int mask);
|
|
|
|
/* mlx5_vlan_os.c */
|
|
|
|
void mlx5_vlan_vmwa_exit(void *ctx);
|
|
void mlx5_vlan_vmwa_release(struct rte_eth_dev *dev,
|
|
struct mlx5_vf_vlan *vf_vlan);
|
|
void mlx5_vlan_vmwa_acquire(struct rte_eth_dev *dev,
|
|
struct mlx5_vf_vlan *vf_vlan);
|
|
void *mlx5_vlan_vmwa_init(struct rte_eth_dev *dev, uint32_t ifindex);
|
|
|
|
/* mlx5_trigger.c */
|
|
|
|
int mlx5_dev_start(struct rte_eth_dev *dev);
|
|
int mlx5_dev_stop(struct rte_eth_dev *dev);
|
|
int mlx5_traffic_enable(struct rte_eth_dev *dev);
|
|
void mlx5_traffic_disable(struct rte_eth_dev *dev);
|
|
int mlx5_traffic_restart(struct rte_eth_dev *dev);
|
|
int mlx5_hairpin_queue_peer_update(struct rte_eth_dev *dev, uint16_t peer_queue,
|
|
struct rte_hairpin_peer_info *current_info,
|
|
struct rte_hairpin_peer_info *peer_info,
|
|
uint32_t direction);
|
|
int mlx5_hairpin_queue_peer_bind(struct rte_eth_dev *dev, uint16_t cur_queue,
|
|
struct rte_hairpin_peer_info *peer_info,
|
|
uint32_t direction);
|
|
int mlx5_hairpin_queue_peer_unbind(struct rte_eth_dev *dev, uint16_t cur_queue,
|
|
uint32_t direction);
|
|
int mlx5_hairpin_bind(struct rte_eth_dev *dev, uint16_t rx_port);
|
|
int mlx5_hairpin_unbind(struct rte_eth_dev *dev, uint16_t rx_port);
|
|
int mlx5_hairpin_get_peer_ports(struct rte_eth_dev *dev, uint16_t *peer_ports,
|
|
size_t len, uint32_t direction);
|
|
|
|
/* mlx5_flow.c */
|
|
|
|
int mlx5_flow_discover_mreg_c(struct rte_eth_dev *eth_dev);
|
|
bool mlx5_flow_ext_mreg_supported(struct rte_eth_dev *dev);
|
|
void mlx5_flow_print(struct rte_flow *flow);
|
|
int mlx5_flow_validate(struct rte_eth_dev *dev,
|
|
const struct rte_flow_attr *attr,
|
|
const struct rte_flow_item items[],
|
|
const struct rte_flow_action actions[],
|
|
struct rte_flow_error *error);
|
|
struct rte_flow *mlx5_flow_create(struct rte_eth_dev *dev,
|
|
const struct rte_flow_attr *attr,
|
|
const struct rte_flow_item items[],
|
|
const struct rte_flow_action actions[],
|
|
struct rte_flow_error *error);
|
|
int mlx5_flow_destroy(struct rte_eth_dev *dev, struct rte_flow *flow,
|
|
struct rte_flow_error *error);
|
|
void mlx5_flow_list_flush(struct rte_eth_dev *dev, uint32_t *list, bool active);
|
|
int mlx5_flow_flush(struct rte_eth_dev *dev, struct rte_flow_error *error);
|
|
int mlx5_flow_query(struct rte_eth_dev *dev, struct rte_flow *flow,
|
|
const struct rte_flow_action *action, void *data,
|
|
struct rte_flow_error *error);
|
|
int mlx5_flow_isolate(struct rte_eth_dev *dev, int enable,
|
|
struct rte_flow_error *error);
|
|
int mlx5_flow_ops_get(struct rte_eth_dev *dev, const struct rte_flow_ops **ops);
|
|
int mlx5_flow_start_default(struct rte_eth_dev *dev);
|
|
void mlx5_flow_stop_default(struct rte_eth_dev *dev);
|
|
int mlx5_flow_verify(struct rte_eth_dev *dev);
|
|
int mlx5_ctrl_flow_source_queue(struct rte_eth_dev *dev, uint32_t queue);
|
|
int mlx5_ctrl_flow_vlan(struct rte_eth_dev *dev,
|
|
struct rte_flow_item_eth *eth_spec,
|
|
struct rte_flow_item_eth *eth_mask,
|
|
struct rte_flow_item_vlan *vlan_spec,
|
|
struct rte_flow_item_vlan *vlan_mask);
|
|
int mlx5_ctrl_flow(struct rte_eth_dev *dev,
|
|
struct rte_flow_item_eth *eth_spec,
|
|
struct rte_flow_item_eth *eth_mask);
|
|
int mlx5_flow_lacp_miss(struct rte_eth_dev *dev);
|
|
struct rte_flow *mlx5_flow_create_esw_table_zero_flow(struct rte_eth_dev *dev);
|
|
void mlx5_flow_async_pool_query_handle(struct mlx5_dev_ctx_shared *sh,
|
|
uint64_t async_id, int status);
|
|
void mlx5_set_query_alarm(struct mlx5_dev_ctx_shared *sh);
|
|
void mlx5_flow_query_alarm(void *arg);
|
|
uint32_t mlx5_counter_alloc(struct rte_eth_dev *dev);
|
|
void mlx5_counter_free(struct rte_eth_dev *dev, uint32_t cnt);
|
|
int mlx5_counter_query(struct rte_eth_dev *dev, uint32_t cnt,
|
|
bool clear, uint64_t *pkts, uint64_t *bytes);
|
|
int mlx5_flow_dev_dump(struct rte_eth_dev *dev, struct rte_flow *flow,
|
|
FILE *file, struct rte_flow_error *error);
|
|
void mlx5_flow_rxq_dynf_metadata_set(struct rte_eth_dev *dev);
|
|
int mlx5_flow_get_aged_flows(struct rte_eth_dev *dev, void **contexts,
|
|
uint32_t nb_contexts, struct rte_flow_error *error);
|
|
int mlx5_validate_action_ct(struct rte_eth_dev *dev,
|
|
const struct rte_flow_action_conntrack *conntrack,
|
|
struct rte_flow_error *error);
|
|
|
|
|
|
/* mlx5_mp_os.c */
|
|
|
|
int mlx5_mp_os_primary_handle(const struct rte_mp_msg *mp_msg,
|
|
const void *peer);
|
|
int mlx5_mp_os_secondary_handle(const struct rte_mp_msg *mp_msg,
|
|
const void *peer);
|
|
void mlx5_mp_os_req_start_rxtx(struct rte_eth_dev *dev);
|
|
void mlx5_mp_os_req_stop_rxtx(struct rte_eth_dev *dev);
|
|
int mlx5_mp_os_req_queue_control(struct rte_eth_dev *dev, uint16_t queue_id,
|
|
enum mlx5_mp_req_type req_type);
|
|
|
|
/* mlx5_socket.c */
|
|
|
|
int mlx5_pmd_socket_init(void);
|
|
|
|
/* mlx5_flow_meter.c */
|
|
|
|
int mlx5_flow_meter_ops_get(struct rte_eth_dev *dev, void *arg);
|
|
struct mlx5_flow_meter_info *mlx5_flow_meter_find(struct mlx5_priv *priv,
|
|
uint32_t meter_id, uint32_t *mtr_idx);
|
|
struct mlx5_flow_meter_info *
|
|
flow_dv_meter_find_by_idx(struct mlx5_priv *priv, uint32_t idx);
|
|
int mlx5_flow_meter_attach(struct mlx5_priv *priv,
|
|
struct mlx5_flow_meter_info *fm,
|
|
const struct rte_flow_attr *attr,
|
|
struct rte_flow_error *error);
|
|
void mlx5_flow_meter_detach(struct mlx5_priv *priv,
|
|
struct mlx5_flow_meter_info *fm);
|
|
struct mlx5_flow_meter_policy *mlx5_flow_meter_policy_find
|
|
(struct rte_eth_dev *dev,
|
|
uint32_t policy_id,
|
|
uint32_t *policy_idx);
|
|
int mlx5_flow_meter_flush(struct rte_eth_dev *dev,
|
|
struct rte_mtr_error *error);
|
|
void mlx5_flow_meter_rxq_flush(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_os.c */
|
|
struct rte_pci_driver;
|
|
int mlx5_os_get_dev_attr(void *ctx, struct mlx5_dev_attr *dev_attr);
|
|
void mlx5_os_free_shared_dr(struct mlx5_priv *priv);
|
|
int mlx5_os_open_device(const struct mlx5_dev_spawn_data *spawn,
|
|
const struct mlx5_dev_config *config,
|
|
struct mlx5_dev_ctx_shared *sh);
|
|
int mlx5_os_get_pdn(void *pd, uint32_t *pdn);
|
|
int mlx5_os_pci_probe(struct rte_pci_driver *pci_drv __rte_unused,
|
|
struct rte_pci_device *pci_dev);
|
|
void mlx5_os_dev_shared_handler_install(struct mlx5_dev_ctx_shared *sh);
|
|
void mlx5_os_dev_shared_handler_uninstall(struct mlx5_dev_ctx_shared *sh);
|
|
void mlx5_os_set_reg_mr_cb(mlx5_reg_mr_t *reg_mr_cb,
|
|
mlx5_dereg_mr_t *dereg_mr_cb);
|
|
void mlx5_os_mac_addr_remove(struct rte_eth_dev *dev, uint32_t index);
|
|
int mlx5_os_mac_addr_add(struct rte_eth_dev *dev, struct rte_ether_addr *mac,
|
|
uint32_t index);
|
|
int mlx5_os_vf_mac_addr_modify(struct mlx5_priv *priv, unsigned int iface_idx,
|
|
struct rte_ether_addr *mac_addr,
|
|
int vf_index);
|
|
int mlx5_os_set_promisc(struct rte_eth_dev *dev, int enable);
|
|
int mlx5_os_set_allmulti(struct rte_eth_dev *dev, int enable);
|
|
int mlx5_os_set_nonblock_channel_fd(int fd);
|
|
void mlx5_os_mac_addr_flush(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_txpp.c */
|
|
|
|
int mlx5_txpp_start(struct rte_eth_dev *dev);
|
|
void mlx5_txpp_stop(struct rte_eth_dev *dev);
|
|
int mlx5_txpp_read_clock(struct rte_eth_dev *dev, uint64_t *timestamp);
|
|
int mlx5_txpp_xstats_get(struct rte_eth_dev *dev,
|
|
struct rte_eth_xstat *stats,
|
|
unsigned int n, unsigned int n_used);
|
|
int mlx5_txpp_xstats_reset(struct rte_eth_dev *dev);
|
|
int mlx5_txpp_xstats_get_names(struct rte_eth_dev *dev,
|
|
struct rte_eth_xstat_name *xstats_names,
|
|
unsigned int n, unsigned int n_used);
|
|
void mlx5_txpp_interrupt_handler(void *cb_arg);
|
|
|
|
/* mlx5_rxtx.c */
|
|
|
|
eth_tx_burst_t mlx5_select_tx_function(struct rte_eth_dev *dev);
|
|
|
|
/* mlx5_flow_aso.c */
|
|
|
|
int mlx5_aso_queue_init(struct mlx5_dev_ctx_shared *sh,
|
|
enum mlx5_access_aso_opc_mod aso_opc_mod);
|
|
int mlx5_aso_flow_hit_queue_poll_start(struct mlx5_dev_ctx_shared *sh);
|
|
int mlx5_aso_flow_hit_queue_poll_stop(struct mlx5_dev_ctx_shared *sh);
|
|
void mlx5_aso_queue_uninit(struct mlx5_dev_ctx_shared *sh,
|
|
enum mlx5_access_aso_opc_mod aso_opc_mod);
|
|
int mlx5_aso_meter_update_by_wqe(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_mtr *mtr);
|
|
int mlx5_aso_mtr_wait(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_mtr *mtr);
|
|
int mlx5_aso_ct_update_by_wqe(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_ct_action *ct,
|
|
const struct rte_flow_action_conntrack *profile);
|
|
int mlx5_aso_ct_wait_ready(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_ct_action *ct);
|
|
int mlx5_aso_ct_query_by_wqe(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_ct_action *ct,
|
|
struct rte_flow_action_conntrack *profile);
|
|
int mlx5_aso_ct_available(struct mlx5_dev_ctx_shared *sh,
|
|
struct mlx5_aso_ct_action *ct);
|
|
|
|
#endif /* RTE_PMD_MLX5_H_ */
|