lib/librte_eventdev/rte_eventdev.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2016 Cavium, Inc
   3  */
   4
   5 #include <ctype.h>
   6 #include <stdio.h>
   7 #include <stdlib.h>
   8 #include <string.h>
   9 #include <stdarg.h>
  10 #include <errno.h>
  11 #include <stdint.h>
  12 #include <inttypes.h>
  13 #include <sys/types.h>
  14 #include <sys/queue.h>
  15
  16 #include <rte_string_fns.h>
  17 #include <rte_byteorder.h>
  18 #include <rte_log.h>
  19 #include <rte_debug.h>
  20 #include <rte_dev.h>
  21 #include <rte_memory.h>
  22 #include <rte_memcpy.h>
  23 #include <rte_memzone.h>
  24 #include <rte_eal.h>
  25 #include <rte_per_lcore.h>
  26 #include <rte_lcore.h>
  27 #include <rte_atomic.h>
  28 #include <rte_branch_prediction.h>
  29 #include <rte_common.h>
  30 #include <rte_malloc.h>
  31 #include <rte_errno.h>
  32 #include <rte_ethdev.h>
  33 #include <rte_cryptodev.h>
  34 #include <rte_cryptodev_pmd.h>
  35 #include <rte_telemetry.h>
  36
  37 #include "rte_eventdev.h"
  38 #include "rte_eventdev_pmd.h"
  39 #include "rte_eventdev_trace.h"
  40
  41 static struct rte_eventdev rte_event_devices[RTE_EVENT_MAX_DEVS];
  42
  43 struct rte_eventdev *rte_eventdevs = rte_event_devices;
  44
  45 static struct rte_eventdev_global eventdev_globals = {
  46         .nb_devs                = 0
  47 };
  48
  49 /* Event dev north bound API implementation */
  50
  51 uint8_t
  52 rte_event_dev_count(void)
  53 {
  54         return eventdev_globals.nb_devs;
  55 }
  56
  57 int
  58 rte_event_dev_get_dev_id(const char *name)
  59 {
  60         int i;
  61         uint8_t cmp;
  62
  63         if (!name)
  64                 return -EINVAL;
  65
  66         for (i = 0; i < eventdev_globals.nb_devs; i++) {
  67                 cmp = (strncmp(rte_event_devices[i].data->name, name,
  68                                 RTE_EVENTDEV_NAME_MAX_LEN) == 0) ||
  69                         (rte_event_devices[i].dev ? (strncmp(
  70                                 rte_event_devices[i].dev->driver->name, name,
  71                                          RTE_EVENTDEV_NAME_MAX_LEN) == 0) : 0);
  72                 if (cmp && (rte_event_devices[i].attached ==
  73                                         RTE_EVENTDEV_ATTACHED))
  74                         return i;
  75         }
  76         return -ENODEV;
  77 }
  78
  79 int
  80 rte_event_dev_socket_id(uint8_t dev_id)
  81 {
  82         struct rte_eventdev *dev;
  83
  84         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
  85         dev = &rte_eventdevs[dev_id];
  86
  87         return dev->data->socket_id;
  88 }
  89
  90 int
  91 rte_event_dev_info_get(uint8_t dev_id, struct rte_event_dev_info *dev_info)
  92 {
  93         struct rte_eventdev *dev;
  94
  95         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
  96         dev = &rte_eventdevs[dev_id];
  97
  98         if (dev_info == NULL)
  99                 return -EINVAL;
 100
 101         memset(dev_info, 0, sizeof(struct rte_event_dev_info));
 102
 103         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
 104         (*dev->dev_ops->dev_infos_get)(dev, dev_info);
 105
 106         dev_info->dequeue_timeout_ns = dev->data->dev_conf.dequeue_timeout_ns;
 107
 108         dev_info->dev = dev->dev;
 109         return 0;
 110 }
 111
 112 int
 113 rte_event_eth_rx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id,
 114                                 uint32_t *caps)
 115 {
 116         struct rte_eventdev *dev;
 117
 118         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 119         RTE_ETH_VALID_PORTID_OR_ERR_RET(eth_port_id, -EINVAL);
 120
 121         dev = &rte_eventdevs[dev_id];
 122
 123         if (caps == NULL)
 124                 return -EINVAL;
 125         *caps = 0;
 126
 127         return dev->dev_ops->eth_rx_adapter_caps_get ?
 128                                 (*dev->dev_ops->eth_rx_adapter_caps_get)(dev,
 129                                                 &rte_eth_devices[eth_port_id],
 130                                                 caps)
 131                                 : 0;
 132 }
 133
 134 int
 135 rte_event_timer_adapter_caps_get(uint8_t dev_id, uint32_t *caps)
 136 {
 137         struct rte_eventdev *dev;
 138         const struct rte_event_timer_adapter_ops *ops;
 139
 140         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 141
 142         dev = &rte_eventdevs[dev_id];
 143
 144         if (caps == NULL)
 145                 return -EINVAL;
 146         *caps = 0;
 147
 148         return dev->dev_ops->timer_adapter_caps_get ?
 149                                 (*dev->dev_ops->timer_adapter_caps_get)(dev,
 150                                                                         0,
 151                                                                         caps,
 152                                                                         &ops)
 153                                 : 0;
 154 }
 155
 156 int
 157 rte_event_crypto_adapter_caps_get(uint8_t dev_id, uint8_t cdev_id,
 158                                   uint32_t *caps)
 159 {
 160         struct rte_eventdev *dev;
 161         struct rte_cryptodev *cdev;
 162
 163         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 164         if (!rte_cryptodev_pmd_is_valid_dev(cdev_id))
 165                 return -EINVAL;
 166
 167         dev = &rte_eventdevs[dev_id];
 168         cdev = rte_cryptodev_pmd_get_dev(cdev_id);
 169
 170         if (caps == NULL)
 171                 return -EINVAL;
 172         *caps = 0;
 173
 174         return dev->dev_ops->crypto_adapter_caps_get ?
 175                 (*dev->dev_ops->crypto_adapter_caps_get)
 176                 (dev, cdev, caps) : -ENOTSUP;
 177 }
 178
 179 int
 180 rte_event_eth_tx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id,
 181                                 uint32_t *caps)
 182 {
 183         struct rte_eventdev *dev;
 184         struct rte_eth_dev *eth_dev;
 185
 186         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 187         RTE_ETH_VALID_PORTID_OR_ERR_RET(eth_port_id, -EINVAL);
 188
 189         dev = &rte_eventdevs[dev_id];
 190         eth_dev = &rte_eth_devices[eth_port_id];
 191
 192         if (caps == NULL)
 193                 return -EINVAL;
 194
 195         *caps = 0;
 196
 197         return dev->dev_ops->eth_tx_adapter_caps_get ?
 198                         (*dev->dev_ops->eth_tx_adapter_caps_get)(dev,
 199                                                                 eth_dev,
 200                                                                 caps)
 201                         : 0;
 202 }
 203
 204 static inline int
 205 rte_event_dev_queue_config(struct rte_eventdev *dev, uint8_t nb_queues)
 206 {
 207         uint8_t old_nb_queues = dev->data->nb_queues;
 208         struct rte_event_queue_conf *queues_cfg;
 209         unsigned int i;
 210
 211         RTE_EDEV_LOG_DEBUG("Setup %d queues on device %u", nb_queues,
 212                          dev->data->dev_id);
 213
 214         /* First time configuration */
 215         if (dev->data->queues_cfg == NULL && nb_queues != 0) {
 216                 /* Allocate memory to store queue configuration */
 217                 dev->data->queues_cfg = rte_zmalloc_socket(
 218                                 "eventdev->data->queues_cfg",
 219                                 sizeof(dev->data->queues_cfg[0]) * nb_queues,
 220                                 RTE_CACHE_LINE_SIZE, dev->data->socket_id);
 221                 if (dev->data->queues_cfg == NULL) {
 222                         dev->data->nb_queues = 0;
 223                         RTE_EDEV_LOG_ERR("failed to get mem for queue cfg,"
 224                                         "nb_queues %u", nb_queues);
 225                         return -(ENOMEM);
 226                 }
 227         /* Re-configure */
 228         } else if (dev->data->queues_cfg != NULL && nb_queues != 0) {
 229                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_release, -ENOTSUP);
 230
 231                 for (i = nb_queues; i < old_nb_queues; i++)
 232                         (*dev->dev_ops->queue_release)(dev, i);
 233
 234                 /* Re allocate memory to store queue configuration */
 235                 queues_cfg = dev->data->queues_cfg;
 236                 queues_cfg = rte_realloc(queues_cfg,
 237                                 sizeof(queues_cfg[0]) * nb_queues,
 238                                 RTE_CACHE_LINE_SIZE);
 239                 if (queues_cfg == NULL) {
 240                         RTE_EDEV_LOG_ERR("failed to realloc queue cfg memory,"
 241                                                 " nb_queues %u", nb_queues);
 242                         return -(ENOMEM);
 243                 }
 244                 dev->data->queues_cfg = queues_cfg;
 245
 246                 if (nb_queues > old_nb_queues) {
 247                         uint8_t new_qs = nb_queues - old_nb_queues;
 248
 249                         memset(queues_cfg + old_nb_queues, 0,
 250                                 sizeof(queues_cfg[0]) * new_qs);
 251                 }
 252         } else if (dev->data->queues_cfg != NULL && nb_queues == 0) {
 253                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_release, -ENOTSUP);
 254
 255                 for (i = nb_queues; i < old_nb_queues; i++)
 256                         (*dev->dev_ops->queue_release)(dev, i);
 257         }
 258
 259         dev->data->nb_queues = nb_queues;
 260         return 0;
 261 }
 262
 263 #define EVENT_QUEUE_SERVICE_PRIORITY_INVALID (0xdead)
 264
 265 static inline int
 266 rte_event_dev_port_config(struct rte_eventdev *dev, uint8_t nb_ports)
 267 {
 268         uint8_t old_nb_ports = dev->data->nb_ports;
 269         void **ports;
 270         uint16_t *links_map;
 271         struct rte_event_port_conf *ports_cfg;
 272         unsigned int i;
 273
 274         RTE_EDEV_LOG_DEBUG("Setup %d ports on device %u", nb_ports,
 275                          dev->data->dev_id);
 276
 277         /* First time configuration */
 278         if (dev->data->ports == NULL && nb_ports != 0) {
 279                 dev->data->ports = rte_zmalloc_socket("eventdev->data->ports",
 280                                 sizeof(dev->data->ports[0]) * nb_ports,
 281                                 RTE_CACHE_LINE_SIZE, dev->data->socket_id);
 282                 if (dev->data->ports == NULL) {
 283                         dev->data->nb_ports = 0;
 284                         RTE_EDEV_LOG_ERR("failed to get mem for port meta data,"
 285                                         "nb_ports %u", nb_ports);
 286                         return -(ENOMEM);
 287                 }
 288
 289                 /* Allocate memory to store port configurations */
 290                 dev->data->ports_cfg =
 291                         rte_zmalloc_socket("eventdev->ports_cfg",
 292                         sizeof(dev->data->ports_cfg[0]) * nb_ports,
 293                         RTE_CACHE_LINE_SIZE, dev->data->socket_id);
 294                 if (dev->data->ports_cfg == NULL) {
 295                         dev->data->nb_ports = 0;
 296                         RTE_EDEV_LOG_ERR("failed to get mem for port cfg,"
 297                                         "nb_ports %u", nb_ports);
 298                         return -(ENOMEM);
 299                 }
 300
 301                 /* Allocate memory to store queue to port link connection */
 302                 dev->data->links_map =
 303                         rte_zmalloc_socket("eventdev->links_map",
 304                         sizeof(dev->data->links_map[0]) * nb_ports *
 305                         RTE_EVENT_MAX_QUEUES_PER_DEV,
 306                         RTE_CACHE_LINE_SIZE, dev->data->socket_id);
 307                 if (dev->data->links_map == NULL) {
 308                         dev->data->nb_ports = 0;
 309                         RTE_EDEV_LOG_ERR("failed to get mem for port_map area,"
 310                                         "nb_ports %u", nb_ports);
 311                         return -(ENOMEM);
 312                 }
 313                 for (i = 0; i < nb_ports * RTE_EVENT_MAX_QUEUES_PER_DEV; i++)
 314                         dev->data->links_map[i] =
 315                                 EVENT_QUEUE_SERVICE_PRIORITY_INVALID;
 316         } else if (dev->data->ports != NULL && nb_ports != 0) {/* re-config */
 317                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_release, -ENOTSUP);
 318
 319                 ports = dev->data->ports;
 320                 ports_cfg = dev->data->ports_cfg;
 321                 links_map = dev->data->links_map;
 322
 323                 for (i = nb_ports; i < old_nb_ports; i++)
 324                         (*dev->dev_ops->port_release)(ports[i]);
 325
 326                 /* Realloc memory for ports */
 327                 ports = rte_realloc(ports, sizeof(ports[0]) * nb_ports,
 328                                 RTE_CACHE_LINE_SIZE);
 329                 if (ports == NULL) {
 330                         RTE_EDEV_LOG_ERR("failed to realloc port meta data,"
 331                                                 " nb_ports %u", nb_ports);
 332                         return -(ENOMEM);
 333                 }
 334
 335                 /* Realloc memory for ports_cfg */
 336                 ports_cfg = rte_realloc(ports_cfg,
 337                         sizeof(ports_cfg[0]) * nb_ports,
 338                         RTE_CACHE_LINE_SIZE);
 339                 if (ports_cfg == NULL) {
 340                         RTE_EDEV_LOG_ERR("failed to realloc port cfg mem,"
 341                                                 " nb_ports %u", nb_ports);
 342                         return -(ENOMEM);
 343                 }
 344
 345                 /* Realloc memory to store queue to port link connection */
 346                 links_map = rte_realloc(links_map,
 347                         sizeof(dev->data->links_map[0]) * nb_ports *
 348                         RTE_EVENT_MAX_QUEUES_PER_DEV,
 349                         RTE_CACHE_LINE_SIZE);
 350                 if (links_map == NULL) {
 351                         dev->data->nb_ports = 0;
 352                         RTE_EDEV_LOG_ERR("failed to realloc mem for port_map,"
 353                                         "nb_ports %u", nb_ports);
 354                         return -(ENOMEM);
 355                 }
 356
 357                 if (nb_ports > old_nb_ports) {
 358                         uint8_t new_ps = nb_ports - old_nb_ports;
 359                         unsigned int old_links_map_end =
 360                                 old_nb_ports * RTE_EVENT_MAX_QUEUES_PER_DEV;
 361                         unsigned int links_map_end =
 362                                 nb_ports * RTE_EVENT_MAX_QUEUES_PER_DEV;
 363
 364                         memset(ports + old_nb_ports, 0,
 365                                 sizeof(ports[0]) * new_ps);
 366                         memset(ports_cfg + old_nb_ports, 0,
 367                                 sizeof(ports_cfg[0]) * new_ps);
 368                         for (i = old_links_map_end; i < links_map_end; i++)
 369                                 links_map[i] =
 370                                         EVENT_QUEUE_SERVICE_PRIORITY_INVALID;
 371                 }
 372
 373                 dev->data->ports = ports;
 374                 dev->data->ports_cfg = ports_cfg;
 375                 dev->data->links_map = links_map;
 376         } else if (dev->data->ports != NULL && nb_ports == 0) {
 377                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_release, -ENOTSUP);
 378
 379                 ports = dev->data->ports;
 380                 for (i = nb_ports; i < old_nb_ports; i++)
 381                         (*dev->dev_ops->port_release)(ports[i]);
 382         }
 383
 384         dev->data->nb_ports = nb_ports;
 385         return 0;
 386 }
 387
 388 int
 389 rte_event_dev_configure(uint8_t dev_id,
 390                         const struct rte_event_dev_config *dev_conf)
 391 {
 392         struct rte_eventdev *dev;
 393         struct rte_event_dev_info info;
 394         int diag;
 395
 396         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 397         dev = &rte_eventdevs[dev_id];
 398
 399         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
 400         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
 401
 402         if (dev->data->dev_started) {
 403                 RTE_EDEV_LOG_ERR(
 404                     "device %d must be stopped to allow configuration", dev_id);
 405                 return -EBUSY;
 406         }
 407
 408         if (dev_conf == NULL)
 409                 return -EINVAL;
 410
 411         (*dev->dev_ops->dev_infos_get)(dev, &info);
 412
 413         /* Check dequeue_timeout_ns value is in limit */
 414         if (!(dev_conf->event_dev_cfg & RTE_EVENT_DEV_CFG_PER_DEQUEUE_TIMEOUT)) {
 415                 if (dev_conf->dequeue_timeout_ns &&
 416                     (dev_conf->dequeue_timeout_ns < info.min_dequeue_timeout_ns
 417                         || dev_conf->dequeue_timeout_ns >
 418                                  info.max_dequeue_timeout_ns)) {
 419                         RTE_EDEV_LOG_ERR("dev%d invalid dequeue_timeout_ns=%d"
 420                         " min_dequeue_timeout_ns=%d max_dequeue_timeout_ns=%d",
 421                         dev_id, dev_conf->dequeue_timeout_ns,
 422                         info.min_dequeue_timeout_ns,
 423                         info.max_dequeue_timeout_ns);
 424                         return -EINVAL;
 425                 }
 426         }
 427
 428         /* Check nb_events_limit is in limit */
 429         if (dev_conf->nb_events_limit > info.max_num_events) {
 430                 RTE_EDEV_LOG_ERR("dev%d nb_events_limit=%d > max_num_events=%d",
 431                 dev_id, dev_conf->nb_events_limit, info.max_num_events);
 432                 return -EINVAL;
 433         }
 434
 435         /* Check nb_event_queues is in limit */
 436         if (!dev_conf->nb_event_queues) {
 437                 RTE_EDEV_LOG_ERR("dev%d nb_event_queues cannot be zero",
 438                                         dev_id);
 439                 return -EINVAL;
 440         }
 441         if (dev_conf->nb_event_queues > info.max_event_queues) {
 442                 RTE_EDEV_LOG_ERR("%d nb_event_queues=%d > max_event_queues=%d",
 443                 dev_id, dev_conf->nb_event_queues, info.max_event_queues);
 444                 return -EINVAL;
 445         }
 446
 447         /* Check nb_event_ports is in limit */
 448         if (!dev_conf->nb_event_ports) {
 449                 RTE_EDEV_LOG_ERR("dev%d nb_event_ports cannot be zero", dev_id);
 450                 return -EINVAL;
 451         }
 452         if (dev_conf->nb_event_ports > info.max_event_ports) {
 453                 RTE_EDEV_LOG_ERR("id%d nb_event_ports=%d > max_event_ports= %d",
 454                 dev_id, dev_conf->nb_event_ports, info.max_event_ports);
 455                 return -EINVAL;
 456         }
 457
 458         /* Check nb_event_queue_flows is in limit */
 459         if (!dev_conf->nb_event_queue_flows) {
 460                 RTE_EDEV_LOG_ERR("dev%d nb_flows cannot be zero", dev_id);
 461                 return -EINVAL;
 462         }
 463         if (dev_conf->nb_event_queue_flows > info.max_event_queue_flows) {
 464                 RTE_EDEV_LOG_ERR("dev%d nb_flows=%x > max_flows=%x",
 465                 dev_id, dev_conf->nb_event_queue_flows,
 466                 info.max_event_queue_flows);
 467                 return -EINVAL;
 468         }
 469
 470         /* Check nb_event_port_dequeue_depth is in limit */
 471         if (!dev_conf->nb_event_port_dequeue_depth) {
 472                 RTE_EDEV_LOG_ERR("dev%d nb_dequeue_depth cannot be zero",
 473                                         dev_id);
 474                 return -EINVAL;
 475         }
 476         if ((info.event_dev_cap & RTE_EVENT_DEV_CAP_BURST_MODE) &&
 477                  (dev_conf->nb_event_port_dequeue_depth >
 478                          info.max_event_port_dequeue_depth)) {
 479                 RTE_EDEV_LOG_ERR("dev%d nb_dq_depth=%d > max_dq_depth=%d",
 480                 dev_id, dev_conf->nb_event_port_dequeue_depth,
 481                 info.max_event_port_dequeue_depth);
 482                 return -EINVAL;
 483         }
 484
 485         /* Check nb_event_port_enqueue_depth is in limit */
 486         if (!dev_conf->nb_event_port_enqueue_depth) {
 487                 RTE_EDEV_LOG_ERR("dev%d nb_enqueue_depth cannot be zero",
 488                                         dev_id);
 489                 return -EINVAL;
 490         }
 491         if ((info.event_dev_cap & RTE_EVENT_DEV_CAP_BURST_MODE) &&
 492                 (dev_conf->nb_event_port_enqueue_depth >
 493                          info.max_event_port_enqueue_depth)) {
 494                 RTE_EDEV_LOG_ERR("dev%d nb_enq_depth=%d > max_enq_depth=%d",
 495                 dev_id, dev_conf->nb_event_port_enqueue_depth,
 496                 info.max_event_port_enqueue_depth);
 497                 return -EINVAL;
 498         }
 499
 500         /* Copy the dev_conf parameter into the dev structure */
 501         memcpy(&dev->data->dev_conf, dev_conf, sizeof(dev->data->dev_conf));
 502
 503         /* Setup new number of queues and reconfigure device. */
 504         diag = rte_event_dev_queue_config(dev, dev_conf->nb_event_queues);
 505         if (diag != 0) {
 506                 RTE_EDEV_LOG_ERR("dev%d rte_event_dev_queue_config = %d",
 507                                 dev_id, diag);
 508                 return diag;
 509         }
 510
 511         /* Setup new number of ports and reconfigure device. */
 512         diag = rte_event_dev_port_config(dev, dev_conf->nb_event_ports);
 513         if (diag != 0) {
 514                 rte_event_dev_queue_config(dev, 0);
 515                 RTE_EDEV_LOG_ERR("dev%d rte_event_dev_port_config = %d",
 516                                 dev_id, diag);
 517                 return diag;
 518         }
 519
 520         /* Configure the device */
 521         diag = (*dev->dev_ops->dev_configure)(dev);
 522         if (diag != 0) {
 523                 RTE_EDEV_LOG_ERR("dev%d dev_configure = %d", dev_id, diag);
 524                 rte_event_dev_queue_config(dev, 0);
 525                 rte_event_dev_port_config(dev, 0);
 526         }
 527
 528         dev->data->event_dev_cap = info.event_dev_cap;
 529         rte_eventdev_trace_configure(dev_id, dev_conf, diag);
 530         return diag;
 531 }
 532
 533 static inline int
 534 is_valid_queue(struct rte_eventdev *dev, uint8_t queue_id)
 535 {
 536         if (queue_id < dev->data->nb_queues && queue_id <
 537                                 RTE_EVENT_MAX_QUEUES_PER_DEV)
 538                 return 1;
 539         else
 540                 return 0;
 541 }
 542
 543 int
 544 rte_event_queue_default_conf_get(uint8_t dev_id, uint8_t queue_id,
 545                                  struct rte_event_queue_conf *queue_conf)
 546 {
 547         struct rte_eventdev *dev;
 548
 549         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 550         dev = &rte_eventdevs[dev_id];
 551
 552         if (queue_conf == NULL)
 553                 return -EINVAL;
 554
 555         if (!is_valid_queue(dev, queue_id)) {
 556                 RTE_EDEV_LOG_ERR("Invalid queue_id=%" PRIu8, queue_id);
 557                 return -EINVAL;
 558         }
 559
 560         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_def_conf, -ENOTSUP);
 561         memset(queue_conf, 0, sizeof(struct rte_event_queue_conf));
 562         (*dev->dev_ops->queue_def_conf)(dev, queue_id, queue_conf);
 563         return 0;
 564 }
 565
 566 static inline int
 567 is_valid_atomic_queue_conf(const struct rte_event_queue_conf *queue_conf)
 568 {
 569         if (queue_conf &&
 570                 !(queue_conf->event_queue_cfg &
 571                   RTE_EVENT_QUEUE_CFG_SINGLE_LINK) &&
 572                 ((queue_conf->event_queue_cfg &
 573                          RTE_EVENT_QUEUE_CFG_ALL_TYPES) ||
 574                 (queue_conf->schedule_type
 575                         == RTE_SCHED_TYPE_ATOMIC)
 576                 ))
 577                 return 1;
 578         else
 579                 return 0;
 580 }
 581
 582 static inline int
 583 is_valid_ordered_queue_conf(const struct rte_event_queue_conf *queue_conf)
 584 {
 585         if (queue_conf &&
 586                 !(queue_conf->event_queue_cfg &
 587                   RTE_EVENT_QUEUE_CFG_SINGLE_LINK) &&
 588                 ((queue_conf->event_queue_cfg &
 589                          RTE_EVENT_QUEUE_CFG_ALL_TYPES) ||
 590                 (queue_conf->schedule_type
 591                         == RTE_SCHED_TYPE_ORDERED)
 592                 ))
 593                 return 1;
 594         else
 595                 return 0;
 596 }
 597
 598
 599 int
 600 rte_event_queue_setup(uint8_t dev_id, uint8_t queue_id,
 601                       const struct rte_event_queue_conf *queue_conf)
 602 {
 603         struct rte_eventdev *dev;
 604         struct rte_event_queue_conf def_conf;
 605
 606         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 607         dev = &rte_eventdevs[dev_id];
 608
 609         if (!is_valid_queue(dev, queue_id)) {
 610                 RTE_EDEV_LOG_ERR("Invalid queue_id=%" PRIu8, queue_id);
 611                 return -EINVAL;
 612         }
 613
 614         /* Check nb_atomic_flows limit */
 615         if (is_valid_atomic_queue_conf(queue_conf)) {
 616                 if (queue_conf->nb_atomic_flows == 0 ||
 617                     queue_conf->nb_atomic_flows >
 618                         dev->data->dev_conf.nb_event_queue_flows) {
 619                         RTE_EDEV_LOG_ERR(
 620                 "dev%d queue%d Invalid nb_atomic_flows=%d max_flows=%d",
 621                         dev_id, queue_id, queue_conf->nb_atomic_flows,
 622                         dev->data->dev_conf.nb_event_queue_flows);
 623                         return -EINVAL;
 624                 }
 625         }
 626
 627         /* Check nb_atomic_order_sequences limit */
 628         if (is_valid_ordered_queue_conf(queue_conf)) {
 629                 if (queue_conf->nb_atomic_order_sequences == 0 ||
 630                     queue_conf->nb_atomic_order_sequences >
 631                         dev->data->dev_conf.nb_event_queue_flows) {
 632                         RTE_EDEV_LOG_ERR(
 633                 "dev%d queue%d Invalid nb_atomic_order_seq=%d max_flows=%d",
 634                         dev_id, queue_id, queue_conf->nb_atomic_order_sequences,
 635                         dev->data->dev_conf.nb_event_queue_flows);
 636                         return -EINVAL;
 637                 }
 638         }
 639
 640         if (dev->data->dev_started) {
 641                 RTE_EDEV_LOG_ERR(
 642                     "device %d must be stopped to allow queue setup", dev_id);
 643                 return -EBUSY;
 644         }
 645
 646         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_setup, -ENOTSUP);
 647
 648         if (queue_conf == NULL) {
 649                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_def_conf,
 650                                         -ENOTSUP);
 651                 (*dev->dev_ops->queue_def_conf)(dev, queue_id, &def_conf);
 652                 queue_conf = &def_conf;
 653         }
 654
 655         dev->data->queues_cfg[queue_id] = *queue_conf;
 656         rte_eventdev_trace_queue_setup(dev_id, queue_id, queue_conf);
 657         return (*dev->dev_ops->queue_setup)(dev, queue_id, queue_conf);
 658 }
 659
 660 static inline int
 661 is_valid_port(struct rte_eventdev *dev, uint8_t port_id)
 662 {
 663         if (port_id < dev->data->nb_ports)
 664                 return 1;
 665         else
 666                 return 0;
 667 }
 668
 669 int
 670 rte_event_port_default_conf_get(uint8_t dev_id, uint8_t port_id,
 671                                  struct rte_event_port_conf *port_conf)
 672 {
 673         struct rte_eventdev *dev;
 674
 675         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 676         dev = &rte_eventdevs[dev_id];
 677
 678         if (port_conf == NULL)
 679                 return -EINVAL;
 680
 681         if (!is_valid_port(dev, port_id)) {
 682                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
 683                 return -EINVAL;
 684         }
 685
 686         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_def_conf, -ENOTSUP);
 687         memset(port_conf, 0, sizeof(struct rte_event_port_conf));
 688         (*dev->dev_ops->port_def_conf)(dev, port_id, port_conf);
 689         return 0;
 690 }
 691
 692 int
 693 rte_event_port_setup(uint8_t dev_id, uint8_t port_id,
 694                      const struct rte_event_port_conf *port_conf)
 695 {
 696         struct rte_eventdev *dev;
 697         struct rte_event_port_conf def_conf;
 698         int diag;
 699
 700         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 701         dev = &rte_eventdevs[dev_id];
 702
 703         if (!is_valid_port(dev, port_id)) {
 704                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
 705                 return -EINVAL;
 706         }
 707
 708         /* Check new_event_threshold limit */
 709         if ((port_conf && !port_conf->new_event_threshold) ||
 710                         (port_conf && port_conf->new_event_threshold >
 711                                  dev->data->dev_conf.nb_events_limit)) {
 712                 RTE_EDEV_LOG_ERR(
 713                    "dev%d port%d Invalid event_threshold=%d nb_events_limit=%d",
 714                         dev_id, port_id, port_conf->new_event_threshold,
 715                         dev->data->dev_conf.nb_events_limit);
 716                 return -EINVAL;
 717         }
 718
 719         /* Check dequeue_depth limit */
 720         if ((port_conf && !port_conf->dequeue_depth) ||
 721                         (port_conf && port_conf->dequeue_depth >
 722                 dev->data->dev_conf.nb_event_port_dequeue_depth)) {
 723                 RTE_EDEV_LOG_ERR(
 724                    "dev%d port%d Invalid dequeue depth=%d max_dequeue_depth=%d",
 725                         dev_id, port_id, port_conf->dequeue_depth,
 726                         dev->data->dev_conf.nb_event_port_dequeue_depth);
 727                 return -EINVAL;
 728         }
 729
 730         /* Check enqueue_depth limit */
 731         if ((port_conf && !port_conf->enqueue_depth) ||
 732                         (port_conf && port_conf->enqueue_depth >
 733                 dev->data->dev_conf.nb_event_port_enqueue_depth)) {
 734                 RTE_EDEV_LOG_ERR(
 735                    "dev%d port%d Invalid enqueue depth=%d max_enqueue_depth=%d",
 736                         dev_id, port_id, port_conf->enqueue_depth,
 737                         dev->data->dev_conf.nb_event_port_enqueue_depth);
 738                 return -EINVAL;
 739         }
 740
 741         if (port_conf && port_conf->disable_implicit_release &&
 742             !(dev->data->event_dev_cap &
 743               RTE_EVENT_DEV_CAP_IMPLICIT_RELEASE_DISABLE)) {
 744                 RTE_EDEV_LOG_ERR(
 745                    "dev%d port%d Implicit release disable not supported",
 746                         dev_id, port_id);
 747                 return -EINVAL;
 748         }
 749
 750         if (dev->data->dev_started) {
 751                 RTE_EDEV_LOG_ERR(
 752                     "device %d must be stopped to allow port setup", dev_id);
 753                 return -EBUSY;
 754         }
 755
 756         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_setup, -ENOTSUP);
 757
 758         if (port_conf == NULL) {
 759                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_def_conf,
 760                                         -ENOTSUP);
 761                 (*dev->dev_ops->port_def_conf)(dev, port_id, &def_conf);
 762                 port_conf = &def_conf;
 763         }
 764
 765         dev->data->ports_cfg[port_id] = *port_conf;
 766
 767         diag = (*dev->dev_ops->port_setup)(dev, port_id, port_conf);
 768
 769         /* Unlink all the queues from this port(default state after setup) */
 770         if (!diag)
 771                 diag = rte_event_port_unlink(dev_id, port_id, NULL, 0);
 772
 773         rte_eventdev_trace_port_setup(dev_id, port_id, port_conf, diag);
 774         if (diag < 0)
 775                 return diag;
 776
 777         return 0;
 778 }
 779
 780 int
 781 rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id,
 782                        uint32_t *attr_value)
 783 {
 784         struct rte_eventdev *dev;
 785
 786         if (!attr_value)
 787                 return -EINVAL;
 788         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 789         dev = &rte_eventdevs[dev_id];
 790
 791         switch (attr_id) {
 792         case RTE_EVENT_DEV_ATTR_PORT_COUNT:
 793                 *attr_value = dev->data->nb_ports;
 794                 break;
 795         case RTE_EVENT_DEV_ATTR_QUEUE_COUNT:
 796                 *attr_value = dev->data->nb_queues;
 797                 break;
 798         case RTE_EVENT_DEV_ATTR_STARTED:
 799                 *attr_value = dev->data->dev_started;
 800                 break;
 801         default:
 802                 return -EINVAL;
 803         }
 804
 805         return 0;
 806 }
 807
 808 int
 809 rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,
 810                         uint32_t *attr_value)
 811 {
 812         struct rte_eventdev *dev;
 813
 814         if (!attr_value)
 815                 return -EINVAL;
 816
 817         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 818         dev = &rte_eventdevs[dev_id];
 819         if (!is_valid_port(dev, port_id)) {
 820                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
 821                 return -EINVAL;
 822         }
 823
 824         switch (attr_id) {
 825         case RTE_EVENT_PORT_ATTR_ENQ_DEPTH:
 826                 *attr_value = dev->data->ports_cfg[port_id].enqueue_depth;
 827                 break;
 828         case RTE_EVENT_PORT_ATTR_DEQ_DEPTH:
 829                 *attr_value = dev->data->ports_cfg[port_id].dequeue_depth;
 830                 break;
 831         case RTE_EVENT_PORT_ATTR_NEW_EVENT_THRESHOLD:
 832                 *attr_value = dev->data->ports_cfg[port_id].new_event_threshold;
 833                 break;
 834         default:
 835                 return -EINVAL;
 836         };
 837         return 0;
 838 }
 839
 840 int
 841 rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,
 842                         uint32_t *attr_value)
 843 {
 844         struct rte_event_queue_conf *conf;
 845         struct rte_eventdev *dev;
 846
 847         if (!attr_value)
 848                 return -EINVAL;
 849
 850         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
 851         dev = &rte_eventdevs[dev_id];
 852         if (!is_valid_queue(dev, queue_id)) {
 853                 RTE_EDEV_LOG_ERR("Invalid queue_id=%" PRIu8, queue_id);
 854                 return -EINVAL;
 855         }
 856
 857         conf = &dev->data->queues_cfg[queue_id];
 858
 859         switch (attr_id) {
 860         case RTE_EVENT_QUEUE_ATTR_PRIORITY:
 861                 *attr_value = RTE_EVENT_DEV_PRIORITY_NORMAL;
 862                 if (dev->data->event_dev_cap & RTE_EVENT_DEV_CAP_QUEUE_QOS)
 863                         *attr_value = conf->priority;
 864                 break;
 865         case RTE_EVENT_QUEUE_ATTR_NB_ATOMIC_FLOWS:
 866                 *attr_value = conf->nb_atomic_flows;
 867                 break;
 868         case RTE_EVENT_QUEUE_ATTR_NB_ATOMIC_ORDER_SEQUENCES:
 869                 *attr_value = conf->nb_atomic_order_sequences;
 870                 break;
 871         case RTE_EVENT_QUEUE_ATTR_EVENT_QUEUE_CFG:
 872                 *attr_value = conf->event_queue_cfg;
 873                 break;
 874         case RTE_EVENT_QUEUE_ATTR_SCHEDULE_TYPE:
 875                 if (conf->event_queue_cfg & RTE_EVENT_QUEUE_CFG_ALL_TYPES)
 876                         return -EOVERFLOW;
 877
 878                 *attr_value = conf->schedule_type;
 879                 break;
 880         default:
 881                 return -EINVAL;
 882         };
 883         return 0;
 884 }
 885
 886 int
 887 rte_event_port_link(uint8_t dev_id, uint8_t port_id,
 888                     const uint8_t queues[], const uint8_t priorities[],
 889                     uint16_t nb_links)
 890 {
 891         struct rte_eventdev *dev;
 892         uint8_t queues_list[RTE_EVENT_MAX_QUEUES_PER_DEV];
 893         uint8_t priorities_list[RTE_EVENT_MAX_QUEUES_PER_DEV];
 894         uint16_t *links_map;
 895         int i, diag;
 896
 897         RTE_EVENTDEV_VALID_DEVID_OR_ERRNO_RET(dev_id, EINVAL, 0);
 898         dev = &rte_eventdevs[dev_id];
 899
 900         if (*dev->dev_ops->port_link == NULL) {
 901                 RTE_EDEV_LOG_ERR("Function not supported\n");
 902                 rte_errno = ENOTSUP;
 903                 return 0;
 904         }
 905
 906         if (!is_valid_port(dev, port_id)) {
 907                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
 908                 rte_errno = EINVAL;
 909                 return 0;
 910         }
 911
 912         if (queues == NULL) {
 913                 for (i = 0; i < dev->data->nb_queues; i++)
 914                         queues_list[i] = i;
 915
 916                 queues = queues_list;
 917                 nb_links = dev->data->nb_queues;
 918         }
 919
 920         if (priorities == NULL) {
 921                 for (i = 0; i < nb_links; i++)
 922                         priorities_list[i] = RTE_EVENT_DEV_PRIORITY_NORMAL;
 923
 924                 priorities = priorities_list;
 925         }
 926
 927         for (i = 0; i < nb_links; i++)
 928                 if (queues[i] >= dev->data->nb_queues) {
 929                         rte_errno = EINVAL;
 930                         return 0;
 931                 }
 932
 933         diag = (*dev->dev_ops->port_link)(dev, dev->data->ports[port_id],
 934                                                 queues, priorities, nb_links);
 935         if (diag < 0)
 936                 return diag;
 937
 938         links_map = dev->data->links_map;
 939         /* Point links_map to this port specific area */
 940         links_map += (port_id * RTE_EVENT_MAX_QUEUES_PER_DEV);
 941         for (i = 0; i < diag; i++)
 942                 links_map[queues[i]] = (uint8_t)priorities[i];
 943
 944         rte_eventdev_trace_port_link(dev_id, port_id, nb_links, diag);
 945         return diag;
 946 }
 947
 948 int
 949 rte_event_port_unlink(uint8_t dev_id, uint8_t port_id,
 950                       uint8_t queues[], uint16_t nb_unlinks)
 951 {
 952         struct rte_eventdev *dev;
 953         uint8_t all_queues[RTE_EVENT_MAX_QUEUES_PER_DEV];
 954         int i, diag, j;
 955         uint16_t *links_map;
 956
 957         RTE_EVENTDEV_VALID_DEVID_OR_ERRNO_RET(dev_id, EINVAL, 0);
 958         dev = &rte_eventdevs[dev_id];
 959
 960         if (*dev->dev_ops->port_unlink == NULL) {
 961                 RTE_EDEV_LOG_ERR("Function not supported");
 962                 rte_errno = ENOTSUP;
 963                 return 0;
 964         }
 965
 966         if (!is_valid_port(dev, port_id)) {
 967                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
 968                 rte_errno = EINVAL;
 969                 return 0;
 970         }
 971
 972         links_map = dev->data->links_map;
 973         /* Point links_map to this port specific area */
 974         links_map += (port_id * RTE_EVENT_MAX_QUEUES_PER_DEV);
 975
 976         if (queues == NULL) {
 977                 j = 0;
 978                 for (i = 0; i < dev->data->nb_queues; i++) {
 979                         if (links_map[i] !=
 980                                         EVENT_QUEUE_SERVICE_PRIORITY_INVALID) {
 981                                 all_queues[j] = i;
 982                                 j++;
 983                         }
 984                 }
 985                 queues = all_queues;
 986         } else {
 987                 for (j = 0; j < nb_unlinks; j++) {
 988                         if (links_map[queues[j]] ==
 989                                         EVENT_QUEUE_SERVICE_PRIORITY_INVALID)
 990                                 break;
 991                 }
 992         }
 993
 994         nb_unlinks = j;
 995         for (i = 0; i < nb_unlinks; i++)
 996                 if (queues[i] >= dev->data->nb_queues) {
 997                         rte_errno = EINVAL;
 998                         return 0;
 999                 }
1000
1001         diag = (*dev->dev_ops->port_unlink)(dev, dev->data->ports[port_id],
1002                                         queues, nb_unlinks);
1003
1004         if (diag < 0)
1005                 return diag;
1006
1007         for (i = 0; i < diag; i++)
1008                 links_map[queues[i]] = EVENT_QUEUE_SERVICE_PRIORITY_INVALID;
1009
1010         rte_eventdev_trace_port_unlink(dev_id, port_id, nb_unlinks, diag);
1011         return diag;
1012 }
1013
1014 int
1015 rte_event_port_unlinks_in_progress(uint8_t dev_id, uint8_t port_id)
1016 {
1017         struct rte_eventdev *dev;
1018
1019         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1020         dev = &rte_eventdevs[dev_id];
1021         if (!is_valid_port(dev, port_id)) {
1022                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
1023                 return -EINVAL;
1024         }
1025
1026         /* Return 0 if the PMD does not implement unlinks in progress.
1027          * This allows PMDs which handle unlink synchronously to not implement
1028          * this function at all.
1029          */
1030         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->port_unlinks_in_progress, 0);
1031
1032         return (*dev->dev_ops->port_unlinks_in_progress)(dev,
1033                         dev->data->ports[port_id]);
1034 }
1035
1036 int
1037 rte_event_port_links_get(uint8_t dev_id, uint8_t port_id,
1038                          uint8_t queues[], uint8_t priorities[])
1039 {
1040         struct rte_eventdev *dev;
1041         uint16_t *links_map;
1042         int i, count = 0;
1043
1044         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1045         dev = &rte_eventdevs[dev_id];
1046         if (!is_valid_port(dev, port_id)) {
1047                 RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
1048                 return -EINVAL;
1049         }
1050
1051         links_map = dev->data->links_map;
1052         /* Point links_map to this port specific area */
1053         links_map += (port_id * RTE_EVENT_MAX_QUEUES_PER_DEV);
1054         for (i = 0; i < dev->data->nb_queues; i++) {
1055                 if (links_map[i] != EVENT_QUEUE_SERVICE_PRIORITY_INVALID) {
1056                         queues[count] = i;
1057                         priorities[count] = (uint8_t)links_map[i];
1058                         ++count;
1059                 }
1060         }
1061         return count;
1062 }
1063
1064 int
1065 rte_event_dequeue_timeout_ticks(uint8_t dev_id, uint64_t ns,
1066                                  uint64_t *timeout_ticks)
1067 {
1068         struct rte_eventdev *dev;
1069
1070         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1071         dev = &rte_eventdevs[dev_id];
1072         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->timeout_ticks, -ENOTSUP);
1073
1074         if (timeout_ticks == NULL)
1075                 return -EINVAL;
1076
1077         return (*dev->dev_ops->timeout_ticks)(dev, ns, timeout_ticks);
1078 }
1079
1080 int
1081 rte_event_dev_service_id_get(uint8_t dev_id, uint32_t *service_id)
1082 {
1083         struct rte_eventdev *dev;
1084
1085         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1086         dev = &rte_eventdevs[dev_id];
1087
1088         if (service_id == NULL)
1089                 return -EINVAL;
1090
1091         if (dev->data->service_inited)
1092                 *service_id = dev->data->service_id;
1093
1094         return dev->data->service_inited ? 0 : -ESRCH;
1095 }
1096
1097 int
1098 rte_event_dev_dump(uint8_t dev_id, FILE *f)
1099 {
1100         struct rte_eventdev *dev;
1101
1102         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1103         dev = &rte_eventdevs[dev_id];
1104         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dump, -ENOTSUP);
1105
1106         (*dev->dev_ops->dump)(dev, f);
1107         return 0;
1108
1109 }
1110
1111 static int
1112 xstats_get_count(uint8_t dev_id, enum rte_event_dev_xstats_mode mode,
1113                 uint8_t queue_port_id)
1114 {
1115         struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1116         if (dev->dev_ops->xstats_get_names != NULL)
1117                 return (*dev->dev_ops->xstats_get_names)(dev, mode,
1118                                                         queue_port_id,
1119                                                         NULL, NULL, 0);
1120         return 0;
1121 }
1122
1123 int
1124 rte_event_dev_xstats_names_get(uint8_t dev_id,
1125                 enum rte_event_dev_xstats_mode mode, uint8_t queue_port_id,
1126                 struct rte_event_dev_xstats_name *xstats_names,
1127                 unsigned int *ids, unsigned int size)
1128 {
1129         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -ENODEV);
1130         const int cnt_expected_entries = xstats_get_count(dev_id, mode,
1131                                                           queue_port_id);
1132         if (xstats_names == NULL || cnt_expected_entries < 0 ||
1133                         (int)size < cnt_expected_entries)
1134                 return cnt_expected_entries;
1135
1136         /* dev_id checked above */
1137         const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1138
1139         if (dev->dev_ops->xstats_get_names != NULL)
1140                 return (*dev->dev_ops->xstats_get_names)(dev, mode,
1141                                 queue_port_id, xstats_names, ids, size);
1142
1143         return -ENOTSUP;
1144 }
1145
1146 /* retrieve eventdev extended statistics */
1147 int
1148 rte_event_dev_xstats_get(uint8_t dev_id, enum rte_event_dev_xstats_mode mode,
1149                 uint8_t queue_port_id, const unsigned int ids[],
1150                 uint64_t values[], unsigned int n)
1151 {
1152         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -ENODEV);
1153         const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1154
1155         /* implemented by the driver */
1156         if (dev->dev_ops->xstats_get != NULL)
1157                 return (*dev->dev_ops->xstats_get)(dev, mode, queue_port_id,
1158                                 ids, values, n);
1159         return -ENOTSUP;
1160 }
1161
1162 uint64_t
1163 rte_event_dev_xstats_by_name_get(uint8_t dev_id, const char *name,
1164                 unsigned int *id)
1165 {
1166         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, 0);
1167         const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1168         unsigned int temp = -1;
1169
1170         if (id != NULL)
1171                 *id = (unsigned int)-1;
1172         else
1173                 id = &temp; /* ensure driver never gets a NULL value */
1174
1175         /* implemented by driver */
1176         if (dev->dev_ops->xstats_get_by_name != NULL)
1177                 return (*dev->dev_ops->xstats_get_by_name)(dev, name, id);
1178         return -ENOTSUP;
1179 }
1180
1181 int rte_event_dev_xstats_reset(uint8_t dev_id,
1182                 enum rte_event_dev_xstats_mode mode, int16_t queue_port_id,
1183                 const uint32_t ids[], uint32_t nb_ids)
1184 {
1185         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1186         struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1187
1188         if (dev->dev_ops->xstats_reset != NULL)
1189                 return (*dev->dev_ops->xstats_reset)(dev, mode, queue_port_id,
1190                                                         ids, nb_ids);
1191         return -ENOTSUP;
1192 }
1193
1194 int rte_event_dev_selftest(uint8_t dev_id)
1195 {
1196         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1197         struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1198
1199         if (dev->dev_ops->dev_selftest != NULL)
1200                 return (*dev->dev_ops->dev_selftest)();
1201         return -ENOTSUP;
1202 }
1203
1204 int
1205 rte_event_dev_start(uint8_t dev_id)
1206 {
1207         struct rte_eventdev *dev;
1208         int diag;
1209
1210         RTE_EDEV_LOG_DEBUG("Start dev_id=%" PRIu8, dev_id);
1211
1212         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1213         dev = &rte_eventdevs[dev_id];
1214         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
1215
1216         if (dev->data->dev_started != 0) {
1217                 RTE_EDEV_LOG_ERR("Device with dev_id=%" PRIu8 "already started",
1218                         dev_id);
1219                 return 0;
1220         }
1221
1222         diag = (*dev->dev_ops->dev_start)(dev);
1223         rte_eventdev_trace_start(dev_id, diag);
1224         if (diag == 0)
1225                 dev->data->dev_started = 1;
1226         else
1227                 return diag;
1228
1229         return 0;
1230 }
1231
1232 int
1233 rte_event_dev_stop_flush_callback_register(uint8_t dev_id,
1234                 eventdev_stop_flush_t callback, void *userdata)
1235 {
1236         struct rte_eventdev *dev;
1237
1238         RTE_EDEV_LOG_DEBUG("Stop flush register dev_id=%" PRIu8, dev_id);
1239
1240         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1241         dev = &rte_eventdevs[dev_id];
1242
1243         dev->dev_ops->dev_stop_flush = callback;
1244         dev->data->dev_stop_flush_arg = userdata;
1245
1246         return 0;
1247 }
1248
1249 void
1250 rte_event_dev_stop(uint8_t dev_id)
1251 {
1252         struct rte_eventdev *dev;
1253
1254         RTE_EDEV_LOG_DEBUG("Stop dev_id=%" PRIu8, dev_id);
1255
1256         RTE_EVENTDEV_VALID_DEVID_OR_RET(dev_id);
1257         dev = &rte_eventdevs[dev_id];
1258         RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
1259
1260         if (dev->data->dev_started == 0) {
1261                 RTE_EDEV_LOG_ERR("Device with dev_id=%" PRIu8 "already stopped",
1262                         dev_id);
1263                 return;
1264         }
1265
1266         dev->data->dev_started = 0;
1267         (*dev->dev_ops->dev_stop)(dev);
1268         rte_eventdev_trace_stop(dev_id);
1269 }
1270
1271 int
1272 rte_event_dev_close(uint8_t dev_id)
1273 {
1274         struct rte_eventdev *dev;
1275
1276         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1277         dev = &rte_eventdevs[dev_id];
1278         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP);
1279
1280         /* Device must be stopped before it can be closed */
1281         if (dev->data->dev_started == 1) {
1282                 RTE_EDEV_LOG_ERR("Device %u must be stopped before closing",
1283                                 dev_id);
1284                 return -EBUSY;
1285         }
1286
1287         rte_eventdev_trace_close(dev_id);
1288         return (*dev->dev_ops->dev_close)(dev);
1289 }
1290
1291 static inline int
1292 rte_eventdev_data_alloc(uint8_t dev_id, struct rte_eventdev_data **data,
1293                 int socket_id)
1294 {
1295         char mz_name[RTE_EVENTDEV_NAME_MAX_LEN];
1296         const struct rte_memzone *mz;
1297         int n;
1298
1299         /* Generate memzone name */
1300         n = snprintf(mz_name, sizeof(mz_name), "rte_eventdev_data_%u", dev_id);
1301         if (n >= (int)sizeof(mz_name))
1302                 return -EINVAL;
1303
1304         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1305                 mz = rte_memzone_reserve(mz_name,
1306                                 sizeof(struct rte_eventdev_data),
1307                                 socket_id, 0);
1308         } else
1309                 mz = rte_memzone_lookup(mz_name);
1310
1311         if (mz == NULL)
1312                 return -ENOMEM;
1313
1314         *data = mz->addr;
1315         if (rte_eal_process_type() == RTE_PROC_PRIMARY)
1316                 memset(*data, 0, sizeof(struct rte_eventdev_data));
1317
1318         return 0;
1319 }
1320
1321 static inline uint8_t
1322 rte_eventdev_find_free_device_index(void)
1323 {
1324         uint8_t dev_id;
1325
1326         for (dev_id = 0; dev_id < RTE_EVENT_MAX_DEVS; dev_id++) {
1327                 if (rte_eventdevs[dev_id].attached ==
1328                                 RTE_EVENTDEV_DETACHED)
1329                         return dev_id;
1330         }
1331         return RTE_EVENT_MAX_DEVS;
1332 }
1333
1334 static uint16_t
1335 rte_event_tx_adapter_enqueue(__rte_unused void *port,
1336                         __rte_unused struct rte_event ev[],
1337                         __rte_unused uint16_t nb_events)
1338 {
1339         rte_errno = ENOTSUP;
1340         return 0;
1341 }
1342
1343 struct rte_eventdev *
1344 rte_event_pmd_allocate(const char *name, int socket_id)
1345 {
1346         struct rte_eventdev *eventdev;
1347         uint8_t dev_id;
1348
1349         if (rte_event_pmd_get_named_dev(name) != NULL) {
1350                 RTE_EDEV_LOG_ERR("Event device with name %s already "
1351                                 "allocated!", name);
1352                 return NULL;
1353         }
1354
1355         dev_id = rte_eventdev_find_free_device_index();
1356         if (dev_id == RTE_EVENT_MAX_DEVS) {
1357                 RTE_EDEV_LOG_ERR("Reached maximum number of event devices");
1358                 return NULL;
1359         }
1360
1361         eventdev = &rte_eventdevs[dev_id];
1362
1363         eventdev->txa_enqueue = rte_event_tx_adapter_enqueue;
1364         eventdev->txa_enqueue_same_dest = rte_event_tx_adapter_enqueue;
1365
1366         if (eventdev->data == NULL) {
1367                 struct rte_eventdev_data *eventdev_data = NULL;
1368
1369                 int retval = rte_eventdev_data_alloc(dev_id, &eventdev_data,
1370                                 socket_id);
1371
1372                 if (retval < 0 || eventdev_data == NULL)
1373                         return NULL;
1374
1375                 eventdev->data = eventdev_data;
1376
1377                 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1378
1379                         strlcpy(eventdev->data->name, name,
1380                                 RTE_EVENTDEV_NAME_MAX_LEN);
1381
1382                         eventdev->data->dev_id = dev_id;
1383                         eventdev->data->socket_id = socket_id;
1384                         eventdev->data->dev_started = 0;
1385                 }
1386
1387                 eventdev->attached = RTE_EVENTDEV_ATTACHED;
1388                 eventdev_globals.nb_devs++;
1389         }
1390
1391         return eventdev;
1392 }
1393
1394 int
1395 rte_event_pmd_release(struct rte_eventdev *eventdev)
1396 {
1397         int ret;
1398         char mz_name[RTE_EVENTDEV_NAME_MAX_LEN];
1399         const struct rte_memzone *mz;
1400
1401         if (eventdev == NULL)
1402                 return -EINVAL;
1403
1404         eventdev->attached = RTE_EVENTDEV_DETACHED;
1405         eventdev_globals.nb_devs--;
1406
1407         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1408                 rte_free(eventdev->data->dev_private);
1409
1410                 /* Generate memzone name */
1411                 ret = snprintf(mz_name, sizeof(mz_name), "rte_eventdev_data_%u",
1412                                 eventdev->data->dev_id);
1413                 if (ret >= (int)sizeof(mz_name))
1414                         return -EINVAL;
1415
1416                 mz = rte_memzone_lookup(mz_name);
1417                 if (mz == NULL)
1418                         return -ENOMEM;
1419
1420                 ret = rte_memzone_free(mz);
1421                 if (ret)
1422                         return ret;
1423         }
1424
1425         eventdev->data = NULL;
1426         return 0;
1427 }
1428
1429
1430 static int
1431 handle_dev_list(const char *cmd __rte_unused,
1432                 const char *params __rte_unused,
1433                 struct rte_tel_data *d)
1434 {
1435         uint8_t dev_id;
1436         int ndev = rte_event_dev_count();
1437
1438         if (ndev < 1)
1439                 return -1;
1440
1441         rte_tel_data_start_array(d, RTE_TEL_INT_VAL);
1442         for (dev_id = 0; dev_id < RTE_EVENT_MAX_DEVS; dev_id++) {
1443                 if (rte_eventdevs[dev_id].attached ==
1444                                 RTE_EVENTDEV_ATTACHED)
1445                         rte_tel_data_add_array_int(d, dev_id);
1446         }
1447
1448         return 0;
1449 }
1450
1451 static int
1452 handle_port_list(const char *cmd __rte_unused,
1453                  const char *params,
1454                  struct rte_tel_data *d)
1455 {
1456         int i;
1457         uint8_t dev_id;
1458         struct rte_eventdev *dev;
1459         char *end_param;
1460
1461         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1462                 return -1;
1463
1464         dev_id = strtoul(params, &end_param, 10);
1465         if (*end_param != '\0')
1466                 RTE_EDEV_LOG_DEBUG(
1467                         "Extra parameters passed to eventdev telemetry command, ignoring");
1468
1469         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1470         dev = &rte_eventdevs[dev_id];
1471
1472         rte_tel_data_start_array(d, RTE_TEL_INT_VAL);
1473         for (i = 0; i < dev->data->nb_ports; i++)
1474                 rte_tel_data_add_array_int(d, i);
1475
1476         return 0;
1477 }
1478
1479 static int
1480 handle_queue_list(const char *cmd __rte_unused,
1481                   const char *params,
1482                   struct rte_tel_data *d)
1483 {
1484         int i;
1485         uint8_t dev_id;
1486         struct rte_eventdev *dev;
1487         char *end_param;
1488
1489         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1490                 return -1;
1491
1492         dev_id = strtoul(params, &end_param, 10);
1493         if (*end_param != '\0')
1494                 RTE_EDEV_LOG_DEBUG(
1495                         "Extra parameters passed to eventdev telemetry command, ignoring");
1496
1497         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1498         dev = &rte_eventdevs[dev_id];
1499
1500         rte_tel_data_start_array(d, RTE_TEL_INT_VAL);
1501         for (i = 0; i < dev->data->nb_queues; i++)
1502                 rte_tel_data_add_array_int(d, i);
1503
1504         return 0;
1505 }
1506
1507 static int
1508 handle_queue_links(const char *cmd __rte_unused,
1509                    const char *params,
1510                    struct rte_tel_data *d)
1511 {
1512         int i, ret, port_id = 0;
1513         char *end_param;
1514         uint8_t dev_id;
1515         uint8_t queues[RTE_EVENT_MAX_QUEUES_PER_DEV];
1516         uint8_t priorities[RTE_EVENT_MAX_QUEUES_PER_DEV];
1517         const char *p_param;
1518
1519         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1520                 return -1;
1521
1522         /* Get dev ID from parameter string */
1523         dev_id = strtoul(params, &end_param, 10);
1524         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1525
1526         p_param = strtok(end_param, ",");
1527         if (p_param == NULL || strlen(p_param) == 0 || !isdigit(*p_param))
1528                 return -1;
1529
1530         port_id = strtoul(p_param, &end_param, 10);
1531         p_param = strtok(NULL, "\0");
1532         if (p_param != NULL)
1533                 RTE_EDEV_LOG_DEBUG(
1534                         "Extra parameters passed to eventdev telemetry command, ignoring");
1535
1536         ret = rte_event_port_links_get(dev_id, port_id, queues, priorities);
1537         if (ret < 0)
1538                 return -1;
1539
1540         rte_tel_data_start_dict(d);
1541         for (i = 0; i < ret; i++) {
1542                 char qid_name[32];
1543
1544                 snprintf(qid_name, 31, "qid_%u", queues[i]);
1545                 rte_tel_data_add_dict_u64(d, qid_name, priorities[i]);
1546         }
1547
1548         return 0;
1549 }
1550
1551 static int
1552 eventdev_build_telemetry_data(int dev_id,
1553                               enum rte_event_dev_xstats_mode mode,
1554                               int port_queue_id,
1555                               struct rte_tel_data *d)
1556 {
1557         struct rte_event_dev_xstats_name *xstat_names;
1558         unsigned int *ids;
1559         uint64_t *values;
1560         int i, ret, num_xstats;
1561
1562         num_xstats = rte_event_dev_xstats_names_get(dev_id,
1563                                                     mode,
1564                                                     port_queue_id,
1565                                                     NULL,
1566                                                     NULL,
1567                                                     0);
1568
1569         if (num_xstats < 0)
1570                 return -1;
1571
1572         /* use one malloc for names */
1573         xstat_names = malloc((sizeof(struct rte_event_dev_xstats_name))
1574                              * num_xstats);
1575         if (xstat_names == NULL)
1576                 return -1;
1577
1578         ids = malloc((sizeof(unsigned int)) * num_xstats);
1579         if (ids == NULL) {
1580                 free(xstat_names);
1581                 return -1;
1582         }
1583
1584         values = malloc((sizeof(uint64_t)) * num_xstats);
1585         if (values == NULL) {
1586                 free(xstat_names);
1587                 free(ids);
1588                 return -1;
1589         }
1590
1591         ret = rte_event_dev_xstats_names_get(dev_id, mode, port_queue_id,
1592                                              xstat_names, ids, num_xstats);
1593         if (ret < 0 || ret > num_xstats) {
1594                 free(xstat_names);
1595                 free(ids);
1596                 free(values);
1597                 return -1;
1598         }
1599
1600         ret = rte_event_dev_xstats_get(dev_id, mode, port_queue_id,
1601                                        ids, values, num_xstats);
1602         if (ret < 0 || ret > num_xstats) {
1603                 free(xstat_names);
1604                 free(ids);
1605                 free(values);
1606                 return -1;
1607         }
1608
1609         rte_tel_data_start_dict(d);
1610         for (i = 0; i < num_xstats; i++)
1611                 rte_tel_data_add_dict_u64(d, xstat_names[i].name,
1612                                           values[i]);
1613
1614         free(xstat_names);
1615         free(ids);
1616         free(values);
1617         return 0;
1618 }
1619
1620 static int
1621 handle_dev_xstats(const char *cmd __rte_unused,
1622                   const char *params,
1623                   struct rte_tel_data *d)
1624 {
1625         int dev_id;
1626         enum rte_event_dev_xstats_mode mode;
1627         char *end_param;
1628
1629         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1630                 return -1;
1631
1632         /* Get dev ID from parameter string */
1633         dev_id = strtoul(params, &end_param, 10);
1634         if (*end_param != '\0')
1635                 RTE_EDEV_LOG_DEBUG(
1636                         "Extra parameters passed to eventdev telemetry command, ignoring");
1637
1638         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1639
1640         mode = RTE_EVENT_DEV_XSTATS_DEVICE;
1641         return eventdev_build_telemetry_data(dev_id, mode, 0, d);
1642 }
1643
1644 static int
1645 handle_port_xstats(const char *cmd __rte_unused,
1646                    const char *params,
1647                    struct rte_tel_data *d)
1648 {
1649         int dev_id;
1650         int port_queue_id = 0;
1651         enum rte_event_dev_xstats_mode mode;
1652         char *end_param;
1653         const char *p_param;
1654
1655         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1656                 return -1;
1657
1658         /* Get dev ID from parameter string */
1659         dev_id = strtoul(params, &end_param, 10);
1660         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1661
1662         p_param = strtok(end_param, ",");
1663         mode = RTE_EVENT_DEV_XSTATS_PORT;
1664
1665         if (p_param == NULL || strlen(p_param) == 0 || !isdigit(*p_param))
1666                 return -1;
1667
1668         port_queue_id = strtoul(p_param, &end_param, 10);
1669
1670         p_param = strtok(NULL, "\0");
1671         if (p_param != NULL)
1672                 RTE_EDEV_LOG_DEBUG(
1673                         "Extra parameters passed to eventdev telemetry command, ignoring");
1674
1675         return eventdev_build_telemetry_data(dev_id, mode, port_queue_id, d);
1676 }
1677
1678 static int
1679 handle_queue_xstats(const char *cmd __rte_unused,
1680                     const char *params,
1681                     struct rte_tel_data *d)
1682 {
1683         int dev_id;
1684         int port_queue_id = 0;
1685         enum rte_event_dev_xstats_mode mode;
1686         char *end_param;
1687         const char *p_param;
1688
1689         if (params == NULL || strlen(params) == 0 || !isdigit(*params))
1690                 return -1;
1691
1692         /* Get dev ID from parameter string */
1693         dev_id = strtoul(params, &end_param, 10);
1694         RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
1695
1696         p_param = strtok(end_param, ",");
1697         mode = RTE_EVENT_DEV_XSTATS_QUEUE;
1698
1699         if (p_param == NULL || strlen(p_param) == 0 || !isdigit(*p_param))
1700                 return -1;
1701
1702         port_queue_id = strtoul(p_param, &end_param, 10);
1703
1704         p_param = strtok(NULL, "\0");
1705         if (p_param != NULL)
1706                 RTE_EDEV_LOG_DEBUG(
1707                         "Extra parameters passed to eventdev telemetry command, ignoring");
1708
1709         return eventdev_build_telemetry_data(dev_id, mode, port_queue_id, d);
1710 }
1711
1712 RTE_INIT(eventdev_init_telemetry)
1713 {
1714         rte_telemetry_register_cmd("/eventdev/dev_list", handle_dev_list,
1715                         "Returns list of available eventdevs. Takes no parameters");
1716         rte_telemetry_register_cmd("/eventdev/port_list", handle_port_list,
1717                         "Returns list of available ports. Parameter: DevID");
1718         rte_telemetry_register_cmd("/eventdev/queue_list", handle_queue_list,
1719                         "Returns list of available queues. Parameter: DevID");
1720
1721         rte_telemetry_register_cmd("/eventdev/dev_xstats", handle_dev_xstats,
1722                         "Returns stats for an eventdev. Parameter: DevID");
1723         rte_telemetry_register_cmd("/eventdev/port_xstats", handle_port_xstats,
1724                         "Returns stats for an eventdev port. Params: DevID,PortID");
1725         rte_telemetry_register_cmd("/eventdev/queue_xstats",
1726                         handle_queue_xstats,
1727                         "Returns stats for an eventdev queue. Params: DevID,QueueID");
1728         rte_telemetry_register_cmd("/eventdev/queue_links", handle_queue_links,
1729                         "Returns links for an eventdev port. Params: DevID,QueueID");
1730 }