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_lcore.h>
31 #include <rte_branch_prediction.h>
32 #include <rte_interrupts.h>
33 #include <rte_bus_pci.h>
34 #include <rte_debug.h>
35 #include <rte_ether.h>
36 #include <rte_ethdev.h>
37 #include <rte_mempool.h>
39 #include <rte_string_fns.h>
40 #include <rte_cycles.h>
41 #include <rte_malloc.h>
44 /* Macros for printing using RTE_LOG */
45 #define RTE_LOGTYPE_APP RTE_LOGTYPE_USER1
47 /* Max size of a single packet */
48 #define MAX_PACKET_SZ 2048
50 /* Size of the data buffer in each mbuf */
51 #define MBUF_DATA_SZ (MAX_PACKET_SZ + RTE_PKTMBUF_HEADROOM)
53 /* Number of mbufs in mempool that is created */
54 #define NB_MBUF (8192 * 16)
56 /* How many packets to attempt to read from NIC in one go */
57 #define PKT_BURST_SZ 32
59 /* How many objects (mbufs) to keep in per-lcore mempool cache */
60 #define MEMPOOL_CACHE_SZ PKT_BURST_SZ
62 /* Number of RX ring descriptors */
65 /* Number of TX ring descriptors */
68 /* Total octets in ethernet header */
69 #define KNI_ENET_HEADER_SIZE 14
71 /* Total octets in the FCS */
72 #define KNI_ENET_FCS_SIZE 4
74 #define KNI_US_PER_SECOND 1000000
75 #define KNI_SECOND_PER_DAY 86400
77 #define KNI_MAX_KTHREAD 32
79 * Structure of port parameters
81 struct kni_port_params {
82 uint16_t port_id;/* Port ID */
83 unsigned lcore_rx; /* lcore ID for RX */
84 unsigned lcore_tx; /* lcore ID for TX */
85 uint32_t nb_lcore_k; /* Number of lcores for KNI multi kernel threads */
86 uint32_t nb_kni; /* Number of KNI devices to be created */
87 unsigned lcore_k[KNI_MAX_KTHREAD]; /* lcore ID list for kthreads */
88 struct rte_kni *kni[KNI_MAX_KTHREAD]; /* KNI context pointers */
89 } __rte_cache_aligned;
91 static struct kni_port_params *kni_port_params_array[RTE_MAX_ETHPORTS];
94 /* Options for configuring ethernet port */
95 static struct rte_eth_conf port_conf = {
97 .mq_mode = RTE_ETH_MQ_TX_NONE,
101 /* Mempool for mbufs */
102 static struct rte_mempool * pktmbuf_pool = NULL;
104 /* Mask of enabled ports */
105 static uint32_t ports_mask = 0;
106 /* Ports set in promiscuous mode off by default. */
107 static int promiscuous_on = 0;
108 /* Monitor link status continually. off by default. */
109 static int monitor_links;
111 /* Structure type for recording kni interface specific stats */
112 struct kni_interface_stats {
113 /* number of pkts received from NIC, and sent to KNI */
116 /* number of pkts received from NIC, but failed to send to KNI */
119 /* number of pkts received from KNI, and sent to NIC */
122 /* number of pkts received from KNI, but failed to send to NIC */
126 /* kni device statistics array */
127 static struct kni_interface_stats kni_stats[RTE_MAX_ETHPORTS];
129 static int kni_change_mtu(uint16_t port_id, unsigned int new_mtu);
130 static int kni_config_network_interface(uint16_t port_id, uint8_t if_up);
131 static int kni_config_mac_address(uint16_t port_id, uint8_t mac_addr[]);
133 static uint32_t kni_stop;
134 static uint32_t kni_pause;
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");
164 /* Custom handling of signals to handle stats and kni processing */
166 signal_handler(int signum)
168 /* When we receive a USR1 signal, print stats */
169 if (signum == SIGUSR1) {
173 /* When we receive a USR2 signal, reset stats */
174 if (signum == SIGUSR2) {
175 memset(&kni_stats, 0, sizeof(kni_stats));
176 printf("\n** Statistics have been reset **\n");
181 * When we receive a RTMIN or SIGINT or SIGTERM signal,
182 * stop kni processing
184 if (signum == SIGRTMIN || signum == SIGINT || signum == SIGTERM) {
185 printf("\nSIGRTMIN/SIGINT/SIGTERM received. "
186 "KNI processing stopping.\n");
187 __atomic_fetch_add(&kni_stop, 1, __ATOMIC_RELAXED);
193 kni_burst_free_mbufs(struct rte_mbuf **pkts, unsigned num)
200 for (i = 0; i < num; i++) {
201 rte_pktmbuf_free(pkts[i]);
207 * Interface to burst rx and enqueue mbufs into rx_q
210 kni_ingress(struct kni_port_params *p)
216 struct rte_mbuf *pkts_burst[PKT_BURST_SZ];
222 port_id = p->port_id;
223 for (i = 0; i < nb_kni; i++) {
224 /* Burst rx from eth */
225 nb_rx = rte_eth_rx_burst(port_id, 0, pkts_burst, PKT_BURST_SZ);
226 if (unlikely(nb_rx > PKT_BURST_SZ)) {
227 RTE_LOG(ERR, APP, "Error receiving from eth\n");
230 /* Burst tx to kni */
231 num = rte_kni_tx_burst(p->kni[i], pkts_burst, nb_rx);
233 kni_stats[port_id].rx_packets += num;
235 rte_kni_handle_request(p->kni[i]);
236 if (unlikely(num < nb_rx)) {
237 /* Free mbufs not tx to kni interface */
238 kni_burst_free_mbufs(&pkts_burst[num], nb_rx - num);
239 kni_stats[port_id].rx_dropped += nb_rx - num;
245 * Interface to dequeue mbufs from tx_q and burst tx
248 kni_egress(struct kni_port_params *p)
254 struct rte_mbuf *pkts_burst[PKT_BURST_SZ];
260 port_id = p->port_id;
261 for (i = 0; i < nb_kni; i++) {
262 /* Burst rx from kni */
263 num = rte_kni_rx_burst(p->kni[i], pkts_burst, PKT_BURST_SZ);
264 if (unlikely(num > PKT_BURST_SZ)) {
265 RTE_LOG(ERR, APP, "Error receiving from KNI\n");
268 /* Burst tx to eth */
269 nb_tx = rte_eth_tx_burst(port_id, 0, pkts_burst, (uint16_t)num);
271 kni_stats[port_id].tx_packets += nb_tx;
272 if (unlikely(nb_tx < num)) {
273 /* Free mbufs not tx to NIC */
274 kni_burst_free_mbufs(&pkts_burst[nb_tx], num - nb_tx);
275 kni_stats[port_id].tx_dropped += num - nb_tx;
281 main_loop(__rte_unused void *arg)
286 const unsigned lcore_id = rte_lcore_id();
293 enum lcore_rxtx flag = LCORE_NONE;
295 RTE_ETH_FOREACH_DEV(i) {
296 if (!kni_port_params_array[i])
298 if (kni_port_params_array[i]->lcore_rx == (uint8_t)lcore_id) {
301 } else if (kni_port_params_array[i]->lcore_tx ==
308 if (flag == LCORE_RX) {
309 RTE_LOG(INFO, APP, "Lcore %u is reading from port %d\n",
310 kni_port_params_array[i]->lcore_rx,
311 kni_port_params_array[i]->port_id);
313 f_stop = __atomic_load_n(&kni_stop, __ATOMIC_RELAXED);
314 f_pause = __atomic_load_n(&kni_pause, __ATOMIC_RELAXED);
319 kni_ingress(kni_port_params_array[i]);
321 } else if (flag == LCORE_TX) {
322 RTE_LOG(INFO, APP, "Lcore %u is writing to port %d\n",
323 kni_port_params_array[i]->lcore_tx,
324 kni_port_params_array[i]->port_id);
326 f_stop = __atomic_load_n(&kni_stop, __ATOMIC_RELAXED);
327 f_pause = __atomic_load_n(&kni_pause, __ATOMIC_RELAXED);
332 kni_egress(kni_port_params_array[i]);
335 RTE_LOG(INFO, APP, "Lcore %u has nothing to do\n", lcore_id);
340 /* Display usage instructions */
342 print_usage(const char *prgname)
344 RTE_LOG(INFO, APP, "\nUsage: %s [EAL options] -- -p PORTMASK -P -m "
345 "[--config (port,lcore_rx,lcore_tx,lcore_kthread...)"
346 "[,(port,lcore_rx,lcore_tx,lcore_kthread...)]]\n"
347 " -p PORTMASK: hex bitmask of ports to use\n"
348 " -P : enable promiscuous mode\n"
349 " -m : enable monitoring of port carrier state\n"
350 " --config (port,lcore_rx,lcore_tx,lcore_kthread...): "
351 "port and lcore configurations\n",
355 /* Convert string to unsigned number. 0 is returned if error occurs */
357 parse_unsigned(const char *portmask)
362 num = strtoul(portmask, &end, 16);
363 if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
366 return (uint32_t)num;
373 struct kni_port_params **p = kni_port_params_array;
375 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
378 RTE_LOG(DEBUG, APP, "Port ID: %d\n", p[i]->port_id);
379 RTE_LOG(DEBUG, APP, "Rx lcore ID: %u, Tx lcore ID: %u\n",
380 p[i]->lcore_rx, p[i]->lcore_tx);
381 for (j = 0; j < p[i]->nb_lcore_k; j++)
382 RTE_LOG(DEBUG, APP, "Kernel thread lcore ID: %u\n",
388 parse_config(const char *arg)
390 const char *p, *p0 = arg;
397 _NUM_FLD = KNI_MAX_KTHREAD + 3,
400 char *str_fld[_NUM_FLD];
401 unsigned long int_fld[_NUM_FLD];
402 uint16_t port_id, nb_kni_port_params = 0;
404 memset(&kni_port_params_array, 0, sizeof(kni_port_params_array));
405 while (((p = strchr(p0, '(')) != NULL) &&
406 nb_kni_port_params < RTE_MAX_ETHPORTS) {
408 if ((p0 = strchr(p, ')')) == NULL)
411 if (size >= sizeof(s)) {
412 printf("Invalid config parameters\n");
415 snprintf(s, sizeof(s), "%.*s", size, p);
416 nb_token = rte_strsplit(s, sizeof(s), str_fld, _NUM_FLD, ',');
417 if (nb_token <= FLD_LCORE_TX) {
418 printf("Invalid config parameters\n");
421 for (i = 0; i < nb_token; i++) {
423 int_fld[i] = strtoul(str_fld[i], &end, 0);
424 if (errno != 0 || end == str_fld[i]) {
425 printf("Invalid config parameters\n");
431 port_id = int_fld[i++];
432 if (port_id >= RTE_MAX_ETHPORTS) {
433 printf("Port ID %d could not exceed the maximum %d\n",
434 port_id, RTE_MAX_ETHPORTS);
437 if (kni_port_params_array[port_id]) {
438 printf("Port %d has been configured\n", port_id);
441 kni_port_params_array[port_id] =
442 rte_zmalloc("KNI_port_params",
443 sizeof(struct kni_port_params), RTE_CACHE_LINE_SIZE);
444 kni_port_params_array[port_id]->port_id = port_id;
445 kni_port_params_array[port_id]->lcore_rx =
446 (uint8_t)int_fld[i++];
447 kni_port_params_array[port_id]->lcore_tx =
448 (uint8_t)int_fld[i++];
449 if (kni_port_params_array[port_id]->lcore_rx >= RTE_MAX_LCORE ||
450 kni_port_params_array[port_id]->lcore_tx >= RTE_MAX_LCORE) {
451 printf("lcore_rx %u or lcore_tx %u ID could not "
452 "exceed the maximum %u\n",
453 kni_port_params_array[port_id]->lcore_rx,
454 kni_port_params_array[port_id]->lcore_tx,
455 (unsigned)RTE_MAX_LCORE);
458 for (j = 0; i < nb_token && j < KNI_MAX_KTHREAD; i++, j++)
459 kni_port_params_array[port_id]->lcore_k[j] =
461 kni_port_params_array[port_id]->nb_lcore_k = j;
468 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
469 if (kni_port_params_array[i]) {
470 rte_free(kni_port_params_array[i]);
471 kni_port_params_array[i] = NULL;
479 validate_parameters(uint32_t portmask)
484 printf("No port configured in port mask\n");
488 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
489 if (((portmask & (1 << i)) && !kni_port_params_array[i]) ||
490 (!(portmask & (1 << i)) && kni_port_params_array[i]))
491 rte_exit(EXIT_FAILURE, "portmask is not consistent "
492 "to port ids specified in --config\n");
494 if (kni_port_params_array[i] && !rte_lcore_is_enabled(\
495 (unsigned)(kni_port_params_array[i]->lcore_rx)))
496 rte_exit(EXIT_FAILURE, "lcore id %u for "
497 "port %d receiving not enabled\n",
498 kni_port_params_array[i]->lcore_rx,
499 kni_port_params_array[i]->port_id);
501 if (kni_port_params_array[i] && !rte_lcore_is_enabled(\
502 (unsigned)(kni_port_params_array[i]->lcore_tx)))
503 rte_exit(EXIT_FAILURE, "lcore id %u for "
504 "port %d transmitting not enabled\n",
505 kni_port_params_array[i]->lcore_tx,
506 kni_port_params_array[i]->port_id);
513 #define CMDLINE_OPT_CONFIG "config"
515 /* Parse the arguments given in the command line of the application */
517 parse_args(int argc, char **argv)
519 int opt, longindex, ret = 0;
520 const char *prgname = argv[0];
521 static struct option longopts[] = {
522 {CMDLINE_OPT_CONFIG, required_argument, NULL, 0},
526 /* Disable printing messages within getopt() */
529 /* Parse command line */
530 while ((opt = getopt_long(argc, argv, "p:Pm", longopts,
531 &longindex)) != EOF) {
534 ports_mask = parse_unsigned(optarg);
543 if (!strncmp(longopts[longindex].name,
545 sizeof(CMDLINE_OPT_CONFIG))) {
546 ret = parse_config(optarg);
548 printf("Invalid config\n");
549 print_usage(prgname);
555 print_usage(prgname);
556 rte_exit(EXIT_FAILURE, "Invalid option specified\n");
560 /* Check that options were parsed ok */
561 if (validate_parameters(ports_mask) < 0) {
562 print_usage(prgname);
563 rte_exit(EXIT_FAILURE, "Invalid parameters\n");
569 /* Initialize KNI subsystem */
573 unsigned int num_of_kni_ports = 0, i;
574 struct kni_port_params **params = kni_port_params_array;
576 /* Calculate the maximum number of KNI interfaces that will be used */
577 for (i = 0; i < RTE_MAX_ETHPORTS; i++) {
578 if (kni_port_params_array[i]) {
579 num_of_kni_ports += (params[i]->nb_lcore_k ?
580 params[i]->nb_lcore_k : 1);
584 /* Invoke rte KNI init to preallocate the ports */
585 rte_kni_init(num_of_kni_ports);
588 /* Initialise a single port on an Ethernet device */
590 init_port(uint16_t port)
593 uint16_t nb_rxd = NB_RXD;
594 uint16_t nb_txd = NB_TXD;
595 struct rte_eth_dev_info dev_info;
596 struct rte_eth_rxconf rxq_conf;
597 struct rte_eth_txconf txq_conf;
598 struct rte_eth_conf local_port_conf = port_conf;
600 /* Initialise device and RX/TX queues */
601 RTE_LOG(INFO, APP, "Initialising port %u ...\n", (unsigned)port);
604 ret = rte_eth_dev_info_get(port, &dev_info);
606 rte_exit(EXIT_FAILURE,
607 "Error during getting device (port %u) info: %s\n",
608 port, strerror(-ret));
610 if (dev_info.tx_offload_capa & RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE)
611 local_port_conf.txmode.offloads |=
612 RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE;
613 ret = rte_eth_dev_configure(port, 1, 1, &local_port_conf);
615 rte_exit(EXIT_FAILURE, "Could not configure port%u (%d)\n",
616 (unsigned)port, ret);
618 ret = rte_eth_dev_adjust_nb_rx_tx_desc(port, &nb_rxd, &nb_txd);
620 rte_exit(EXIT_FAILURE, "Could not adjust number of descriptors "
621 "for port%u (%d)\n", (unsigned)port, ret);
623 rxq_conf = dev_info.default_rxconf;
624 rxq_conf.offloads = local_port_conf.rxmode.offloads;
625 ret = rte_eth_rx_queue_setup(port, 0, nb_rxd,
626 rte_eth_dev_socket_id(port), &rxq_conf, pktmbuf_pool);
628 rte_exit(EXIT_FAILURE, "Could not setup up RX queue for "
629 "port%u (%d)\n", (unsigned)port, ret);
631 txq_conf = dev_info.default_txconf;
632 txq_conf.offloads = local_port_conf.txmode.offloads;
633 ret = rte_eth_tx_queue_setup(port, 0, nb_txd,
634 rte_eth_dev_socket_id(port), &txq_conf);
636 rte_exit(EXIT_FAILURE, "Could not setup up TX queue for "
637 "port%u (%d)\n", (unsigned)port, ret);
639 ret = rte_eth_dev_start(port);
641 rte_exit(EXIT_FAILURE, "Could not start port%u (%d)\n",
642 (unsigned)port, ret);
644 if (promiscuous_on) {
645 ret = rte_eth_promiscuous_enable(port);
647 rte_exit(EXIT_FAILURE,
648 "Could not enable promiscuous mode for port%u: %s\n",
649 port, rte_strerror(-ret));
653 /* Check the link status of all ports in up to 9s, and print them finally */
655 check_all_ports_link_status(uint32_t port_mask)
657 #define CHECK_INTERVAL 100 /* 100ms */
658 #define MAX_CHECK_TIME 90 /* 9s (90 * 100ms) in total */
660 uint8_t count, all_ports_up, print_flag = 0;
661 struct rte_eth_link link;
663 char link_status_text[RTE_ETH_LINK_MAX_STR_LEN];
665 printf("\nChecking link status\n");
667 for (count = 0; count <= MAX_CHECK_TIME; count++) {
669 RTE_ETH_FOREACH_DEV(portid) {
670 if ((port_mask & (1 << portid)) == 0)
672 memset(&link, 0, sizeof(link));
673 ret = rte_eth_link_get_nowait(portid, &link);
677 printf("Port %u link get failed: %s\n",
678 portid, rte_strerror(-ret));
681 /* print link status if flag set */
682 if (print_flag == 1) {
683 rte_eth_link_to_str(link_status_text,
684 sizeof(link_status_text), &link);
685 printf("Port %d %s\n", portid,
689 /* clear all_ports_up flag if any link down */
690 if (link.link_status == RTE_ETH_LINK_DOWN) {
695 /* after finally printing all link status, get out */
699 if (all_ports_up == 0) {
702 rte_delay_ms(CHECK_INTERVAL);
705 /* set the print_flag if all ports up or timeout */
706 if (all_ports_up == 1 || count == (MAX_CHECK_TIME - 1)) {
714 log_link_state(struct rte_kni *kni, int prev, struct rte_eth_link *link)
716 char link_status_text[RTE_ETH_LINK_MAX_STR_LEN];
717 if (kni == NULL || link == NULL)
720 rte_eth_link_to_str(link_status_text, sizeof(link_status_text), link);
721 if (prev != link->link_status)
722 RTE_LOG(INFO, APP, "%s NIC %s",
723 rte_kni_get_name(kni),
728 * Monitor the link status of all ports and update the
729 * corresponding KNI interface(s)
732 monitor_all_ports_link_status(void *arg)
735 struct rte_eth_link link;
737 struct kni_port_params **p = kni_port_params_array;
742 while (monitor_links) {
744 RTE_ETH_FOREACH_DEV(portid) {
745 if ((ports_mask & (1 << portid)) == 0)
747 memset(&link, 0, sizeof(link));
748 ret = rte_eth_link_get_nowait(portid, &link);
751 "Get link failed (port %u): %s\n",
752 portid, rte_strerror(-ret));
755 for (i = 0; i < p[portid]->nb_kni; i++) {
756 prev = rte_kni_update_link(p[portid]->kni[i],
758 log_link_state(p[portid]->kni[i], prev, &link);
766 kni_change_mtu_(uint16_t port_id, unsigned int new_mtu)
769 uint16_t nb_rxd = NB_RXD;
770 uint16_t nb_txd = NB_TXD;
771 struct rte_eth_conf conf;
772 struct rte_eth_dev_info dev_info;
773 struct rte_eth_rxconf rxq_conf;
774 struct rte_eth_txconf txq_conf;
776 if (!rte_eth_dev_is_valid_port(port_id)) {
777 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
781 RTE_LOG(INFO, APP, "Change MTU of port %d to %u\n", port_id, new_mtu);
783 /* Stop specific port */
784 ret = rte_eth_dev_stop(port_id);
786 RTE_LOG(ERR, APP, "Failed to stop port %d: %s\n",
787 port_id, rte_strerror(-ret));
791 memcpy(&conf, &port_conf, sizeof(conf));
793 conf.rxmode.mtu = new_mtu;
794 ret = rte_eth_dev_configure(port_id, 1, 1, &conf);
796 RTE_LOG(ERR, APP, "Fail to reconfigure port %d\n", port_id);
800 ret = rte_eth_dev_adjust_nb_rx_tx_desc(port_id, &nb_rxd, &nb_txd);
802 rte_exit(EXIT_FAILURE, "Could not adjust number of descriptors "
803 "for port%u (%d)\n", (unsigned int)port_id,
806 ret = rte_eth_dev_info_get(port_id, &dev_info);
809 "Error during getting device (port %u) info: %s\n",
810 port_id, strerror(-ret));
815 rxq_conf = dev_info.default_rxconf;
816 rxq_conf.offloads = conf.rxmode.offloads;
817 ret = rte_eth_rx_queue_setup(port_id, 0, nb_rxd,
818 rte_eth_dev_socket_id(port_id), &rxq_conf, pktmbuf_pool);
820 RTE_LOG(ERR, APP, "Fail to setup Rx queue of port %d\n",
825 txq_conf = dev_info.default_txconf;
826 txq_conf.offloads = conf.txmode.offloads;
827 ret = rte_eth_tx_queue_setup(port_id, 0, nb_txd,
828 rte_eth_dev_socket_id(port_id), &txq_conf);
830 RTE_LOG(ERR, APP, "Fail to setup Tx queue of port %d\n",
835 /* Restart specific port */
836 ret = rte_eth_dev_start(port_id);
838 RTE_LOG(ERR, APP, "Fail to restart port %d\n", port_id);
845 /* Callback for request of changing MTU */
847 kni_change_mtu(uint16_t port_id, unsigned int new_mtu)
851 __atomic_fetch_add(&kni_pause, 1, __ATOMIC_RELAXED);
852 ret = kni_change_mtu_(port_id, new_mtu);
853 __atomic_fetch_sub(&kni_pause, 1, __ATOMIC_RELAXED);
858 /* Callback for request of configuring network interface up/down */
860 kni_config_network_interface(uint16_t port_id, uint8_t if_up)
864 if (!rte_eth_dev_is_valid_port(port_id)) {
865 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
869 RTE_LOG(INFO, APP, "Configure network interface of %d %s\n",
870 port_id, if_up ? "up" : "down");
872 __atomic_fetch_add(&kni_pause, 1, __ATOMIC_RELAXED);
874 if (if_up != 0) { /* Configure network interface up */
875 ret = rte_eth_dev_stop(port_id);
877 RTE_LOG(ERR, APP, "Failed to stop port %d: %s\n",
878 port_id, rte_strerror(-ret));
879 __atomic_fetch_sub(&kni_pause, 1, __ATOMIC_RELAXED);
882 ret = rte_eth_dev_start(port_id);
883 } else { /* Configure network interface down */
884 ret = rte_eth_dev_stop(port_id);
886 RTE_LOG(ERR, APP, "Failed to stop port %d: %s\n",
887 port_id, rte_strerror(-ret));
888 __atomic_fetch_sub(&kni_pause, 1, __ATOMIC_RELAXED);
893 __atomic_fetch_sub(&kni_pause, 1, __ATOMIC_RELAXED);
896 RTE_LOG(ERR, APP, "Failed to start port %d\n", port_id);
902 print_ethaddr(const char *name, struct rte_ether_addr *mac_addr)
904 char buf[RTE_ETHER_ADDR_FMT_SIZE];
905 rte_ether_format_addr(buf, RTE_ETHER_ADDR_FMT_SIZE, mac_addr);
906 RTE_LOG(INFO, APP, "\t%s%s\n", name, buf);
909 /* Callback for request of configuring mac address */
911 kni_config_mac_address(uint16_t port_id, uint8_t mac_addr[])
915 if (!rte_eth_dev_is_valid_port(port_id)) {
916 RTE_LOG(ERR, APP, "Invalid port id %d\n", port_id);
920 RTE_LOG(INFO, APP, "Configure mac address of %d\n", port_id);
921 print_ethaddr("Address:", (struct rte_ether_addr *)mac_addr);
923 ret = rte_eth_dev_default_mac_addr_set(port_id,
924 (struct rte_ether_addr *)mac_addr);
926 RTE_LOG(ERR, APP, "Failed to config mac_addr for port %d\n",
933 kni_alloc(uint16_t port_id)
937 struct rte_kni_conf conf;
938 struct kni_port_params **params = kni_port_params_array;
941 if (port_id >= RTE_MAX_ETHPORTS || !params[port_id])
944 params[port_id]->nb_kni = params[port_id]->nb_lcore_k ?
945 params[port_id]->nb_lcore_k : 1;
947 for (i = 0; i < params[port_id]->nb_kni; i++) {
948 /* Clear conf at first */
949 memset(&conf, 0, sizeof(conf));
950 if (params[port_id]->nb_lcore_k) {
951 snprintf(conf.name, RTE_KNI_NAMESIZE,
952 "vEth%u_%u", port_id, i);
953 conf.core_id = params[port_id]->lcore_k[i];
956 snprintf(conf.name, RTE_KNI_NAMESIZE,
958 conf.group_id = port_id;
959 conf.mbuf_size = MAX_PACKET_SZ;
961 * The first KNI device associated to a port
962 * is the main, for multiple kernel thread
966 struct rte_kni_ops ops;
967 struct rte_eth_dev_info dev_info;
969 ret = rte_eth_dev_info_get(port_id, &dev_info);
971 rte_exit(EXIT_FAILURE,
972 "Error during getting device (port %u) info: %s\n",
973 port_id, strerror(-ret));
975 /* Get the interface default mac address */
976 ret = rte_eth_macaddr_get(port_id,
977 (struct rte_ether_addr *)&conf.mac_addr);
979 rte_exit(EXIT_FAILURE,
980 "Failed to get MAC address (port %u): %s\n",
981 port_id, rte_strerror(-ret));
983 rte_eth_dev_get_mtu(port_id, &conf.mtu);
985 conf.min_mtu = dev_info.min_mtu;
986 conf.max_mtu = dev_info.max_mtu;
988 memset(&ops, 0, sizeof(ops));
989 ops.port_id = port_id;
990 ops.change_mtu = kni_change_mtu;
991 ops.config_network_if = kni_config_network_interface;
992 ops.config_mac_address = kni_config_mac_address;
994 kni = rte_kni_alloc(pktmbuf_pool, &conf, &ops);
996 kni = rte_kni_alloc(pktmbuf_pool, &conf, NULL);
999 rte_exit(EXIT_FAILURE, "Fail to create kni for "
1000 "port: %d\n", port_id);
1001 params[port_id]->kni[i] = kni;
1008 kni_free_kni(uint16_t port_id)
1012 struct kni_port_params **p = kni_port_params_array;
1014 if (port_id >= RTE_MAX_ETHPORTS || !p[port_id])
1017 for (i = 0; i < p[port_id]->nb_kni; i++) {
1018 if (rte_kni_release(p[port_id]->kni[i]))
1019 printf("Fail to release kni\n");
1020 p[port_id]->kni[i] = NULL;
1022 ret = rte_eth_dev_stop(port_id);
1024 RTE_LOG(ERR, APP, "Failed to stop port %d: %s\n",
1025 port_id, rte_strerror(-ret));
1026 rte_eth_dev_close(port_id);
1031 /* Initialise ports/queues etc. and start main loop on each core */
1033 main(int argc, char** argv)
1036 uint16_t nb_sys_ports, port;
1039 pthread_t kni_link_tid;
1042 /* Associate signal_handler function with USR signals */
1043 signal(SIGUSR1, signal_handler);
1044 signal(SIGUSR2, signal_handler);
1045 signal(SIGRTMIN, signal_handler);
1046 signal(SIGINT, signal_handler);
1047 signal(SIGTERM, signal_handler);
1049 /* Initialise EAL */
1050 ret = rte_eal_init(argc, argv);
1052 rte_exit(EXIT_FAILURE, "Could not initialise EAL (%d)\n", ret);
1056 /* Parse application arguments (after the EAL ones) */
1057 ret = parse_args(argc, argv);
1059 rte_exit(EXIT_FAILURE, "Could not parse input parameters\n");
1061 /* Create the mbuf pool */
1062 pktmbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", NB_MBUF,
1063 MEMPOOL_CACHE_SZ, 0, MBUF_DATA_SZ, rte_socket_id());
1064 if (pktmbuf_pool == NULL) {
1065 rte_exit(EXIT_FAILURE, "Could not initialise mbuf pool\n");
1069 /* Get number of ports found in scan */
1070 nb_sys_ports = rte_eth_dev_count_avail();
1071 if (nb_sys_ports == 0)
1072 rte_exit(EXIT_FAILURE, "No supported Ethernet device found\n");
1074 /* Check if the configured port ID is valid */
1075 for (i = 0; i < RTE_MAX_ETHPORTS; i++)
1076 if (kni_port_params_array[i] && !rte_eth_dev_is_valid_port(i))
1077 rte_exit(EXIT_FAILURE, "Configured invalid "
1080 /* Initialize KNI subsystem */
1083 /* Initialise each port */
1084 RTE_ETH_FOREACH_DEV(port) {
1085 /* Skip ports that are not enabled */
1086 if (!(ports_mask & (1 << port)))
1090 if (port >= RTE_MAX_ETHPORTS)
1091 rte_exit(EXIT_FAILURE, "Can not use more than "
1092 "%d ports for kni\n", RTE_MAX_ETHPORTS);
1096 check_all_ports_link_status(ports_mask);
1099 RTE_LOG(INFO, APP, "========================\n");
1100 RTE_LOG(INFO, APP, "KNI Running\n");
1101 RTE_LOG(INFO, APP, "kill -SIGUSR1 %d\n", pid);
1102 RTE_LOG(INFO, APP, " Show KNI Statistics.\n");
1103 RTE_LOG(INFO, APP, "kill -SIGUSR2 %d\n", pid);
1104 RTE_LOG(INFO, APP, " Zero KNI Statistics.\n");
1105 RTE_LOG(INFO, APP, "========================\n");
1108 ret = rte_ctrl_thread_create(&kni_link_tid,
1109 "KNI link status check", NULL,
1110 monitor_all_ports_link_status, NULL);
1112 rte_exit(EXIT_FAILURE,
1113 "Could not create link status thread!\n");
1115 /* Launch per-lcore function on every lcore */
1116 rte_eal_mp_remote_launch(main_loop, NULL, CALL_MAIN);
1117 RTE_LCORE_FOREACH_WORKER(i) {
1118 if (rte_eal_wait_lcore(i) < 0)
1122 pthread_join(kni_link_tid, &retval);
1124 /* Release resources */
1125 RTE_ETH_FOREACH_DEV(port) {
1126 if (!(ports_mask & (1 << port)))
1130 for (i = 0; i < RTE_MAX_ETHPORTS; i++)
1131 if (kni_port_params_array[i]) {
1132 rte_free(kni_port_params_array[i]);
1133 kni_port_params_array[i] = NULL;
1136 /* clean up the EAL */