ad2782f0fbe93c9ddc822015343390d37f967a98
[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 #include <stdlib.h>
12
13 #include "parse.h"
14 #include "debug.h"
15 #include "options.h"
16
17 static struct fio_option *fio_options;
18 extern unsigned int fio_get_kb_base(void *);
19
20 static int vp_cmp(const void *p1, const void *p2)
21 {
22         const struct value_pair *vp1 = p1;
23         const struct value_pair *vp2 = p2;
24
25         return strlen(vp2->ival) - strlen(vp1->ival);
26 }
27
28 static void posval_sort(struct fio_option *o, struct value_pair *vpmap)
29 {
30         const struct value_pair *vp;
31         int entries;
32
33         memset(vpmap, 0, PARSE_MAX_VP * sizeof(struct value_pair));
34
35         for (entries = 0; entries < PARSE_MAX_VP; entries++) {
36                 vp = &o->posval[entries];
37                 if (!vp->ival || vp->ival[0] == '\0')
38                         break;
39
40                 memcpy(&vpmap[entries], vp, sizeof(*vp));
41         }
42
43         qsort(vpmap, entries, sizeof(struct value_pair), vp_cmp);
44 }
45
46 static void show_option_range(struct fio_option *o, FILE *out)
47 {
48         if (!o->minval && !o->maxval)
49                 return;
50
51         fprintf(out, "%20s: min=%d", "range", o->minval);
52         if (o->maxval)
53                 fprintf(out, ", max=%d", o->maxval);
54         fprintf(out, "\n");
55 }
56
57 static void show_option_values(struct fio_option *o)
58 {
59         int i;
60
61         for (i = 0; i < PARSE_MAX_VP; i++) {
62                 const struct value_pair *vp = &o->posval[i];
63
64                 if (!vp->ival)
65                         continue;
66
67                 printf("%20s: %-10s", i == 0 ? "valid values" : "", vp->ival);
68                 if (vp->help)
69                         printf(" %s", vp->help);
70                 printf("\n");
71         }
72
73         if (i)
74                 printf("\n");
75 }
76
77 static void show_option_help(struct fio_option *o, FILE *out)
78 {
79         const char *typehelp[] = {
80                 "invalid",
81                 "string (opt=bla)",
82                 "string (opt=bla)",
83                 "string with possible k/m/g postfix (opt=4k)",
84                 "string with time postfix (opt=10s)",
85                 "string (opt=bla)",
86                 "string with dual range (opt=1k-4k,4k-8k)",
87                 "integer value (opt=100)",
88                 "boolean value (opt=1)",
89                 "no argument (opt)",
90                 "deprecated",
91         };
92
93         if (o->alias)
94                 fprintf(out, "%20s: %s\n", "alias", o->alias);
95
96         fprintf(out, "%20s: %s\n", "type", typehelp[o->type]);
97         fprintf(out, "%20s: %s\n", "default", o->def ? o->def : "no default");
98         if (o->prof_name)
99                 fprintf(out, "%20s: only for profile '%s'\n", "valid", o->prof_name);
100         show_option_range(o, stdout);
101         show_option_values(o);
102 }
103
104 static unsigned long get_mult_time(char c)
105 {
106         switch (c) {
107         case 'm':
108         case 'M':
109                 return 60;
110         case 'h':
111         case 'H':
112                 return 60 * 60;
113         case 'd':
114         case 'D':
115                 return 24 * 60 * 60;
116         default:
117                 return 1;
118         }
119 }
120
121 static unsigned long long __get_mult_bytes(const char *p, void *data,
122                                            int *percent)
123 {
124         unsigned int kb_base = fio_get_kb_base(data);
125         unsigned long long ret = 1;
126         unsigned int i, pow = 0, mult = kb_base;
127         char *c;
128
129         if (!p)
130                 return 1;
131
132         c = strdup(p);
133
134         for (i = 0; i < strlen(c); i++)
135                 c[i] = tolower(c[i]);
136
137         if (!strcmp("pib", c)) {
138                 pow = 5;
139                 mult = 1000;
140         } else if (!strcmp("tib", c)) {
141                 pow = 4;
142                 mult = 1000;
143         } else if (!strcmp("gib", c)) {
144                 pow = 3;
145                 mult = 1000;
146         } else if (!strcmp("mib", c)) {
147                 pow = 2;
148                 mult = 1000;
149         } else if (!strcmp("kib", c)) {
150                 pow = 1;
151                 mult = 1000;
152         } else if (!strcmp("p", c) || !strcmp("pb", c))
153                 pow = 5;
154         else if (!strcmp("t", c) || !strcmp("tb", c))
155                 pow = 4;
156         else if (!strcmp("g", c) || !strcmp("gb", c))
157                 pow = 3;
158         else if (!strcmp("m", c) || !strcmp("mb", c))
159                 pow = 2;
160         else if (!strcmp("k", c) || !strcmp("kb", c))
161                 pow = 1;
162         else if (!strcmp("%", c)) {
163                 *percent = 1;
164                 return ret;
165         }
166
167         while (pow--)
168                 ret *= (unsigned long long) mult;
169
170         free(c);
171         return ret;
172 }
173
174 static unsigned long long get_mult_bytes(const char *str, int len, void *data,
175                                          int *percent)
176 {
177         const char *p = str;
178
179         if (len < 2)
180                 return __get_mult_bytes(str, data, percent);
181
182         /*
183          * Go forward until we hit a non-digit
184          */
185         while ((p - str) <= len) {
186                 if (!isdigit((int) *p))
187                         break;
188                 p++;
189         }
190
191         if (!isalpha((int) *p) && (*p != '%'))
192                 p = NULL;
193
194         return __get_mult_bytes(p, data, percent);
195 }
196
197 /*
198  * convert string into decimal value, noting any size suffix
199  */
200 int str_to_decimal(const char *str, long long *val, int kilo, void *data)
201 {
202         int len, base;
203
204         len = strlen(str);
205         if (!len)
206                 return 1;
207
208         if (strstr(str, "0x") || strstr(str, "0X"))
209                 base = 16;
210         else
211                 base = 10;
212
213         *val = strtoll(str, NULL, base);
214         if (*val == LONG_MAX && errno == ERANGE)
215                 return 1;
216
217         if (kilo) {
218                 unsigned long long mult;
219                 int perc = 0;
220
221                 mult = get_mult_bytes(str, len, data, &perc);
222                 if (perc)
223                         *val = -1ULL - *val;
224                 else
225                         *val *= mult;
226         } else
227                 *val *= get_mult_time(str[len - 1]);
228
229         return 0;
230 }
231
232 static int check_str_bytes(const char *p, long long *val, void *data)
233 {
234         return str_to_decimal(p, val, 1, data);
235 }
236
237 static int check_str_time(const char *p, long long *val)
238 {
239         return str_to_decimal(p, val, 0, NULL);
240 }
241
242 void strip_blank_front(char **p)
243 {
244         char *s = *p;
245
246         while (isspace((int) *s))
247                 s++;
248
249         *p = s;
250 }
251
252 void strip_blank_end(char *p)
253 {
254         char *start = p, *s;
255
256         s = strchr(p, ';');
257         if (s)
258                 *s = '\0';
259         s = strchr(p, '#');
260         if (s)
261                 *s = '\0';
262         if (s)
263                 p = s;
264
265         s = p + strlen(p);
266         while ((isspace((int) *s) || iscntrl((int) *s)) && (s > start))
267                 s--;
268
269         *(s + 1) = '\0';
270 }
271
272 static int check_range_bytes(const char *str, long *val, void *data)
273 {
274         long long __val;
275
276         if (!str_to_decimal(str, &__val, 1, data)) {
277                 *val = __val;
278                 return 0;
279         }
280
281         return 1;
282 }
283
284 static int check_int(const char *p, int *val)
285 {
286         if (!strlen(p))
287                 return 1;
288         if (strstr(p, "0x") || strstr(p, "0X")) {
289                 if (sscanf(p, "%x", val) == 1)
290                         return 0;
291         } else {
292                 if (sscanf(p, "%u", val) == 1)
293                         return 0;
294         }
295
296         return 1;
297 }
298
299 static int opt_len(const char *str)
300 {
301         char *postfix;
302
303         postfix = strchr(str, ':');
304         if (!postfix)
305                 return strlen(str);
306
307         return (int)(postfix - str);
308 }
309
310 #define val_store(ptr, val, off, or, data)              \
311         do {                                            \
312                 ptr = td_var((data), (off));            \
313                 if ((or))                               \
314                         *ptr |= (val);                  \
315                 else                                    \
316                         *ptr = (val);                   \
317         } while (0)
318
319 static int __handle_option(struct fio_option *o, const char *ptr, void *data,
320                            int first, int more)
321 {
322         int il, *ilp;
323         long long ull, *ullp;
324         long ul1, ul2;
325         char **cp;
326         int ret = 0, is_time = 0;
327
328         dprint(FD_PARSE, "__handle_option=%s, type=%d, ptr=%s\n", o->name,
329                                                         o->type, ptr);
330
331         if (!ptr && o->type != FIO_OPT_STR_SET && o->type != FIO_OPT_STR) {
332                 fprintf(stderr, "Option %s requires an argument\n", o->name);
333                 return 1;
334         }
335
336         switch (o->type) {
337         case FIO_OPT_STR:
338         case FIO_OPT_STR_MULTI: {
339                 fio_opt_str_fn *fn = o->cb;
340                 const struct value_pair *vp;
341                 struct value_pair posval[PARSE_MAX_VP];
342                 int i, all_skipped = 1;
343
344                 posval_sort(o, posval);
345
346                 ret = 1;
347                 for (i = 0; i < PARSE_MAX_VP; i++) {
348                         vp = &posval[i];
349                         if (!vp->ival || vp->ival[0] == '\0')
350                                 continue;
351                         all_skipped = 0;
352                         if (!strncmp(vp->ival, ptr, opt_len(ptr))) {
353                                 ret = 0;
354                                 if (o->roff1) {
355                                         if (vp->or)
356                                                 *(unsigned int *) o->roff1 |= vp->oval;
357                                         else
358                                                 *(unsigned int *) o->roff1 = vp->oval;
359                                 } else {
360                                         if (!o->off1)
361                                                 continue;
362                                         val_store(ilp, vp->oval, o->off1, vp->or, data);
363                                 }
364                                 continue;
365                         }
366                 }
367
368                 if (ret && !all_skipped)
369                         show_option_values(o);
370                 else if (fn)
371                         ret = fn(data, ptr);
372                 break;
373         }
374         case FIO_OPT_STR_VAL_TIME:
375                 is_time = 1;
376         case FIO_OPT_INT:
377         case FIO_OPT_STR_VAL: {
378                 fio_opt_str_val_fn *fn = o->cb;
379
380                 if (is_time)
381                         ret = check_str_time(ptr, &ull);
382                 else
383                         ret = check_str_bytes(ptr, &ull, data);
384
385                 if (ret)
386                         break;
387
388                 if (o->maxval && ull > o->maxval) {
389                         fprintf(stderr, "max value out of range: %lld"
390                                         " (%d max)\n", ull, o->maxval);
391                         return 1;
392                 }
393                 if (o->minval && ull < o->minval) {
394                         fprintf(stderr, "min value out of range: %lld"
395                                         " (%d min)\n", ull, o->minval);
396                         return 1;
397                 }
398
399                 if (fn)
400                         ret = fn(data, &ull);
401                 else {
402                         if (o->type == FIO_OPT_INT) {
403                                 if (first) {
404                                         if (o->roff1)
405                                                 *(unsigned int *) o->roff1 = ull;
406                                         else
407                                                 val_store(ilp, ull, o->off1, 0, data);
408                                 }
409                                 if (!more) {
410                                         if (o->roff2)
411                                                 *(unsigned int *) o->roff2 = ull;
412                                         else if (o->off2)
413                                                 val_store(ilp, ull, o->off2, 0, data);
414                                 }
415                         } else {
416                                 if (first) {
417                                         if (o->roff1)
418                                                 *(unsigned long long *) o->roff1 = ull;
419                                         else
420                                                 val_store(ullp, ull, o->off1, 0, data);
421                                 }
422                                 if (!more) {
423                                         if (o->roff2)
424                                                 *(unsigned long long *) o->roff2 =  ull;
425                                         else if (o->off2)
426                                                 val_store(ullp, ull, o->off2, 0, data);
427                                 }
428                         }
429                 }
430                 break;
431         }
432         case FIO_OPT_STR_STORE: {
433                 fio_opt_str_fn *fn = o->cb;
434
435                 if (o->roff1)
436                         cp = (char **) o->roff1;
437                 else
438                         cp = td_var(data, o->off1);
439
440                 *cp = strdup(ptr);
441                 if (fn) {
442                         ret = fn(data, ptr);
443                         if (ret) {
444                                 free(*cp);
445                                 *cp = NULL;
446                         }
447                 }
448                 break;
449         }
450         case FIO_OPT_RANGE: {
451                 char tmp[128];
452                 char *p1, *p2;
453
454                 strncpy(tmp, ptr, sizeof(tmp) - 1);
455
456                 p1 = strchr(tmp, '-');
457                 if (!p1) {
458                         p1 = strchr(tmp, ':');
459                         if (!p1) {
460                                 ret = 1;
461                                 break;
462                         }
463                 }
464
465                 p2 = p1 + 1;
466                 *p1 = '\0';
467                 p1 = tmp;
468
469                 ret = 1;
470                 if (!check_range_bytes(p1, &ul1, data) &&
471                     !check_range_bytes(p2, &ul2, data)) {
472                         ret = 0;
473                         if (ul1 > ul2) {
474                                 unsigned long foo = ul1;
475
476                                 ul1 = ul2;
477                                 ul2 = foo;
478                         }
479
480                         if (first) {
481                                 if (o->roff1)
482                                         *(unsigned int *) o->roff1 = ul1;
483                                 else
484                                         val_store(ilp, ul1, o->off1, 0, data);
485                                 if (o->roff2)
486                                         *(unsigned int *) o->roff2 = ul2;
487                                 else
488                                         val_store(ilp, ul2, o->off2, 0, data);
489                         }
490                         if (o->roff3 && o->roff4) {
491                                 *(unsigned int *) o->roff3 = ul1;
492                                 *(unsigned int *) o->roff4 = ul2;
493                         } else if (o->off3 && o->off4) {
494                                 val_store(ilp, ul1, o->off3, 0, data);
495                                 val_store(ilp, ul2, o->off4, 0, data);
496                         }
497                 }
498
499                 break;
500         }
501         case FIO_OPT_BOOL:
502         case FIO_OPT_STR_SET: {
503                 fio_opt_int_fn *fn = o->cb;
504
505                 if (ptr)
506                         ret = check_int(ptr, &il);
507                 else if (o->type == FIO_OPT_BOOL)
508                         ret = 1;
509                 else
510                         il = 1;
511
512                 if (ret)
513                         break;
514
515                 if (o->maxval && il > (int) o->maxval) {
516                         fprintf(stderr, "max value out of range: %d (%d max)\n",
517                                                                 il, o->maxval);
518                         return 1;
519                 }
520                 if (o->minval && il < o->minval) {
521                         fprintf(stderr, "min value out of range: %d (%d min)\n",
522                                                                 il, o->minval);
523                         return 1;
524                 }
525
526                 if (o->neg)
527                         il = !il;
528
529                 if (fn)
530                         ret = fn(data, &il);
531                 else {
532                         if (first) {
533                                 if (o->roff1)
534                                         *(unsigned int *)o->roff1 = il;
535                                 else
536                                         val_store(ilp, il, o->off1, 0, data);
537                         }
538                         if (!more) {
539                                 if (o->roff2)
540                                         *(unsigned int *) o->roff2 = il;
541                                 else if (o->off2)
542                                         val_store(ilp, il, o->off2, 0, data);
543                         }
544                 }
545                 break;
546         }
547         case FIO_OPT_DEPRECATED:
548                 fprintf(stdout, "Option %s is deprecated\n", o->name);
549                 break;
550         default:
551                 fprintf(stderr, "Bad option type %u\n", o->type);
552                 ret = 1;
553         }
554
555         if (ret)
556                 return ret;
557
558         if (o->verify) {
559                 ret = o->verify(o, data);
560                 if (ret) {
561                         fprintf(stderr,"Correct format for offending option\n");
562                         fprintf(stderr, "%20s: %s\n", o->name, o->help);
563                         show_option_help(o, stderr);
564                 }
565         }
566
567         return ret;
568 }
569
570 static int handle_option(struct fio_option *o, const char *__ptr, void *data)
571 {
572         char *o_ptr, *ptr, *ptr2;
573         int ret, done;
574
575         dprint(FD_PARSE, "handle_option=%s, ptr=%s\n", o->name, __ptr);
576
577         o_ptr = ptr = NULL;
578         if (__ptr)
579                 o_ptr = ptr = strdup(__ptr);
580
581         /*
582          * See if we have another set of parameters, hidden after a comma.
583          * Do this before parsing this round, to check if we should
584          * copy set 1 options to set 2.
585          */
586         done = 0;
587         ret = 1;
588         do {
589                 int __ret;
590
591                 ptr2 = NULL;
592                 if (ptr &&
593                     (o->type != FIO_OPT_STR_STORE) &&
594                     (o->type != FIO_OPT_STR)) {
595                         ptr2 = strchr(ptr, ',');
596                         if (ptr2 && *(ptr2 + 1) == '\0')
597                                 *ptr2 = '\0';
598                         if (o->type != FIO_OPT_STR_MULTI) {
599                                 if (!ptr2)
600                                         ptr2 = strchr(ptr, ':');
601                                 if (!ptr2)
602                                         ptr2 = strchr(ptr, '-');
603                         }
604                 }
605
606                 /*
607                  * Don't return early if parsing the first option fails - if
608                  * we are doing multiple arguments, we can allow the first one
609                  * being empty.
610                  */
611                 __ret = __handle_option(o, ptr, data, !done, !!ptr2);
612                 if (ret)
613                         ret = __ret;
614
615                 if (!ptr2)
616                         break;
617
618                 ptr = ptr2 + 1;
619                 done++;
620         } while (1);
621
622         if (o_ptr)
623                 free(o_ptr);
624         return ret;
625 }
626
627 static struct fio_option *get_option(const char *opt,
628                                      struct fio_option *options, char **post)
629 {
630         struct fio_option *o;
631         char *ret;
632
633         ret = strchr(opt, '=');
634         if (ret) {
635                 *post = ret;
636                 *ret = '\0';
637                 ret = (char *) opt;
638                 (*post)++;
639                 strip_blank_end(ret);
640                 o = find_option(options, ret);
641         } else {
642                 o = find_option(options, opt);
643                 *post = NULL;
644         }
645
646         return o;
647 }
648
649 static int opt_cmp(const void *p1, const void *p2)
650 {
651         struct fio_option *o1, *o2;
652         char *s1, *s2, *foo;
653         int prio1, prio2;
654
655         s1 = strdup(*((char **) p1));
656         s2 = strdup(*((char **) p2));
657
658         o1 = get_option(s1, fio_options, &foo);
659         o2 = get_option(s2, fio_options, &foo);
660
661         prio1 = prio2 = 0;
662         if (o1)
663                 prio1 = o1->prio;
664         if (o2)
665                 prio2 = o2->prio;
666
667         free(s1);
668         free(s2);
669         return prio2 - prio1;
670 }
671
672 void sort_options(char **opts, struct fio_option *options, int num_opts)
673 {
674         fio_options = options;
675         qsort(opts, num_opts, sizeof(char *), opt_cmp);
676         fio_options = NULL;
677 }
678
679 int parse_cmd_option(const char *opt, const char *val,
680                      struct fio_option *options, void *data)
681 {
682         struct fio_option *o;
683
684         o = find_option(options, opt);
685         if (!o) {
686                 fprintf(stderr, "Bad option <%s>\n", opt);
687                 return 1;
688         }
689
690         if (!handle_option(o, val, data))
691                 return 0;
692
693         fprintf(stderr, "fio: failed parsing %s=%s\n", opt, val);
694         return 1;
695 }
696
697 /*
698  * Return a copy of the input string with substrings of the form ${VARNAME}
699  * substituted with the value of the environment variable VARNAME.  The
700  * substitution always occurs, even if VARNAME is empty or the corresponding
701  * environment variable undefined.
702  */
703 static char *option_dup_subs(const char *opt)
704 {
705         char out[OPT_LEN_MAX+1];
706         char in[OPT_LEN_MAX+1];
707         char *outptr = out;
708         char *inptr = in;
709         char *ch1, *ch2, *env;
710         ssize_t nchr = OPT_LEN_MAX;
711         size_t envlen;
712
713         if (strlen(opt) + 1 > OPT_LEN_MAX) {
714                 fprintf(stderr, "OPT_LEN_MAX (%d) is too small\n", OPT_LEN_MAX);
715                 return NULL;
716         }
717
718         in[OPT_LEN_MAX] = '\0';
719         strncpy(in, opt, OPT_LEN_MAX);
720
721         while (*inptr && nchr > 0) {
722                 if (inptr[0] == '$' && inptr[1] == '{') {
723                         ch2 = strchr(inptr, '}');
724                         if (ch2 && inptr+1 < ch2) {
725                                 ch1 = inptr+2;
726                                 inptr = ch2+1;
727                                 *ch2 = '\0';
728
729                                 env = getenv(ch1);
730                                 if (env) {
731                                         envlen = strlen(env);
732                                         if (envlen <= nchr) {
733                                                 memcpy(outptr, env, envlen);
734                                                 outptr += envlen;
735                                                 nchr -= envlen;
736                                         }
737                                 }
738
739                                 continue;
740                         }
741                 }
742
743                 *outptr++ = *inptr++;
744                 --nchr;
745         }
746
747         *outptr = '\0';
748         return strdup(out);
749 }
750
751 int parse_option(const char *opt, struct fio_option *options, void *data)
752 {
753         struct fio_option *o;
754         char *post, *tmp;
755
756         tmp = option_dup_subs(opt);
757         if (!tmp)
758                 return 1;
759
760         o = get_option(tmp, options, &post);
761         if (!o) {
762                 fprintf(stderr, "Bad option <%s>\n", tmp);
763                 free(tmp);
764                 return 1;
765         }
766
767         if (!handle_option(o, post, data)) {
768                 free(tmp);
769                 return 0;
770         }
771
772         fprintf(stderr, "fio: failed parsing %s\n", opt);
773         free(tmp);
774         return 1;
775 }
776
777 /*
778  * Option match, levenshtein distance. Handy for not quite remembering what
779  * the option name is.
780  */
781 static int string_distance(const char *s1, const char *s2)
782 {
783         unsigned int s1_len = strlen(s1);
784         unsigned int s2_len = strlen(s2);
785         unsigned int *p, *q, *r;
786         unsigned int i, j;
787
788         p = malloc(sizeof(unsigned int) * (s2_len + 1));
789         q = malloc(sizeof(unsigned int) * (s2_len + 1));
790
791         p[0] = 0;
792         for (i = 1; i <= s2_len; i++)
793                 p[i] = p[i - 1] + 1;
794
795         for (i = 1; i <= s1_len; i++) {
796                 q[0] = p[0] + 1;
797                 for (j = 1; j <= s2_len; j++) {
798                         unsigned int sub = p[j - 1];
799
800                         if (s1[i - 1] != s2[j - 1])
801                                 sub++;
802
803                         q[j] = min(p[j] + 1, min(q[j - 1] + 1, sub));
804                 }
805                 r = p;
806                 p = q;
807                 q = r;
808         }
809
810         i = p[s2_len];
811         free(p);
812         free(q);
813         return i;
814 }
815
816 static struct fio_option *find_child(struct fio_option *options,
817                                      struct fio_option *o)
818 {
819         struct fio_option *__o;
820
821         for (__o = options + 1; __o->name; __o++)
822                 if (__o->parent && !strcmp(__o->parent, o->name))
823                         return __o;
824
825         return NULL;
826 }
827
828 static void __print_option(struct fio_option *o, struct fio_option *org,
829                            int level)
830 {
831         char name[256], *p;
832         int depth;
833
834         if (!o)
835                 return;
836         if (!org)
837                 org = o;
838
839         p = name;
840         depth = level;
841         while (depth--)
842                 p += sprintf(p, "%s", "  ");
843
844         sprintf(p, "%s", o->name);
845
846         printf("%-24s: %s\n", name, o->help);
847 }
848
849 static void print_option(struct fio_option *o)
850 {
851         struct fio_option *parent;
852         struct fio_option *__o;
853         unsigned int printed;
854         unsigned int level;
855
856         __print_option(o, NULL, 0);
857         parent = o;
858         level = 0;
859         do {
860                 level++;
861                 printed = 0;
862
863                 while ((__o = find_child(o, parent)) != NULL) {
864                         __print_option(__o, o, level);
865                         o = __o;
866                         printed++;
867                 }
868
869                 parent = o;
870         } while (printed);
871 }
872
873 int show_cmd_help(struct fio_option *options, const char *name)
874 {
875         struct fio_option *o, *closest;
876         unsigned int best_dist = -1U;
877         int found = 0;
878         int show_all = 0;
879
880         if (!name || !strcmp(name, "all"))
881                 show_all = 1;
882
883         closest = NULL;
884         best_dist = -1;
885         for (o = &options[0]; o->name; o++) {
886                 int match = 0;
887
888                 if (o->type == FIO_OPT_DEPRECATED)
889                         continue;
890                 if (!exec_profile && o->prof_name)
891                         continue;
892
893                 if (name) {
894                         if (!strcmp(name, o->name) ||
895                             (o->alias && !strcmp(name, o->alias)))
896                                 match = 1;
897                         else {
898                                 unsigned int dist;
899
900                                 dist = string_distance(name, o->name);
901                                 if (dist < best_dist) {
902                                         best_dist = dist;
903                                         closest = o;
904                                 }
905                         }
906                 }
907
908                 if (show_all || match) {
909                         found = 1;
910                         if (match)
911                                 printf("%20s: %s\n", o->name, o->help);
912                         if (show_all) {
913                                 if (!o->parent)
914                                         print_option(o);
915                                 continue;
916                         }
917                 }
918
919                 if (!match)
920                         continue;
921
922                 show_option_help(o, stdout);
923         }
924
925         if (found)
926                 return 0;
927
928         printf("No such command: %s", name);
929
930         /*
931          * Only print an appropriately close option, one where the edit
932          * distance isn't too big. Otherwise we get crazy matches.
933          */
934         if (closest && best_dist < 3) {
935                 printf(" - showing closest match\n");
936                 printf("%20s: %s\n", closest->name, closest->help);
937                 show_option_help(closest, stdout);
938         } else
939                 printf("\n");
940
941         return 1;
942 }
943
944 /*
945  * Handle parsing of default parameters.
946  */
947 void fill_default_options(void *data, struct fio_option *options)
948 {
949         struct fio_option *o;
950
951         dprint(FD_PARSE, "filling default options\n");
952
953         for (o = &options[0]; o->name; o++)
954                 if (o->def)
955                         handle_option(o, o->def, data);
956 }
957
958 void option_init(struct fio_option *o)
959 {
960         if (o->type == FIO_OPT_DEPRECATED)
961                 return;
962         if (o->type == FIO_OPT_BOOL) {
963                 o->minval = 0;
964                 o->maxval = 1;
965         }
966         if (o->type == FIO_OPT_STR_SET && o->def) {
967                 fprintf(stderr, "Option %s: string set option with"
968                                 " default will always be true\n", o->name);
969         }
970         if (!o->cb && (!o->off1 && !o->roff1)) {
971                 fprintf(stderr, "Option %s: neither cb nor offset given\n",
972                                                         o->name);
973         }
974         if (o->type == FIO_OPT_STR || o->type == FIO_OPT_STR_STORE ||
975             o->type == FIO_OPT_STR_MULTI)
976                 return;
977         if (o->cb && ((o->off1 || o->off2 || o->off3 || o->off4) ||
978                       (o->roff1 || o->roff2 || o->roff3 || o->roff4))) {
979                 fprintf(stderr, "Option %s: both cb and offset given\n",
980                                                          o->name);
981         }
982 }
983
984 /*
985  * Sanitize the options structure. For now it just sets min/max for bool
986  * values and whether both callback and offsets are given.
987  */
988 void options_init(struct fio_option *options)
989 {
990         struct fio_option *o;
991
992         dprint(FD_PARSE, "init options\n");
993
994         for (o = &options[0]; o->name; o++)
995                 option_init(o);
996 }