drivers/net/mlx4/mlx4_rxq.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright 2017 6WIND S.A.
   3  * Copyright 2017 Mellanox Technologies, Ltd
   4  */
   5
   6 /**
   7  * @file
   8  * Rx queues configuration for mlx4 driver.
   9  */
  10
  11 #include <assert.h>
  12 #include <errno.h>
  13 #include <stddef.h>
  14 #include <stdint.h>
  15 #include <string.h>
  16
  17 /* Verbs headers do not support -pedantic. */
  18 #ifdef PEDANTIC
  19 #pragma GCC diagnostic ignored "-Wpedantic"
  20 #endif
  21 #include <infiniband/mlx4dv.h>
  22 #include <infiniband/verbs.h>
  23 #ifdef PEDANTIC
  24 #pragma GCC diagnostic error "-Wpedantic"
  25 #endif
  26
  27 #include <rte_byteorder.h>
  28 #include <rte_common.h>
  29 #include <rte_errno.h>
  30 #include <rte_ethdev_driver.h>
  31 #include <rte_flow.h>
  32 #include <rte_malloc.h>
  33 #include <rte_mbuf.h>
  34 #include <rte_mempool.h>
  35
  36 #include "mlx4.h"
  37 #include "mlx4_glue.h"
  38 #include "mlx4_flow.h"
  39 #include "mlx4_rxtx.h"
  40 #include "mlx4_utils.h"
  41
  42 /**
  43  * Historical RSS hash key.
  44  *
  45  * This used to be the default for mlx4 in Linux before v3.19 switched to
  46  * generating random hash keys through netdev_rss_key_fill().
  47  *
  48  * It is used in this PMD for consistency with past DPDK releases but can
  49  * now be overridden through user configuration.
  50  *
  51  * Note: this is not const to work around API quirks.
  52  */
  53 uint8_t
  54 mlx4_rss_hash_key_default[MLX4_RSS_HASH_KEY_SIZE] = {
  55         0x2c, 0xc6, 0x81, 0xd1,
  56         0x5b, 0xdb, 0xf4, 0xf7,
  57         0xfc, 0xa2, 0x83, 0x19,
  58         0xdb, 0x1a, 0x3e, 0x94,
  59         0x6b, 0x9e, 0x38, 0xd9,
  60         0x2c, 0x9c, 0x03, 0xd1,
  61         0xad, 0x99, 0x44, 0xa7,
  62         0xd9, 0x56, 0x3d, 0x59,
  63         0x06, 0x3c, 0x25, 0xf3,
  64         0xfc, 0x1f, 0xdc, 0x2a,
  65 };
  66
  67 /**
  68  * Obtain a RSS context with specified properties.
  69  *
  70  * Used when creating a flow rule targeting one or several Rx queues.
  71  *
  72  * If a matching RSS context already exists, it is returned with its
  73  * reference count incremented.
  74  *
  75  * @param priv
  76  *   Pointer to private structure.
  77  * @param fields
  78  *   Fields for RSS processing (Verbs format).
  79  * @param[in] key
  80  *   Hash key to use (whose size is exactly MLX4_RSS_HASH_KEY_SIZE).
  81  * @param queues
  82  *   Number of target queues.
  83  * @param[in] queue_id
  84  *   Target queues.
  85  *
  86  * @return
  87  *   Pointer to RSS context on success, NULL otherwise and rte_errno is set.
  88  */
  89 struct mlx4_rss *
  90 mlx4_rss_get(struct priv *priv, uint64_t fields,
  91              const uint8_t key[MLX4_RSS_HASH_KEY_SIZE],
  92              uint16_t queues, const uint16_t queue_id[])
  93 {
  94         struct mlx4_rss *rss;
  95         size_t queue_id_size = sizeof(queue_id[0]) * queues;
  96
  97         LIST_FOREACH(rss, &priv->rss, next)
  98                 if (fields == rss->fields &&
  99                     queues == rss->queues &&
 100                     !memcmp(key, rss->key, MLX4_RSS_HASH_KEY_SIZE) &&
 101                     !memcmp(queue_id, rss->queue_id, queue_id_size)) {
 102                         ++rss->refcnt;
 103                         return rss;
 104                 }
 105         rss = rte_malloc(__func__, offsetof(struct mlx4_rss, queue_id) +
 106                          queue_id_size, 0);
 107         if (!rss)
 108                 goto error;
 109         *rss = (struct mlx4_rss){
 110                 .priv = priv,
 111                 .refcnt = 1,
 112                 .usecnt = 0,
 113                 .qp = NULL,
 114                 .ind = NULL,
 115                 .fields = fields,
 116                 .queues = queues,
 117         };
 118         memcpy(rss->key, key, MLX4_RSS_HASH_KEY_SIZE);
 119         memcpy(rss->queue_id, queue_id, queue_id_size);
 120         LIST_INSERT_HEAD(&priv->rss, rss, next);
 121         return rss;
 122 error:
 123         rte_errno = ENOMEM;
 124         return NULL;
 125 }
 126
 127 /**
 128  * Release a RSS context instance.
 129  *
 130  * Used when destroying a flow rule targeting one or several Rx queues.
 131  *
 132  * This function decrements the reference count of the context and destroys
 133  * it after reaching 0. The context must have no users at this point; all
 134  * prior calls to mlx4_rss_attach() must have been followed by matching
 135  * calls to mlx4_rss_detach().
 136  *
 137  * @param rss
 138  *   RSS context to release.
 139  */
 140 void
 141 mlx4_rss_put(struct mlx4_rss *rss)
 142 {
 143         assert(rss->refcnt);
 144         if (--rss->refcnt)
 145                 return;
 146         assert(!rss->usecnt);
 147         assert(!rss->qp);
 148         assert(!rss->ind);
 149         LIST_REMOVE(rss, next);
 150         rte_free(rss);
 151 }
 152
 153 /**
 154  * Attach a user to a RSS context instance.
 155  *
 156  * Used when the RSS QP and indirection table objects must be instantiated,
 157  * that is, when a flow rule must be enabled.
 158  *
 159  * This function increments the usage count of the context.
 160  *
 161  * @param rss
 162  *   RSS context to attach to.
 163  *
 164  * @return
 165  *   0 on success, a negative errno value otherwise and rte_errno is set.
 166  */
 167 int
 168 mlx4_rss_attach(struct mlx4_rss *rss)
 169 {
 170         assert(rss->refcnt);
 171         if (rss->usecnt++) {
 172                 assert(rss->qp);
 173                 assert(rss->ind);
 174                 return 0;
 175         }
 176
 177         struct ibv_wq *ind_tbl[rss->queues];
 178         struct priv *priv = rss->priv;
 179         const char *msg;
 180         unsigned int i = 0;
 181         int ret;
 182
 183         if (!rte_is_power_of_2(RTE_DIM(ind_tbl))) {
 184                 ret = EINVAL;
 185                 msg = "number of RSS queues must be a power of two";
 186                 goto error;
 187         }
 188         for (i = 0; i != RTE_DIM(ind_tbl); ++i) {
 189                 uint16_t id = rss->queue_id[i];
 190                 struct rxq *rxq = NULL;
 191
 192                 if (id < priv->dev->data->nb_rx_queues)
 193                         rxq = priv->dev->data->rx_queues[id];
 194                 if (!rxq) {
 195                         ret = EINVAL;
 196                         msg = "RSS target queue is not configured";
 197                         goto error;
 198                 }
 199                 ret = mlx4_rxq_attach(rxq);
 200                 if (ret) {
 201                         ret = -ret;
 202                         msg = "unable to attach RSS target queue";
 203                         goto error;
 204                 }
 205                 ind_tbl[i] = rxq->wq;
 206         }
 207         rss->ind = mlx4_glue->create_rwq_ind_table
 208                 (priv->ctx,
 209                  &(struct ibv_rwq_ind_table_init_attr){
 210                         .log_ind_tbl_size = rte_log2_u32(RTE_DIM(ind_tbl)),
 211                         .ind_tbl = ind_tbl,
 212                         .comp_mask = 0,
 213                  });
 214         if (!rss->ind) {
 215                 ret = errno ? errno : EINVAL;
 216                 msg = "RSS indirection table creation failure";
 217                 goto error;
 218         }
 219         rss->qp = mlx4_glue->create_qp_ex
 220                 (priv->ctx,
 221                  &(struct ibv_qp_init_attr_ex){
 222                         .comp_mask = (IBV_QP_INIT_ATTR_PD |
 223                                       IBV_QP_INIT_ATTR_RX_HASH |
 224                                       IBV_QP_INIT_ATTR_IND_TABLE),
 225                         .qp_type = IBV_QPT_RAW_PACKET,
 226                         .pd = priv->pd,
 227                         .rwq_ind_tbl = rss->ind,
 228                         .rx_hash_conf = {
 229                                 .rx_hash_function = IBV_RX_HASH_FUNC_TOEPLITZ,
 230                                 .rx_hash_key_len = MLX4_RSS_HASH_KEY_SIZE,
 231                                 .rx_hash_key = rss->key,
 232                                 .rx_hash_fields_mask = rss->fields,
 233                         },
 234                  });
 235         if (!rss->qp) {
 236                 ret = errno ? errno : EINVAL;
 237                 msg = "RSS hash QP creation failure";
 238                 goto error;
 239         }
 240         ret = mlx4_glue->modify_qp
 241                 (rss->qp,
 242                  &(struct ibv_qp_attr){
 243                         .qp_state = IBV_QPS_INIT,
 244                         .port_num = priv->port,
 245                  },
 246                  IBV_QP_STATE | IBV_QP_PORT);
 247         if (ret) {
 248                 msg = "failed to switch RSS hash QP to INIT state";
 249                 goto error;
 250         }
 251         ret = mlx4_glue->modify_qp
 252                 (rss->qp,
 253                  &(struct ibv_qp_attr){
 254                         .qp_state = IBV_QPS_RTR,
 255                  },
 256                  IBV_QP_STATE);
 257         if (ret) {
 258                 msg = "failed to switch RSS hash QP to RTR state";
 259                 goto error;
 260         }
 261         return 0;
 262 error:
 263         if (rss->qp) {
 264                 claim_zero(mlx4_glue->destroy_qp(rss->qp));
 265                 rss->qp = NULL;
 266         }
 267         if (rss->ind) {
 268                 claim_zero(mlx4_glue->destroy_rwq_ind_table(rss->ind));
 269                 rss->ind = NULL;
 270         }
 271         while (i--)
 272                 mlx4_rxq_detach(priv->dev->data->rx_queues[rss->queue_id[i]]);
 273         ERROR("mlx4: %s", msg);
 274         --rss->usecnt;
 275         rte_errno = ret;
 276         return -ret;
 277 }
 278
 279 /**
 280  * Detach a user from a RSS context instance.
 281  *
 282  * Used when disabling (not destroying) a flow rule.
 283  *
 284  * This function decrements the usage count of the context and destroys
 285  * usage resources after reaching 0.
 286  *
 287  * @param rss
 288  *   RSS context to detach from.
 289  */
 290 void
 291 mlx4_rss_detach(struct mlx4_rss *rss)
 292 {
 293         struct priv *priv = rss->priv;
 294         unsigned int i;
 295
 296         assert(rss->refcnt);
 297         assert(rss->qp);
 298         assert(rss->ind);
 299         if (--rss->usecnt)
 300                 return;
 301         claim_zero(mlx4_glue->destroy_qp(rss->qp));
 302         rss->qp = NULL;
 303         claim_zero(mlx4_glue->destroy_rwq_ind_table(rss->ind));
 304         rss->ind = NULL;
 305         for (i = 0; i != rss->queues; ++i)
 306                 mlx4_rxq_detach(priv->dev->data->rx_queues[rss->queue_id[i]]);
 307 }
 308
 309 /**
 310  * Initialize common RSS context resources.
 311  *
 312  * Because ConnectX-3 hardware limitations require a fixed order in the
 313  * indirection table, WQs must be allocated sequentially to be part of a
 314  * common RSS context.
 315  *
 316  * Since a newly created WQ cannot be moved to a different context, this
 317  * function allocates them all at once, one for each configured Rx queue,
 318  * as well as all related resources (CQs and mbufs).
 319  *
 320  * This must therefore be done before creating any Rx flow rules relying on
 321  * indirection tables.
 322  *
 323  * @param priv
 324  *   Pointer to private structure.
 325  *
 326  * @return
 327  *   0 on success, a negative errno value otherwise and rte_errno is set.
 328  */
 329 int
 330 mlx4_rss_init(struct priv *priv)
 331 {
 332         struct rte_eth_dev *dev = priv->dev;
 333         uint8_t log2_range = rte_log2_u32(dev->data->nb_rx_queues);
 334         uint32_t wq_num_prev = 0;
 335         const char *msg;
 336         unsigned int i;
 337         int ret;
 338
 339         if (priv->rss_init)
 340                 return 0;
 341         /* Prepare range for RSS contexts before creating the first WQ. */
 342         ret = mlx4_glue->dv_set_context_attr
 343                 (priv->ctx,
 344                  MLX4DV_SET_CTX_ATTR_LOG_WQS_RANGE_SZ,
 345                  &log2_range);
 346         if (ret) {
 347                 ERROR("cannot set up range size for RSS context to %u"
 348                       " (for %u Rx queues), error: %s",
 349                       1 << log2_range, dev->data->nb_rx_queues, strerror(ret));
 350                 rte_errno = ret;
 351                 return -ret;
 352         }
 353         for (i = 0; i != priv->dev->data->nb_rx_queues; ++i) {
 354                 struct rxq *rxq = priv->dev->data->rx_queues[i];
 355                 struct ibv_cq *cq;
 356                 struct ibv_wq *wq;
 357                 uint32_t wq_num;
 358
 359                 /* Attach the configured Rx queues. */
 360                 if (rxq) {
 361                         assert(!rxq->usecnt);
 362                         ret = mlx4_rxq_attach(rxq);
 363                         if (!ret) {
 364                                 wq_num = rxq->wq->wq_num;
 365                                 goto wq_num_check;
 366                         }
 367                         ret = -ret;
 368                         msg = "unable to create Rx queue resources";
 369                         goto error;
 370                 }
 371                 /*
 372                  * WQs are temporarily allocated for unconfigured Rx queues
 373                  * to maintain proper index alignment in indirection table
 374                  * by skipping unused WQ numbers.
 375                  *
 376                  * The reason this works at all even though these WQs are
 377                  * immediately destroyed is that WQNs are allocated
 378                  * sequentially and are guaranteed to never be reused in the
 379                  * same context by the underlying implementation.
 380                  */
 381                 cq = mlx4_glue->create_cq(priv->ctx, 1, NULL, NULL, 0);
 382                 if (!cq) {
 383                         ret = ENOMEM;
 384                         msg = "placeholder CQ creation failure";
 385                         goto error;
 386                 }
 387                 wq = mlx4_glue->create_wq
 388                         (priv->ctx,
 389                          &(struct ibv_wq_init_attr){
 390                                 .wq_type = IBV_WQT_RQ,
 391                                 .max_wr = 1,
 392                                 .max_sge = 1,
 393                                 .pd = priv->pd,
 394                                 .cq = cq,
 395                          });
 396                 if (wq) {
 397                         wq_num = wq->wq_num;
 398                         claim_zero(mlx4_glue->destroy_wq(wq));
 399                 } else {
 400                         wq_num = 0; /* Shut up GCC 4.8 warnings. */
 401                 }
 402                 claim_zero(mlx4_glue->destroy_cq(cq));
 403                 if (!wq) {
 404                         ret = ENOMEM;
 405                         msg = "placeholder WQ creation failure";
 406                         goto error;
 407                 }
 408 wq_num_check:
 409                 /*
 410                  * While guaranteed by the implementation, make sure WQ
 411                  * numbers are really sequential (as the saying goes,
 412                  * trust, but verify).
 413                  */
 414                 if (i && wq_num - wq_num_prev != 1) {
 415                         if (rxq)
 416                                 mlx4_rxq_detach(rxq);
 417                         ret = ERANGE;
 418                         msg = "WQ numbers are not sequential";
 419                         goto error;
 420                 }
 421                 wq_num_prev = wq_num;
 422         }
 423         priv->rss_init = 1;
 424         return 0;
 425 error:
 426         ERROR("cannot initialize common RSS resources (queue %u): %s: %s",
 427               i, msg, strerror(ret));
 428         while (i--) {
 429                 struct rxq *rxq = priv->dev->data->rx_queues[i];
 430
 431                 if (rxq)
 432                         mlx4_rxq_detach(rxq);
 433         }
 434         rte_errno = ret;
 435         return -ret;
 436 }
 437
 438 /**
 439  * Release common RSS context resources.
 440  *
 441  * As the reverse of mlx4_rss_init(), this must be done after removing all
 442  * flow rules relying on indirection tables.
 443  *
 444  * @param priv
 445  *   Pointer to private structure.
 446  */
 447 void
 448 mlx4_rss_deinit(struct priv *priv)
 449 {
 450         unsigned int i;
 451
 452         if (!priv->rss_init)
 453                 return;
 454         for (i = 0; i != priv->dev->data->nb_rx_queues; ++i) {
 455                 struct rxq *rxq = priv->dev->data->rx_queues[i];
 456
 457                 if (rxq) {
 458                         assert(rxq->usecnt == 1);
 459                         mlx4_rxq_detach(rxq);
 460                 }
 461         }
 462         priv->rss_init = 0;
 463 }
 464
 465 /**
 466  * Attach a user to a Rx queue.
 467  *
 468  * Used when the resources of an Rx queue must be instantiated for it to
 469  * become in a usable state.
 470  *
 471  * This function increments the usage count of the Rx queue.
 472  *
 473  * @param rxq
 474  *   Pointer to Rx queue structure.
 475  *
 476  * @return
 477  *   0 on success, negative errno value otherwise and rte_errno is set.
 478  */
 479 int
 480 mlx4_rxq_attach(struct rxq *rxq)
 481 {
 482         if (rxq->usecnt++) {
 483                 assert(rxq->cq);
 484                 assert(rxq->wq);
 485                 assert(rxq->wqes);
 486                 assert(rxq->rq_db);
 487                 return 0;
 488         }
 489
 490         struct priv *priv = rxq->priv;
 491         const uint32_t elts_n = 1 << rxq->elts_n;
 492         const uint32_t sges_n = 1 << rxq->sges_n;
 493         struct rte_mbuf *(*elts)[elts_n] = rxq->elts;
 494         struct mlx4dv_obj mlxdv;
 495         struct mlx4dv_rwq dv_rwq;
 496         struct mlx4dv_cq dv_cq = { .comp_mask = MLX4DV_CQ_MASK_UAR, };
 497         const char *msg;
 498         struct ibv_cq *cq = NULL;
 499         struct ibv_wq *wq = NULL;
 500         uint32_t create_flags = 0;
 501         uint32_t comp_mask = 0;
 502         volatile struct mlx4_wqe_data_seg (*wqes)[];
 503         unsigned int i;
 504         int ret;
 505
 506         assert(rte_is_power_of_2(elts_n));
 507         cq = mlx4_glue->create_cq(priv->ctx, elts_n / sges_n, NULL,
 508                                   rxq->channel, 0);
 509         if (!cq) {
 510                 ret = ENOMEM;
 511                 msg = "CQ creation failure";
 512                 goto error;
 513         }
 514         /* By default, FCS (CRC) is stripped by hardware. */
 515         if (rxq->crc_present) {
 516                 create_flags |= IBV_WQ_FLAGS_SCATTER_FCS;
 517                 comp_mask |= IBV_WQ_INIT_ATTR_FLAGS;
 518         }
 519         wq = mlx4_glue->create_wq
 520                 (priv->ctx,
 521                  &(struct ibv_wq_init_attr){
 522                         .wq_type = IBV_WQT_RQ,
 523                         .max_wr = elts_n / sges_n,
 524                         .max_sge = sges_n,
 525                         .pd = priv->pd,
 526                         .cq = cq,
 527                         .comp_mask = comp_mask,
 528                         .create_flags = create_flags,
 529                  });
 530         if (!wq) {
 531                 ret = errno ? errno : EINVAL;
 532                 msg = "WQ creation failure";
 533                 goto error;
 534         }
 535         ret = mlx4_glue->modify_wq
 536                 (wq,
 537                  &(struct ibv_wq_attr){
 538                         .attr_mask = IBV_WQ_ATTR_STATE,
 539                         .wq_state = IBV_WQS_RDY,
 540                  });
 541         if (ret) {
 542                 msg = "WQ state change to IBV_WQS_RDY failed";
 543                 goto error;
 544         }
 545         /* Retrieve device queue information. */
 546         mlxdv.cq.in = cq;
 547         mlxdv.cq.out = &dv_cq;
 548         mlxdv.rwq.in = wq;
 549         mlxdv.rwq.out = &dv_rwq;
 550         ret = mlx4_glue->dv_init_obj(&mlxdv, MLX4DV_OBJ_RWQ | MLX4DV_OBJ_CQ);
 551         if (ret) {
 552                 msg = "failed to obtain device information from WQ/CQ objects";
 553                 goto error;
 554         }
 555         wqes = (volatile struct mlx4_wqe_data_seg (*)[])
 556                 ((uintptr_t)dv_rwq.buf.buf + dv_rwq.rq.offset);
 557         for (i = 0; i != RTE_DIM(*elts); ++i) {
 558                 volatile struct mlx4_wqe_data_seg *scat = &(*wqes)[i];
 559                 struct rte_mbuf *buf = rte_pktmbuf_alloc(rxq->mp);
 560
 561                 if (buf == NULL) {
 562                         while (i--) {
 563                                 rte_pktmbuf_free_seg((*elts)[i]);
 564                                 (*elts)[i] = NULL;
 565                         }
 566                         ret = ENOMEM;
 567                         msg = "cannot allocate mbuf";
 568                         goto error;
 569                 }
 570                 /* Headroom is reserved by rte_pktmbuf_alloc(). */
 571                 assert(buf->data_off == RTE_PKTMBUF_HEADROOM);
 572                 /* Buffer is supposed to be empty. */
 573                 assert(rte_pktmbuf_data_len(buf) == 0);
 574                 assert(rte_pktmbuf_pkt_len(buf) == 0);
 575                 /* Only the first segment keeps headroom. */
 576                 if (i % sges_n)
 577                         buf->data_off = 0;
 578                 buf->port = rxq->port_id;
 579                 buf->data_len = rte_pktmbuf_tailroom(buf);
 580                 buf->pkt_len = rte_pktmbuf_tailroom(buf);
 581                 buf->nb_segs = 1;
 582                 *scat = (struct mlx4_wqe_data_seg){
 583                         .addr = rte_cpu_to_be_64(rte_pktmbuf_mtod(buf,
 584                                                                   uintptr_t)),
 585                         .byte_count = rte_cpu_to_be_32(buf->data_len),
 586                         .lkey = rte_cpu_to_be_32(rxq->mr->lkey),
 587                 };
 588                 (*elts)[i] = buf;
 589         }
 590         DEBUG("%p: allocated and configured %u segments (max %u packets)",
 591               (void *)rxq, elts_n, elts_n / sges_n);
 592         rxq->cq = cq;
 593         rxq->wq = wq;
 594         rxq->wqes = wqes;
 595         rxq->rq_db = dv_rwq.rdb;
 596         rxq->mcq.buf = dv_cq.buf.buf;
 597         rxq->mcq.cqe_cnt = dv_cq.cqe_cnt;
 598         rxq->mcq.set_ci_db = dv_cq.set_ci_db;
 599         rxq->mcq.cqe_64 = (dv_cq.cqe_size & 64) ? 1 : 0;
 600         rxq->mcq.arm_db = dv_cq.arm_db;
 601         rxq->mcq.arm_sn = dv_cq.arm_sn;
 602         rxq->mcq.cqn = dv_cq.cqn;
 603         rxq->mcq.cq_uar = dv_cq.cq_uar;
 604         rxq->mcq.cq_db_reg = (uint8_t *)dv_cq.cq_uar + MLX4_CQ_DOORBELL;
 605         /* Update doorbell counter. */
 606         rxq->rq_ci = elts_n / sges_n;
 607         rte_wmb();
 608         *rxq->rq_db = rte_cpu_to_be_32(rxq->rq_ci);
 609         return 0;
 610 error:
 611         if (wq)
 612                 claim_zero(mlx4_glue->destroy_wq(wq));
 613         if (cq)
 614                 claim_zero(mlx4_glue->destroy_cq(cq));
 615         --rxq->usecnt;
 616         rte_errno = ret;
 617         ERROR("error while attaching Rx queue %p: %s: %s",
 618               (void *)rxq, msg, strerror(ret));
 619         return -ret;
 620 }
 621
 622 /**
 623  * Detach a user from a Rx queue.
 624  *
 625  * This function decrements the usage count of the Rx queue and destroys
 626  * usage resources after reaching 0.
 627  *
 628  * @param rxq
 629  *   Pointer to Rx queue structure.
 630  */
 631 void
 632 mlx4_rxq_detach(struct rxq *rxq)
 633 {
 634         unsigned int i;
 635         struct rte_mbuf *(*elts)[1 << rxq->elts_n] = rxq->elts;
 636
 637         if (--rxq->usecnt)
 638                 return;
 639         rxq->rq_ci = 0;
 640         memset(&rxq->mcq, 0, sizeof(rxq->mcq));
 641         rxq->rq_db = NULL;
 642         rxq->wqes = NULL;
 643         claim_zero(mlx4_glue->destroy_wq(rxq->wq));
 644         rxq->wq = NULL;
 645         claim_zero(mlx4_glue->destroy_cq(rxq->cq));
 646         rxq->cq = NULL;
 647         DEBUG("%p: freeing Rx queue elements", (void *)rxq);
 648         for (i = 0; (i != RTE_DIM(*elts)); ++i) {
 649                 if (!(*elts)[i])
 650                         continue;
 651                 rte_pktmbuf_free_seg((*elts)[i]);
 652                 (*elts)[i] = NULL;
 653         }
 654 }
 655
 656 /**
 657  * Returns the per-queue supported offloads.
 658  *
 659  * @param priv
 660  *   Pointer to private structure.
 661  *
 662  * @return
 663  *   Supported Tx offloads.
 664  */
 665 uint64_t
 666 mlx4_get_rx_queue_offloads(struct priv *priv)
 667 {
 668         uint64_t offloads = DEV_RX_OFFLOAD_SCATTER |
 669                             DEV_RX_OFFLOAD_CRC_STRIP;
 670
 671         if (priv->hw_csum)
 672                 offloads |= DEV_RX_OFFLOAD_CHECKSUM;
 673         return offloads;
 674 }
 675
 676 /**
 677  * Returns the per-port supported offloads.
 678  *
 679  * @param priv
 680  *   Pointer to private structure.
 681  *
 682  * @return
 683  *   Supported Rx offloads.
 684  */
 685 uint64_t
 686 mlx4_get_rx_port_offloads(struct priv *priv)
 687 {
 688         uint64_t offloads = DEV_RX_OFFLOAD_VLAN_FILTER;
 689
 690         (void)priv;
 691         return offloads;
 692 }
 693
 694 /**
 695  * DPDK callback to configure a Rx queue.
 696  *
 697  * @param dev
 698  *   Pointer to Ethernet device structure.
 699  * @param idx
 700  *   Rx queue index.
 701  * @param desc
 702  *   Number of descriptors to configure in queue.
 703  * @param socket
 704  *   NUMA socket on which memory must be allocated.
 705  * @param[in] conf
 706  *   Thresholds parameters.
 707  * @param mp
 708  *   Memory pool for buffer allocations.
 709  *
 710  * @return
 711  *   0 on success, negative errno value otherwise and rte_errno is set.
 712  */
 713 int
 714 mlx4_rx_queue_setup(struct rte_eth_dev *dev, uint16_t idx, uint16_t desc,
 715                     unsigned int socket, const struct rte_eth_rxconf *conf,
 716                     struct rte_mempool *mp)
 717 {
 718         struct priv *priv = dev->data->dev_private;
 719         uint32_t mb_len = rte_pktmbuf_data_room_size(mp);
 720         struct rte_mbuf *(*elts)[rte_align32pow2(desc)];
 721         struct rxq *rxq;
 722         struct mlx4_malloc_vec vec[] = {
 723                 {
 724                         .align = RTE_CACHE_LINE_SIZE,
 725                         .size = sizeof(*rxq),
 726                         .addr = (void **)&rxq,
 727                 },
 728                 {
 729                         .align = RTE_CACHE_LINE_SIZE,
 730                         .size = sizeof(*elts),
 731                         .addr = (void **)&elts,
 732                 },
 733         };
 734         int ret;
 735         uint32_t crc_present;
 736         uint64_t offloads;
 737
 738         offloads = conf->offloads | dev->data->dev_conf.rxmode.offloads;
 739
 740         DEBUG("%p: configuring queue %u for %u descriptors",
 741               (void *)dev, idx, desc);
 742
 743         if (idx >= dev->data->nb_rx_queues) {
 744                 rte_errno = EOVERFLOW;
 745                 ERROR("%p: queue index out of range (%u >= %u)",
 746                       (void *)dev, idx, dev->data->nb_rx_queues);
 747                 return -rte_errno;
 748         }
 749         rxq = dev->data->rx_queues[idx];
 750         if (rxq) {
 751                 rte_errno = EEXIST;
 752                 ERROR("%p: Rx queue %u already configured, release it first",
 753                       (void *)dev, idx);
 754                 return -rte_errno;
 755         }
 756         if (!desc) {
 757                 rte_errno = EINVAL;
 758                 ERROR("%p: invalid number of Rx descriptors", (void *)dev);
 759                 return -rte_errno;
 760         }
 761         if (desc != RTE_DIM(*elts)) {
 762                 desc = RTE_DIM(*elts);
 763                 WARN("%p: increased number of descriptors in Rx queue %u"
 764                      " to the next power of two (%u)",
 765                      (void *)dev, idx, desc);
 766         }
 767         /* By default, FCS (CRC) is stripped by hardware. */
 768         if (offloads & DEV_RX_OFFLOAD_CRC_STRIP) {
 769                 crc_present = 0;
 770         } else if (priv->hw_fcs_strip) {
 771                 crc_present = 1;
 772         } else {
 773                 WARN("%p: CRC stripping has been disabled but will still"
 774                      " be performed by hardware, make sure MLNX_OFED and"
 775                      " firmware are up to date",
 776                      (void *)dev);
 777                 crc_present = 0;
 778         }
 779         DEBUG("%p: CRC stripping is %s, %u bytes will be subtracted from"
 780               " incoming frames to hide it",
 781               (void *)dev,
 782               crc_present ? "disabled" : "enabled",
 783               crc_present << 2);
 784         /* Allocate and initialize Rx queue. */
 785         mlx4_zmallocv_socket("RXQ", vec, RTE_DIM(vec), socket);
 786         if (!rxq) {
 787                 ERROR("%p: unable to allocate queue index %u",
 788                       (void *)dev, idx);
 789                 return -rte_errno;
 790         }
 791         *rxq = (struct rxq){
 792                 .priv = priv,
 793                 .mp = mp,
 794                 .port_id = dev->data->port_id,
 795                 .sges_n = 0,
 796                 .elts_n = rte_log2_u32(desc),
 797                 .elts = elts,
 798                 /* Toggle Rx checksum offload if hardware supports it. */
 799                 .csum = priv->hw_csum &&
 800                         (offloads & DEV_RX_OFFLOAD_CHECKSUM),
 801                 .csum_l2tun = priv->hw_csum_l2tun &&
 802                               (offloads & DEV_RX_OFFLOAD_CHECKSUM),
 803                 .crc_present = crc_present,
 804                 .l2tun_offload = priv->hw_csum_l2tun,
 805                 .stats = {
 806                         .idx = idx,
 807                 },
 808                 .socket = socket,
 809         };
 810         /* Enable scattered packets support for this queue if necessary. */
 811         assert(mb_len >= RTE_PKTMBUF_HEADROOM);
 812         if (dev->data->dev_conf.rxmode.max_rx_pkt_len <=
 813             (mb_len - RTE_PKTMBUF_HEADROOM)) {
 814                 ;
 815         } else if (offloads & DEV_RX_OFFLOAD_SCATTER) {
 816                 uint32_t size =
 817                         RTE_PKTMBUF_HEADROOM +
 818                         dev->data->dev_conf.rxmode.max_rx_pkt_len;
 819                 uint32_t sges_n;
 820
 821                 /*
 822                  * Determine the number of SGEs needed for a full packet
 823                  * and round it to the next power of two.
 824                  */
 825                 sges_n = rte_log2_u32((size / mb_len) + !!(size % mb_len));
 826                 rxq->sges_n = sges_n;
 827                 /* Make sure sges_n did not overflow. */
 828                 size = mb_len * (1 << rxq->sges_n);
 829                 size -= RTE_PKTMBUF_HEADROOM;
 830                 if (size < dev->data->dev_conf.rxmode.max_rx_pkt_len) {
 831                         rte_errno = EOVERFLOW;
 832                         ERROR("%p: too many SGEs (%u) needed to handle"
 833                               " requested maximum packet size %u",
 834                               (void *)dev,
 835                               1 << sges_n,
 836                               dev->data->dev_conf.rxmode.max_rx_pkt_len);
 837                         goto error;
 838                 }
 839         } else {
 840                 WARN("%p: the requested maximum Rx packet size (%u) is"
 841                      " larger than a single mbuf (%u) and scattered"
 842                      " mode has not been requested",
 843                      (void *)dev,
 844                      dev->data->dev_conf.rxmode.max_rx_pkt_len,
 845                      mb_len - RTE_PKTMBUF_HEADROOM);
 846         }
 847         DEBUG("%p: maximum number of segments per packet: %u",
 848               (void *)dev, 1 << rxq->sges_n);
 849         if (desc % (1 << rxq->sges_n)) {
 850                 rte_errno = EINVAL;
 851                 ERROR("%p: number of Rx queue descriptors (%u) is not a"
 852                       " multiple of maximum segments per packet (%u)",
 853                       (void *)dev,
 854                       desc,
 855                       1 << rxq->sges_n);
 856                 goto error;
 857         }
 858         /* Use the entire Rx mempool as the memory region. */
 859         rxq->mr = mlx4_mr_get(priv, mp);
 860         if (!rxq->mr) {
 861                 ERROR("%p: MR creation failure: %s",
 862                       (void *)dev, strerror(rte_errno));
 863                 goto error;
 864         }
 865         if (dev->data->dev_conf.intr_conf.rxq) {
 866                 rxq->channel = mlx4_glue->create_comp_channel(priv->ctx);
 867                 if (rxq->channel == NULL) {
 868                         rte_errno = ENOMEM;
 869                         ERROR("%p: Rx interrupt completion channel creation"
 870                               " failure: %s",
 871                               (void *)dev, strerror(rte_errno));
 872                         goto error;
 873                 }
 874                 if (mlx4_fd_set_non_blocking(rxq->channel->fd) < 0) {
 875                         ERROR("%p: unable to make Rx interrupt completion"
 876                               " channel non-blocking: %s",
 877                               (void *)dev, strerror(rte_errno));
 878                         goto error;
 879                 }
 880         }
 881         DEBUG("%p: adding Rx queue %p to list", (void *)dev, (void *)rxq);
 882         dev->data->rx_queues[idx] = rxq;
 883         return 0;
 884 error:
 885         dev->data->rx_queues[idx] = NULL;
 886         ret = rte_errno;
 887         mlx4_rx_queue_release(rxq);
 888         rte_errno = ret;
 889         assert(rte_errno > 0);
 890         return -rte_errno;
 891 }
 892
 893 /**
 894  * DPDK callback to release a Rx queue.
 895  *
 896  * @param dpdk_rxq
 897  *   Generic Rx queue pointer.
 898  */
 899 void
 900 mlx4_rx_queue_release(void *dpdk_rxq)
 901 {
 902         struct rxq *rxq = (struct rxq *)dpdk_rxq;
 903         struct priv *priv;
 904         unsigned int i;
 905
 906         if (rxq == NULL)
 907                 return;
 908         priv = rxq->priv;
 909         for (i = 0; i != priv->dev->data->nb_rx_queues; ++i)
 910                 if (priv->dev->data->rx_queues[i] == rxq) {
 911                         DEBUG("%p: removing Rx queue %p from list",
 912                               (void *)priv->dev, (void *)rxq);
 913                         priv->dev->data->rx_queues[i] = NULL;
 914                         break;
 915                 }
 916         assert(!rxq->cq);
 917         assert(!rxq->wq);
 918         assert(!rxq->wqes);
 919         assert(!rxq->rq_db);
 920         if (rxq->channel)
 921                 claim_zero(mlx4_glue->destroy_comp_channel(rxq->channel));
 922         if (rxq->mr)
 923                 mlx4_mr_put(rxq->mr);
 924         rte_free(rxq);
 925 }