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 eth_tx_buffer_retry(struct rte_mbuf **pkts, uint16_t unsent,
33 int port_id = (uintptr_t) userdata;
34 unsigned int _sent = 0;
37 /* Note: hard-coded TX queue */
38 _sent += rte_eth_tx_burst(port_id, 0, &pkts[_sent],
40 } while (_sent != unsent);
44 * Parse the coremask given as argument (hexadecimal string) and fill
45 * the global configuration (core role and core count) with the parsed
48 static int xdigit2val(unsigned char c)
62 parse_coremask(const char *coremask)
65 unsigned int count = 0;
69 const int32_t BITS_HEX = 4;
73 /* Remove all blank characters ahead and after .
74 * Remove 0x/0X if exists.
76 while (isblank(*coremask))
78 if (coremask[0] == '0' && ((coremask[1] == 'x')
79 || (coremask[1] == 'X')))
82 while ((i > 0) && isblank(coremask[i - 1]))
87 for (i = i - 1; i >= 0 && idx < MAX_NUM_CORE; i--) {
89 if (isxdigit(c) == 0) {
90 /* invalid characters */
94 for (j = 0; j < BITS_HEX && idx < MAX_NUM_CORE; j++, idx++) {
102 if (coremask[i] != '0')
109 static struct option long_options[] = {
110 {"workers", required_argument, 0, 'w'},
111 {"packets", required_argument, 0, 'n'},
112 {"atomic-flows", required_argument, 0, 'f'},
113 {"num_stages", required_argument, 0, 's'},
114 {"rx-mask", required_argument, 0, 'r'},
115 {"tx-mask", required_argument, 0, 't'},
116 {"sched-mask", required_argument, 0, 'e'},
117 {"cq-depth", required_argument, 0, 'c'},
118 {"work-cycles", required_argument, 0, 'W'},
119 {"queue-priority", no_argument, 0, 'P'},
120 {"parallel", no_argument, 0, 'p'},
121 {"ordered", no_argument, 0, 'o'},
122 {"quiet", no_argument, 0, 'q'},
123 {"dump", no_argument, 0, 'D'},
130 const char *usage_str =
131 " Usage: eventdev_demo [options]\n"
133 " -n, --packets=N Send N packets (default ~32M), 0 implies no limit\n"
134 " -f, --atomic-flows=N Use N random flows from 1 to N (default 16)\n"
135 " -s, --num_stages=N Use N atomic stages (default 1)\n"
136 " -r, --rx-mask=core mask Run NIC rx on CPUs in core mask\n"
137 " -w, --worker-mask=core mask Run worker on CPUs in core mask\n"
138 " -t, --tx-mask=core mask Run NIC tx on CPUs in core mask\n"
139 " -e --sched-mask=core mask Run scheduler on CPUs in core mask\n"
140 " -c --cq-depth=N Worker CQ depth (default 16)\n"
141 " -W --work-cycles=N Worker cycles (default 0)\n"
142 " -P --queue-priority Enable scheduler queue prioritization\n"
143 " -o, --ordered Use ordered scheduling\n"
144 " -p, --parallel Use parallel scheduling\n"
145 " -q, --quiet Minimize printed output\n"
146 " -D, --dump Print detailed statistics before exit"
148 fprintf(stderr, "%s", usage_str);
153 parse_app_args(int argc, char **argv)
155 /* Parse cli options*/
159 uint64_t rx_lcore_mask = 0;
160 uint64_t tx_lcore_mask = 0;
161 uint64_t sched_lcore_mask = 0;
162 uint64_t worker_lcore_mask = 0;
166 c = getopt_long(argc, argv, "r:t:e:c:w:n:f:s:poPqDW:",
167 long_options, &option_index);
174 cdata.num_packets = (int64_t)atol(optarg);
175 if (cdata.num_packets == 0)
176 cdata.num_packets = INT64_MAX;
179 cdata.num_fids = (unsigned int)atoi(optarg);
182 cdata.num_stages = (unsigned int)atoi(optarg);
185 cdata.worker_cq_depth = (unsigned int)atoi(optarg);
188 cdata.worker_cycles = (unsigned int)atoi(optarg);
191 cdata.enable_queue_priorities = 1;
194 cdata.queue_type = RTE_SCHED_TYPE_ORDERED;
197 cdata.queue_type = RTE_SCHED_TYPE_PARALLEL;
206 worker_lcore_mask = parse_coremask(optarg);
209 rx_lcore_mask = parse_coremask(optarg);
210 popcnt = __builtin_popcountll(rx_lcore_mask);
211 fdata->rx_single = (popcnt == 1);
214 tx_lcore_mask = parse_coremask(optarg);
215 popcnt = __builtin_popcountll(tx_lcore_mask);
216 fdata->tx_single = (popcnt == 1);
219 sched_lcore_mask = parse_coremask(optarg);
220 popcnt = __builtin_popcountll(sched_lcore_mask);
221 fdata->sched_single = (popcnt == 1);
228 if (worker_lcore_mask == 0 || rx_lcore_mask == 0 ||
229 sched_lcore_mask == 0 || tx_lcore_mask == 0) {
230 printf("Core part of pipeline was not assigned any cores. "
231 "This will stall the pipeline, please check core masks "
232 "(use -h for details on setting core masks):\n"
233 "\trx: %"PRIu64"\n\ttx: %"PRIu64"\n\tsched: %"PRIu64
234 "\n\tworkers: %"PRIu64"\n",
235 rx_lcore_mask, tx_lcore_mask, sched_lcore_mask,
237 rte_exit(-1, "Fix core masks\n");
239 if (cdata.num_stages == 0 || cdata.num_stages > MAX_NUM_STAGES)
242 for (i = 0; i < MAX_NUM_CORE; i++) {
243 fdata->rx_core[i] = !!(rx_lcore_mask & (1UL << i));
244 fdata->tx_core[i] = !!(tx_lcore_mask & (1UL << i));
245 fdata->sched_core[i] = !!(sched_lcore_mask & (1UL << i));
246 fdata->worker_core[i] = !!(worker_lcore_mask & (1UL << i));
248 if (fdata->worker_core[i])
251 cdata.active_cores++;
256 * Initializes a given port using global settings and with the RX buffers
257 * coming from the mbuf_pool passed as a parameter.
260 port_init(uint8_t port, struct rte_mempool *mbuf_pool)
262 static const struct rte_eth_conf port_conf_default = {
264 .mq_mode = ETH_MQ_RX_RSS,
265 .max_rx_pkt_len = ETHER_MAX_LEN,
266 .ignore_offload_bitfield = 1,
270 .rss_hf = ETH_RSS_IP |
276 const uint16_t rx_rings = 1, tx_rings = 1;
277 const uint16_t rx_ring_size = 512, tx_ring_size = 512;
278 struct rte_eth_conf port_conf = port_conf_default;
281 struct rte_eth_dev_info dev_info;
282 struct rte_eth_txconf txconf;
284 if (port >= rte_eth_dev_count())
287 rte_eth_dev_info_get(port, &dev_info);
288 if (dev_info.tx_offload_capa & DEV_TX_OFFLOAD_MBUF_FAST_FREE)
289 port_conf.txmode.offloads |=
290 DEV_TX_OFFLOAD_MBUF_FAST_FREE;
292 /* Configure the Ethernet device. */
293 retval = rte_eth_dev_configure(port, rx_rings, tx_rings, &port_conf);
297 /* Allocate and set up 1 RX queue per Ethernet port. */
298 for (q = 0; q < rx_rings; q++) {
299 retval = rte_eth_rx_queue_setup(port, q, rx_ring_size,
300 rte_eth_dev_socket_id(port), NULL, mbuf_pool);
305 txconf = dev_info.default_txconf;
306 txconf.txq_flags = ETH_TXQ_FLAGS_IGNORE;
307 txconf.offloads = port_conf_default.txmode.offloads;
308 /* Allocate and set up 1 TX queue per Ethernet port. */
309 for (q = 0; q < tx_rings; q++) {
310 retval = rte_eth_tx_queue_setup(port, q, tx_ring_size,
311 rte_eth_dev_socket_id(port), &txconf);
316 /* Start the Ethernet port. */
317 retval = rte_eth_dev_start(port);
321 /* Display the port MAC address. */
322 struct ether_addr addr;
323 rte_eth_macaddr_get(port, &addr);
324 printf("Port %u MAC: %02" PRIx8 " %02" PRIx8 " %02" PRIx8
325 " %02" PRIx8 " %02" PRIx8 " %02" PRIx8 "\n",
327 addr.addr_bytes[0], addr.addr_bytes[1],
328 addr.addr_bytes[2], addr.addr_bytes[3],
329 addr.addr_bytes[4], addr.addr_bytes[5]);
331 /* Enable RX in promiscuous mode for the Ethernet device. */
332 rte_eth_promiscuous_enable(port);
338 init_ports(unsigned int num_ports)
343 struct rte_mempool *mp = rte_pktmbuf_pool_create("packet_pool",
344 /* mbufs */ 16384 * num_ports,
345 /* cache_size */ 512,
347 /* data_room_size */ RTE_MBUF_DEFAULT_BUF_SIZE,
350 for (portid = 0; portid < num_ports; portid++)
351 if (port_init(portid, mp) != 0)
352 rte_exit(EXIT_FAILURE, "Cannot init port %"PRIu8 "\n",
355 for (i = 0; i < num_ports; i++) {
356 void *userdata = (void *)(uintptr_t) i;
358 rte_malloc(NULL, RTE_ETH_TX_BUFFER_SIZE(32), 0);
359 if (fdata->tx_buf[i] == NULL)
360 rte_panic("Out of memory\n");
361 rte_eth_tx_buffer_init(fdata->tx_buf[i], 32);
362 rte_eth_tx_buffer_set_err_callback(fdata->tx_buf[i],
371 do_capability_setup(uint16_t nb_ethdev, uint8_t eventdev_id)
373 RTE_SET_USED(nb_ethdev);
374 RTE_SET_USED(eventdev_id);
375 set_worker_generic_setup_data(&fdata->cap, 1);
379 signal_handler(int signum)
382 rte_exit(1, "Exiting on signal %d\n", signum);
383 if (signum == SIGINT || signum == SIGTERM) {
384 printf("\n\nSignal %d received, preparing to exit...\n",
388 if (signum == SIGTSTP)
389 rte_event_dev_dump(0, stdout);
392 static inline uint64_t
393 port_stat(int dev_id, int32_t p)
396 snprintf(statname, sizeof(statname), "port_%u_rx", p);
397 return rte_event_dev_xstats_by_name_get(dev_id, statname, NULL);
401 main(int argc, char **argv)
403 struct worker_data *worker_data;
404 unsigned int num_ports;
408 signal(SIGINT, signal_handler);
409 signal(SIGTERM, signal_handler);
410 signal(SIGTSTP, signal_handler);
412 err = rte_eal_init(argc, argv);
414 rte_panic("Invalid EAL arguments\n");
419 fdata = rte_malloc(NULL, sizeof(struct fastpath_data), 0);
421 rte_panic("Out of memory\n");
423 /* Parse cli options*/
424 parse_app_args(argc, argv);
426 num_ports = rte_eth_dev_count();
428 rte_panic("No ethernet ports found\n");
430 const unsigned int cores_needed = cdata.active_cores;
433 printf(" Config:\n");
434 printf("\tports: %u\n", num_ports);
435 printf("\tworkers: %u\n", cdata.num_workers);
436 printf("\tpackets: %"PRIi64"\n", cdata.num_packets);
437 printf("\tQueue-prio: %u\n", cdata.enable_queue_priorities);
438 if (cdata.queue_type == RTE_SCHED_TYPE_ORDERED)
439 printf("\tqid0 type: ordered\n");
440 if (cdata.queue_type == RTE_SCHED_TYPE_ATOMIC)
441 printf("\tqid0 type: atomic\n");
442 printf("\tCores available: %u\n", rte_lcore_count());
443 printf("\tCores used: %u\n", cores_needed);
446 if (rte_lcore_count() < cores_needed)
447 rte_panic("Too few cores (%d < %d)\n", rte_lcore_count(),
450 const unsigned int ndevs = rte_event_dev_count();
452 rte_panic("No dev_id devs found. Pasl in a --vdev eventdev.\n");
454 fprintf(stderr, "Warning: More than one eventdev, using idx 0");
457 do_capability_setup(num_ports, 0);
458 fdata->cap.check_opt();
460 worker_data = rte_calloc(0, cdata.num_workers,
461 sizeof(worker_data[0]), 0);
462 if (worker_data == NULL)
463 rte_panic("rte_calloc failed\n");
465 int dev_id = fdata->cap.evdev_setup(&cons_data, worker_data);
467 rte_exit(EXIT_FAILURE, "Error setting up eventdev\n");
469 init_ports(num_ports);
470 fdata->cap.adptr_setup(num_ports);
473 RTE_LCORE_FOREACH_SLAVE(lcore_id) {
474 if (lcore_id >= MAX_NUM_CORE)
477 if (!fdata->rx_core[lcore_id] &&
478 !fdata->worker_core[lcore_id] &&
479 !fdata->tx_core[lcore_id] &&
480 !fdata->sched_core[lcore_id])
483 if (fdata->rx_core[lcore_id])
485 "[%s()] lcore %d executing NIC Rx\n",
488 if (fdata->tx_core[lcore_id])
490 "[%s()] lcore %d executing NIC Tx, and using eventdev port %u\n",
491 __func__, lcore_id, cons_data.port_id);
493 if (fdata->sched_core[lcore_id])
494 printf("[%s()] lcore %d executing scheduler\n",
497 if (fdata->worker_core[lcore_id])
499 "[%s()] lcore %d executing worker, using eventdev port %u\n",
501 worker_data[worker_idx].port_id);
503 err = rte_eal_remote_launch(fdata->cap.worker,
504 &worker_data[worker_idx], lcore_id);
506 rte_panic("Failed to launch worker on core %d\n",
510 if (fdata->worker_core[lcore_id])
514 lcore_id = rte_lcore_id();
516 if (core_in_use(lcore_id))
517 fdata->cap.worker(&worker_data[worker_idx++]);
519 rte_eal_mp_wait_lcore();
522 rte_event_dev_dump(dev_id, stdout);
524 if (!cdata.quiet && (port_stat(dev_id, worker_data[0].port_id) !=
525 (uint64_t)-ENOTSUP)) {
526 printf("\nPort Workload distribution:\n");
528 uint64_t tot_pkts = 0;
529 uint64_t pkts_per_wkr[RTE_MAX_LCORE] = {0};
530 for (i = 0; i < cdata.num_workers; i++) {
532 port_stat(dev_id, worker_data[i].port_id);
533 tot_pkts += pkts_per_wkr[i];
535 for (i = 0; i < cdata.num_workers; i++) {
536 float pc = pkts_per_wkr[i] * 100 /
538 printf("worker %i :\t%.1f %% (%"PRIu64" pkts)\n",
539 i, pc, pkts_per_wkr[i]);