xref: /dpdk/examples/l2fwd/main.c (revision daa02b5cddbb8e11b31d41e2bf7bb1ae64dcae2f)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2010-2016 Intel Corporation
3  */
4 
5 #include <stdio.h>
6 #include <stdlib.h>
7 #include <string.h>
8 #include <stdint.h>
9 #include <inttypes.h>
10 #include <sys/types.h>
11 #include <sys/queue.h>
12 #include <setjmp.h>
13 #include <stdarg.h>
14 #include <ctype.h>
15 #include <errno.h>
16 #include <getopt.h>
17 #include <signal.h>
18 #include <stdbool.h>
19 
20 #include <rte_common.h>
21 #include <rte_log.h>
22 #include <rte_malloc.h>
23 #include <rte_memory.h>
24 #include <rte_memcpy.h>
25 #include <rte_eal.h>
26 #include <rte_launch.h>
27 #include <rte_cycles.h>
28 #include <rte_prefetch.h>
29 #include <rte_lcore.h>
30 #include <rte_per_lcore.h>
31 #include <rte_branch_prediction.h>
32 #include <rte_interrupts.h>
33 #include <rte_random.h>
34 #include <rte_debug.h>
35 #include <rte_ether.h>
36 #include <rte_ethdev.h>
37 #include <rte_mempool.h>
38 #include <rte_mbuf.h>
39 #include <rte_string_fns.h>
40 
41 static volatile bool force_quit;
42 
43 /* MAC updating enabled by default */
44 static int mac_updating = 1;
45 
46 #define RTE_LOGTYPE_L2FWD RTE_LOGTYPE_USER1
47 
48 #define MAX_PKT_BURST 32
49 #define BURST_TX_DRAIN_US 100 /* TX drain every ~100us */
50 #define MEMPOOL_CACHE_SIZE 256
51 
52 /*
53  * Configurable number of RX/TX ring descriptors
54  */
55 #define RTE_TEST_RX_DESC_DEFAULT 1024
56 #define RTE_TEST_TX_DESC_DEFAULT 1024
57 static uint16_t nb_rxd = RTE_TEST_RX_DESC_DEFAULT;
58 static uint16_t nb_txd = RTE_TEST_TX_DESC_DEFAULT;
59 
60 /* ethernet addresses of ports */
61 static struct rte_ether_addr l2fwd_ports_eth_addr[RTE_MAX_ETHPORTS];
62 
63 /* mask of enabled ports */
64 static uint32_t l2fwd_enabled_port_mask = 0;
65 
66 /* list of enabled ports */
67 static uint32_t l2fwd_dst_ports[RTE_MAX_ETHPORTS];
68 
69 struct port_pair_params {
70 #define NUM_PORTS	2
71 	uint16_t port[NUM_PORTS];
72 } __rte_cache_aligned;
73 
74 static struct port_pair_params port_pair_params_array[RTE_MAX_ETHPORTS / 2];
75 static struct port_pair_params *port_pair_params;
76 static uint16_t nb_port_pair_params;
77 
78 static unsigned int l2fwd_rx_queue_per_lcore = 1;
79 
80 #define MAX_RX_QUEUE_PER_LCORE 16
81 #define MAX_TX_QUEUE_PER_PORT 16
82 /* List of queues to be polled for a given lcore. 8< */
83 struct lcore_queue_conf {
84 	unsigned n_rx_port;
85 	unsigned rx_port_list[MAX_RX_QUEUE_PER_LCORE];
86 } __rte_cache_aligned;
87 struct lcore_queue_conf lcore_queue_conf[RTE_MAX_LCORE];
88 /* >8 End of list of queues to be polled for a given lcore. */
89 
90 static struct rte_eth_dev_tx_buffer *tx_buffer[RTE_MAX_ETHPORTS];
91 
92 static struct rte_eth_conf port_conf = {
93 	.rxmode = {
94 		.split_hdr_size = 0,
95 	},
96 	.txmode = {
97 		.mq_mode = RTE_ETH_MQ_TX_NONE,
98 	},
99 };
100 
101 struct rte_mempool * l2fwd_pktmbuf_pool = NULL;
102 
103 /* Per-port statistics struct */
104 struct l2fwd_port_statistics {
105 	uint64_t tx;
106 	uint64_t rx;
107 	uint64_t dropped;
108 } __rte_cache_aligned;
109 struct l2fwd_port_statistics port_statistics[RTE_MAX_ETHPORTS];
110 
111 #define MAX_TIMER_PERIOD 86400 /* 1 day max */
112 /* A tsc-based timer responsible for triggering statistics printout */
113 static uint64_t timer_period = 10; /* default period is 10 seconds */
114 
115 /* Print out statistics on packets dropped */
116 static void
117 print_stats(void)
118 {
119 	uint64_t total_packets_dropped, total_packets_tx, total_packets_rx;
120 	unsigned portid;
121 
122 	total_packets_dropped = 0;
123 	total_packets_tx = 0;
124 	total_packets_rx = 0;
125 
126 	const char clr[] = { 27, '[', '2', 'J', '\0' };
127 	const char topLeft[] = { 27, '[', '1', ';', '1', 'H','\0' };
128 
129 		/* Clear screen and move to top left */
130 	printf("%s%s", clr, topLeft);
131 
132 	printf("\nPort statistics ====================================");
133 
134 	for (portid = 0; portid < RTE_MAX_ETHPORTS; portid++) {
135 		/* skip disabled ports */
136 		if ((l2fwd_enabled_port_mask & (1 << portid)) == 0)
137 			continue;
138 		printf("\nStatistics for port %u ------------------------------"
139 			   "\nPackets sent: %24"PRIu64
140 			   "\nPackets received: %20"PRIu64
141 			   "\nPackets dropped: %21"PRIu64,
142 			   portid,
143 			   port_statistics[portid].tx,
144 			   port_statistics[portid].rx,
145 			   port_statistics[portid].dropped);
146 
147 		total_packets_dropped += port_statistics[portid].dropped;
148 		total_packets_tx += port_statistics[portid].tx;
149 		total_packets_rx += port_statistics[portid].rx;
150 	}
151 	printf("\nAggregate statistics ==============================="
152 		   "\nTotal packets sent: %18"PRIu64
153 		   "\nTotal packets received: %14"PRIu64
154 		   "\nTotal packets dropped: %15"PRIu64,
155 		   total_packets_tx,
156 		   total_packets_rx,
157 		   total_packets_dropped);
158 	printf("\n====================================================\n");
159 
160 	fflush(stdout);
161 }
162 
163 static void
164 l2fwd_mac_updating(struct rte_mbuf *m, unsigned dest_portid)
165 {
166 	struct rte_ether_hdr *eth;
167 	void *tmp;
168 
169 	eth = rte_pktmbuf_mtod(m, struct rte_ether_hdr *);
170 
171 	/* 02:00:00:00:00:xx */
172 	tmp = &eth->dst_addr.addr_bytes[0];
173 	*((uint64_t *)tmp) = 0x000000000002 + ((uint64_t)dest_portid << 40);
174 
175 	/* src addr */
176 	rte_ether_addr_copy(&l2fwd_ports_eth_addr[dest_portid], &eth->src_addr);
177 }
178 
179 /* Simple forward. 8< */
180 static void
181 l2fwd_simple_forward(struct rte_mbuf *m, unsigned portid)
182 {
183 	unsigned dst_port;
184 	int sent;
185 	struct rte_eth_dev_tx_buffer *buffer;
186 
187 	dst_port = l2fwd_dst_ports[portid];
188 
189 	if (mac_updating)
190 		l2fwd_mac_updating(m, dst_port);
191 
192 	buffer = tx_buffer[dst_port];
193 	sent = rte_eth_tx_buffer(dst_port, 0, buffer, m);
194 	if (sent)
195 		port_statistics[dst_port].tx += sent;
196 }
197 /* >8 End of simple forward. */
198 
199 /* main processing loop */
200 static void
201 l2fwd_main_loop(void)
202 {
203 	struct rte_mbuf *pkts_burst[MAX_PKT_BURST];
204 	struct rte_mbuf *m;
205 	int sent;
206 	unsigned lcore_id;
207 	uint64_t prev_tsc, diff_tsc, cur_tsc, timer_tsc;
208 	unsigned i, j, portid, nb_rx;
209 	struct lcore_queue_conf *qconf;
210 	const uint64_t drain_tsc = (rte_get_tsc_hz() + US_PER_S - 1) / US_PER_S *
211 			BURST_TX_DRAIN_US;
212 	struct rte_eth_dev_tx_buffer *buffer;
213 
214 	prev_tsc = 0;
215 	timer_tsc = 0;
216 
217 	lcore_id = rte_lcore_id();
218 	qconf = &lcore_queue_conf[lcore_id];
219 
220 	if (qconf->n_rx_port == 0) {
221 		RTE_LOG(INFO, L2FWD, "lcore %u has nothing to do\n", lcore_id);
222 		return;
223 	}
224 
225 	RTE_LOG(INFO, L2FWD, "entering main loop on lcore %u\n", lcore_id);
226 
227 	for (i = 0; i < qconf->n_rx_port; i++) {
228 
229 		portid = qconf->rx_port_list[i];
230 		RTE_LOG(INFO, L2FWD, " -- lcoreid=%u portid=%u\n", lcore_id,
231 			portid);
232 
233 	}
234 
235 	while (!force_quit) {
236 
237 		/* Drains TX queue in its main loop. 8< */
238 		cur_tsc = rte_rdtsc();
239 
240 		/*
241 		 * TX burst queue drain
242 		 */
243 		diff_tsc = cur_tsc - prev_tsc;
244 		if (unlikely(diff_tsc > drain_tsc)) {
245 
246 			for (i = 0; i < qconf->n_rx_port; i++) {
247 
248 				portid = l2fwd_dst_ports[qconf->rx_port_list[i]];
249 				buffer = tx_buffer[portid];
250 
251 				sent = rte_eth_tx_buffer_flush(portid, 0, buffer);
252 				if (sent)
253 					port_statistics[portid].tx += sent;
254 
255 			}
256 
257 			/* if timer is enabled */
258 			if (timer_period > 0) {
259 
260 				/* advance the timer */
261 				timer_tsc += diff_tsc;
262 
263 				/* if timer has reached its timeout */
264 				if (unlikely(timer_tsc >= timer_period)) {
265 
266 					/* do this only on main core */
267 					if (lcore_id == rte_get_main_lcore()) {
268 						print_stats();
269 						/* reset the timer */
270 						timer_tsc = 0;
271 					}
272 				}
273 			}
274 
275 			prev_tsc = cur_tsc;
276 		}
277 		/* >8 End of draining TX queue. */
278 
279 		/* Read packet from RX queues. 8< */
280 		for (i = 0; i < qconf->n_rx_port; i++) {
281 
282 			portid = qconf->rx_port_list[i];
283 			nb_rx = rte_eth_rx_burst(portid, 0,
284 						 pkts_burst, MAX_PKT_BURST);
285 
286 			port_statistics[portid].rx += nb_rx;
287 
288 			for (j = 0; j < nb_rx; j++) {
289 				m = pkts_burst[j];
290 				rte_prefetch0(rte_pktmbuf_mtod(m, void *));
291 				l2fwd_simple_forward(m, portid);
292 			}
293 		}
294 		/* >8 End of read packet from RX queues. */
295 	}
296 }
297 
298 static int
299 l2fwd_launch_one_lcore(__rte_unused void *dummy)
300 {
301 	l2fwd_main_loop();
302 	return 0;
303 }
304 
305 /* display usage */
306 static void
307 l2fwd_usage(const char *prgname)
308 {
309 	printf("%s [EAL options] -- -p PORTMASK [-q NQ]\n"
310 	       "  -p PORTMASK: hexadecimal bitmask of ports to configure\n"
311 	       "  -q NQ: number of queue (=ports) per lcore (default is 1)\n"
312 	       "  -T PERIOD: statistics will be refreshed each PERIOD seconds (0 to disable, 10 default, 86400 maximum)\n"
313 	       "  --no-mac-updating: Disable MAC addresses updating (enabled by default)\n"
314 	       "      When enabled:\n"
315 	       "       - The source MAC address is replaced by the TX port MAC address\n"
316 	       "       - The destination MAC address is replaced by 02:00:00:00:00:TX_PORT_ID\n"
317 	       "  --portmap: Configure forwarding port pair mapping\n"
318 	       "	      Default: alternate port pairs\n\n",
319 	       prgname);
320 }
321 
322 static int
323 l2fwd_parse_portmask(const char *portmask)
324 {
325 	char *end = NULL;
326 	unsigned long pm;
327 
328 	/* parse hexadecimal string */
329 	pm = strtoul(portmask, &end, 16);
330 	if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
331 		return 0;
332 
333 	return pm;
334 }
335 
336 static int
337 l2fwd_parse_port_pair_config(const char *q_arg)
338 {
339 	enum fieldnames {
340 		FLD_PORT1 = 0,
341 		FLD_PORT2,
342 		_NUM_FLD
343 	};
344 	unsigned long int_fld[_NUM_FLD];
345 	const char *p, *p0 = q_arg;
346 	char *str_fld[_NUM_FLD];
347 	unsigned int size;
348 	char s[256];
349 	char *end;
350 	int i;
351 
352 	nb_port_pair_params = 0;
353 
354 	while ((p = strchr(p0, '(')) != NULL) {
355 		++p;
356 		p0 = strchr(p, ')');
357 		if (p0 == NULL)
358 			return -1;
359 
360 		size = p0 - p;
361 		if (size >= sizeof(s))
362 			return -1;
363 
364 		memcpy(s, p, size);
365 		s[size] = '\0';
366 		if (rte_strsplit(s, sizeof(s), str_fld,
367 				 _NUM_FLD, ',') != _NUM_FLD)
368 			return -1;
369 		for (i = 0; i < _NUM_FLD; i++) {
370 			errno = 0;
371 			int_fld[i] = strtoul(str_fld[i], &end, 0);
372 			if (errno != 0 || end == str_fld[i] ||
373 			    int_fld[i] >= RTE_MAX_ETHPORTS)
374 				return -1;
375 		}
376 		if (nb_port_pair_params >= RTE_MAX_ETHPORTS/2) {
377 			printf("exceeded max number of port pair params: %hu\n",
378 				nb_port_pair_params);
379 			return -1;
380 		}
381 		port_pair_params_array[nb_port_pair_params].port[0] =
382 				(uint16_t)int_fld[FLD_PORT1];
383 		port_pair_params_array[nb_port_pair_params].port[1] =
384 				(uint16_t)int_fld[FLD_PORT2];
385 		++nb_port_pair_params;
386 	}
387 	port_pair_params = port_pair_params_array;
388 	return 0;
389 }
390 
391 static unsigned int
392 l2fwd_parse_nqueue(const char *q_arg)
393 {
394 	char *end = NULL;
395 	unsigned long n;
396 
397 	/* parse hexadecimal string */
398 	n = strtoul(q_arg, &end, 10);
399 	if ((q_arg[0] == '\0') || (end == NULL) || (*end != '\0'))
400 		return 0;
401 	if (n == 0)
402 		return 0;
403 	if (n >= MAX_RX_QUEUE_PER_LCORE)
404 		return 0;
405 
406 	return n;
407 }
408 
409 static int
410 l2fwd_parse_timer_period(const char *q_arg)
411 {
412 	char *end = NULL;
413 	int n;
414 
415 	/* parse number string */
416 	n = strtol(q_arg, &end, 10);
417 	if ((q_arg[0] == '\0') || (end == NULL) || (*end != '\0'))
418 		return -1;
419 	if (n >= MAX_TIMER_PERIOD)
420 		return -1;
421 
422 	return n;
423 }
424 
425 static const char short_options[] =
426 	"p:"  /* portmask */
427 	"q:"  /* number of queues */
428 	"T:"  /* timer period */
429 	;
430 
431 #define CMD_LINE_OPT_NO_MAC_UPDATING "no-mac-updating"
432 #define CMD_LINE_OPT_PORTMAP_CONFIG "portmap"
433 
434 enum {
435 	/* long options mapped to a short option */
436 
437 	/* first long only option value must be >= 256, so that we won't
438 	 * conflict with short options */
439 	CMD_LINE_OPT_NO_MAC_UPDATING_NUM = 256,
440 	CMD_LINE_OPT_PORTMAP_NUM,
441 };
442 
443 static const struct option lgopts[] = {
444 	{ CMD_LINE_OPT_NO_MAC_UPDATING, no_argument, 0,
445 		CMD_LINE_OPT_NO_MAC_UPDATING_NUM},
446 	{ CMD_LINE_OPT_PORTMAP_CONFIG, 1, 0, CMD_LINE_OPT_PORTMAP_NUM},
447 	{NULL, 0, 0, 0}
448 };
449 
450 /* Parse the argument given in the command line of the application */
451 static int
452 l2fwd_parse_args(int argc, char **argv)
453 {
454 	int opt, ret, timer_secs;
455 	char **argvopt;
456 	int option_index;
457 	char *prgname = argv[0];
458 
459 	argvopt = argv;
460 	port_pair_params = NULL;
461 
462 	while ((opt = getopt_long(argc, argvopt, short_options,
463 				  lgopts, &option_index)) != EOF) {
464 
465 		switch (opt) {
466 		/* portmask */
467 		case 'p':
468 			l2fwd_enabled_port_mask = l2fwd_parse_portmask(optarg);
469 			if (l2fwd_enabled_port_mask == 0) {
470 				printf("invalid portmask\n");
471 				l2fwd_usage(prgname);
472 				return -1;
473 			}
474 			break;
475 
476 		/* nqueue */
477 		case 'q':
478 			l2fwd_rx_queue_per_lcore = l2fwd_parse_nqueue(optarg);
479 			if (l2fwd_rx_queue_per_lcore == 0) {
480 				printf("invalid queue number\n");
481 				l2fwd_usage(prgname);
482 				return -1;
483 			}
484 			break;
485 
486 		/* timer period */
487 		case 'T':
488 			timer_secs = l2fwd_parse_timer_period(optarg);
489 			if (timer_secs < 0) {
490 				printf("invalid timer period\n");
491 				l2fwd_usage(prgname);
492 				return -1;
493 			}
494 			timer_period = timer_secs;
495 			break;
496 
497 		/* long options */
498 		case CMD_LINE_OPT_PORTMAP_NUM:
499 			ret = l2fwd_parse_port_pair_config(optarg);
500 			if (ret) {
501 				fprintf(stderr, "Invalid config\n");
502 				l2fwd_usage(prgname);
503 				return -1;
504 			}
505 			break;
506 
507 		case CMD_LINE_OPT_NO_MAC_UPDATING_NUM:
508 			mac_updating = 0;
509 			break;
510 
511 		default:
512 			l2fwd_usage(prgname);
513 			return -1;
514 		}
515 	}
516 
517 	if (optind >= 0)
518 		argv[optind-1] = prgname;
519 
520 	ret = optind-1;
521 	optind = 1; /* reset getopt lib */
522 	return ret;
523 }
524 
525 /*
526  * Check port pair config with enabled port mask,
527  * and for valid port pair combinations.
528  */
529 static int
530 check_port_pair_config(void)
531 {
532 	uint32_t port_pair_config_mask = 0;
533 	uint32_t port_pair_mask = 0;
534 	uint16_t index, i, portid;
535 
536 	for (index = 0; index < nb_port_pair_params; index++) {
537 		port_pair_mask = 0;
538 
539 		for (i = 0; i < NUM_PORTS; i++)  {
540 			portid = port_pair_params[index].port[i];
541 			if ((l2fwd_enabled_port_mask & (1 << portid)) == 0) {
542 				printf("port %u is not enabled in port mask\n",
543 				       portid);
544 				return -1;
545 			}
546 			if (!rte_eth_dev_is_valid_port(portid)) {
547 				printf("port %u is not present on the board\n",
548 				       portid);
549 				return -1;
550 			}
551 
552 			port_pair_mask |= 1 << portid;
553 		}
554 
555 		if (port_pair_config_mask & port_pair_mask) {
556 			printf("port %u is used in other port pairs\n", portid);
557 			return -1;
558 		}
559 		port_pair_config_mask |= port_pair_mask;
560 	}
561 
562 	l2fwd_enabled_port_mask &= port_pair_config_mask;
563 
564 	return 0;
565 }
566 
567 /* Check the link status of all ports in up to 9s, and print them finally */
568 static void
569 check_all_ports_link_status(uint32_t port_mask)
570 {
571 #define CHECK_INTERVAL 100 /* 100ms */
572 #define MAX_CHECK_TIME 90 /* 9s (90 * 100ms) in total */
573 	uint16_t portid;
574 	uint8_t count, all_ports_up, print_flag = 0;
575 	struct rte_eth_link link;
576 	int ret;
577 	char link_status_text[RTE_ETH_LINK_MAX_STR_LEN];
578 
579 	printf("\nChecking link status");
580 	fflush(stdout);
581 	for (count = 0; count <= MAX_CHECK_TIME; count++) {
582 		if (force_quit)
583 			return;
584 		all_ports_up = 1;
585 		RTE_ETH_FOREACH_DEV(portid) {
586 			if (force_quit)
587 				return;
588 			if ((port_mask & (1 << portid)) == 0)
589 				continue;
590 			memset(&link, 0, sizeof(link));
591 			ret = rte_eth_link_get_nowait(portid, &link);
592 			if (ret < 0) {
593 				all_ports_up = 0;
594 				if (print_flag == 1)
595 					printf("Port %u link get failed: %s\n",
596 						portid, rte_strerror(-ret));
597 				continue;
598 			}
599 			/* print link status if flag set */
600 			if (print_flag == 1) {
601 				rte_eth_link_to_str(link_status_text,
602 					sizeof(link_status_text), &link);
603 				printf("Port %d %s\n", portid,
604 				       link_status_text);
605 				continue;
606 			}
607 			/* clear all_ports_up flag if any link down */
608 			if (link.link_status == RTE_ETH_LINK_DOWN) {
609 				all_ports_up = 0;
610 				break;
611 			}
612 		}
613 		/* after finally printing all link status, get out */
614 		if (print_flag == 1)
615 			break;
616 
617 		if (all_ports_up == 0) {
618 			printf(".");
619 			fflush(stdout);
620 			rte_delay_ms(CHECK_INTERVAL);
621 		}
622 
623 		/* set the print_flag if all ports up or timeout */
624 		if (all_ports_up == 1 || count == (MAX_CHECK_TIME - 1)) {
625 			print_flag = 1;
626 			printf("done\n");
627 		}
628 	}
629 }
630 
631 static void
632 signal_handler(int signum)
633 {
634 	if (signum == SIGINT || signum == SIGTERM) {
635 		printf("\n\nSignal %d received, preparing to exit...\n",
636 				signum);
637 		force_quit = true;
638 	}
639 }
640 
641 int
642 main(int argc, char **argv)
643 {
644 	struct lcore_queue_conf *qconf;
645 	int ret;
646 	uint16_t nb_ports;
647 	uint16_t nb_ports_available = 0;
648 	uint16_t portid, last_port;
649 	unsigned lcore_id, rx_lcore_id;
650 	unsigned nb_ports_in_mask = 0;
651 	unsigned int nb_lcores = 0;
652 	unsigned int nb_mbufs;
653 
654 	/* Init EAL. 8< */
655 	ret = rte_eal_init(argc, argv);
656 	if (ret < 0)
657 		rte_exit(EXIT_FAILURE, "Invalid EAL arguments\n");
658 	argc -= ret;
659 	argv += ret;
660 
661 	force_quit = false;
662 	signal(SIGINT, signal_handler);
663 	signal(SIGTERM, signal_handler);
664 
665 	/* parse application arguments (after the EAL ones) */
666 	ret = l2fwd_parse_args(argc, argv);
667 	if (ret < 0)
668 		rte_exit(EXIT_FAILURE, "Invalid L2FWD arguments\n");
669 	/* >8 End of init EAL. */
670 
671 	printf("MAC updating %s\n", mac_updating ? "enabled" : "disabled");
672 
673 	/* convert to number of cycles */
674 	timer_period *= rte_get_timer_hz();
675 
676 	nb_ports = rte_eth_dev_count_avail();
677 	if (nb_ports == 0)
678 		rte_exit(EXIT_FAILURE, "No Ethernet ports - bye\n");
679 
680 	if (port_pair_params != NULL) {
681 		if (check_port_pair_config() < 0)
682 			rte_exit(EXIT_FAILURE, "Invalid port pair config\n");
683 	}
684 
685 	/* check port mask to possible port mask */
686 	if (l2fwd_enabled_port_mask & ~((1 << nb_ports) - 1))
687 		rte_exit(EXIT_FAILURE, "Invalid portmask; possible (0x%x)\n",
688 			(1 << nb_ports) - 1);
689 
690 	/* Initialization of the driver. 8< */
691 
692 	/* reset l2fwd_dst_ports */
693 	for (portid = 0; portid < RTE_MAX_ETHPORTS; portid++)
694 		l2fwd_dst_ports[portid] = 0;
695 	last_port = 0;
696 
697 	/* populate destination port details */
698 	if (port_pair_params != NULL) {
699 		uint16_t idx, p;
700 
701 		for (idx = 0; idx < (nb_port_pair_params << 1); idx++) {
702 			p = idx & 1;
703 			portid = port_pair_params[idx >> 1].port[p];
704 			l2fwd_dst_ports[portid] =
705 				port_pair_params[idx >> 1].port[p ^ 1];
706 		}
707 	} else {
708 		RTE_ETH_FOREACH_DEV(portid) {
709 			/* skip ports that are not enabled */
710 			if ((l2fwd_enabled_port_mask & (1 << portid)) == 0)
711 				continue;
712 
713 			if (nb_ports_in_mask % 2) {
714 				l2fwd_dst_ports[portid] = last_port;
715 				l2fwd_dst_ports[last_port] = portid;
716 			} else {
717 				last_port = portid;
718 			}
719 
720 			nb_ports_in_mask++;
721 		}
722 		if (nb_ports_in_mask % 2) {
723 			printf("Notice: odd number of ports in portmask.\n");
724 			l2fwd_dst_ports[last_port] = last_port;
725 		}
726 	}
727 	/* >8 End of initialization of the driver. */
728 
729 	rx_lcore_id = 0;
730 	qconf = NULL;
731 
732 	/* Initialize the port/queue configuration of each logical core */
733 	RTE_ETH_FOREACH_DEV(portid) {
734 		/* skip ports that are not enabled */
735 		if ((l2fwd_enabled_port_mask & (1 << portid)) == 0)
736 			continue;
737 
738 		/* get the lcore_id for this port */
739 		while (rte_lcore_is_enabled(rx_lcore_id) == 0 ||
740 		       lcore_queue_conf[rx_lcore_id].n_rx_port ==
741 		       l2fwd_rx_queue_per_lcore) {
742 			rx_lcore_id++;
743 			if (rx_lcore_id >= RTE_MAX_LCORE)
744 				rte_exit(EXIT_FAILURE, "Not enough cores\n");
745 		}
746 
747 		if (qconf != &lcore_queue_conf[rx_lcore_id]) {
748 			/* Assigned a new logical core in the loop above. */
749 			qconf = &lcore_queue_conf[rx_lcore_id];
750 			nb_lcores++;
751 		}
752 
753 		qconf->rx_port_list[qconf->n_rx_port] = portid;
754 		qconf->n_rx_port++;
755 		printf("Lcore %u: RX port %u TX port %u\n", rx_lcore_id,
756 		       portid, l2fwd_dst_ports[portid]);
757 	}
758 
759 	nb_mbufs = RTE_MAX(nb_ports * (nb_rxd + nb_txd + MAX_PKT_BURST +
760 		nb_lcores * MEMPOOL_CACHE_SIZE), 8192U);
761 
762 	/* Create the mbuf pool. 8< */
763 	l2fwd_pktmbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", nb_mbufs,
764 		MEMPOOL_CACHE_SIZE, 0, RTE_MBUF_DEFAULT_BUF_SIZE,
765 		rte_socket_id());
766 	if (l2fwd_pktmbuf_pool == NULL)
767 		rte_exit(EXIT_FAILURE, "Cannot init mbuf pool\n");
768 	/* >8 End of create the mbuf pool. */
769 
770 	/* Initialise each port */
771 	RTE_ETH_FOREACH_DEV(portid) {
772 		struct rte_eth_rxconf rxq_conf;
773 		struct rte_eth_txconf txq_conf;
774 		struct rte_eth_conf local_port_conf = port_conf;
775 		struct rte_eth_dev_info dev_info;
776 
777 		/* skip ports that are not enabled */
778 		if ((l2fwd_enabled_port_mask & (1 << portid)) == 0) {
779 			printf("Skipping disabled port %u\n", portid);
780 			continue;
781 		}
782 		nb_ports_available++;
783 
784 		/* init port */
785 		printf("Initializing port %u... ", portid);
786 		fflush(stdout);
787 
788 		ret = rte_eth_dev_info_get(portid, &dev_info);
789 		if (ret != 0)
790 			rte_exit(EXIT_FAILURE,
791 				"Error during getting device (port %u) info: %s\n",
792 				portid, strerror(-ret));
793 
794 		if (dev_info.tx_offload_capa & RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE)
795 			local_port_conf.txmode.offloads |=
796 				RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE;
797 		/* Configure the number of queues for a port. */
798 		ret = rte_eth_dev_configure(portid, 1, 1, &local_port_conf);
799 		if (ret < 0)
800 			rte_exit(EXIT_FAILURE, "Cannot configure device: err=%d, port=%u\n",
801 				  ret, portid);
802 		/* >8 End of configuration of the number of queues for a port. */
803 
804 		ret = rte_eth_dev_adjust_nb_rx_tx_desc(portid, &nb_rxd,
805 						       &nb_txd);
806 		if (ret < 0)
807 			rte_exit(EXIT_FAILURE,
808 				 "Cannot adjust number of descriptors: err=%d, port=%u\n",
809 				 ret, portid);
810 
811 		ret = rte_eth_macaddr_get(portid,
812 					  &l2fwd_ports_eth_addr[portid]);
813 		if (ret < 0)
814 			rte_exit(EXIT_FAILURE,
815 				 "Cannot get MAC address: err=%d, port=%u\n",
816 				 ret, portid);
817 
818 		/* init one RX queue */
819 		fflush(stdout);
820 		rxq_conf = dev_info.default_rxconf;
821 		rxq_conf.offloads = local_port_conf.rxmode.offloads;
822 		/* RX queue setup. 8< */
823 		ret = rte_eth_rx_queue_setup(portid, 0, nb_rxd,
824 					     rte_eth_dev_socket_id(portid),
825 					     &rxq_conf,
826 					     l2fwd_pktmbuf_pool);
827 		if (ret < 0)
828 			rte_exit(EXIT_FAILURE, "rte_eth_rx_queue_setup:err=%d, port=%u\n",
829 				  ret, portid);
830 		/* >8 End of RX queue setup. */
831 
832 		/* Init one TX queue on each port. 8< */
833 		fflush(stdout);
834 		txq_conf = dev_info.default_txconf;
835 		txq_conf.offloads = local_port_conf.txmode.offloads;
836 		ret = rte_eth_tx_queue_setup(portid, 0, nb_txd,
837 				rte_eth_dev_socket_id(portid),
838 				&txq_conf);
839 		if (ret < 0)
840 			rte_exit(EXIT_FAILURE, "rte_eth_tx_queue_setup:err=%d, port=%u\n",
841 				ret, portid);
842 		/* >8 End of init one TX queue on each port. */
843 
844 		/* Initialize TX buffers */
845 		tx_buffer[portid] = rte_zmalloc_socket("tx_buffer",
846 				RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST), 0,
847 				rte_eth_dev_socket_id(portid));
848 		if (tx_buffer[portid] == NULL)
849 			rte_exit(EXIT_FAILURE, "Cannot allocate buffer for tx on port %u\n",
850 					portid);
851 
852 		rte_eth_tx_buffer_init(tx_buffer[portid], MAX_PKT_BURST);
853 
854 		ret = rte_eth_tx_buffer_set_err_callback(tx_buffer[portid],
855 				rte_eth_tx_buffer_count_callback,
856 				&port_statistics[portid].dropped);
857 		if (ret < 0)
858 			rte_exit(EXIT_FAILURE,
859 			"Cannot set error callback for tx buffer on port %u\n",
860 				 portid);
861 
862 		ret = rte_eth_dev_set_ptypes(portid, RTE_PTYPE_UNKNOWN, NULL,
863 					     0);
864 		if (ret < 0)
865 			printf("Port %u, Failed to disable Ptype parsing\n",
866 					portid);
867 		/* Start device */
868 		ret = rte_eth_dev_start(portid);
869 		if (ret < 0)
870 			rte_exit(EXIT_FAILURE, "rte_eth_dev_start:err=%d, port=%u\n",
871 				  ret, portid);
872 
873 		printf("done: \n");
874 
875 		ret = rte_eth_promiscuous_enable(portid);
876 		if (ret != 0)
877 			rte_exit(EXIT_FAILURE,
878 				 "rte_eth_promiscuous_enable:err=%s, port=%u\n",
879 				 rte_strerror(-ret), portid);
880 
881 		printf("Port %u, MAC address: " RTE_ETHER_ADDR_PRT_FMT "\n\n",
882 			portid,
883 			RTE_ETHER_ADDR_BYTES(&l2fwd_ports_eth_addr[portid]));
884 
885 		/* initialize port stats */
886 		memset(&port_statistics, 0, sizeof(port_statistics));
887 	}
888 
889 	if (!nb_ports_available) {
890 		rte_exit(EXIT_FAILURE,
891 			"All available ports are disabled. Please set portmask.\n");
892 	}
893 
894 	check_all_ports_link_status(l2fwd_enabled_port_mask);
895 
896 	ret = 0;
897 	/* launch per-lcore init on every lcore */
898 	rte_eal_mp_remote_launch(l2fwd_launch_one_lcore, NULL, CALL_MAIN);
899 	RTE_LCORE_FOREACH_WORKER(lcore_id) {
900 		if (rte_eal_wait_lcore(lcore_id) < 0) {
901 			ret = -1;
902 			break;
903 		}
904 	}
905 
906 	RTE_ETH_FOREACH_DEV(portid) {
907 		if ((l2fwd_enabled_port_mask & (1 << portid)) == 0)
908 			continue;
909 		printf("Closing port %d...", portid);
910 		ret = rte_eth_dev_stop(portid);
911 		if (ret != 0)
912 			printf("rte_eth_dev_stop: err=%d, port=%d\n",
913 			       ret, portid);
914 		rte_eth_dev_close(portid);
915 		printf(" Done\n");
916 	}
917 
918 	/* clean up the EAL */
919 	rte_eal_cleanup();
920 	printf("Bye...\n");
921 
922 	return ret;
923 }
924