4 * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * * Neither the name of Intel Corporation nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 #include <sys/queue.h>
46 #include <rte_common.h>
48 #include <rte_memory.h>
49 #include <rte_memcpy.h>
50 #include <rte_memzone.h>
51 #include <rte_tailq.h>
53 #include <rte_per_lcore.h>
54 #include <rte_launch.h>
55 #include <rte_atomic.h>
56 #include <rte_cycles.h>
57 #include <rte_prefetch.h>
58 #include <rte_lcore.h>
59 #include <rte_per_lcore.h>
60 #include <rte_branch_prediction.h>
61 #include <rte_interrupts.h>
63 #include <rte_random.h>
64 #include <rte_debug.h>
65 #include <rte_ether.h>
66 #include <rte_ethdev.h>
69 #include <rte_mempool.h>
71 #include <rte_memcpy.h>
75 /* basic constants used in application */
76 #define NUM_QUEUES 128
78 #define NUM_MBUFS 64*1024
79 #define MBUF_CACHE_SIZE 64
80 #define MBUF_SIZE (2048 + sizeof(struct rte_mbuf) + RTE_PKTMBUF_HEADROOM)
82 #define INVALID_PORT_ID 0xFF
84 /* mask of enabled ports */
85 static uint32_t enabled_port_mask = 0;
87 /* number of pools (if user does not specify any, 16 by default */
88 static enum rte_eth_nb_pools num_pools = ETH_16_POOLS;
90 /* empty vmdq+dcb configuration structure. Filled in programatically */
91 static const struct rte_eth_conf vmdq_dcb_conf_default = {
93 .mq_mode = ETH_MQ_RX_VMDQ_DCB,
95 .header_split = 0, /**< Header Split disabled */
96 .hw_ip_checksum = 0, /**< IP checksum offload disabled */
97 .hw_vlan_filter = 0, /**< VLAN filtering disabled */
98 .jumbo_frame = 0, /**< Jumbo Frame Support disabled */
101 .mq_mode = ETH_MQ_TX_NONE,
105 * should be overridden separately in code with
109 .nb_queue_pools = ETH_16_POOLS,
110 .enable_default_pool = 0,
113 .pool_map = {{0, 0},},
119 static uint8_t ports[RTE_MAX_ETHPORTS];
120 static unsigned num_ports = 0;
122 /* array used for printing out statistics */
123 volatile unsigned long rxPackets[ NUM_QUEUES ] = {0};
125 const uint16_t vlan_tags[] = {
126 0, 1, 2, 3, 4, 5, 6, 7,
127 8, 9, 10, 11, 12, 13, 14, 15,
128 16, 17, 18, 19, 20, 21, 22, 23,
129 24, 25, 26, 27, 28, 29, 30, 31
132 /* Builds up the correct configuration for vmdq+dcb based on the vlan tags array
133 * given above, and the number of traffic classes available for use. */
135 get_eth_conf(struct rte_eth_conf *eth_conf, enum rte_eth_nb_pools num_pools)
137 struct rte_eth_vmdq_dcb_conf conf;
140 if (num_pools != ETH_16_POOLS && num_pools != ETH_32_POOLS ) return -1;
142 conf.nb_queue_pools = num_pools;
143 conf.enable_default_pool = 0;
144 conf.default_pool = 0; /* set explicit value, even if not used */
145 conf.nb_pool_maps = sizeof( vlan_tags )/sizeof( vlan_tags[ 0 ]);
146 for (i = 0; i < conf.nb_pool_maps; i++){
147 conf.pool_map[i].vlan_id = vlan_tags[ i ];
148 conf.pool_map[i].pools = 1 << (i % num_pools);
150 for (i = 0; i < ETH_DCB_NUM_USER_PRIORITIES; i++){
151 conf.dcb_queue[i] = (uint8_t)(i % (NUM_QUEUES/num_pools));
153 (void)(rte_memcpy(eth_conf, &vmdq_dcb_conf_default, sizeof(*eth_conf)));
154 (void)(rte_memcpy(ð_conf->rx_adv_conf.vmdq_dcb_conf, &conf,
155 sizeof(eth_conf->rx_adv_conf.vmdq_dcb_conf)));
160 * Initialises a given port using global settings and with the rx buffers
161 * coming from the mbuf_pool passed as parameter
164 port_init(uint8_t port, struct rte_mempool *mbuf_pool)
166 struct rte_eth_conf port_conf;
167 const uint16_t rxRings = ETH_VMDQ_DCB_NUM_QUEUES,
168 txRings = (uint16_t)rte_lcore_count();
169 const uint16_t rxRingSize = 128, txRingSize = 512;
173 retval = get_eth_conf(&port_conf, num_pools);
177 if (port >= rte_eth_dev_count()) return -1;
179 retval = rte_eth_dev_configure(port, rxRings, txRings, &port_conf);
183 for (q = 0; q < rxRings; q ++) {
184 retval = rte_eth_rx_queue_setup(port, q, rxRingSize,
185 rte_eth_dev_socket_id(port),
192 for (q = 0; q < txRings; q ++) {
193 retval = rte_eth_tx_queue_setup(port, q, txRingSize,
194 rte_eth_dev_socket_id(port),
200 retval = rte_eth_dev_start(port);
204 struct ether_addr addr;
205 rte_eth_macaddr_get(port, &addr);
206 printf("Port %u MAC: %02"PRIx8" %02"PRIx8" %02"PRIx8
207 " %02"PRIx8" %02"PRIx8" %02"PRIx8"\n",
209 addr.addr_bytes[0], addr.addr_bytes[1], addr.addr_bytes[2],
210 addr.addr_bytes[3], addr.addr_bytes[4], addr.addr_bytes[5]);
215 /* Check num_pools parameter and set it if OK*/
217 vmdq_parse_num_pools(const char *q_arg)
222 /* parse number string */
223 n = strtol(q_arg, &end, 10);
224 if ((q_arg[0] == '\0') || (end == NULL) || (*end != '\0'))
226 if (n != 16 && n != 32)
229 num_pools = ETH_16_POOLS;
231 num_pools = ETH_32_POOLS;
237 parse_portmask(const char *portmask)
242 /* parse hexadecimal string */
243 pm = strtoul(portmask, &end, 16);
244 if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
255 vmdq_usage(const char *prgname)
257 printf("%s [EAL options] -- -p PORTMASK]\n"
258 " --nb-pools NP: number of pools (16 default, 32)\n",
262 /* Parse the argument (num_pools) given in the command line of the application */
264 vmdq_parse_args(int argc, char **argv)
269 const char *prgname = argv[0];
270 static struct option long_option[] = {
271 {"nb-pools", required_argument, NULL, 0},
275 /* Parse command line */
276 while ((opt = getopt_long(argc, argv, "p:",long_option,&option_index)) != EOF) {
280 enabled_port_mask = parse_portmask(optarg);
281 if (enabled_port_mask == 0) {
282 printf("invalid portmask\n");
288 if (vmdq_parse_num_pools(optarg) == -1){
289 printf("invalid number of pools\n");
300 for(i = 0; i < RTE_MAX_ETHPORTS; i++)
302 if (enabled_port_mask & (1 << i))
303 ports[num_ports++] = (uint8_t)i;
306 if (num_ports < 2 || num_ports % 2) {
307 printf("Current enabled port number is %u,"
308 "but it should be even and at least 2\n",num_ports);
316 #ifndef RTE_EXEC_ENV_BAREMETAL
317 /* When we receive a HUP signal, print out our stats */
319 sighup_handler(int signum)
322 for (q = 0; q < NUM_QUEUES; q ++) {
323 if (q % (NUM_QUEUES/num_pools) == 0)
324 printf("\nPool %u: ", q/(NUM_QUEUES/num_pools));
325 printf("%lu ", rxPackets[ q ]);
327 printf("\nFinished handling signal %d\n", signum);
332 * Main thread that does the work, reading from INPUT_PORT
333 * and writing to OUTPUT_PORT
335 static __attribute__((noreturn)) int
336 lcore_main(void *arg)
338 const uintptr_t core_num = (uintptr_t)arg;
339 const unsigned num_cores = rte_lcore_count();
340 uint16_t startQueue = (uint16_t)(core_num * (NUM_QUEUES/num_cores));
341 uint16_t endQueue = (uint16_t)(startQueue + (NUM_QUEUES/num_cores));
344 printf("Core %u(lcore %u) reading queues %i-%i\n", (unsigned)core_num,
345 rte_lcore_id(), startQueue, endQueue - 1);
348 struct rte_mbuf *buf[32];
349 const uint16_t buf_size = sizeof(buf) / sizeof(buf[0]);
350 for (p = 0; p < num_ports; p++) {
351 const uint8_t src = ports[p];
352 const uint8_t dst = ports[p ^ 1]; /* 0 <-> 1, 2 <-> 3 etc */
354 if ((src == INVALID_PORT_ID) || (dst == INVALID_PORT_ID))
357 for (q = startQueue; q < endQueue; q++) {
358 const uint16_t rxCount = rte_eth_rx_burst(src,
362 rxPackets[q] += rxCount;
364 const uint16_t txCount = rte_eth_tx_burst(dst,
365 (uint16_t)core_num, buf, rxCount);
366 if (txCount != rxCount) {
367 for (i = txCount; i < rxCount; i++)
368 rte_pktmbuf_free(buf[i]);
376 * Update the global var NUM_PORTS and array PORTS according to system ports number
377 * and return valid ports number
379 static unsigned check_ports_num(unsigned nb_ports)
381 unsigned valid_num_ports = num_ports;
384 if (num_ports > nb_ports) {
385 printf("\nSpecified port number(%u) exceeds total system port number(%u)\n",
386 num_ports, nb_ports);
387 num_ports = nb_ports;
390 for (portid = 0; portid < num_ports; portid ++) {
391 if (ports[portid] >= nb_ports) {
392 printf("\nSpecified port ID(%u) exceeds max system port ID(%u)\n",
393 ports[portid], (nb_ports - 1));
394 ports[portid] = INVALID_PORT_ID;
398 return valid_num_ports;
402 /* Main function, does initialisation and calls the per-lcore functions */
404 MAIN(int argc, char *argv[])
407 struct rte_mempool *mbuf_pool;
411 unsigned nb_ports, valid_num_ports;
414 #ifndef RTE_EXEC_ENV_BAREMETAL
415 signal(SIGHUP, sighup_handler);
419 ret = rte_eal_init(argc, argv);
421 rte_exit(EXIT_FAILURE, "Error with EAL initialization\n");
425 /* parse app arguments */
426 ret = vmdq_parse_args(argc, argv);
428 rte_exit(EXIT_FAILURE, "Invalid VMDQ argument\n");
430 cores = rte_lcore_count();
431 if ((cores & (cores - 1)) != 0 || cores > 128) {
432 rte_exit(EXIT_FAILURE,"This program can only run on an even"
433 "number of cores(1-128)\n\n");
436 nb_ports = rte_eth_dev_count();
437 if (nb_ports > RTE_MAX_ETHPORTS)
438 nb_ports = RTE_MAX_ETHPORTS;
441 * Update the global var NUM_PORTS and global array PORTS
442 * and get value of var VALID_NUM_PORTS according to system ports number
444 valid_num_ports = check_ports_num(nb_ports);
446 if (valid_num_ports < 2 || valid_num_ports % 2) {
447 printf("Current valid ports number is %u\n", valid_num_ports);
448 rte_exit(EXIT_FAILURE, "Error with valid ports number is not even or less than 2\n");
451 mbuf_pool = rte_mempool_create("MBUF_POOL", NUM_MBUFS * nb_ports,
452 MBUF_SIZE, MBUF_CACHE_SIZE,
453 sizeof(struct rte_pktmbuf_pool_private),
454 rte_pktmbuf_pool_init, NULL,
455 rte_pktmbuf_init, NULL,
457 if (mbuf_pool == NULL)
458 rte_exit(EXIT_FAILURE, "Cannot create mbuf pool\n");
460 /* initialize all ports */
461 for (portid = 0; portid < nb_ports; portid++) {
462 /* skip ports that are not enabled */
463 if ((enabled_port_mask & (1 << portid)) == 0) {
464 printf("\nSkipping disabled port %d\n", portid);
467 if (port_init(portid, mbuf_pool) != 0)
468 rte_exit(EXIT_FAILURE, "Cannot initialize network ports\n");
471 /* call lcore_main() on every slave lcore */
473 RTE_LCORE_FOREACH_SLAVE(lcore_id) {
474 rte_eal_remote_launch(lcore_main, (void*)i++, lcore_id);
476 /* call on master too */
477 (void) lcore_main((void*)i);