1 /*- 2 * BSD LICENSE 3 * 4 * Copyright(c) 2010-2012 Intel Corporation. All rights reserved. 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 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 16 * distribution. 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. 20 * 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. 32 * 33 * version: DPDK.L.1.2.3-3 34 */ 35 36 #include <stdio.h> 37 #include <stdlib.h> 38 #include <stdint.h> 39 #include <getopt.h> 40 #include <stdarg.h> 41 #include <errno.h> 42 43 #include <rte_memory.h> 44 #include <rte_string_fns.h> 45 46 #include "common.h" 47 #include "args.h" 48 #include "init.h" 49 50 /* global var for number of clients - extern in header */ 51 uint8_t num_clients; 52 53 static const char *progname; 54 55 /** 56 * Prints out usage information to stdout 57 */ 58 static void 59 usage(void) 60 { 61 printf( 62 "%s [EAL options] -- -p PORTMASK -n NUM_CLIENTS [-s NUM_SOCKETS]\n" 63 " -p PORTMASK: hexadecimal bitmask of ports to use\n" 64 " -n NUM_CLIENTS: number of client processes to use\n" 65 , progname); 66 } 67 68 /** 69 * The ports to be used by the application are passed in 70 * the form of a bitmask. This function parses the bitmask 71 * and places the port numbers to be used into the port[] 72 * array variable 73 */ 74 static int 75 parse_portmask(uint8_t max_ports, const char *portmask) 76 { 77 char *end = NULL; 78 unsigned long pm; 79 uint8_t count = 0; 80 81 if (portmask == NULL || *portmask == '\0') 82 return -1; 83 84 /* convert parameter to a number and verify */ 85 pm = strtoul(portmask, &end, 16); 86 if (end == NULL || *end != '\0' || pm == 0) 87 return -1; 88 89 /* loop through bits of the mask and mark ports */ 90 while (pm != 0){ 91 if (pm & 0x01){ /* bit is set in mask, use port */ 92 if (count >= max_ports) 93 printf("WARNING: requested port %u not present" 94 " - ignoring\n", (unsigned)count); 95 else 96 ports->id[ports->num_ports++] = count; 97 } 98 pm = (pm >> 1); 99 count++; 100 } 101 102 return 0; 103 } 104 105 /** 106 * Take the number of clients parameter passed to the app 107 * and convert to a number to store in the num_clients variable 108 */ 109 static int 110 parse_num_clients(const char *clients) 111 { 112 char *end = NULL; 113 unsigned long temp; 114 115 if (clients == NULL || *clients == '\0') 116 return -1; 117 118 temp = strtoul(clients, &end, 10); 119 if (end == NULL || *end != '\0' || temp == 0) 120 return -1; 121 122 num_clients = (uint8_t)temp; 123 return 0; 124 } 125 126 /** 127 * The application specific arguments follow the DPDK-specific 128 * arguments which are stripped by the DPDK init. This function 129 * processes these application arguments, printing usage info 130 * on error. 131 */ 132 int 133 parse_app_args(uint8_t max_ports, int argc, char *argv[]) 134 { 135 int option_index, opt; 136 char **argvopt = argv; 137 static struct option lgopts[] = { /* no long options */ 138 {NULL, 0, 0, 0 } 139 }; 140 progname = argv[0]; 141 142 while ((opt = getopt_long(argc, argvopt, "n:p:", lgopts, 143 &option_index)) != EOF){ 144 switch (opt){ 145 case 'p': 146 if (parse_portmask(max_ports, optarg) != 0){ 147 usage(); 148 return -1; 149 } 150 break; 151 case 'n': 152 if (parse_num_clients(optarg) != 0){ 153 usage(); 154 return -1; 155 } 156 break; 157 default: 158 printf("ERROR: Unknown option '%c'\n", opt); 159 usage(); 160 return -1; 161 } 162 } 163 164 if (ports->num_ports == 0 || num_clients == 0){ 165 usage(); 166 return -1; 167 } 168 169 if (ports->num_ports % 2 != 0){ 170 printf("ERROR: application requires an even number of ports to use\n"); 171 return -1; 172 } 173 return 0; 174 } 175 176