[PATCH] Abort early for bad option given to --cmdhelp
[fio.git] / parse.c
1 /*
2  * This file contains the ini and command liner parser main.
3  */
4 #include <stdio.h>
5 #include <stdlib.h>
6 #include <unistd.h>
7 #include <ctype.h>
8 #include <string.h>
9 #include <errno.h>
10 #include <limits.h>
11
12 #include "parse.h"
13
14 static unsigned long get_mult_time(char c)
15 {
16         switch (c) {
17                 case 'm':
18                 case 'M':
19                         return 60;
20                 case 'h':
21                 case 'H':
22                         return 60 * 60;
23                 case 'd':
24                 case 'D':
25                         return 24 * 60 * 60;
26                 default:
27                         return 1;
28         }
29 }
30
31 static unsigned long get_mult_bytes(char c)
32 {
33         switch (c) {
34                 case 'k':
35                 case 'K':
36                         return 1024;
37                 case 'm':
38                 case 'M':
39                         return 1024 * 1024;
40                 case 'g':
41                 case 'G':
42                         return 1024 * 1024 * 1024;
43                 default:
44                         return 1;
45         }
46 }
47
48 /*
49  * convert string into decimal value, noting any size suffix
50  */
51 static int str_to_decimal(const char *str, long long *val, int kilo)
52 {
53         int len;
54
55         len = strlen(str);
56         if (!len)
57                 return 1;
58
59         *val = strtol(str, NULL, 10);
60         if (*val == LONG_MAX && errno == ERANGE)
61                 return 1;
62
63         if (kilo)
64                 *val *= get_mult_bytes(str[len - 1]);
65         else
66                 *val *= get_mult_time(str[len - 1]);
67
68         return 0;
69 }
70
71 static int check_str_bytes(const char *p, long long *val)
72 {
73         return str_to_decimal(p, val, 1);
74 }
75
76 static int check_str_time(const char *p, long long *val)
77 {
78         return str_to_decimal(p, val, 0);
79 }
80
81 void strip_blank_front(char **p)
82 {
83         char *s = *p;
84
85         while (isspace(*s))
86                 s++;
87 }
88
89 void strip_blank_end(char *p)
90 {
91         char *s = p + strlen(p) - 1;
92
93         while (isspace(*s) || iscntrl(*s))
94                 s--;
95
96         *(s + 1) = '\0';
97 }
98
99 static int check_range_bytes(const char *str, long *val)
100 {
101         char suffix;
102
103         if (!strlen(str))
104                 return 1;
105
106         if (sscanf(str, "%lu%c", val, &suffix) == 2) {
107                 *val *= get_mult_bytes(suffix);
108                 return 0;
109         }
110
111         if (sscanf(str, "%lu", val) == 1)
112                 return 0;
113
114         return 1;
115 }
116
117 static int check_int(const char *p, int *val)
118 {
119         if (!strlen(p))
120                 return 1;
121         if (sscanf(p, "%u", val) == 1)
122                 return 0;
123
124         return 1;
125 }
126
127 static struct fio_option *find_option(struct fio_option *options,
128                                       const char *opt)
129 {
130         struct fio_option *o;
131
132         for (o = &options[0]; o->name; o++) {
133                 if (!strcmp(o->name, opt))
134                         return o;
135                 else if (o->alias && !strcmp(o->alias, opt))
136                         return o;
137         }
138
139         return NULL;
140 }
141
142 #define val_store(ptr, val, off, data)                  \
143         do {                                            \
144                 ptr = td_var((data), (off));            \
145                 *ptr = (val);                           \
146         } while (0)
147
148 static int __handle_option(struct fio_option *o, const char *ptr, void *data,
149                            int first, int more)
150 {
151         int il, *ilp;
152         long long ull, *ullp;
153         long ul1, ul2;
154         char **cp;
155         int ret = 0, is_time = 0;
156
157         if (!ptr && o->type != FIO_OPT_STR_SET) {
158                 fprintf(stderr, "Option %s requires an argument\n", o->name);
159                 return 1;
160         }
161
162         switch (o->type) {
163         case FIO_OPT_STR: {
164                 fio_opt_str_fn *fn = o->cb;
165
166                 ret = fn(data, ptr);
167                 break;
168         }
169         case FIO_OPT_STR_VAL_TIME:
170                 is_time = 1;
171         case FIO_OPT_STR_VAL:
172         case FIO_OPT_STR_VAL_INT: {
173                 fio_opt_str_val_fn *fn = o->cb;
174
175                 if (is_time)
176                         ret = check_str_time(ptr, &ull);
177                 else
178                         ret = check_str_bytes(ptr, &ull);
179
180                 if (ret)
181                         break;
182
183                 if (o->maxval && ull > o->maxval) {
184                         fprintf(stderr, "max value out of range: %lld (%d max)\n", ull, o->maxval);
185                         return 1;
186                 }
187                 if (o->minval && ull < o->minval) {
188                         fprintf(stderr, "min value out of range: %lld (%d min)\n", ull, o->minval);
189                         return 1;
190                 }
191
192                 if (fn)
193                         ret = fn(data, &ull);
194                 else {
195                         if (o->type == FIO_OPT_STR_VAL_INT) {
196                                 if (first)
197                                         val_store(ilp, ull, o->off1, data);
198                                 if (!more && o->off2)
199                                         val_store(ilp, ull, o->off2, data);
200                         } else {
201                                 if (first)
202                                         val_store(ullp, ull, o->off1, data);
203                                 if (!more && o->off2)
204                                         val_store(ullp, ull, o->off2, data);
205                         }
206                 }
207                 break;
208         }
209         case FIO_OPT_STR_STORE:
210                 cp = td_var(data, o->off1);
211                 *cp = strdup(ptr);
212                 break;
213         case FIO_OPT_RANGE: {
214                 char tmp[128];
215                 char *p1, *p2;
216
217                 strncpy(tmp, ptr, sizeof(tmp) - 1);
218
219                 p1 = strchr(tmp, '-');
220                 if (!p1) {
221                         ret = 1;
222                         break;
223                 }
224
225                 p2 = p1 + 1;
226                 *p1 = '\0';
227                 p1 = tmp;
228
229                 ret = 1;
230                 if (!check_range_bytes(p1, &ul1) && !check_range_bytes(p2, &ul2)) {
231                         ret = 0;
232                         if (ul1 > ul2) {
233                                 unsigned long foo = ul1;
234
235                                 ul1 = ul2;
236                                 ul2 = foo;
237                         }
238
239                         if (first) {
240                                 val_store(ilp, ul1, o->off1, data);
241                                 val_store(ilp, ul2, o->off2, data);
242                         }
243                         if (!more && o->off3 && o->off4) {
244                                 val_store(ilp, ul1, o->off3, data);
245                                 val_store(ilp, ul2, o->off4, data);
246                         }
247                 }
248
249                 break;
250         }
251         case FIO_OPT_INT:
252         case FIO_OPT_BOOL: {
253                 fio_opt_int_fn *fn = o->cb;
254
255                 ret = check_int(ptr, &il);
256                 if (ret)
257                         break;
258
259                 if (o->maxval && il > (int) o->maxval) {
260                         fprintf(stderr, "max value out of range: %d (%d max)\n", il, o->maxval);
261                         return 1;
262                 }
263                 if (o->minval && il < o->minval) {
264                         fprintf(stderr, "min value out of range: %d (%d min)\n", il, o->minval);
265                         return 1;
266                 }
267
268                 if (o->neg)
269                         il = !il;
270
271                 if (fn)
272                         ret = fn(data, &il);
273                 else {
274                         if (first)
275                                 val_store(ilp, il, o->off1, data);
276                         if (!more && o->off2)
277                                 val_store(ilp, il, o->off2, data);
278                 }
279                 break;
280         }
281         case FIO_OPT_STR_SET: {
282                 fio_opt_str_set_fn *fn = o->cb;
283
284                 if (fn)
285                         ret = fn(data);
286                 else {
287                         if (first)
288                                 val_store(ilp, 1, o->off1, data);
289                         if (!more && o->off2)
290                                 val_store(ilp, 1, o->off2, data);
291                 }
292                 break;
293         }
294         default:
295                 fprintf(stderr, "Bad option type %u\n", o->type);
296                 ret = 1;
297         }
298
299         return ret;
300 }
301
302 static int handle_option(struct fio_option *o, const char *ptr, void *data)
303 {
304         const char *ptr2 = NULL;
305         int r1, r2;
306
307         /*
308          * See if we have a second set of parameters, hidden after a comma.
309          * Do this before parsing the first round, to check if we should
310          * copy set 1 options to set 2.
311          */
312         if (ptr)
313                 ptr2 = strchr(ptr, ',');
314
315         /*
316          * Don't return early if parsing the first option fails - if
317          * we are doing multiple arguments, we can allow the first one
318          * being empty.
319          */
320         r1 = __handle_option(o, ptr, data, 1, !!ptr2);
321
322         if (!ptr2)
323                 return r1;
324
325         ptr2++;
326         r2 = __handle_option(o, ptr2, data, 0, 0);
327
328         return r1 && r2;
329 }
330
331 int parse_cmd_option(const char *opt, const char *val,
332                      struct fio_option *options, void *data)
333 {
334         struct fio_option *o;
335
336         o = find_option(options, opt);
337         if (!o) {
338                 fprintf(stderr, "Bad option %s\n", opt);
339                 return 1;
340         }
341
342         if (!handle_option(o, val, data))
343                 return 0;
344
345         fprintf(stderr, "fio: failed parsing %s=%s\n", opt, val);
346         return 1;
347 }
348
349 int parse_option(const char *opt, struct fio_option *options, void *data)
350 {
351         struct fio_option *o;
352         char *pre, *post;
353         char tmp[64];
354
355         strncpy(tmp, opt, sizeof(tmp) - 1);
356
357         pre = strchr(tmp, '=');
358         if (pre) {
359                 post = pre;
360                 *pre = '\0';
361                 pre = tmp;
362                 post++;
363                 o = find_option(options, pre);
364         } else {
365                 o = find_option(options, tmp);
366                 post = NULL;
367         }
368
369         if (!o) {
370                 fprintf(stderr, "Bad option %s\n", tmp);
371                 return 1;
372         }
373
374         if (!handle_option(o, post, data))
375                 return 0;
376
377         fprintf(stderr, "fio: failed parsing %s\n", opt);
378         return 1;
379 }
380
381 static void show_option_range(struct fio_option *o)
382 {
383         if (!o->minval && !o->maxval)
384                 return;
385
386         printf("%16s: min=%d, max=%d\n", "range", o->minval, o->maxval);
387 }
388
389 static void show_option_values(struct fio_option *o)
390 {
391         const char *msg;
392         int i = 0;
393
394         if (!o->posval)
395                 return;
396
397         do {
398                 msg = o->posval[i];
399                 if (!msg)
400                         break;
401
402                 if (!i)
403                         printf("%16s: ", "valid values");
404
405                 printf("%s,", msg);
406                 i++;
407         } while (1);
408
409         if (i)
410                 printf("\n");
411 }
412
413 int show_cmd_help(struct fio_option *options, const char *name)
414 {
415         int show_all = !strcmp(name, "all");
416         const char *typehelp[] = {
417                 "string (opt=bla)",
418                 "string with possible k/m/g postfix (opt=4k)",
419                 "string with range and postfix (opt=1k-4k)",
420                 "string with time postfix (opt=10s)",
421                 "string (opt=bla)",
422                 "string with dual range (opt=1k-4k,4k-8k)",
423                 "integer value (opt=100)",
424                 "boolean value (opt=1)",
425                 "no argument (opt)",
426         };
427         struct fio_option *o;
428         int found = 0;
429
430         for (o = &options[0]; o->name; o++) {
431                 int match = !strcmp(name, o->name);
432
433                 if (show_all || match) {
434                         found = 1;
435                         printf("%16s: %s\n", o->name, o->help);
436                         if (show_all)
437                                 continue;
438                 }
439
440                 if (!match)
441                         continue;
442
443                 printf("%16s: %s\n", "type", typehelp[o->type]);
444                 printf("%16s: %s\n", "default", o->def ? o->def : "no default");
445                 show_option_range(o);
446                 show_option_values(o);
447         }
448
449         if (found)
450                 return 0;
451
452         printf("No such command: %s\n", name);
453         return 1;
454 }
455
456 /*
457  * Handle parsing of default parameters.
458  */
459 void fill_default_options(void *data, struct fio_option *options)
460 {
461         struct fio_option *o;
462
463         for (o = &options[0]; o->name; o++)
464                 if (o->def)
465                         handle_option(o, o->def, data);
466 }
467
468 /*
469  * Sanitize the options structure. For now it just sets min/max for bool
470  * values and whether both callback and offsets are given.
471  */
472 void options_init(struct fio_option *options)
473 {
474         struct fio_option *o;
475
476         for (o = &options[0]; o->name; o++) {
477                 if (o->type == FIO_OPT_BOOL) {
478                         o->minval = 0;
479                         o->maxval = 1;
480                 }
481                 if (o->cb && (o->off1 || o->off2 || o->off3 || o->off4))
482                         fprintf(stderr, "Option %s: both cb and offset given\n", o->name);
483         }
484 }