1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2014 Intel Corporation
10 #include <sys/queue.h>
15 #include <netinet/in.h>
17 #include <linux/if_tun.h>
19 #include <sys/ioctl.h>
23 #include <rte_common.h>
25 #include <rte_memory.h>
26 #include <rte_memcpy.h>
28 #include <rte_per_lcore.h>
29 #include <rte_launch.h>
30 #include <rte_atomic.h>
31 #include <rte_lcore.h>
32 #include <rte_branch_prediction.h>
33 #include <rte_interrupts.h>
34 #include <rte_bus_pci.h>
35 #include <rte_debug.h>
36 #include <rte_ether.h>
37 #include <rte_ethdev.h>
38 #include <rte_mempool.h>
40 #include <rte_string_fns.h>
41 #include <rte_cycles.h>
42 #include <rte_malloc.h>
45 /* Macros for printing using RTE_LOG */
46 #define RTE_LOGTYPE_APP RTE_LOGTYPE_USER1
48 /* Max size of a single packet */
49 #define MAX_PACKET_SZ 2048
51 /* Size of the data buffer in each mbuf */
52 #define MBUF_DATA_SZ (MAX_PACKET_SZ + RTE_PKTMBUF_HEADROOM)
54 /* Number of mbufs in mempool that is created */
55 #define NB_MBUF (8192 * 16)
57 /* How many packets to attempt to read from NIC in one go */
58 #define PKT_BURST_SZ 32
60 /* How many objects (mbufs) to keep in per-lcore mempool cache */
61 #define MEMPOOL_CACHE_SZ PKT_BURST_SZ
63 /* Number of RX ring descriptors */
66 /* Number of TX ring descriptors */
69 /* Total octets in ethernet header */
70 #define KNI_ENET_HEADER_SIZE 14
72 /* Total octets in the FCS */
73 #define KNI_ENET_FCS_SIZE 4
75 #define KNI_US_PER_SECOND 1000000
76 #define KNI_SECOND_PER_DAY 86400
78 #define KNI_MAX_KTHREAD 32
80 * Structure of port parameters
82 struct kni_port_params {
83 uint16_t port_id;/* Port ID */
84 unsigned lcore_rx; /* lcore ID for RX */
85 unsigned lcore_tx; /* lcore ID for TX */
86 uint32_t nb_lcore_k; /* Number of lcores for KNI multi kernel threads */
87 uint32_t nb_kni; /* Number of KNI devices to be created */
88 unsigned lcore_k[KNI_MAX_KTHREAD]; /* lcore ID list for kthreads */
89 struct rte_kni *kni[KNI_MAX_KTHREAD]; /* KNI context pointers */
90 } __rte_cache_aligned;
92 static struct kni_port_params *kni_port_params_array[RTE_MAX_ETHPORTS];
95 /* Options for configuring ethernet port */
96 static struct rte_eth_conf port_conf = {
98 .mq_mode = ETH_MQ_TX_NONE,
102 /* Mempool for mbufs */
103 static struct rte_mempool * pktmbuf_pool = NULL;
105 /* Mask of enabled ports */
106 static uint32_t ports_mask = 0;
107 /* Ports set in promiscuous mode off by default. */
108 static int promiscuous_on = 0;
109 /* Monitor link status continually. off by default. */
110 static int monitor_links;
112 /* Structure type for recording kni interface specific stats */
113 struct kni_interface_stats {
114 /* number of pkts received from NIC, and sent to KNI */
117 /* number of pkts received from NIC, but failed to send to KNI */
120 /* number of pkts received from KNI, and sent to NIC */
123 /* number of pkts received from KNI, but failed to send to NIC */
127 /* kni device statistics array */
128 static struct kni_interface_stats kni_stats[RTE_MAX_ETHPORTS];
130 static int kni_change_mtu(uint16_t port_id, unsigned int new_mtu);
131 static int kni_config_network_interface(uint16_t port_id, uint8_t if_up);
132 static int kni_config_mac_address(uint16_t port_id, uint8_t mac_addr[]);
134 static rte_atomic32_t kni_stop = RTE_ATOMIC32_INIT(0);
136 /* Print out statistics on packets handled */
142 printf("\n**KNI example application statistics**\n"
143 "====== ============== ============ ============ ============ ============\n"
144 " Port Lcore(RX/TX) rx_packets rx_dropped tx_packets tx_dropped\n"
145 "------ -------------- ------------ ------------ ------------ ------------\n");
146 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
147 if (!kni_port_params_array[i])
150 printf("%7d %10u/%2u %13"PRIu64" %13"PRIu64" %13"PRIu64" "
152 kni_port_params_array[i]->lcore_rx,
153 kni_port_params_array[i]->lcore_tx,
154 kni_stats[i].rx_packets,
155 kni_stats[i].rx_dropped,
156 kni_stats[i].tx_packets,
157 kni_stats[i].tx_dropped);
159 printf("====== ============== ============ ============ ============ ============\n");
162 /* Custom handling of signals to handle stats and kni processing */
164 signal_handler(int signum)
166 /* When we receive a USR1 signal, print stats */
167 if (signum == SIGUSR1) {
171 /* When we receive a USR2 signal, reset stats */
172 if (signum == SIGUSR2) {
173 memset(&kni_stats, 0, sizeof(kni_stats));
174 printf("\n** Statistics have been reset **\n");
178 /* When we receive a RTMIN or SIGINT signal, stop kni processing */
179 if (signum == SIGRTMIN || signum == SIGINT){
180 printf("\nSIGRTMIN/SIGINT received. KNI processing stopping.\n");
181 rte_atomic32_inc(&kni_stop);
187 kni_burst_free_mbufs(struct rte_mbuf **pkts, unsigned num)
194 for (i = 0; i < num; i++) {
195 rte_pktmbuf_free(pkts[i]);
201 * Interface to burst rx and enqueue mbufs into rx_q
204 kni_ingress(struct kni_port_params *p)
210 struct rte_mbuf *pkts_burst[PKT_BURST_SZ];
216 port_id = p->port_id;
217 for (i = 0; i < nb_kni; i++) {
218 /* Burst rx from eth */
219 nb_rx = rte_eth_rx_burst(port_id, 0, pkts_burst, PKT_BURST_SZ);
220 if (unlikely(nb_rx > PKT_BURST_SZ)) {
221 RTE_LOG(ERR, APP, "Error receiving from eth\n");
224 /* Burst tx to kni */
225 num = rte_kni_tx_burst(p->kni[i], pkts_burst, nb_rx);
227 kni_stats[port_id].rx_packets += num;
229 rte_kni_handle_request(p->kni[i]);
230 if (unlikely(num < nb_rx)) {
231 /* Free mbufs not tx to kni interface */
232 kni_burst_free_mbufs(&pkts_burst[num], nb_rx - num);
233 kni_stats[port_id].rx_dropped += nb_rx - num;
239 * Interface to dequeue mbufs from tx_q and burst tx
242 kni_egress(struct kni_port_params *p)
248 struct rte_mbuf *pkts_burst[PKT_BURST_SZ];
254 port_id = p->port_id;
255 for (i = 0; i < nb_kni; i++) {
256 /* Burst rx from kni */
257 num = rte_kni_rx_burst(p->kni[i], pkts_burst, PKT_BURST_SZ);
258 if (unlikely(num > PKT_BURST_SZ)) {
259 RTE_LOG(ERR, APP, "Error receiving from KNI\n");
262 /* Burst tx to eth */
263 nb_tx = rte_eth_tx_burst(port_id, 0, pkts_burst, (uint16_t)num);
265 kni_stats[port_id].tx_packets += nb_tx;
266 if (unlikely(nb_tx < num)) {
267 /* Free mbufs not tx to NIC */
268 kni_burst_free_mbufs(&pkts_burst[nb_tx], num - nb_tx);
269 kni_stats[port_id].tx_dropped += num - nb_tx;
275 main_loop(__rte_unused void *arg)
279 const unsigned lcore_id = rte_lcore_id();
286 enum lcore_rxtx flag = LCORE_NONE;
288 RTE_ETH_FOREACH_DEV(i) {
289 if (!kni_port_params_array[i])
291 if (kni_port_params_array[i]->lcore_rx == (uint8_t)lcore_id) {
294 } else if (kni_port_params_array[i]->lcore_tx ==
301 if (flag == LCORE_RX) {
302 RTE_LOG(INFO, APP, "Lcore %u is reading from port %d\n",
303 kni_port_params_array[i]->lcore_rx,
304 kni_port_params_array[i]->port_id);
306 f_stop = rte_atomic32_read(&kni_stop);
309 kni_ingress(kni_port_params_array[i]);
311 } else if (flag == LCORE_TX) {
312 RTE_LOG(INFO, APP, "Lcore %u is writing to port %d\n",
313 kni_port_params_array[i]->lcore_tx,
314 kni_port_params_array[i]->port_id);
316 f_stop = rte_atomic32_read(&kni_stop);
319 kni_egress(kni_port_params_array[i]);
322 RTE_LOG(INFO, APP, "Lcore %u has nothing to do\n", lcore_id);
327 /* Display usage instructions */
329 print_usage(const char *prgname)
331 RTE_LOG(INFO, APP, "\nUsage: %s [EAL options] -- -p PORTMASK -P -m "
332 "[--config (port,lcore_rx,lcore_tx,lcore_kthread...)"
333 "[,(port,lcore_rx,lcore_tx,lcore_kthread...)]]\n"
334 " -p PORTMASK: hex bitmask of ports to use\n"
335 " -P : enable promiscuous mode\n"
336 " -m : enable monitoring of port carrier state\n"
337 " --config (port,lcore_rx,lcore_tx,lcore_kthread...): "
338 "port and lcore configurations\n",
342 /* Convert string to unsigned number. 0 is returned if error occurs */
344 parse_unsigned(const char *portmask)
349 num = strtoul(portmask, &end, 16);
350 if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
353 return (uint32_t)num;
360 struct kni_port_params **p = kni_port_params_array;
362 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
365 RTE_LOG(DEBUG, APP, "Port ID: %d\n", p[i]->port_id);
366 RTE_LOG(DEBUG, APP, "Rx lcore ID: %u, Tx lcore ID: %u\n",
367 p[i]->lcore_rx, p[i]->lcore_tx);
368 for (j = 0; j < p[i]->nb_lcore_k; j++)
369 RTE_LOG(DEBUG, APP, "Kernel thread lcore ID: %u\n",
375 parse_config(const char *arg)
377 const char *p, *p0 = arg;
384 _NUM_FLD = KNI_MAX_KTHREAD + 3,
387 char *str_fld[_NUM_FLD];
388 unsigned long int_fld[_NUM_FLD];
389 uint16_t port_id, nb_kni_port_params = 0;
391 memset(&kni_port_params_array, 0, sizeof(kni_port_params_array));
392 while (((p = strchr(p0, '(')) != NULL) &&
393 nb_kni_port_params < RTE_MAX_ETHPORTS) {
395 if ((p0 = strchr(p, ')')) == NULL)
398 if (size >= sizeof(s)) {
399 printf("Invalid config parameters\n");
402 snprintf(s, sizeof(s), "%.*s", size, p);
403 nb_token = rte_strsplit(s, sizeof(s), str_fld, _NUM_FLD, ',');
404 if (nb_token <= FLD_LCORE_TX) {
405 printf("Invalid config parameters\n");
408 for (i = 0; i < nb_token; i++) {
410 int_fld[i] = strtoul(str_fld[i], &end, 0);
411 if (errno != 0 || end == str_fld[i]) {
412 printf("Invalid config parameters\n");
418 port_id = int_fld[i++];
419 if (port_id >= RTE_MAX_ETHPORTS) {
420 printf("Port ID %d could not exceed the maximum %d\n",
421 port_id, RTE_MAX_ETHPORTS);
424 if (kni_port_params_array[port_id]) {
425 printf("Port %d has been configured\n", port_id);
428 kni_port_params_array[port_id] =
429 rte_zmalloc("KNI_port_params",
430 sizeof(struct kni_port_params), RTE_CACHE_LINE_SIZE);
431 kni_port_params_array[port_id]->port_id = port_id;
432 kni_port_params_array[port_id]->lcore_rx =
433 (uint8_t)int_fld[i++];
434 kni_port_params_array[port_id]->lcore_tx =
435 (uint8_t)int_fld[i++];
436 if (kni_port_params_array[port_id]->lcore_rx >= RTE_MAX_LCORE ||
437 kni_port_params_array[port_id]->lcore_tx >= RTE_MAX_LCORE) {
438 printf("lcore_rx %u or lcore_tx %u ID could not "
439 "exceed the maximum %u\n",
440 kni_port_params_array[port_id]->lcore_rx,
441 kni_port_params_array[port_id]->lcore_tx,
442 (unsigned)RTE_MAX_LCORE);
445 for (j = 0; i < nb_token && j < KNI_MAX_KTHREAD; i++, j++)
446 kni_port_params_array[port_id]->lcore_k[j] =
448 kni_port_params_array[port_id]->nb_lcore_k = j;
455 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
456 if (kni_port_params_array[i]) {
457 rte_free(kni_port_params_array[i]);
458 kni_port_params_array[i] = NULL;
466 validate_parameters(uint32_t portmask)
471 printf("No port configured in port mask\n");
475 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
476 if (((portmask & (1 << i)) && !kni_port_params_array[i]) ||
477 (!(portmask & (1 << i)) && kni_port_params_array[i]))
478 rte_exit(EXIT_FAILURE, "portmask is not consistent "
479 "to port ids specified in --config\n");
481 if (kni_port_params_array[i] && !rte_lcore_is_enabled(\
482 (unsigned)(kni_port_params_array[i]->lcore_rx)))
483 rte_exit(EXIT_FAILURE, "lcore id %u for "
484 "port %d receiving not enabled\n",
485 kni_port_params_array[i]->lcore_rx,
486 kni_port_params_array[i]->port_id);
488 if (kni_port_params_array[i] && !rte_lcore_is_enabled(\
489 (unsigned)(kni_port_params_array[i]->lcore_tx)))
490 rte_exit(EXIT_FAILURE, "lcore id %u for "
491 "port %d transmitting not enabled\n",
492 kni_port_params_array[i]->lcore_tx,
493 kni_port_params_array[i]->port_id);
500 #define CMDLINE_OPT_CONFIG "config"
502 /* Parse the arguments given in the command line of the application */
504 parse_args(int argc, char **argv)
506 int opt, longindex, ret = 0;
507 const char *prgname = argv[0];
508 static struct option longopts[] = {
509 {CMDLINE_OPT_CONFIG, required_argument, NULL, 0},
513 /* Disable printing messages within getopt() */
516 /* Parse command line */
517 while ((opt = getopt_long(argc, argv, "p:Pm", longopts,
518 &longindex)) != EOF) {
521 ports_mask = parse_unsigned(optarg);
530 if (!strncmp(longopts[longindex].name,
532 sizeof(CMDLINE_OPT_CONFIG))) {
533 ret = parse_config(optarg);
535 printf("Invalid config\n");
536 print_usage(prgname);
542 print_usage(prgname);
543 rte_exit(EXIT_FAILURE, "Invalid option specified\n");
547 /* Check that options were parsed ok */
548 if (validate_parameters(ports_mask) < 0) {
549 print_usage(prgname);
550 rte_exit(EXIT_FAILURE, "Invalid parameters\n");
556 /* Initialize KNI subsystem */
560 unsigned int num_of_kni_ports = 0, i;
561 struct kni_port_params **params = kni_port_params_array;
563 /* Calculate the maximum number of KNI interfaces that will be used */
564 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
565 if (kni_port_params_array[i]) {
566 num_of_kni_ports += (params[i]->nb_lcore_k ?
567 params[i]->nb_lcore_k : 1);
571 /* Invoke rte KNI init to preallocate the ports */
572 rte_kni_init(num_of_kni_ports);
575 /* Initialise a single port on an Ethernet device */
577 init_port(uint16_t port)
580 uint16_t nb_rxd = NB_RXD;
581 uint16_t nb_txd = NB_TXD;
582 struct rte_eth_dev_info dev_info;
583 struct rte_eth_rxconf rxq_conf;
584 struct rte_eth_txconf txq_conf;
585 struct rte_eth_conf local_port_conf = port_conf;
587 /* Initialise device and RX/TX queues */
588 RTE_LOG(INFO, APP, "Initialising port %u ...\n", (unsigned)port);
590 rte_eth_dev_info_get(port, &dev_info);
591 if (dev_info.tx_offload_capa & DEV_TX_OFFLOAD_MBUF_FAST_FREE)
592 local_port_conf.txmode.offloads |=
593 DEV_TX_OFFLOAD_MBUF_FAST_FREE;
594 ret = rte_eth_dev_configure(port, 1, 1, &local_port_conf);
596 rte_exit(EXIT_FAILURE, "Could not configure port%u (%d)\n",
597 (unsigned)port, ret);
599 ret = rte_eth_dev_adjust_nb_rx_tx_desc(port, &nb_rxd, &nb_txd);
601 rte_exit(EXIT_FAILURE, "Could not adjust number of descriptors "
602 "for port%u (%d)\n", (unsigned)port, ret);
604 rxq_conf = dev_info.default_rxconf;
605 rxq_conf.offloads = local_port_conf.rxmode.offloads;
606 ret = rte_eth_rx_queue_setup(port, 0, nb_rxd,
607 rte_eth_dev_socket_id(port), &rxq_conf, pktmbuf_pool);
609 rte_exit(EXIT_FAILURE, "Could not setup up RX queue for "
610 "port%u (%d)\n", (unsigned)port, ret);
612 txq_conf = dev_info.default_txconf;
613 txq_conf.offloads = local_port_conf.txmode.offloads;
614 ret = rte_eth_tx_queue_setup(port, 0, nb_txd,
615 rte_eth_dev_socket_id(port), &txq_conf);
617 rte_exit(EXIT_FAILURE, "Could not setup up TX queue for "
618 "port%u (%d)\n", (unsigned)port, ret);
620 ret = rte_eth_dev_start(port);
622 rte_exit(EXIT_FAILURE, "Could not start port%u (%d)\n",
623 (unsigned)port, ret);
626 rte_eth_promiscuous_enable(port);
629 /* Check the link status of all ports in up to 9s, and print them finally */
631 check_all_ports_link_status(uint32_t port_mask)
633 #define CHECK_INTERVAL 100 /* 100ms */
634 #define MAX_CHECK_TIME 90 /* 9s (90 * 100ms) in total */
636 uint8_t count, all_ports_up, print_flag = 0;
637 struct rte_eth_link link;
639 printf("\nChecking link status\n");
641 for (count = 0; count <= MAX_CHECK_TIME; count++) {
643 RTE_ETH_FOREACH_DEV(portid) {
644 if ((port_mask & (1 << portid)) == 0)
646 memset(&link, 0, sizeof(link));
647 rte_eth_link_get_nowait(portid, &link);
648 /* print link status if flag set */
649 if (print_flag == 1) {
650 if (link.link_status)
652 "Port%d Link Up - speed %uMbps - %s\n",
653 portid, link.link_speed,
654 (link.link_duplex == ETH_LINK_FULL_DUPLEX) ?
655 ("full-duplex") : ("half-duplex\n"));
657 printf("Port %d Link Down\n", portid);
660 /* clear all_ports_up flag if any link down */
661 if (link.link_status == ETH_LINK_DOWN) {
666 /* after finally printing all link status, get out */
670 if (all_ports_up == 0) {
673 rte_delay_ms(CHECK_INTERVAL);
676 /* set the print_flag if all ports up or timeout */
677 if (all_ports_up == 1 || count == (MAX_CHECK_TIME - 1)) {
685 log_link_state(struct rte_kni *kni, int prev, struct rte_eth_link *link)
687 if (kni == NULL || link == NULL)
690 if (prev == ETH_LINK_DOWN && link->link_status == ETH_LINK_UP) {
691 RTE_LOG(INFO, APP, "%s NIC Link is Up %d Mbps %s %s.\n",
692 rte_kni_get_name(kni),
694 link->link_autoneg ? "(AutoNeg)" : "(Fixed)",
695 link->link_duplex ? "Full Duplex" : "Half Duplex");
696 } else if (prev == ETH_LINK_UP && link->link_status == ETH_LINK_DOWN) {
697 RTE_LOG(INFO, APP, "%s NIC Link is Down.\n",
698 rte_kni_get_name(kni));
703 * Monitor the link status of all ports and update the
704 * corresponding KNI interface(s)
707 monitor_all_ports_link_status(void *arg)
710 struct rte_eth_link link;
712 struct kni_port_params **p = kni_port_params_array;
716 while (monitor_links) {
718 RTE_ETH_FOREACH_DEV(portid) {
719 if ((ports_mask & (1 << portid)) == 0)
721 memset(&link, 0, sizeof(link));
722 rte_eth_link_get_nowait(portid, &link);
723 for (i = 0; i < p[portid]->nb_kni; i++) {
724 prev = rte_kni_update_link(p[portid]->kni[i],
726 log_link_state(p[portid]->kni[i], prev, &link);
733 /* Callback for request of changing MTU */
735 kni_change_mtu(uint16_t port_id, unsigned int new_mtu)
738 uint16_t nb_rxd = NB_RXD;
739 struct rte_eth_conf conf;
740 struct rte_eth_dev_info dev_info;
741 struct rte_eth_rxconf rxq_conf;
743 if (!rte_eth_dev_is_valid_port(port_id)) {
744 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
748 RTE_LOG(INFO, APP, "Change MTU of port %d to %u\n", port_id, new_mtu);
750 /* Stop specific port */
751 rte_eth_dev_stop(port_id);
753 memcpy(&conf, &port_conf, sizeof(conf));
755 if (new_mtu > ETHER_MAX_LEN)
756 conf.rxmode.offloads |= DEV_RX_OFFLOAD_JUMBO_FRAME;
758 conf.rxmode.offloads &= ~DEV_RX_OFFLOAD_JUMBO_FRAME;
760 /* mtu + length of header + length of FCS = max pkt length */
761 conf.rxmode.max_rx_pkt_len = new_mtu + KNI_ENET_HEADER_SIZE +
763 ret = rte_eth_dev_configure(port_id, 1, 1, &conf);
765 RTE_LOG(ERR, APP, "Fail to reconfigure port %d\n", port_id);
769 ret = rte_eth_dev_adjust_nb_rx_tx_desc(port_id, &nb_rxd, NULL);
771 rte_exit(EXIT_FAILURE, "Could not adjust number of descriptors "
772 "for port%u (%d)\n", (unsigned int)port_id,
775 rte_eth_dev_info_get(port_id, &dev_info);
776 rxq_conf = dev_info.default_rxconf;
777 rxq_conf.offloads = conf.rxmode.offloads;
778 ret = rte_eth_rx_queue_setup(port_id, 0, nb_rxd,
779 rte_eth_dev_socket_id(port_id), &rxq_conf, pktmbuf_pool);
781 RTE_LOG(ERR, APP, "Fail to setup Rx queue of port %d\n",
786 /* Restart specific port */
787 ret = rte_eth_dev_start(port_id);
789 RTE_LOG(ERR, APP, "Fail to restart port %d\n", port_id);
796 /* Callback for request of configuring network interface up/down */
798 kni_config_network_interface(uint16_t port_id, uint8_t if_up)
802 if (!rte_eth_dev_is_valid_port(port_id)) {
803 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
807 RTE_LOG(INFO, APP, "Configure network interface of %d %s\n",
808 port_id, if_up ? "up" : "down");
810 if (if_up != 0) { /* Configure network interface up */
811 rte_eth_dev_stop(port_id);
812 ret = rte_eth_dev_start(port_id);
813 } else /* Configure network interface down */
814 rte_eth_dev_stop(port_id);
817 RTE_LOG(ERR, APP, "Failed to start port %d\n", port_id);
823 print_ethaddr(const char *name, struct ether_addr *mac_addr)
825 char buf[ETHER_ADDR_FMT_SIZE];
826 ether_format_addr(buf, ETHER_ADDR_FMT_SIZE, mac_addr);
827 RTE_LOG(INFO, APP, "\t%s%s\n", name, buf);
830 /* Callback for request of configuring mac address */
832 kni_config_mac_address(uint16_t port_id, uint8_t mac_addr[])
836 if (!rte_eth_dev_is_valid_port(port_id)) {
837 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
841 RTE_LOG(INFO, APP, "Configure mac address of %d\n", port_id);
842 print_ethaddr("Address:", (struct ether_addr *)mac_addr);
844 ret = rte_eth_dev_default_mac_addr_set(port_id,
845 (struct ether_addr *)mac_addr);
847 RTE_LOG(ERR, APP, "Failed to config mac_addr for port %d\n",
854 kni_alloc(uint16_t port_id)
858 struct rte_kni_conf conf;
859 struct kni_port_params **params = kni_port_params_array;
861 if (port_id >= RTE_MAX_ETHPORTS || !params[port_id])
864 params[port_id]->nb_kni = params[port_id]->nb_lcore_k ?
865 params[port_id]->nb_lcore_k : 1;
867 for (i = 0; i < params[port_id]->nb_kni; i++) {
868 /* Clear conf at first */
869 memset(&conf, 0, sizeof(conf));
870 if (params[port_id]->nb_lcore_k) {
871 snprintf(conf.name, RTE_KNI_NAMESIZE,
872 "vEth%u_%u", port_id, i);
873 conf.core_id = params[port_id]->lcore_k[i];
876 snprintf(conf.name, RTE_KNI_NAMESIZE,
878 conf.group_id = port_id;
879 conf.mbuf_size = MAX_PACKET_SZ;
881 * The first KNI device associated to a port
882 * is the master, for multiple kernel thread
886 struct rte_kni_ops ops;
887 struct rte_eth_dev_info dev_info;
888 const struct rte_pci_device *pci_dev;
889 const struct rte_bus *bus = NULL;
891 memset(&dev_info, 0, sizeof(dev_info));
892 rte_eth_dev_info_get(port_id, &dev_info);
895 bus = rte_bus_find_by_device(dev_info.device);
896 if (bus && !strcmp(bus->name, "pci")) {
897 pci_dev = RTE_DEV_TO_PCI(dev_info.device);
898 conf.addr = pci_dev->addr;
899 conf.id = pci_dev->id;
901 /* Get the interface default mac address */
902 rte_eth_macaddr_get(port_id,
903 (struct ether_addr *)&conf.mac_addr);
905 rte_eth_dev_get_mtu(port_id, &conf.mtu);
907 memset(&ops, 0, sizeof(ops));
908 ops.port_id = port_id;
909 ops.change_mtu = kni_change_mtu;
910 ops.config_network_if = kni_config_network_interface;
911 ops.config_mac_address = kni_config_mac_address;
913 kni = rte_kni_alloc(pktmbuf_pool, &conf, &ops);
915 kni = rte_kni_alloc(pktmbuf_pool, &conf, NULL);
918 rte_exit(EXIT_FAILURE, "Fail to create kni for "
919 "port: %d\n", port_id);
920 params[port_id]->kni[i] = kni;
927 kni_free_kni(uint16_t port_id)
930 struct kni_port_params **p = kni_port_params_array;
932 if (port_id >= RTE_MAX_ETHPORTS || !p[port_id])
935 for (i = 0; i < p[port_id]->nb_kni; i++) {
936 if (rte_kni_release(p[port_id]->kni[i]))
937 printf("Fail to release kni\n");
938 p[port_id]->kni[i] = NULL;
940 rte_eth_dev_stop(port_id);
945 /* Initialise ports/queues etc. and start main loop on each core */
947 main(int argc, char** argv)
950 uint16_t nb_sys_ports, port;
953 pthread_t kni_link_tid;
956 /* Associate signal_hanlder function with USR signals */
957 signal(SIGUSR1, signal_handler);
958 signal(SIGUSR2, signal_handler);
959 signal(SIGRTMIN, signal_handler);
960 signal(SIGINT, signal_handler);
963 ret = rte_eal_init(argc, argv);
965 rte_exit(EXIT_FAILURE, "Could not initialise EAL (%d)\n", ret);
969 /* Parse application arguments (after the EAL ones) */
970 ret = parse_args(argc, argv);
972 rte_exit(EXIT_FAILURE, "Could not parse input parameters\n");
974 /* Create the mbuf pool */
975 pktmbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", NB_MBUF,
976 MEMPOOL_CACHE_SZ, 0, MBUF_DATA_SZ, rte_socket_id());
977 if (pktmbuf_pool == NULL) {
978 rte_exit(EXIT_FAILURE, "Could not initialise mbuf pool\n");
982 /* Get number of ports found in scan */
983 nb_sys_ports = rte_eth_dev_count_avail();
984 if (nb_sys_ports == 0)
985 rte_exit(EXIT_FAILURE, "No supported Ethernet device found\n");
987 /* Check if the configured port ID is valid */
988 for (i = 0; i < RTE_MAX_ETHPORTS; i++)
989 if (kni_port_params_array[i] && !rte_eth_dev_is_valid_port(i))
990 rte_exit(EXIT_FAILURE, "Configured invalid "
993 /* Initialize KNI subsystem */
996 /* Initialise each port */
997 RTE_ETH_FOREACH_DEV(port) {
998 /* Skip ports that are not enabled */
999 if (!(ports_mask & (1 << port)))
1003 if (port >= RTE_MAX_ETHPORTS)
1004 rte_exit(EXIT_FAILURE, "Can not use more than "
1005 "%d ports for kni\n", RTE_MAX_ETHPORTS);
1009 check_all_ports_link_status(ports_mask);
1012 RTE_LOG(INFO, APP, "========================\n");
1013 RTE_LOG(INFO, APP, "KNI Running\n");
1014 RTE_LOG(INFO, APP, "kill -SIGUSR1 %d\n", pid);
1015 RTE_LOG(INFO, APP, " Show KNI Statistics.\n");
1016 RTE_LOG(INFO, APP, "kill -SIGUSR2 %d\n", pid);
1017 RTE_LOG(INFO, APP, " Zero KNI Statistics.\n");
1018 RTE_LOG(INFO, APP, "========================\n");
1021 ret = rte_ctrl_thread_create(&kni_link_tid,
1022 "KNI link status check", NULL,
1023 monitor_all_ports_link_status, NULL);
1025 rte_exit(EXIT_FAILURE,
1026 "Could not create link status thread!\n");
1028 /* Launch per-lcore function on every lcore */
1029 rte_eal_mp_remote_launch(main_loop, NULL, CALL_MASTER);
1030 RTE_LCORE_FOREACH_SLAVE(i) {
1031 if (rte_eal_wait_lcore(i) < 0)
1035 pthread_join(kni_link_tid, &retval);
1037 /* Release resources */
1038 RTE_ETH_FOREACH_DEV(port) {
1039 if (!(ports_mask & (1 << port)))
1043 for (i = 0; i < RTE_MAX_ETHPORTS; i++)
1044 if (kni_port_params_array[i]) {
1045 rte_free(kni_port_params_array[i]);
1046 kni_port_params_array[i] = NULL;