Imported Upstream version 16.04
[deb_dpdk.git] / examples / multi_process / client_server_mp / mp_server / main.c
diff --git a/examples/multi_process/client_server_mp/mp_server/main.c b/examples/multi_process/client_server_mp/mp_server/main.c
new file mode 100644 (file)
index 0000000..de54c67
--- /dev/null
@@ -0,0 +1,319 @@
+/*-
+ *   BSD LICENSE
+ *
+ *   Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
+ *   All rights reserved.
+ *
+ *   Redistribution and use in source and binary forms, with or without
+ *   modification, are permitted provided that the following conditions
+ *   are met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in
+ *       the documentation and/or other materials provided with the
+ *       distribution.
+ *     * Neither the name of Intel Corporation nor the names of its
+ *       contributors may be used to endorse or promote products derived
+ *       from this software without specific prior written permission.
+ *
+ *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <stdint.h>
+#include <stdarg.h>
+#include <inttypes.h>
+#include <inttypes.h>
+#include <sys/queue.h>
+#include <errno.h>
+#include <netinet/ip.h>
+
+#include <rte_common.h>
+#include <rte_memory.h>
+#include <rte_memzone.h>
+#include <rte_eal.h>
+#include <rte_byteorder.h>
+#include <rte_launch.h>
+#include <rte_per_lcore.h>
+#include <rte_lcore.h>
+#include <rte_branch_prediction.h>
+#include <rte_atomic.h>
+#include <rte_ring.h>
+#include <rte_log.h>
+#include <rte_debug.h>
+#include <rte_mempool.h>
+#include <rte_memcpy.h>
+#include <rte_mbuf.h>
+#include <rte_ether.h>
+#include <rte_interrupts.h>
+#include <rte_pci.h>
+#include <rte_ethdev.h>
+#include <rte_byteorder.h>
+#include <rte_malloc.h>
+#include <rte_fbk_hash.h>
+#include <rte_string_fns.h>
+
+#include "common.h"
+#include "args.h"
+#include "init.h"
+
+/*
+ * When doing reads from the NIC or the client queues,
+ * use this batch size
+ */
+#define PACKET_READ_SIZE 32
+
+/*
+ * Local buffers to put packets in, used to send packets in bursts to the
+ * clients
+ */
+struct client_rx_buf {
+       struct rte_mbuf *buffer[PACKET_READ_SIZE];
+       uint16_t count;
+};
+
+/* One buffer per client rx queue - dynamically allocate array */
+static struct client_rx_buf *cl_rx_buf;
+
+static const char *
+get_printable_mac_addr(uint8_t port)
+{
+       static const char err_address[] = "00:00:00:00:00:00";
+       static char addresses[RTE_MAX_ETHPORTS][sizeof(err_address)];
+
+       if (unlikely(port >= RTE_MAX_ETHPORTS))
+               return err_address;
+       if (unlikely(addresses[port][0]=='\0')){
+               struct ether_addr mac;
+               rte_eth_macaddr_get(port, &mac);
+               snprintf(addresses[port], sizeof(addresses[port]),
+                               "%02x:%02x:%02x:%02x:%02x:%02x\n",
+                               mac.addr_bytes[0], mac.addr_bytes[1], mac.addr_bytes[2],
+                               mac.addr_bytes[3], mac.addr_bytes[4], mac.addr_bytes[5]);
+       }
+       return addresses[port];
+}
+
+/*
+ * This function displays the recorded statistics for each port
+ * and for each client. It uses ANSI terminal codes to clear
+ * screen when called. It is called from a single non-master
+ * thread in the server process, when the process is run with more
+ * than one lcore enabled.
+ */
+static void
+do_stats_display(void)
+{
+       unsigned i, j;
+       const char clr[] = { 27, '[', '2', 'J', '\0' };
+       const char topLeft[] = { 27, '[', '1', ';', '1', 'H','\0' };
+       uint64_t port_tx[RTE_MAX_ETHPORTS], port_tx_drop[RTE_MAX_ETHPORTS];
+       uint64_t client_tx[MAX_CLIENTS], client_tx_drop[MAX_CLIENTS];
+
+       /* to get TX stats, we need to do some summing calculations */
+       memset(port_tx, 0, sizeof(port_tx));
+       memset(port_tx_drop, 0, sizeof(port_tx_drop));
+       memset(client_tx, 0, sizeof(client_tx));
+       memset(client_tx_drop, 0, sizeof(client_tx_drop));
+
+       for (i = 0; i < num_clients; i++){
+               const volatile struct tx_stats *tx = &ports->tx_stats[i];
+               for (j = 0; j < ports->num_ports; j++){
+                       /* assign to local variables here, save re-reading volatile vars */
+                       const uint64_t tx_val = tx->tx[ports->id[j]];
+                       const uint64_t drop_val = tx->tx_drop[ports->id[j]];
+                       port_tx[j] += tx_val;
+                       port_tx_drop[j] += drop_val;
+                       client_tx[i] += tx_val;
+                       client_tx_drop[i] += drop_val;
+               }
+       }
+
+       /* Clear screen and move to top left */
+       printf("%s%s", clr, topLeft);
+
+       printf("PORTS\n");
+       printf("-----\n");
+       for (i = 0; i < ports->num_ports; i++)
+               printf("Port %u: '%s'\t", (unsigned)ports->id[i],
+                               get_printable_mac_addr(ports->id[i]));
+       printf("\n\n");
+       for (i = 0; i < ports->num_ports; i++){
+               printf("Port %u - rx: %9"PRIu64"\t"
+                               "tx: %9"PRIu64"\n",
+                               (unsigned)ports->id[i], ports->rx_stats.rx[i],
+                               port_tx[i]);
+       }
+
+       printf("\nCLIENTS\n");
+       printf("-------\n");
+       for (i = 0; i < num_clients; i++){
+               const unsigned long long rx = clients[i].stats.rx;
+               const unsigned long long rx_drop = clients[i].stats.rx_drop;
+               printf("Client %2u - rx: %9llu, rx_drop: %9llu\n"
+                               "            tx: %9"PRIu64", tx_drop: %9"PRIu64"\n",
+                               i, rx, rx_drop, client_tx[i], client_tx_drop[i]);
+       }
+
+       printf("\n");
+}
+
+/*
+ * The function called from each non-master lcore used by the process.
+ * The test_and_set function is used to randomly pick a single lcore on which
+ * the code to display the statistics will run. Otherwise, the code just
+ * repeatedly sleeps.
+ */
+static int
+sleep_lcore(__attribute__((unused)) void *dummy)
+{
+       /* Used to pick a display thread - static, so zero-initialised */
+       static rte_atomic32_t display_stats;
+
+       /* Only one core should display stats */
+       if (rte_atomic32_test_and_set(&display_stats)) {
+               const unsigned sleeptime = 1;
+               printf("Core %u displaying statistics\n", rte_lcore_id());
+
+               /* Longer initial pause so above printf is seen */
+               sleep(sleeptime * 3);
+
+               /* Loop forever: sleep always returns 0 or <= param */
+               while (sleep(sleeptime) <= sleeptime)
+                       do_stats_display();
+       }
+       return 0;
+}
+
+/*
+ * Function to set all the client statistic values to zero.
+ * Called at program startup.
+ */
+static void
+clear_stats(void)
+{
+       unsigned i;
+
+       for (i = 0; i < num_clients; i++)
+               clients[i].stats.rx = clients[i].stats.rx_drop = 0;
+}
+
+/*
+ * send a burst of traffic to a client, assuming there are packets
+ * available to be sent to this client
+ */
+static void
+flush_rx_queue(uint16_t client)
+{
+       uint16_t j;
+       struct client *cl;
+
+       if (cl_rx_buf[client].count == 0)
+               return;
+
+       cl = &clients[client];
+       if (rte_ring_enqueue_bulk(cl->rx_q, (void **)cl_rx_buf[client].buffer,
+                       cl_rx_buf[client].count) != 0){
+               for (j = 0; j < cl_rx_buf[client].count; j++)
+                       rte_pktmbuf_free(cl_rx_buf[client].buffer[j]);
+               cl->stats.rx_drop += cl_rx_buf[client].count;
+       }
+       else
+               cl->stats.rx += cl_rx_buf[client].count;
+
+       cl_rx_buf[client].count = 0;
+}
+
+/*
+ * marks a packet down to be sent to a particular client process
+ */
+static inline void
+enqueue_rx_packet(uint8_t client, struct rte_mbuf *buf)
+{
+       cl_rx_buf[client].buffer[cl_rx_buf[client].count++] = buf;
+}
+
+/*
+ * This function takes a group of packets and routes them
+ * individually to the client process. Very simply round-robins the packets
+ * without checking any of the packet contents.
+ */
+static void
+process_packets(uint32_t port_num __rte_unused,
+               struct rte_mbuf *pkts[], uint16_t rx_count)
+{
+       uint16_t i;
+       uint8_t client = 0;
+
+       for (i = 0; i < rx_count; i++) {
+               enqueue_rx_packet(client, pkts[i]);
+
+               if (++client == num_clients)
+                       client = 0;
+       }
+
+       for (i = 0; i < num_clients; i++)
+               flush_rx_queue(i);
+}
+
+/*
+ * Function called by the master lcore of the DPDK process.
+ */
+static void
+do_packet_forwarding(void)
+{
+       unsigned port_num = 0; /* indexes the port[] array */
+
+       for (;;) {
+               struct rte_mbuf *buf[PACKET_READ_SIZE];
+               uint16_t rx_count;
+
+               /* read a port */
+               rx_count = rte_eth_rx_burst(ports->id[port_num], 0, \
+                               buf, PACKET_READ_SIZE);
+               ports->rx_stats.rx[port_num] += rx_count;
+
+               /* Now process the NIC packets read */
+               if (likely(rx_count > 0))
+                       process_packets(port_num, buf, rx_count);
+
+               /* move to next port */
+               if (++port_num == ports->num_ports)
+                       port_num = 0;
+       }
+}
+
+int
+main(int argc, char *argv[])
+{
+       /* initialise the system */
+       if (init(argc, argv) < 0 )
+               return -1;
+       RTE_LOG(INFO, APP, "Finished Process Init.\n");
+
+       cl_rx_buf = calloc(num_clients, sizeof(cl_rx_buf[0]));
+
+       /* clear statistics */
+       clear_stats();
+
+       /* put all other cores to sleep bar master */
+       rte_eal_mp_remote_launch(sleep_lcore, NULL, SKIP_MASTER);
+
+       do_packet_forwarding();
+       return 0;
+}