examples/eventdev_pipeline/main.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2016-2017 Intel Corporation
   3  */
   4
   5 #include <getopt.h>
   6 #include <stdint.h>
   7 #include <stdio.h>
   8 #include <signal.h>
   9 #include <sched.h>
  10
  11 #include "pipeline_common.h"
  12
  13 struct config_data cdata = {
  14         .num_packets = (1L << 25), /* do ~32M packets */
  15         .num_fids = 512,
  16         .queue_type = RTE_SCHED_TYPE_ATOMIC,
  17         .next_qid = {-1},
  18         .qid = {-1},
  19         .num_stages = 1,
  20         .worker_cq_depth = 16
  21 };
  22
  23 static bool
  24 core_in_use(unsigned int lcore_id) {
  25         return (fdata->rx_core[lcore_id] || fdata->sched_core[lcore_id] ||
  26                 fdata->tx_core[lcore_id] || fdata->worker_core[lcore_id]);
  27 }
  28
  29 /*
  30  * Parse the coremask given as argument (hexadecimal string) and fill
  31  * the global configuration (core role and core count) with the parsed
  32  * value.
  33  */
  34 static int xdigit2val(unsigned char c)
  35 {
  36         int val;
  37
  38         if (isdigit(c))
  39                 val = c - '0';
  40         else if (isupper(c))
  41                 val = c - 'A' + 10;
  42         else
  43                 val = c - 'a' + 10;
  44         return val;
  45 }
  46
  47 static uint64_t
  48 parse_coremask(const char *coremask)
  49 {
  50         int i, j, idx = 0;
  51         unsigned int count = 0;
  52         char c;
  53         int val;
  54         uint64_t mask = 0;
  55         const int32_t BITS_HEX = 4;
  56
  57         if (coremask == NULL)
  58                 return -1;
  59         /* Remove all blank characters ahead and after .
  60          * Remove 0x/0X if exists.
  61          */
  62         while (isblank(*coremask))
  63                 coremask++;
  64         if (coremask[0] == '0' && ((coremask[1] == 'x')
  65                 || (coremask[1] == 'X')))
  66                 coremask += 2;
  67         i = strlen(coremask);
  68         while ((i > 0) && isblank(coremask[i - 1]))
  69                 i--;
  70         if (i == 0)
  71                 return -1;
  72
  73         for (i = i - 1; i >= 0 && idx < MAX_NUM_CORE; i--) {
  74                 c = coremask[i];
  75                 if (isxdigit(c) == 0) {
  76                         /* invalid characters */
  77                         return -1;
  78                 }
  79                 val = xdigit2val(c);
  80                 for (j = 0; j < BITS_HEX && idx < MAX_NUM_CORE; j++, idx++) {
  81                         if ((1 << j) & val) {
  82                                 mask |= (1UL << idx);
  83                                 count++;
  84                         }
  85                 }
  86         }
  87         for (; i >= 0; i--)
  88                 if (coremask[i] != '0')
  89                         return -1;
  90         if (count == 0)
  91                 return -1;
  92         return mask;
  93 }
  94
  95 static struct option long_options[] = {
  96         {"workers", required_argument, 0, 'w'},
  97         {"packets", required_argument, 0, 'n'},
  98         {"atomic-flows", required_argument, 0, 'f'},
  99         {"num_stages", required_argument, 0, 's'},
 100         {"rx-mask", required_argument, 0, 'r'},
 101         {"tx-mask", required_argument, 0, 't'},
 102         {"sched-mask", required_argument, 0, 'e'},
 103         {"cq-depth", required_argument, 0, 'c'},
 104         {"work-cycles", required_argument, 0, 'W'},
 105         {"mempool-size", required_argument, 0, 'm'},
 106         {"queue-priority", no_argument, 0, 'P'},
 107         {"parallel", no_argument, 0, 'p'},
 108         {"ordered", no_argument, 0, 'o'},
 109         {"quiet", no_argument, 0, 'q'},
 110         {"use-atq", no_argument, 0, 'a'},
 111         {"dump", no_argument, 0, 'D'},
 112         {0, 0, 0, 0}
 113 };
 114
 115 static void
 116 usage(void)
 117 {
 118         const char *usage_str =
 119                 "  Usage: eventdev_demo [options]\n"
 120                 "  Options:\n"
 121                 "  -n, --packets=N              Send N packets (default ~32M), 0 implies no limit\n"
 122                 "  -f, --atomic-flows=N         Use N random flows from 1 to N (default 16)\n"
 123                 "  -s, --num_stages=N           Use N atomic stages (default 1)\n"
 124                 "  -r, --rx-mask=core mask      Run NIC rx on CPUs in core mask\n"
 125                 "  -w, --worker-mask=core mask  Run worker on CPUs in core mask\n"
 126                 "  -t, --tx-mask=core mask      Run NIC tx on CPUs in core mask\n"
 127                 "  -e  --sched-mask=core mask   Run scheduler on CPUs in core mask\n"
 128                 "  -c  --cq-depth=N             Worker CQ depth (default 16)\n"
 129                 "  -W  --work-cycles=N          Worker cycles (default 0)\n"
 130                 "  -P  --queue-priority         Enable scheduler queue prioritization\n"
 131                 "  -o, --ordered                Use ordered scheduling\n"
 132                 "  -p, --parallel               Use parallel scheduling\n"
 133                 "  -q, --quiet                  Minimize printed output\n"
 134                 "  -a, --use-atq                Use all type queues\n"
 135                 "  -m, --mempool-size=N         Dictate the mempool size\n"
 136                 "  -D, --dump                   Print detailed statistics before exit"
 137                 "\n";
 138         fprintf(stderr, "%s", usage_str);
 139         exit(1);
 140 }
 141
 142 static void
 143 parse_app_args(int argc, char **argv)
 144 {
 145         /* Parse cli options*/
 146         int option_index;
 147         int c;
 148         opterr = 0;
 149         uint64_t rx_lcore_mask = 0;
 150         uint64_t tx_lcore_mask = 0;
 151         uint64_t sched_lcore_mask = 0;
 152         uint64_t worker_lcore_mask = 0;
 153         int i;
 154
 155         for (;;) {
 156                 c = getopt_long(argc, argv, "r:t:e:c:w:n:f:s:m:paoPqDW:",
 157                                 long_options, &option_index);
 158                 if (c == -1)
 159                         break;
 160
 161                 int popcnt = 0;
 162                 switch (c) {
 163                 case 'n':
 164                         cdata.num_packets = (int64_t)atol(optarg);
 165                         if (cdata.num_packets == 0)
 166                                 cdata.num_packets = INT64_MAX;
 167                         break;
 168                 case 'f':
 169                         cdata.num_fids = (unsigned int)atoi(optarg);
 170                         break;
 171                 case 's':
 172                         cdata.num_stages = (unsigned int)atoi(optarg);
 173                         break;
 174                 case 'c':
 175                         cdata.worker_cq_depth = (unsigned int)atoi(optarg);
 176                         break;
 177                 case 'W':
 178                         cdata.worker_cycles = (unsigned int)atoi(optarg);
 179                         break;
 180                 case 'P':
 181                         cdata.enable_queue_priorities = 1;
 182                         break;
 183                 case 'o':
 184                         cdata.queue_type = RTE_SCHED_TYPE_ORDERED;
 185                         break;
 186                 case 'p':
 187                         cdata.queue_type = RTE_SCHED_TYPE_PARALLEL;
 188                         break;
 189                 case 'a':
 190                         cdata.all_type_queues = 1;
 191                         break;
 192                 case 'q':
 193                         cdata.quiet = 1;
 194                         break;
 195                 case 'D':
 196                         cdata.dump_dev = 1;
 197                         break;
 198                 case 'w':
 199                         worker_lcore_mask = parse_coremask(optarg);
 200                         break;
 201                 case 'r':
 202                         rx_lcore_mask = parse_coremask(optarg);
 203                         popcnt = __builtin_popcountll(rx_lcore_mask);
 204                         fdata->rx_single = (popcnt == 1);
 205                         break;
 206                 case 't':
 207                         tx_lcore_mask = parse_coremask(optarg);
 208                         popcnt = __builtin_popcountll(tx_lcore_mask);
 209                         fdata->tx_single = (popcnt == 1);
 210                         break;
 211                 case 'e':
 212                         sched_lcore_mask = parse_coremask(optarg);
 213                         popcnt = __builtin_popcountll(sched_lcore_mask);
 214                         fdata->sched_single = (popcnt == 1);
 215                         break;
 216                 case 'm':
 217                         cdata.num_mbuf = (uint64_t)atol(optarg);
 218                         break;
 219                 default:
 220                         usage();
 221                 }
 222         }
 223
 224         cdata.worker_lcore_mask = worker_lcore_mask;
 225         cdata.sched_lcore_mask = sched_lcore_mask;
 226         cdata.rx_lcore_mask = rx_lcore_mask;
 227         cdata.tx_lcore_mask = tx_lcore_mask;
 228
 229         if (cdata.num_stages == 0 || cdata.num_stages > MAX_NUM_STAGES)
 230                 usage();
 231
 232         for (i = 0; i < MAX_NUM_CORE; i++) {
 233                 fdata->rx_core[i] = !!(rx_lcore_mask & (1UL << i));
 234                 fdata->tx_core[i] = !!(tx_lcore_mask & (1UL << i));
 235                 fdata->sched_core[i] = !!(sched_lcore_mask & (1UL << i));
 236                 fdata->worker_core[i] = !!(worker_lcore_mask & (1UL << i));
 237
 238                 if (fdata->worker_core[i])
 239                         cdata.num_workers++;
 240                 if (core_in_use(i))
 241                         cdata.active_cores++;
 242         }
 243 }
 244
 245 /*
 246  * Initializes a given port using global settings and with the RX buffers
 247  * coming from the mbuf_pool passed as a parameter.
 248  */
 249 static inline int
 250 port_init(uint8_t port, struct rte_mempool *mbuf_pool)
 251 {
 252         struct rte_eth_rxconf rx_conf;
 253         static const struct rte_eth_conf port_conf_default = {
 254                 .rxmode = {
 255                         .mq_mode = ETH_MQ_RX_RSS,
 256                         .max_rx_pkt_len = RTE_ETHER_MAX_LEN,
 257                 },
 258                 .rx_adv_conf = {
 259                         .rss_conf = {
 260                                 .rss_hf = ETH_RSS_IP |
 261                                           ETH_RSS_TCP |
 262                                           ETH_RSS_UDP,
 263                         }
 264                 }
 265         };
 266         const uint16_t rx_rings = 1, tx_rings = 1;
 267         const uint16_t rx_ring_size = 512, tx_ring_size = 512;
 268         struct rte_eth_conf port_conf = port_conf_default;
 269         int retval;
 270         uint16_t q;
 271         struct rte_eth_dev_info dev_info;
 272         struct rte_eth_txconf txconf;
 273
 274         if (!rte_eth_dev_is_valid_port(port))
 275                 return -1;
 276
 277         retval = rte_eth_dev_info_get(port, &dev_info);
 278         if (retval != 0) {
 279                 printf("Error during getting device (port %u) info: %s\n",
 280                                 port, strerror(-retval));
 281                 return retval;
 282         }
 283
 284         if (dev_info.tx_offload_capa & DEV_TX_OFFLOAD_MBUF_FAST_FREE)
 285                 port_conf.txmode.offloads |=
 286                         DEV_TX_OFFLOAD_MBUF_FAST_FREE;
 287         rx_conf = dev_info.default_rxconf;
 288         rx_conf.offloads = port_conf.rxmode.offloads;
 289
 290         port_conf.rx_adv_conf.rss_conf.rss_hf &=
 291                 dev_info.flow_type_rss_offloads;
 292         if (port_conf.rx_adv_conf.rss_conf.rss_hf !=
 293                         port_conf_default.rx_adv_conf.rss_conf.rss_hf) {
 294                 printf("Port %u modified RSS hash function based on hardware support,"
 295                         "requested:%#"PRIx64" configured:%#"PRIx64"\n",
 296                         port,
 297                         port_conf_default.rx_adv_conf.rss_conf.rss_hf,
 298                         port_conf.rx_adv_conf.rss_conf.rss_hf);
 299         }
 300
 301         /* Configure the Ethernet device. */
 302         retval = rte_eth_dev_configure(port, rx_rings, tx_rings, &port_conf);
 303         if (retval != 0)
 304                 return retval;
 305
 306         /* Allocate and set up 1 RX queue per Ethernet port. */
 307         for (q = 0; q < rx_rings; q++) {
 308                 retval = rte_eth_rx_queue_setup(port, q, rx_ring_size,
 309                                 rte_eth_dev_socket_id(port), &rx_conf,
 310                                 mbuf_pool);
 311                 if (retval < 0)
 312                         return retval;
 313         }
 314
 315         txconf = dev_info.default_txconf;
 316         txconf.offloads = port_conf_default.txmode.offloads;
 317         /* Allocate and set up 1 TX queue per Ethernet port. */
 318         for (q = 0; q < tx_rings; q++) {
 319                 retval = rte_eth_tx_queue_setup(port, q, tx_ring_size,
 320                                 rte_eth_dev_socket_id(port), &txconf);
 321                 if (retval < 0)
 322                         return retval;
 323         }
 324
 325         /* Display the port MAC address. */
 326         struct rte_ether_addr addr;
 327         retval = rte_eth_macaddr_get(port, &addr);
 328         if (retval != 0) {
 329                 printf("Failed to get MAC address (port %u): %s\n",
 330                                 port, rte_strerror(-retval));
 331                 return retval;
 332         }
 333
 334         printf("Port %u MAC: %02" PRIx8 " %02" PRIx8 " %02" PRIx8
 335                            " %02" PRIx8 " %02" PRIx8 " %02" PRIx8 "\n",
 336                         (unsigned int)port,
 337                         addr.addr_bytes[0], addr.addr_bytes[1],
 338                         addr.addr_bytes[2], addr.addr_bytes[3],
 339                         addr.addr_bytes[4], addr.addr_bytes[5]);
 340
 341         /* Enable RX in promiscuous mode for the Ethernet device. */
 342         retval = rte_eth_promiscuous_enable(port);
 343         if (retval != 0)
 344                 return retval;
 345
 346         return 0;
 347 }
 348
 349 static int
 350 init_ports(uint16_t num_ports)
 351 {
 352         uint16_t portid;
 353
 354         if (!cdata.num_mbuf)
 355                 cdata.num_mbuf = 16384 * num_ports;
 356
 357         struct rte_mempool *mp = rte_pktmbuf_pool_create("packet_pool",
 358                         /* mbufs */ cdata.num_mbuf,
 359                         /* cache_size */ 512,
 360                         /* priv_size*/ 0,
 361                         /* data_room_size */ RTE_MBUF_DEFAULT_BUF_SIZE,
 362                         rte_socket_id());
 363
 364         RTE_ETH_FOREACH_DEV(portid)
 365                 if (port_init(portid, mp) != 0)
 366                         rte_exit(EXIT_FAILURE, "Cannot init port %"PRIu16 "\n",
 367                                         portid);
 368
 369         return 0;
 370 }
 371
 372 static void
 373 do_capability_setup(uint8_t eventdev_id)
 374 {
 375         int ret;
 376         uint16_t i;
 377         uint8_t generic_pipeline = 0;
 378         uint8_t burst = 0;
 379
 380         RTE_ETH_FOREACH_DEV(i) {
 381                 uint32_t caps = 0;
 382
 383                 ret = rte_event_eth_tx_adapter_caps_get(eventdev_id, i, &caps);
 384                 if (ret)
 385                         rte_exit(EXIT_FAILURE,
 386                                 "Invalid capability for Tx adptr port %d\n", i);
 387                 generic_pipeline |= !(caps &
 388                                 RTE_EVENT_ETH_TX_ADAPTER_CAP_INTERNAL_PORT);
 389         }
 390
 391         struct rte_event_dev_info eventdev_info;
 392         memset(&eventdev_info, 0, sizeof(struct rte_event_dev_info));
 393
 394         rte_event_dev_info_get(eventdev_id, &eventdev_info);
 395         burst = eventdev_info.event_dev_cap & RTE_EVENT_DEV_CAP_BURST_MODE ? 1 :
 396                 0;
 397
 398         if (generic_pipeline)
 399                 set_worker_generic_setup_data(&fdata->cap, burst);
 400         else
 401                 set_worker_tx_enq_setup_data(&fdata->cap, burst);
 402 }
 403
 404 static void
 405 signal_handler(int signum)
 406 {
 407         static uint8_t once;
 408         uint16_t portid;
 409
 410         if (fdata->done)
 411                 rte_exit(1, "Exiting on signal %d\n", signum);
 412         if ((signum == SIGINT || signum == SIGTERM) && !once) {
 413                 printf("\n\nSignal %d received, preparing to exit...\n",
 414                                 signum);
 415                 if (cdata.dump_dev)
 416                         rte_event_dev_dump(0, stdout);
 417                 once = 1;
 418                 fdata->done = 1;
 419                 rte_smp_wmb();
 420
 421                 RTE_ETH_FOREACH_DEV(portid) {
 422                         rte_event_eth_rx_adapter_stop(portid);
 423                         rte_event_eth_tx_adapter_stop(portid);
 424                         rte_eth_dev_stop(portid);
 425                 }
 426
 427                 rte_eal_mp_wait_lcore();
 428
 429                 RTE_ETH_FOREACH_DEV(portid) {
 430                         rte_eth_dev_close(portid);
 431                 }
 432
 433                 rte_event_dev_stop(0);
 434                 rte_event_dev_close(0);
 435         }
 436         if (signum == SIGTSTP)
 437                 rte_event_dev_dump(0, stdout);
 438 }
 439
 440 static inline uint64_t
 441 port_stat(int dev_id, int32_t p)
 442 {
 443         char statname[64];
 444         snprintf(statname, sizeof(statname), "port_%u_rx", p);
 445         return rte_event_dev_xstats_by_name_get(dev_id, statname, NULL);
 446 }
 447
 448 int
 449 main(int argc, char **argv)
 450 {
 451         struct worker_data *worker_data;
 452         uint16_t num_ports;
 453         uint16_t portid;
 454         int lcore_id;
 455         int err;
 456
 457         signal(SIGINT, signal_handler);
 458         signal(SIGTERM, signal_handler);
 459         signal(SIGTSTP, signal_handler);
 460
 461         err = rte_eal_init(argc, argv);
 462         if (err < 0)
 463                 rte_panic("Invalid EAL arguments\n");
 464
 465         argc -= err;
 466         argv += err;
 467
 468         fdata = rte_malloc(NULL, sizeof(struct fastpath_data), 0);
 469         if (fdata == NULL)
 470                 rte_panic("Out of memory\n");
 471
 472         /* Parse cli options*/
 473         parse_app_args(argc, argv);
 474
 475         num_ports = rte_eth_dev_count_avail();
 476         if (num_ports == 0)
 477                 rte_panic("No ethernet ports found\n");
 478
 479         const unsigned int cores_needed = cdata.active_cores;
 480
 481         if (!cdata.quiet) {
 482                 printf("  Config:\n");
 483                 printf("\tports: %u\n", num_ports);
 484                 printf("\tworkers: %u\n", cdata.num_workers);
 485                 printf("\tpackets: %"PRIi64"\n", cdata.num_packets);
 486                 printf("\tQueue-prio: %u\n", cdata.enable_queue_priorities);
 487                 if (cdata.queue_type == RTE_SCHED_TYPE_ORDERED)
 488                         printf("\tqid0 type: ordered\n");
 489                 if (cdata.queue_type == RTE_SCHED_TYPE_ATOMIC)
 490                         printf("\tqid0 type: atomic\n");
 491                 printf("\tCores available: %u\n", rte_lcore_count());
 492                 printf("\tCores used: %u\n", cores_needed);
 493         }
 494
 495         if (rte_lcore_count() < cores_needed)
 496                 rte_panic("Too few cores (%d < %d)\n", rte_lcore_count(),
 497                                 cores_needed);
 498
 499         const unsigned int ndevs = rte_event_dev_count();
 500         if (ndevs == 0)
 501                 rte_panic("No dev_id devs found. Pasl in a --vdev eventdev.\n");
 502         if (ndevs > 1)
 503                 fprintf(stderr, "Warning: More than one eventdev, using idx 0");
 504
 505
 506         do_capability_setup(0);
 507         fdata->cap.check_opt();
 508
 509         worker_data = rte_calloc(0, cdata.num_workers,
 510                         sizeof(worker_data[0]), 0);
 511         if (worker_data == NULL)
 512                 rte_panic("rte_calloc failed\n");
 513
 514         int dev_id = fdata->cap.evdev_setup(worker_data);
 515         if (dev_id < 0)
 516                 rte_exit(EXIT_FAILURE, "Error setting up eventdev\n");
 517
 518         init_ports(num_ports);
 519         fdata->cap.adptr_setup(num_ports);
 520
 521         /* Start the Ethernet port. */
 522         RTE_ETH_FOREACH_DEV(portid) {
 523                 err = rte_eth_dev_start(portid);
 524                 if (err < 0)
 525                         rte_exit(EXIT_FAILURE, "Error starting ethdev %d\n",
 526                                         portid);
 527         }
 528
 529         int worker_idx = 0;
 530         RTE_LCORE_FOREACH_SLAVE(lcore_id) {
 531                 if (lcore_id >= MAX_NUM_CORE)
 532                         break;
 533
 534                 if (!fdata->rx_core[lcore_id] &&
 535                         !fdata->worker_core[lcore_id] &&
 536                         !fdata->tx_core[lcore_id] &&
 537                         !fdata->sched_core[lcore_id])
 538                         continue;
 539
 540                 if (fdata->rx_core[lcore_id])
 541                         printf(
 542                                 "[%s()] lcore %d executing NIC Rx\n",
 543                                 __func__, lcore_id);
 544
 545                 if (fdata->tx_core[lcore_id])
 546                         printf(
 547                                 "[%s()] lcore %d executing NIC Tx\n",
 548                                 __func__, lcore_id);
 549
 550                 if (fdata->sched_core[lcore_id])
 551                         printf("[%s()] lcore %d executing scheduler\n",
 552                                         __func__, lcore_id);
 553
 554                 if (fdata->worker_core[lcore_id])
 555                         printf(
 556                                 "[%s()] lcore %d executing worker, using eventdev port %u\n",
 557                                 __func__, lcore_id,
 558                                 worker_data[worker_idx].port_id);
 559
 560                 err = rte_eal_remote_launch(fdata->cap.worker,
 561                                 &worker_data[worker_idx], lcore_id);
 562                 if (err) {
 563                         rte_panic("Failed to launch worker on core %d\n",
 564                                         lcore_id);
 565                         continue;
 566                 }
 567                 if (fdata->worker_core[lcore_id])
 568                         worker_idx++;
 569         }
 570
 571         lcore_id = rte_lcore_id();
 572
 573         if (core_in_use(lcore_id))
 574                 fdata->cap.worker(&worker_data[worker_idx++]);
 575
 576         rte_eal_mp_wait_lcore();
 577
 578         if (!cdata.quiet && (port_stat(dev_id, worker_data[0].port_id) !=
 579                         (uint64_t)-ENOTSUP)) {
 580                 printf("\nPort Workload distribution:\n");
 581                 uint32_t i;
 582                 uint64_t tot_pkts = 0;
 583                 uint64_t pkts_per_wkr[RTE_MAX_LCORE] = {0};
 584                 for (i = 0; i < cdata.num_workers; i++) {
 585                         pkts_per_wkr[i] =
 586                                 port_stat(dev_id, worker_data[i].port_id);
 587                         tot_pkts += pkts_per_wkr[i];
 588                 }
 589                 for (i = 0; i < cdata.num_workers; i++) {
 590                         float pc = pkts_per_wkr[i]  * 100 /
 591                                 ((float)tot_pkts);
 592                         printf("worker %i :\t%.1f %% (%"PRIu64" pkts)\n",
 593                                         i, pc, pkts_per_wkr[i]);
 594                 }
 595
 596         }
 597
 598         return 0;
 599 }