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