drivers/net/mlx5/mlx5_rx.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright 2021 6WIND S.A.
   3  * Copyright 2021 Mellanox Technologies, Ltd
   4  */
   5
   6 #ifndef RTE_PMD_MLX5_RX_H_
   7 #define RTE_PMD_MLX5_RX_H_
   8
   9 #include <stdint.h>
  10 #include <sys/queue.h>
  11
  12 #include <rte_mbuf.h>
  13 #include <rte_mempool.h>
  14 #include <rte_common.h>
  15 #include <rte_spinlock.h>
  16
  17 #include <mlx5_common_mr.h>
  18
  19 #include "mlx5.h"
  20 #include "mlx5_autoconf.h"
  21
  22 /* Support tunnel matching. */
  23 #define MLX5_FLOW_TUNNEL 10
  24
  25 #define RXQ_PORT(rxq_ctrl) LIST_FIRST(&(rxq_ctrl)->owners)->priv
  26 #define RXQ_DEV(rxq_ctrl) ETH_DEV(RXQ_PORT(rxq_ctrl))
  27 #define RXQ_PORT_ID(rxq_ctrl) PORT_ID(RXQ_PORT(rxq_ctrl))
  28
  29 /* First entry must be NULL for comparison. */
  30 #define mlx5_mr_btree_len(bt) ((bt)->len - 1)
  31
  32 struct mlx5_rxq_stats {
  33 #ifdef MLX5_PMD_SOFT_COUNTERS
  34         uint64_t ipackets; /**< Total of successfully received packets. */
  35         uint64_t ibytes; /**< Total of successfully received bytes. */
  36 #endif
  37         uint64_t idropped; /**< Total of packets dropped when RX ring full. */
  38         uint64_t rx_nombuf; /**< Total of RX mbuf allocation failures. */
  39 };
  40
  41 /* Compressed CQE context. */
  42 struct rxq_zip {
  43         uint16_t ai; /* Array index. */
  44         uint16_t ca; /* Current array index. */
  45         uint16_t na; /* Next array index. */
  46         uint16_t cq_ci; /* The next CQE. */
  47         uint32_t cqe_cnt; /* Number of CQEs. */
  48 };
  49
  50 /* Get pointer to the first stride. */
  51 #define mlx5_mprq_buf_addr(ptr, strd_n) (RTE_PTR_ADD((ptr), \
  52                                 sizeof(struct mlx5_mprq_buf) + \
  53                                 (strd_n) * \
  54                                 sizeof(struct rte_mbuf_ext_shared_info) + \
  55                                 RTE_PKTMBUF_HEADROOM))
  56
  57 #define MLX5_MIN_SINGLE_STRIDE_LOG_NUM_BYTES 6
  58 #define MLX5_MIN_SINGLE_WQE_LOG_NUM_STRIDES 9
  59
  60 enum mlx5_rxq_err_state {
  61         MLX5_RXQ_ERR_STATE_NO_ERROR = 0,
  62         MLX5_RXQ_ERR_STATE_NEED_RESET,
  63         MLX5_RXQ_ERR_STATE_NEED_READY,
  64 };
  65
  66 enum mlx5_rqx_code {
  67         MLX5_RXQ_CODE_EXIT = 0,
  68         MLX5_RXQ_CODE_NOMBUF,
  69         MLX5_RXQ_CODE_DROPPED,
  70 };
  71
  72 struct mlx5_eth_rxseg {
  73         struct rte_mempool *mp; /**< Memory pool to allocate segment from. */
  74         uint16_t length; /**< Segment data length, configures split point. */
  75         uint16_t offset; /**< Data offset from beginning of mbuf data buffer. */
  76         uint32_t reserved; /**< Reserved field. */
  77 };
  78
  79 /* RX queue descriptor. */
  80 struct mlx5_rxq_data {
  81         unsigned int csum:1; /* Enable checksum offloading. */
  82         unsigned int hw_timestamp:1; /* Enable HW timestamp. */
  83         unsigned int rt_timestamp:1; /* Realtime timestamp format. */
  84         unsigned int vlan_strip:1; /* Enable VLAN stripping. */
  85         unsigned int crc_present:1; /* CRC must be subtracted. */
  86         unsigned int sges_n:3; /* Log 2 of SGEs (max buffers per packet). */
  87         unsigned int cqe_n:4; /* Log 2 of CQ elements. */
  88         unsigned int elts_n:4; /* Log 2 of Mbufs. */
  89         unsigned int rss_hash:1; /* RSS hash result is enabled. */
  90         unsigned int mark:1; /* Marked flow available on the queue. */
  91         unsigned int strd_num_n:5; /* Log 2 of the number of stride. */
  92         unsigned int strd_sz_n:4; /* Log 2 of stride size. */
  93         unsigned int strd_shift_en:1; /* Enable 2bytes shift on a stride. */
  94         unsigned int err_state:2; /* enum mlx5_rxq_err_state. */
  95         unsigned int strd_scatter_en:1; /* Scattered packets from a stride. */
  96         unsigned int lro:1; /* Enable LRO. */
  97         unsigned int dynf_meta:1; /* Dynamic metadata is configured. */
  98         unsigned int mcqe_format:3; /* CQE compression format. */
  99         unsigned int shared:1; /* Shared RXQ. */
 100         volatile uint32_t *rq_db;
 101         volatile uint32_t *cq_db;
 102         uint16_t port_id;
 103         uint32_t elts_ci;
 104         uint32_t rq_ci;
 105         uint16_t consumed_strd; /* Number of consumed strides in WQE. */
 106         uint32_t rq_pi;
 107         uint32_t cq_ci;
 108         uint16_t rq_repl_thresh; /* Threshold for buffer replenishment. */
 109         uint32_t byte_mask;
 110         union {
 111                 struct rxq_zip zip; /* Compressed context. */
 112                 uint16_t decompressed;
 113                 /* Number of ready mbufs decompressed from the CQ. */
 114         };
 115         struct mlx5_mr_ctrl mr_ctrl; /* MR control descriptor. */
 116         uint16_t mprq_max_memcpy_len; /* Maximum size of packet to memcpy. */
 117         volatile void *wqes;
 118         volatile struct mlx5_cqe(*cqes)[];
 119         struct rte_mbuf *(*elts)[];
 120         struct mlx5_mprq_buf *(*mprq_bufs)[];
 121         struct rte_mempool *mp;
 122         struct rte_mempool *mprq_mp; /* Mempool for Multi-Packet RQ. */
 123         struct mlx5_mprq_buf *mprq_repl; /* Stashed mbuf for replenish. */
 124         struct mlx5_dev_ctx_shared *sh; /* Shared context. */
 125         uint16_t idx; /* Queue index. */
 126         struct mlx5_rxq_stats stats;
 127         rte_xmm_t mbuf_initializer; /* Default rearm/flags for vectorized Rx. */
 128         struct rte_mbuf fake_mbuf; /* elts padding for vectorized Rx. */
 129         void *cq_uar; /* Verbs CQ user access region. */
 130         uint32_t cqn; /* CQ number. */
 131         uint8_t cq_arm_sn; /* CQ arm seq number. */
 132 #ifndef RTE_ARCH_64
 133         rte_spinlock_t *uar_lock_cq;
 134         /* CQ (UAR) access lock required for 32bit implementations */
 135 #endif
 136         uint32_t tunnel; /* Tunnel information. */
 137         int timestamp_offset; /* Dynamic mbuf field for timestamp. */
 138         uint64_t timestamp_rx_flag; /* Dynamic mbuf flag for timestamp. */
 139         uint64_t flow_meta_mask;
 140         int32_t flow_meta_offset;
 141         uint32_t flow_meta_port_mask;
 142         uint32_t rxseg_n; /* Number of split segment descriptions. */
 143         struct mlx5_eth_rxseg rxseg[MLX5_MAX_RXQ_NSEG];
 144         /* Buffer split segment descriptions - sizes, offsets, pools. */
 145 } __rte_cache_aligned;
 146
 147 enum mlx5_rxq_type {
 148         MLX5_RXQ_TYPE_STANDARD, /* Standard Rx queue. */
 149         MLX5_RXQ_TYPE_HAIRPIN, /* Hairpin Rx queue. */
 150         MLX5_RXQ_TYPE_UNDEFINED,
 151 };
 152
 153 /* RX queue control descriptor. */
 154 struct mlx5_rxq_ctrl {
 155         struct mlx5_rxq_data rxq; /* Data path structure. */
 156         LIST_ENTRY(mlx5_rxq_ctrl) next; /* Pointer to the next element. */
 157         LIST_HEAD(priv, mlx5_rxq_priv) owners; /* Owner rxq list. */
 158         struct mlx5_rxq_obj *obj; /* Verbs/DevX elements. */
 159         struct mlx5_dev_ctx_shared *sh; /* Shared context. */
 160         enum mlx5_rxq_type type; /* Rxq type. */
 161         unsigned int socket; /* CPU socket ID for allocations. */
 162         LIST_ENTRY(mlx5_rxq_ctrl) share_entry; /* Entry in shared RXQ list. */
 163         uint32_t share_group; /* Group ID of shared RXQ. */
 164         uint16_t share_qid; /* Shared RxQ ID in group. */
 165         unsigned int started:1; /* Whether (shared) RXQ has been started. */
 166         unsigned int irq:1; /* Whether IRQ is enabled. */
 167         uint32_t flow_mark_n; /* Number of Mark/Flag flows using this Queue. */
 168         uint32_t flow_tunnels_n[MLX5_FLOW_TUNNEL]; /* Tunnels counters. */
 169         uint32_t wqn; /* WQ number. */
 170         uint16_t dump_file_n; /* Number of dump files. */
 171 };
 172
 173 /* RX queue private data. */
 174 struct mlx5_rxq_priv {
 175         uint16_t idx; /* Queue index. */
 176         uint32_t refcnt; /* Reference counter. */
 177         struct mlx5_rxq_ctrl *ctrl; /* Shared Rx Queue. */
 178         LIST_ENTRY(mlx5_rxq_priv) owner_entry; /* Entry in shared rxq_ctrl. */
 179         struct mlx5_priv *priv; /* Back pointer to private data. */
 180         struct mlx5_devx_rq devx_rq;
 181         struct rte_eth_hairpin_conf hairpin_conf; /* Hairpin configuration. */
 182         uint32_t hairpin_status; /* Hairpin binding status. */
 183 };
 184
 185 /* mlx5_rxq.c */
 186
 187 extern uint8_t rss_hash_default_key[];
 188
 189 unsigned int mlx5_rxq_cqe_num(struct mlx5_rxq_data *rxq_data);
 190 int mlx5_mprq_free_mp(struct rte_eth_dev *dev);
 191 int mlx5_mprq_alloc_mp(struct rte_eth_dev *dev);
 192 int mlx5_rx_queue_start(struct rte_eth_dev *dev, uint16_t queue_id);
 193 int mlx5_rx_queue_stop(struct rte_eth_dev *dev, uint16_t queue_id);
 194 int mlx5_rx_queue_start_primary(struct rte_eth_dev *dev, uint16_t queue_id);
 195 int mlx5_rx_queue_stop_primary(struct rte_eth_dev *dev, uint16_t queue_id);
 196 int mlx5_rx_queue_setup(struct rte_eth_dev *dev, uint16_t idx, uint16_t desc,
 197                         unsigned int socket, const struct rte_eth_rxconf *conf,
 198                         struct rte_mempool *mp);
 199 int mlx5_rx_hairpin_queue_setup
 200         (struct rte_eth_dev *dev, uint16_t idx, uint16_t desc,
 201          const struct rte_eth_hairpin_conf *hairpin_conf);
 202 void mlx5_rx_queue_release(struct rte_eth_dev *dev, uint16_t qid);
 203 int mlx5_rx_intr_vec_enable(struct rte_eth_dev *dev);
 204 void mlx5_rx_intr_vec_disable(struct rte_eth_dev *dev);
 205 int mlx5_rx_intr_enable(struct rte_eth_dev *dev, uint16_t rx_queue_id);
 206 int mlx5_rx_intr_disable(struct rte_eth_dev *dev, uint16_t rx_queue_id);
 207 int mlx5_rxq_obj_verify(struct rte_eth_dev *dev);
 208 struct mlx5_rxq_ctrl *mlx5_rxq_new(struct rte_eth_dev *dev,
 209                                    struct mlx5_rxq_priv *rxq,
 210                                    uint16_t desc, unsigned int socket,
 211                                    const struct rte_eth_rxconf *conf,
 212                                    const struct rte_eth_rxseg_split *rx_seg,
 213                                    uint16_t n_seg);
 214 struct mlx5_rxq_ctrl *mlx5_rxq_hairpin_new
 215         (struct rte_eth_dev *dev, struct mlx5_rxq_priv *rxq, uint16_t desc,
 216          const struct rte_eth_hairpin_conf *hairpin_conf);
 217 struct mlx5_rxq_priv *mlx5_rxq_ref(struct rte_eth_dev *dev, uint16_t idx);
 218 uint32_t mlx5_rxq_deref(struct rte_eth_dev *dev, uint16_t idx);
 219 struct mlx5_rxq_priv *mlx5_rxq_get(struct rte_eth_dev *dev, uint16_t idx);
 220 struct mlx5_rxq_ctrl *mlx5_rxq_ctrl_get(struct rte_eth_dev *dev, uint16_t idx);
 221 struct mlx5_rxq_data *mlx5_rxq_data_get(struct rte_eth_dev *dev, uint16_t idx);
 222 int mlx5_rxq_release(struct rte_eth_dev *dev, uint16_t idx);
 223 int mlx5_rxq_verify(struct rte_eth_dev *dev);
 224 int rxq_alloc_elts(struct mlx5_rxq_ctrl *rxq_ctrl);
 225 int mlx5_ind_table_obj_verify(struct rte_eth_dev *dev);
 226 struct mlx5_ind_table_obj *mlx5_ind_table_obj_get(struct rte_eth_dev *dev,
 227                                                   const uint16_t *queues,
 228                                                   uint32_t queues_n);
 229 int mlx5_ind_table_obj_release(struct rte_eth_dev *dev,
 230                                struct mlx5_ind_table_obj *ind_tbl,
 231                                bool standalone);
 232 int mlx5_ind_table_obj_setup(struct rte_eth_dev *dev,
 233                              struct mlx5_ind_table_obj *ind_tbl);
 234 int mlx5_ind_table_obj_modify(struct rte_eth_dev *dev,
 235                               struct mlx5_ind_table_obj *ind_tbl,
 236                               uint16_t *queues, const uint32_t queues_n,
 237                               bool standalone);
 238 int mlx5_ind_table_obj_attach(struct rte_eth_dev *dev,
 239                               struct mlx5_ind_table_obj *ind_tbl);
 240 int mlx5_ind_table_obj_detach(struct rte_eth_dev *dev,
 241                               struct mlx5_ind_table_obj *ind_tbl);
 242 struct mlx5_list_entry *mlx5_hrxq_create_cb(void *tool_ctx, void *cb_ctx);
 243 int mlx5_hrxq_match_cb(void *tool_ctx, struct mlx5_list_entry *entry,
 244                        void *cb_ctx);
 245 void mlx5_hrxq_remove_cb(void *tool_ctx, struct mlx5_list_entry *entry);
 246 struct mlx5_list_entry *mlx5_hrxq_clone_cb(void *tool_ctx,
 247                                            struct mlx5_list_entry *entry,
 248                                            void *cb_ctx __rte_unused);
 249 void mlx5_hrxq_clone_free_cb(void *tool_ctx __rte_unused,
 250                              struct mlx5_list_entry *entry);
 251 uint32_t mlx5_hrxq_get(struct rte_eth_dev *dev,
 252                        struct mlx5_flow_rss_desc *rss_desc);
 253 int mlx5_hrxq_release(struct rte_eth_dev *dev, uint32_t hxrq_idx);
 254 uint32_t mlx5_hrxq_verify(struct rte_eth_dev *dev);
 255 enum mlx5_rxq_type mlx5_rxq_get_type(struct rte_eth_dev *dev, uint16_t idx);
 256 const struct rte_eth_hairpin_conf *mlx5_rxq_get_hairpin_conf
 257         (struct rte_eth_dev *dev, uint16_t idx);
 258 struct mlx5_hrxq *mlx5_drop_action_create(struct rte_eth_dev *dev);
 259 void mlx5_drop_action_destroy(struct rte_eth_dev *dev);
 260 uint64_t mlx5_get_rx_port_offloads(void);
 261 uint64_t mlx5_get_rx_queue_offloads(struct rte_eth_dev *dev);
 262 void mlx5_rxq_timestamp_set(struct rte_eth_dev *dev);
 263 int mlx5_hrxq_modify(struct rte_eth_dev *dev, uint32_t hxrq_idx,
 264                      const uint8_t *rss_key, uint32_t rss_key_len,
 265                      uint64_t hash_fields,
 266                      const uint16_t *queues, uint32_t queues_n);
 267
 268 /* mlx5_rx.c */
 269
 270 uint16_t mlx5_rx_burst(void *dpdk_rxq, struct rte_mbuf **pkts, uint16_t pkts_n);
 271 void mlx5_rxq_initialize(struct mlx5_rxq_data *rxq);
 272 __rte_noinline int mlx5_rx_err_handle(struct mlx5_rxq_data *rxq, uint8_t vec);
 273 void mlx5_mprq_buf_free(struct mlx5_mprq_buf *buf);
 274 uint16_t mlx5_rx_burst_mprq(void *dpdk_rxq, struct rte_mbuf **pkts,
 275                             uint16_t pkts_n);
 276 uint16_t removed_rx_burst(void *dpdk_rxq, struct rte_mbuf **pkts,
 277                           uint16_t pkts_n);
 278 int mlx5_rx_descriptor_status(void *rx_queue, uint16_t offset);
 279 uint32_t mlx5_rx_queue_count(void *rx_queue);
 280 void mlx5_rxq_info_get(struct rte_eth_dev *dev, uint16_t queue_id,
 281                        struct rte_eth_rxq_info *qinfo);
 282 int mlx5_rx_burst_mode_get(struct rte_eth_dev *dev, uint16_t rx_queue_id,
 283                            struct rte_eth_burst_mode *mode);
 284 int mlx5_get_monitor_addr(void *rx_queue, struct rte_power_monitor_cond *pmc);
 285
 286 /* Vectorized version of mlx5_rx.c */
 287 int mlx5_rxq_check_vec_support(struct mlx5_rxq_data *rxq_data);
 288 int mlx5_check_vec_rx_support(struct rte_eth_dev *dev);
 289 uint16_t mlx5_rx_burst_vec(void *dpdk_rxq, struct rte_mbuf **pkts,
 290                            uint16_t pkts_n);
 291 uint16_t mlx5_rx_burst_mprq_vec(void *dpdk_rxq, struct rte_mbuf **pkts,
 292                                 uint16_t pkts_n);
 293
 294 static int mlx5_rxq_mprq_enabled(struct mlx5_rxq_data *rxq);
 295
 296 /**
 297  * Query LKey from a packet buffer for Rx. No need to flush local caches
 298  * as the Rx mempool database entries are valid for the lifetime of the queue.
 299  *
 300  * @param rxq
 301  *   Pointer to Rx queue structure.
 302  * @param addr
 303  *   Address to search.
 304  *
 305  * @return
 306  *   Searched LKey on success, UINT32_MAX on no match.
 307  *   This function always succeeds on valid input.
 308  */
 309 static __rte_always_inline uint32_t
 310 mlx5_rx_addr2mr(struct mlx5_rxq_data *rxq, uintptr_t addr)
 311 {
 312         struct mlx5_mr_ctrl *mr_ctrl = &rxq->mr_ctrl;
 313         struct mlx5_rxq_ctrl *rxq_ctrl;
 314         struct rte_mempool *mp;
 315         uint32_t lkey;
 316
 317         /* Linear search on MR cache array. */
 318         lkey = mlx5_mr_lookup_lkey(mr_ctrl->cache, &mr_ctrl->mru,
 319                                    MLX5_MR_CACHE_N, addr);
 320         if (likely(lkey != UINT32_MAX))
 321                 return lkey;
 322         /*
 323          * Slower search in the mempool database on miss.
 324          * During queue creation rxq->sh is not yet set, so we use rxq_ctrl.
 325          */
 326         rxq_ctrl = container_of(rxq, struct mlx5_rxq_ctrl, rxq);
 327         mp = mlx5_rxq_mprq_enabled(rxq) ? rxq->mprq_mp : rxq->mp;
 328         return mlx5_mr_mempool2mr_bh(&rxq_ctrl->sh->cdev->mr_scache,
 329                                      mr_ctrl, mp, addr);
 330 }
 331
 332 #define mlx5_rx_mb2mr(rxq, mb) mlx5_rx_addr2mr(rxq, (uintptr_t)((mb)->buf_addr))
 333
 334 /**
 335  * Convert timestamp from HW format to linear counter
 336  * from Packet Pacing Clock Queue CQE timestamp format.
 337  *
 338  * @param sh
 339  *   Pointer to the device shared context. Might be needed
 340  *   to convert according current device configuration.
 341  * @param ts
 342  *   Timestamp from CQE to convert.
 343  * @return
 344  *   UTC in nanoseconds
 345  */
 346 static __rte_always_inline uint64_t
 347 mlx5_txpp_convert_rx_ts(struct mlx5_dev_ctx_shared *sh, uint64_t ts)
 348 {
 349         RTE_SET_USED(sh);
 350         return (ts & UINT32_MAX) + (ts >> 32) * NS_PER_S;
 351 }
 352
 353 /**
 354  * Set timestamp in mbuf dynamic field.
 355  *
 356  * @param mbuf
 357  *   Structure to write into.
 358  * @param offset
 359  *   Dynamic field offset in mbuf structure.
 360  * @param timestamp
 361  *   Value to write.
 362  */
 363 static __rte_always_inline void
 364 mlx5_timestamp_set(struct rte_mbuf *mbuf, int offset,
 365                 rte_mbuf_timestamp_t timestamp)
 366 {
 367         *RTE_MBUF_DYNFIELD(mbuf, offset, rte_mbuf_timestamp_t *) = timestamp;
 368 }
 369
 370 /**
 371  * Replace MPRQ buffer.
 372  *
 373  * @param rxq
 374  *   Pointer to Rx queue structure.
 375  * @param rq_idx
 376  *   RQ index to replace.
 377  */
 378 static __rte_always_inline void
 379 mprq_buf_replace(struct mlx5_rxq_data *rxq, uint16_t rq_idx)
 380 {
 381         const uint32_t strd_n = 1 << rxq->strd_num_n;
 382         struct mlx5_mprq_buf *rep = rxq->mprq_repl;
 383         volatile struct mlx5_wqe_data_seg *wqe =
 384                 &((volatile struct mlx5_wqe_mprq *)rxq->wqes)[rq_idx].dseg;
 385         struct mlx5_mprq_buf *buf = (*rxq->mprq_bufs)[rq_idx];
 386         void *addr;
 387
 388         if (__atomic_load_n(&buf->refcnt, __ATOMIC_RELAXED) > 1) {
 389                 MLX5_ASSERT(rep != NULL);
 390                 /* Replace MPRQ buf. */
 391                 (*rxq->mprq_bufs)[rq_idx] = rep;
 392                 /* Replace WQE. */
 393                 addr = mlx5_mprq_buf_addr(rep, strd_n);
 394                 wqe->addr = rte_cpu_to_be_64((uintptr_t)addr);
 395                 /* If there's only one MR, no need to replace LKey in WQE. */
 396                 if (unlikely(mlx5_mr_btree_len(&rxq->mr_ctrl.cache_bh) > 1))
 397                         wqe->lkey = mlx5_rx_addr2mr(rxq, (uintptr_t)addr);
 398                 /* Stash a mbuf for next replacement. */
 399                 if (likely(!rte_mempool_get(rxq->mprq_mp, (void **)&rep)))
 400                         rxq->mprq_repl = rep;
 401                 else
 402                         rxq->mprq_repl = NULL;
 403                 /* Release the old buffer. */
 404                 mlx5_mprq_buf_free(buf);
 405         } else if (unlikely(rxq->mprq_repl == NULL)) {
 406                 struct mlx5_mprq_buf *rep;
 407
 408                 /*
 409                  * Currently, the MPRQ mempool is out of buffer
 410                  * and doing memcpy regardless of the size of Rx
 411                  * packet. Retry allocation to get back to
 412                  * normal.
 413                  */
 414                 if (!rte_mempool_get(rxq->mprq_mp, (void **)&rep))
 415                         rxq->mprq_repl = rep;
 416         }
 417 }
 418
 419 /**
 420  * Attach or copy MPRQ buffer content to a packet.
 421  *
 422  * @param rxq
 423  *   Pointer to Rx queue structure.
 424  * @param pkt
 425  *   Pointer to a packet to fill.
 426  * @param len
 427  *   Packet length.
 428  * @param buf
 429  *   Pointer to a MPRQ buffer to take the data from.
 430  * @param strd_idx
 431  *   Stride index to start from.
 432  * @param strd_cnt
 433  *   Number of strides to consume.
 434  */
 435 static __rte_always_inline enum mlx5_rqx_code
 436 mprq_buf_to_pkt(struct mlx5_rxq_data *rxq, struct rte_mbuf *pkt, uint32_t len,
 437                 struct mlx5_mprq_buf *buf, uint16_t strd_idx, uint16_t strd_cnt)
 438 {
 439         const uint32_t strd_n = 1 << rxq->strd_num_n;
 440         const uint16_t strd_sz = 1 << rxq->strd_sz_n;
 441         const uint16_t strd_shift =
 442                 MLX5_MPRQ_STRIDE_SHIFT_BYTE * rxq->strd_shift_en;
 443         const int32_t hdrm_overlap =
 444                 len + RTE_PKTMBUF_HEADROOM - strd_cnt * strd_sz;
 445         const uint32_t offset = strd_idx * strd_sz + strd_shift;
 446         void *addr = RTE_PTR_ADD(mlx5_mprq_buf_addr(buf, strd_n), offset);
 447
 448         /*
 449          * Memcpy packets to the target mbuf if:
 450          * - The size of packet is smaller than mprq_max_memcpy_len.
 451          * - Out of buffer in the Mempool for Multi-Packet RQ.
 452          * - The packet's stride overlaps a headroom and scatter is off.
 453          */
 454         if (len <= rxq->mprq_max_memcpy_len ||
 455             rxq->mprq_repl == NULL ||
 456             (hdrm_overlap > 0 && !rxq->strd_scatter_en)) {
 457                 if (likely(len <=
 458                            (uint32_t)(pkt->buf_len - RTE_PKTMBUF_HEADROOM))) {
 459                         rte_memcpy(rte_pktmbuf_mtod(pkt, void *),
 460                                    addr, len);
 461                         DATA_LEN(pkt) = len;
 462                 } else if (rxq->strd_scatter_en) {
 463                         struct rte_mbuf *prev = pkt;
 464                         uint32_t seg_len = RTE_MIN(len, (uint32_t)
 465                                 (pkt->buf_len - RTE_PKTMBUF_HEADROOM));
 466                         uint32_t rem_len = len - seg_len;
 467
 468                         rte_memcpy(rte_pktmbuf_mtod(pkt, void *),
 469                                    addr, seg_len);
 470                         DATA_LEN(pkt) = seg_len;
 471                         while (rem_len) {
 472                                 struct rte_mbuf *next =
 473                                         rte_pktmbuf_alloc(rxq->mp);
 474
 475                                 if (unlikely(next == NULL))
 476                                         return MLX5_RXQ_CODE_NOMBUF;
 477                                 NEXT(prev) = next;
 478                                 SET_DATA_OFF(next, 0);
 479                                 addr = RTE_PTR_ADD(addr, seg_len);
 480                                 seg_len = RTE_MIN(rem_len, (uint32_t)
 481                                         (next->buf_len - RTE_PKTMBUF_HEADROOM));
 482                                 rte_memcpy
 483                                         (rte_pktmbuf_mtod(next, void *),
 484                                          addr, seg_len);
 485                                 DATA_LEN(next) = seg_len;
 486                                 rem_len -= seg_len;
 487                                 prev = next;
 488                                 ++NB_SEGS(pkt);
 489                         }
 490                 } else {
 491                         return MLX5_RXQ_CODE_DROPPED;
 492                 }
 493         } else {
 494                 rte_iova_t buf_iova;
 495                 struct rte_mbuf_ext_shared_info *shinfo;
 496                 uint16_t buf_len = strd_cnt * strd_sz;
 497                 void *buf_addr;
 498
 499                 /* Increment the refcnt of the whole chunk. */
 500                 __atomic_add_fetch(&buf->refcnt, 1, __ATOMIC_RELAXED);
 501                 MLX5_ASSERT(__atomic_load_n(&buf->refcnt,
 502                             __ATOMIC_RELAXED) <= strd_n + 1);
 503                 buf_addr = RTE_PTR_SUB(addr, RTE_PKTMBUF_HEADROOM);
 504                 /*
 505                  * MLX5 device doesn't use iova but it is necessary in a
 506                  * case where the Rx packet is transmitted via a
 507                  * different PMD.
 508                  */
 509                 buf_iova = rte_mempool_virt2iova(buf) +
 510                            RTE_PTR_DIFF(buf_addr, buf);
 511                 shinfo = &buf->shinfos[strd_idx];
 512                 rte_mbuf_ext_refcnt_set(shinfo, 1);
 513                 /*
 514                  * RTE_MBUF_F_EXTERNAL will be set to pkt->ol_flags when
 515                  * attaching the stride to mbuf and more offload flags
 516                  * will be added below by calling rxq_cq_to_mbuf().
 517                  * Other fields will be overwritten.
 518                  */
 519                 rte_pktmbuf_attach_extbuf(pkt, buf_addr, buf_iova,
 520                                           buf_len, shinfo);
 521                 /* Set mbuf head-room. */
 522                 SET_DATA_OFF(pkt, RTE_PKTMBUF_HEADROOM);
 523                 MLX5_ASSERT(pkt->ol_flags == RTE_MBUF_F_EXTERNAL);
 524                 MLX5_ASSERT(rte_pktmbuf_tailroom(pkt) >=
 525                         len - (hdrm_overlap > 0 ? hdrm_overlap : 0));
 526                 DATA_LEN(pkt) = len;
 527                 /*
 528                  * Copy the last fragment of a packet (up to headroom
 529                  * size bytes) in case there is a stride overlap with
 530                  * a next packet's headroom. Allocate a separate mbuf
 531                  * to store this fragment and link it. Scatter is on.
 532                  */
 533                 if (hdrm_overlap > 0) {
 534                         MLX5_ASSERT(rxq->strd_scatter_en);
 535                         struct rte_mbuf *seg =
 536                                 rte_pktmbuf_alloc(rxq->mp);
 537
 538                         if (unlikely(seg == NULL))
 539                                 return MLX5_RXQ_CODE_NOMBUF;
 540                         SET_DATA_OFF(seg, 0);
 541                         rte_memcpy(rte_pktmbuf_mtod(seg, void *),
 542                                 RTE_PTR_ADD(addr, len - hdrm_overlap),
 543                                 hdrm_overlap);
 544                         DATA_LEN(seg) = hdrm_overlap;
 545                         DATA_LEN(pkt) = len - hdrm_overlap;
 546                         NEXT(pkt) = seg;
 547                         NB_SEGS(pkt) = 2;
 548                 }
 549         }
 550         return MLX5_RXQ_CODE_EXIT;
 551 }
 552
 553 /**
 554  * Check whether Multi-Packet RQ can be enabled for the device.
 555  *
 556  * @param dev
 557  *   Pointer to Ethernet device.
 558  *
 559  * @return
 560  *   1 if supported, negative errno value if not.
 561  */
 562 static __rte_always_inline int
 563 mlx5_check_mprq_support(struct rte_eth_dev *dev)
 564 {
 565         struct mlx5_priv *priv = dev->data->dev_private;
 566
 567         if (priv->config.mprq.enabled &&
 568             priv->rxqs_n >= priv->config.mprq.min_rxqs_num)
 569                 return 1;
 570         return -ENOTSUP;
 571 }
 572
 573 /**
 574  * Check whether Multi-Packet RQ is enabled for the Rx queue.
 575  *
 576  *  @param rxq
 577  *     Pointer to receive queue structure.
 578  *
 579  * @return
 580  *   0 if disabled, otherwise enabled.
 581  */
 582 static __rte_always_inline int
 583 mlx5_rxq_mprq_enabled(struct mlx5_rxq_data *rxq)
 584 {
 585         return rxq->strd_num_n > 0;
 586 }
 587
 588 /**
 589  * Check whether Multi-Packet RQ is enabled for the device.
 590  *
 591  * @param dev
 592  *   Pointer to Ethernet device.
 593  *
 594  * @return
 595  *   0 if disabled, otherwise enabled.
 596  */
 597 static __rte_always_inline int
 598 mlx5_mprq_enabled(struct rte_eth_dev *dev)
 599 {
 600         struct mlx5_priv *priv = dev->data->dev_private;
 601         uint32_t i;
 602         uint16_t n = 0;
 603         uint16_t n_ibv = 0;
 604
 605         if (mlx5_check_mprq_support(dev) < 0)
 606                 return 0;
 607         /* All the configured queues should be enabled. */
 608         for (i = 0; i < priv->rxqs_n; ++i) {
 609                 struct mlx5_rxq_ctrl *rxq_ctrl = mlx5_rxq_ctrl_get(dev, i);
 610
 611                 if (rxq_ctrl == NULL ||
 612                     rxq_ctrl->type != MLX5_RXQ_TYPE_STANDARD)
 613                         continue;
 614                 n_ibv++;
 615                 if (mlx5_rxq_mprq_enabled(&rxq_ctrl->rxq))
 616                         ++n;
 617         }
 618         /* Multi-Packet RQ can't be partially configured. */
 619         MLX5_ASSERT(n == 0 || n == n_ibv);
 620         return n == n_ibv;
 621 }
 622
 623 #endif /* RTE_PMD_MLX5_RX_H_ */