doc: announce behavior change in bus probing
[dpdk.git] / examples / flow_filtering / main.c
index 27e287a..bfc1949 100644 (file)
@@ -9,7 +9,6 @@
 #include <inttypes.h>
 #include <sys/types.h>
 #include <sys/queue.h>
-#include <netinet/in.h>
 #include <setjmp.h>
 #include <stdarg.h>
 #include <ctype.h>
@@ -45,23 +44,26 @@ struct rte_flow *flow;
 #include "flow_blocks.c"
 
 static inline void
-print_ether_addr(const char *what, struct ether_addr *eth_addr)
+print_ether_addr(const char *what, struct rte_ether_addr *eth_addr)
 {
-       char buf[ETHER_ADDR_FMT_SIZE];
-       ether_format_addr(buf, ETHER_ADDR_FMT_SIZE, eth_addr);
+       char buf[RTE_ETHER_ADDR_FMT_SIZE];
+       rte_ether_format_addr(buf, RTE_ETHER_ADDR_FMT_SIZE, eth_addr);
        printf("%s%s", what, buf);
 }
 
-static void
+/* Main_loop for flow filtering. 8< */
+static int
 main_loop(void)
 {
        struct rte_mbuf *mbufs[32];
-       struct ether_hdr *eth_hdr;
+       struct rte_ether_hdr *eth_hdr;
        struct rte_flow_error error;
        uint16_t nb_rx;
        uint16_t i;
        uint16_t j;
+       int ret;
 
+       /* Reading the packets from all queues. 8< */
        while (!force_quit) {
                for (i = 0; i < nr_queues; i++) {
                        nb_rx = rte_eth_rx_burst(port_id,
@@ -71,11 +73,11 @@ main_loop(void)
                                        struct rte_mbuf *m = mbufs[j];
 
                                        eth_hdr = rte_pktmbuf_mtod(m,
-                                                       struct ether_hdr *);
+                                                       struct rte_ether_hdr *);
                                        print_ether_addr("src=",
-                                                       &eth_hdr->s_addr);
+                                                       &eth_hdr->src_addr);
                                        print_ether_addr(" - dst=",
-                                                       &eth_hdr->d_addr);
+                                                       &eth_hdr->dst_addr);
                                        printf(" - queue=0x%x",
                                                        (unsigned int)i);
                                        printf("\n");
@@ -85,12 +87,18 @@ main_loop(void)
                        }
                }
        }
+       /* >8 End of reading the packets from all queues. */
 
        /* closing and releasing resources */
        rte_flow_flush(port_id, &error);
-       rte_eth_dev_stop(port_id);
+       ret = rte_eth_dev_stop(port_id);
+       if (ret < 0)
+               printf("Failed to stop port %u: %s",
+                      port_id, rte_strerror(-ret));
        rte_eth_dev_close(port_id);
+       return ret;
 }
+/* >8 End of main_loop for flow filtering. */
 
 #define CHECK_INTERVAL 1000  /* 100ms */
 #define MAX_REPEAT_TIMES 90  /* 9s (90 * 100ms) in total */
@@ -100,44 +108,55 @@ assert_link_status(void)
 {
        struct rte_eth_link link;
        uint8_t rep_cnt = MAX_REPEAT_TIMES;
+       int link_get_err = -EINVAL;
 
        memset(&link, 0, sizeof(link));
        do {
-               rte_eth_link_get(port_id, &link);
-               if (link.link_status == ETH_LINK_UP)
+               link_get_err = rte_eth_link_get(port_id, &link);
+               if (link_get_err == 0 && link.link_status == RTE_ETH_LINK_UP)
                        break;
                rte_delay_ms(CHECK_INTERVAL);
        } while (--rep_cnt);
 
-       if (link.link_status == ETH_LINK_DOWN)
+       if (link_get_err < 0)
+               rte_exit(EXIT_FAILURE, ":: error: link get is failing: %s\n",
+                        rte_strerror(-link_get_err));
+       if (link.link_status == RTE_ETH_LINK_DOWN)
                rte_exit(EXIT_FAILURE, ":: error: link is still down\n");
 }
 
