1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2016-2017 Intel Corporation
11 #include "pipeline_common.h"
13 struct config_data cdata = {
14 .num_packets = (1L << 25), /* do ~32M packets */
16 .queue_type = RTE_SCHED_TYPE_ATOMIC,
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]);
30 * Parse the coremask given as argument (hexadecimal string) and fill
31 * the global configuration (core role and core count) with the parsed
34 static int xdigit2val(unsigned char c)
48 parse_coremask(const char *coremask)
51 unsigned int count = 0;
55 const int32_t BITS_HEX = 4;
59 /* Remove all blank characters ahead and after .
60 * Remove 0x/0X if exists.
62 while (isblank(*coremask))
64 if (coremask[0] == '0' && ((coremask[1] == 'x')
65 || (coremask[1] == 'X')))
68 while ((i > 0) && isblank(coremask[i - 1]))
73 for (i = i - 1; i >= 0 && idx < MAX_NUM_CORE; i--) {
75 if (isxdigit(c) == 0) {
76 /* invalid characters */
80 for (j = 0; j < BITS_HEX && idx < MAX_NUM_CORE; j++, idx++) {
88 if (coremask[i] != '0')
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'},
118 const char *usage_str =
119 " Usage: eventdev_demo [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"
138 fprintf(stderr, "%s", usage_str);
143 parse_app_args(int argc, char **argv)
145 /* Parse cli options*/
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;
156 c = getopt_long(argc, argv, "r:t:e:c:w:n:f:s:m:paoPqDW:",
157 long_options, &option_index);
164 cdata.num_packets = (int64_t)atol(optarg);
165 if (cdata.num_packets == 0)
166 cdata.num_packets = INT64_MAX;
169 cdata.num_fids = (unsigned int)atoi(optarg);
172 cdata.num_stages = (unsigned int)atoi(optarg);
175 cdata.worker_cq_depth = (unsigned int)atoi(optarg);
178 cdata.worker_cycles = (unsigned int)atoi(optarg);
181 cdata.enable_queue_priorities = 1;
184 cdata.queue_type = RTE_SCHED_TYPE_ORDERED;
187 cdata.queue_type = RTE_SCHED_TYPE_PARALLEL;
190 cdata.all_type_queues = 1;
199 worker_lcore_mask = parse_coremask(optarg);
202 rx_lcore_mask = parse_coremask(optarg);
203 popcnt = __builtin_popcountll(rx_lcore_mask);
204 fdata->rx_single = (popcnt == 1);
207 tx_lcore_mask = parse_coremask(optarg);
208 popcnt = __builtin_popcountll(tx_lcore_mask);
209 fdata->tx_single = (popcnt == 1);
212 sched_lcore_mask = parse_coremask(optarg);
213 popcnt = __builtin_popcountll(sched_lcore_mask);
214 fdata->sched_single = (popcnt == 1);
217 cdata.num_mbuf = (uint64_t)atol(optarg);
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;
229 if (cdata.num_stages == 0 || cdata.num_stages > MAX_NUM_STAGES)
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));
238 if (fdata->worker_core[i])
241 cdata.active_cores++;
246 * Initializes a given port using global settings and with the RX buffers
247 * coming from the mbuf_pool passed as a parameter.
250 port_init(uint8_t port, struct rte_mempool *mbuf_pool)
252 struct rte_eth_rxconf rx_conf;
253 static const struct rte_eth_conf port_conf_default = {
255 .mq_mode = ETH_MQ_RX_RSS,
256 .max_rx_pkt_len = RTE_ETHER_MAX_LEN,
260 .rss_hf = ETH_RSS_IP |
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;
271 struct rte_eth_dev_info dev_info;
272 struct rte_eth_txconf txconf;
274 if (!rte_eth_dev_is_valid_port(port))
277 retval = rte_eth_dev_info_get(port, &dev_info);
279 printf("Error during getting device (port %u) info: %s\n",
280 port, strerror(-retval));
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;
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",
297 port_conf_default.rx_adv_conf.rss_conf.rss_hf,
298 port_conf.rx_adv_conf.rss_conf.rss_hf);
301 /* Configure the Ethernet device. */
302 retval = rte_eth_dev_configure(port, rx_rings, tx_rings, &port_conf);
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,
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);
325 /* Display the port MAC address. */
326 struct rte_ether_addr addr;
327 retval = rte_eth_macaddr_get(port, &addr);
329 printf("Failed to get MAC address (port %u): %s\n",
330 port, rte_strerror(-retval));
334 printf("Port %u MAC: %02" PRIx8 " %02" PRIx8 " %02" PRIx8
335 " %02" PRIx8 " %02" PRIx8 " %02" PRIx8 "\n",
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]);
341 /* Enable RX in promiscuous mode for the Ethernet device. */
342 retval = rte_eth_promiscuous_enable(port);
350 init_ports(uint16_t num_ports)
355 cdata.num_mbuf = 16384 * num_ports;
357 struct rte_mempool *mp = rte_pktmbuf_pool_create("packet_pool",
358 /* mbufs */ cdata.num_mbuf,
359 /* cache_size */ 512,
361 /* data_room_size */ RTE_MBUF_DEFAULT_BUF_SIZE,
364 RTE_ETH_FOREACH_DEV(portid)
365 if (port_init(portid, mp) != 0)
366 rte_exit(EXIT_FAILURE, "Cannot init port %"PRIu16 "\n",
373 do_capability_setup(uint8_t eventdev_id)
377 uint8_t generic_pipeline = 0;
380 RTE_ETH_FOREACH_DEV(i) {
383 ret = rte_event_eth_tx_adapter_caps_get(eventdev_id, i, &caps);
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);
391 struct rte_event_dev_info eventdev_info;
392 memset(&eventdev_info, 0, sizeof(struct rte_event_dev_info));
394 rte_event_dev_info_get(eventdev_id, &eventdev_info);
395 burst = eventdev_info.event_dev_cap & RTE_EVENT_DEV_CAP_BURST_MODE ? 1 :
398 if (generic_pipeline)
399 set_worker_generic_setup_data(&fdata->cap, burst);
401 set_worker_tx_enq_setup_data(&fdata->cap, burst);
405 signal_handler(int signum)
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",
416 rte_event_dev_dump(0, stdout);
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);
427 rte_eal_mp_wait_lcore();
429 RTE_ETH_FOREACH_DEV(portid) {
430 rte_eth_dev_close(portid);
433 rte_event_dev_stop(0);
434 rte_event_dev_close(0);
436 if (signum == SIGTSTP)
437 rte_event_dev_dump(0, stdout);
440 static inline uint64_t
441 port_stat(int dev_id, int32_t p)
444 snprintf(statname, sizeof(statname), "port_%u_rx", p);
445 return rte_event_dev_xstats_by_name_get(dev_id, statname, NULL);
449 main(int argc, char **argv)
451 struct worker_data *worker_data;
457 signal(SIGINT, signal_handler);
458 signal(SIGTERM, signal_handler);
459 signal(SIGTSTP, signal_handler);
461 err = rte_eal_init(argc, argv);
463 rte_panic("Invalid EAL arguments\n");
468 fdata = rte_malloc(NULL, sizeof(struct fastpath_data), 0);
470 rte_panic("Out of memory\n");
472 /* Parse cli options*/
473 parse_app_args(argc, argv);
475 num_ports = rte_eth_dev_count_avail();
477 rte_panic("No ethernet ports found\n");
479 const unsigned int cores_needed = cdata.active_cores;
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);
495 if (rte_lcore_count() < cores_needed)
496 rte_panic("Too few cores (%d < %d)\n", rte_lcore_count(),
499 const unsigned int ndevs = rte_event_dev_count();
501 rte_panic("No dev_id devs found. Pasl in a --vdev eventdev.\n");
503 fprintf(stderr, "Warning: More than one eventdev, using idx 0");
506 do_capability_setup(0);
507 fdata->cap.check_opt();
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");
514 int dev_id = fdata->cap.evdev_setup(worker_data);
516 rte_exit(EXIT_FAILURE, "Error setting up eventdev\n");
518 init_ports(num_ports);
519 fdata->cap.adptr_setup(num_ports);
521 /* Start the Ethernet port. */
522 RTE_ETH_FOREACH_DEV(portid) {
523 err = rte_eth_dev_start(portid);
525 rte_exit(EXIT_FAILURE, "Error starting ethdev %d\n",
530 RTE_LCORE_FOREACH_SLAVE(lcore_id) {
531 if (lcore_id >= MAX_NUM_CORE)
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])
540 if (fdata->rx_core[lcore_id])
542 "[%s()] lcore %d executing NIC Rx\n",
545 if (fdata->tx_core[lcore_id])
547 "[%s()] lcore %d executing NIC Tx\n",
550 if (fdata->sched_core[lcore_id])
551 printf("[%s()] lcore %d executing scheduler\n",
554 if (fdata->worker_core[lcore_id])
556 "[%s()] lcore %d executing worker, using eventdev port %u\n",
558 worker_data[worker_idx].port_id);
560 err = rte_eal_remote_launch(fdata->cap.worker,
561 &worker_data[worker_idx], lcore_id);
563 rte_panic("Failed to launch worker on core %d\n",
567 if (fdata->worker_core[lcore_id])
571 lcore_id = rte_lcore_id();
573 if (core_in_use(lcore_id))
574 fdata->cap.worker(&worker_data[worker_idx++]);
576 rte_eal_mp_wait_lcore();
578 if (!cdata.quiet && (port_stat(dev_id, worker_data[0].port_id) !=
579 (uint64_t)-ENOTSUP)) {
580 printf("\nPort Workload distribution:\n");
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++) {
586 port_stat(dev_id, worker_data[i].port_id);
587 tot_pkts += pkts_per_wkr[i];
589 for (i = 0; i < cdata.num_workers; i++) {
590 float pc = pkts_per_wkr[i] * 100 /
592 printf("worker %i :\t%.1f %% (%"PRIu64" pkts)\n",
593 i, pc, pkts_per_wkr[i]);