+/* Port initialization used in flow filtering. 8< */
 static void
 init_port(void)
 {
        int ret;
        uint16_t i;
+       /* Ethernet port configured with default settings. 8< */
        struct rte_eth_conf port_conf = {
                .rxmode = {
                        .split_hdr_size = 0,
                },
                .txmode = {
                        .offloads =
-                               DEV_TX_OFFLOAD_VLAN_INSERT |
-                               DEV_TX_OFFLOAD_IPV4_CKSUM  |
-                               DEV_TX_OFFLOAD_UDP_CKSUM   |
-                               DEV_TX_OFFLOAD_TCP_CKSUM   |
-                               DEV_TX_OFFLOAD_SCTP_CKSUM  |
-                               DEV_TX_OFFLOAD_TCP_TSO,
+                               RTE_ETH_TX_OFFLOAD_VLAN_INSERT |
+                               RTE_ETH_TX_OFFLOAD_IPV4_CKSUM  |
+                               RTE_ETH_TX_OFFLOAD_UDP_CKSUM   |
+                               RTE_ETH_TX_OFFLOAD_TCP_CKSUM   |
+                               RTE_ETH_TX_OFFLOAD_SCTP_CKSUM  |
+                               RTE_ETH_TX_OFFLOAD_TCP_TSO,
                },
        };
        struct rte_eth_txconf txq_conf;
        struct rte_eth_rxconf rxq_conf;
        struct rte_eth_dev_info dev_info;
 
-       rte_eth_dev_info_get(port_id, &dev_info);
-       port_conf.txmode.offloads &= dev_info.rx_offload_capa;
+       ret = rte_eth_dev_info_get(port_id, &dev_info);
+       if (ret != 0)
+               rte_exit(EXIT_FAILURE,
+                       "Error during getting device (port %u) info: %s\n",
+                       port_id, strerror(-ret));
+
+       port_conf.txmode.offloads &= dev_info.tx_offload_capa;
        printf(":: initializing port: %d\n", port_id);
        ret = rte_eth_dev_configure(port_id,
                                nr_queues, nr_queues, &port_conf);
@@ -149,7 +168,9 @@ init_port(void)
 
        rxq_conf = dev_info.default_rxconf;
        rxq_conf.offloads = port_conf.rxmode.offloads;
-       /* only set Rx queues: something we care only so far */
+       /* >8 End of ethernet port configured with default settings. */
+
+       /* Configuring number of RX and TX queues connected to single port. 8< */
        for (i = 0; i < nr_queues; i++) {
                ret = rte_eth_rx_queue_setup(port_id, i, 512,
                                     rte_eth_dev_socket_id(port_id),
@@ -175,19 +196,30 @@ init_port(void)
                                ret, port_id);
                }
        }
+       /* >8 End of Configuring RX and TX queues connected to single port. */
+
+       /* Setting the RX port to promiscuous mode. 8< */
+       ret = rte_eth_promiscuous_enable(port_id);
+       if (ret != 0)
+               rte_exit(EXIT_FAILURE,
+                       ":: promiscuous mode enable failed: err=%s, port=%u\n",
+                       rte_strerror(-ret), port_id);
+       /* >8 End of setting the RX port to promiscuous mode. */
 
-       rte_eth_promiscuous_enable(port_id);
+       /* Starting the port. 8< */
        ret = rte_eth_dev_start(port_id);
        if (ret < 0) {
                rte_exit(EXIT_FAILURE,
                        "rte_eth_dev_start:err=%d, port=%u\n",
                        ret, port_id);
        }
+       /* >8 End of starting the port. */
 
        assert_link_status();
 
        printf(":: initializing port: %d done\n", port_id);
 }
+/* >8 End of Port initialization used in flow filtering. */
 
 static void
 signal_handler(int signum)
@@ -206,9 +238,11 @@ main(int argc, char **argv)
        uint16_t nr_ports;
        struct rte_flow_error error;
 
+       /* Initialize EAL. 8< */
        ret = rte_eal_init(argc, argv);
        if (ret < 0)
                rte_exit(EXIT_FAILURE, ":: invalid EAL arguments\n");
+       /* >8 End of Initialization of EAL. */
 
        force_quit = false;
        signal(SIGINT, signal_handler);
@@ -222,26 +256,37 @@ main(int argc, char **argv)
                printf(":: warn: %d ports detected, but we use only one: port %u\n",
                        nr_ports, port_id);
        }
+       /* Allocates a mempool to hold the mbufs. 8< */
        mbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", 4096, 128, 0,
                                            RTE_MBUF_DEFAULT_BUF_SIZE,
                                            rte_socket_id());
+       /* >8 End of allocating a mempool to hold the mbufs. */
        if (mbuf_pool == NULL)
                rte_exit(EXIT_FAILURE, "Cannot init mbuf pool\n");
 
+       /* Initializes all the ports using the user defined init_port(). 8< */
        init_port();
+       /* >8 End of Initializing the ports using user defined init_port(). */
 
-       /* create flow for send packet with */
+       /* Create flow for send packet with. 8< */
        flow = generate_ipv4_flow(port_id, selected_queue,
                                SRC_IP, EMPTY_MASK,
                                DEST_IP, FULL_MASK, &error);
+       /* >8 End of create flow and the flow rule. */
        if (!flow) {
                printf("Flow can't be created %d message: %s\n",
                        error.type,
                        error.message ? error.message : "(no stated reason)");
                rte_exit(EXIT_FAILURE, "error in creating flow");
        }
+       /* >8 End of creating flow for send packet with. */
+
+       /* Launching main_loop(). 8< */
+       ret = main_loop();
+       /* >8 End of launching main_loop(). */
 
-       main_loop();
+       /* clean up the EAL */
+       rte_eal_cleanup();
 
-       return 0;
+       return ret;
 }