]> mj.ucw.cz Git - libucw.git/blob - ucw/opt.c
eae95cf135cfbc32d9021578f674478b5c5310c0
[libucw.git] / ucw / opt.c
1 /*
2  *      UCW Library -- Parsing of command line options
3  *
4  *      (c) 2013 Jan Moskyto Matejka <mq@ucw.cz>
5  *      (c) 2014 Martin Mares <mj@ucw.cz>
6  *
7  *      This software may be freely distributed and used according to the terms
8  *      of the GNU Lesser General Public License.
9  */
10
11 #include <ucw/lib.h>
12 #include <ucw/opt.h>
13 #include <ucw/conf.h>
14 #include <ucw/conf-internal.h>
15 #include <ucw/fastbuf.h>
16 #include <ucw/stkstring.h>
17 #include <ucw/strtonum.h>
18
19 #include <alloca.h>
20 #include <math.h>
21
22 /***
23  * Value flags defaults
24  * ~~~~~~~~~~~~~~~~~~~~
25  *
26  * OPT_NO_VALUE for OPT_BOOL, OPT_SWITCH and OPT_INC
27  * OPT_MAYBE_VALUE for OPT_STRING, OPT_UNS, OPT_INT
28  * Some of the value flags (OPT_NO_VALUE, OPT_MAYBE_VALUE, OPT_REQUIRED_VALUE)
29  * must be specified for OPT_CALL and OPT_USER.
30  ***/
31 static uns opt_default_value_flags[] = {
32     [OPT_CL_BOOL] = OPT_NO_VALUE,
33     [OPT_CL_STATIC] = OPT_MAYBE_VALUE,
34     [OPT_CL_SWITCH] = OPT_NO_VALUE,
35     [OPT_CL_INC] = OPT_NO_VALUE,
36     [OPT_CL_CALL] = 0,
37     [OPT_CL_USER] = 0,
38     [OPT_CL_SECTION] = 0,
39     [OPT_CL_HELP] = 0
40 };
41
42 struct opt_precomputed {
43   struct opt_item * item;
44   const char * name;
45   short flags;
46   short count;
47 };
48
49 struct opt_context {
50   struct opt_precomputed * opts;
51   struct opt_precomputed ** shortopt;
52   struct opt_item ** hooks_before_arg;
53   struct opt_item ** hooks_before_value;
54   struct opt_item ** hooks_after_value;
55   short opt_count;
56   short hooks_before_arg_count;
57   short hooks_before_value_count;
58   short hooks_after_value_count;
59   int positional_max;
60   int positional_count;
61 };
62
63 static void opt_failure(const char * mesg, ...) FORMAT_CHECK(printf,1,2) NONRET;
64 static void opt_failure(const char * mesg, ...) {
65   va_list args;
66   va_start(args, mesg);
67   vfprintf(stderr, mesg, args);
68   fprintf(stderr, "\n");
69   opt_usage();
70   exit(OPT_EXIT_BAD_ARGS);
71   va_end(args);         // FIXME: Does this make a sense after exit()?
72 }
73
74 #define FOREACHLINE(text) for (const char * begin = (text), * end = (text); (*end) && (end = strchrnul(begin, '\n')); begin = end+1)
75
76 static inline uns uns_min(uns x, uns y)
77 {
78   return MIN(x, y);
79 }
80
81 void opt_help(const struct opt_section * help) {
82   int sections_cnt = 0;
83   int lines_cnt = 0;
84
85   for (struct opt_item * item = help->opt; item->cls != OPT_CL_END; item++) {
86     if (item->flags & OPT_NO_HELP) continue;
87     if (item->cls == OPT_CL_SECTION) {
88       sections_cnt++;
89       continue;
90     }
91     if (!*(item->help)) {
92       lines_cnt++;
93       continue;
94     }
95     FOREACHLINE(item->help)
96       lines_cnt++;
97   }
98
99   struct opt_sectlist {
100     int pos;
101     struct opt_section * sect;
102   } sections[sections_cnt];
103   int s = 0;
104
105   const char *lines[lines_cnt][3];
106   memset(lines, 0, sizeof(lines));
107   int line = 0;
108
109   int linelengths[3] = { -1, -1, -1 };
110
111   for (struct opt_item * item = help->opt; item->cls != OPT_CL_END; item++) {
112     if (item->flags & OPT_NO_HELP) continue;
113
114     if (item->cls == OPT_CL_HELP) {
115       if (!*(item->help)) {
116         line++;
117         continue;
118       }
119 #define SPLITLINES(text) do { \
120       FOREACHLINE(text) { \
121         int cell = 0; \
122         for (const char * b = begin, * e = begin; (e < end) && (e = strchrnul(b, '\t')) && (e > end ? (e = end) : end); b = e+1) { \
123           lines[line][cell] = b; \
124           if (cell >= 2) \
125             break; \
126           else \
127             if (*e == '\t' && linelengths[cell] < (e - b)) \
128               linelengths[cell] = e-b; \
129           cell++; \
130         } \
131         line++; \
132       } } while (0)
133       SPLITLINES(item->help);
134       continue;
135     }
136
137     if (item->cls == OPT_CL_SECTION) {
138       sections[s++] = (struct opt_sectlist) { .pos = line, .sect = item->u.section };
139       continue;
140     }
141
142     uns valoff = strchrnul(item->help, '\t') - item->help;
143     uns eol = strchrnul(item->help, '\n') - item->help;
144     if (valoff > eol)
145       valoff = eol;
146 #define VAL(it) ((it->flags & OPT_REQUIRED_VALUE) ? stk_printf("=%.*s", valoff, item->help)  : ((it->flags & OPT_NO_VALUE) ? "" : stk_printf("(=%.*s)", valoff, item->help)))
147     if (item->name) {
148       lines[line][1] = stk_printf("--%s%s", item->name, VAL(item));
149       if (linelengths[1] < (int) strlen(lines[line][1]))
150         linelengths[1] = strlen(lines[line][1]);
151       lines[line][0] = "";
152       if (linelengths[0] < 0)
153         linelengths[0] = 0;
154     }
155     if (item->letter) {
156       lines[line][0] = stk_printf("-%c,", item->letter);
157       if (linelengths[0] < (int) strlen(lines[line][0]))
158         linelengths[0] = strlen(lines[line][0]);
159     }
160 #undef VAL
161
162     if (eol > valoff) {
163       lines[line][2] = item->help + valoff + 1;
164     }
165
166     line++;
167
168     if (*(item->help + eol))
169       SPLITLINES(item->help + eol + 1);
170   }
171 #undef SPLITLINES
172
173   s = 0;
174 #define FIELD(k) linelengths[k], uns_min(strchrnul(lines[i][k], '\t') - lines[i][k], strchrnul(lines[i][k], '\n') - lines[i][k]), lines[i][k]
175 #define LASTFIELD(k) uns_min(strchrnul(lines[i][k], '\t') - lines[i][k], strchrnul(lines[i][k], '\n') - lines[i][k]), lines[i][k]
176   for (int i=0;i<line;i++) {
177     while (s < sections_cnt && sections[s].pos == i) {
178       opt_help(sections[s].sect);
179       s++;
180     }
181     if (lines[i][0] == NULL)
182       printf("\n");
183     else if (linelengths[0] == -1 || lines[i][1] == NULL)
184       printf("%.*s\n", LASTFIELD(0));
185     else if (linelengths[1] == -1 || lines[i][2] == NULL)
186       printf("%-*.*s  %.*s\n", FIELD(0), LASTFIELD(1));
187     else
188       printf("%-*.*s  %-*.*s  %.*s\n", FIELD(0), FIELD(1), LASTFIELD(2));
189   }
190   while (s < sections_cnt && sections[s].pos == line) {
191     opt_help(sections[s].sect);
192     s++;
193   }
194 }
195
196 static struct opt_precomputed * opt_find_item_longopt(struct opt_context * oc, char * str) {
197   uns len = strlen(str);
198   struct opt_precomputed * candidate = NULL;
199
200   for (int i=0; i<oc->opt_count; i++) {
201     if (!oc->opts[i].name)
202       continue;
203     if (!strncmp(oc->opts[i].name, str, len)) {
204       if (strlen(oc->opts[i].name) == len) {
205         if (oc->opts[i].count++ && (oc->opts[i].flags & OPT_SINGLE))
206           opt_failure("Option %s appeared the second time.", oc->opts[i].name);
207
208         return &oc->opts[i];
209       }
210       if (candidate)
211         opt_failure("Ambiguous prefix %s: Found matching %s and %s.", str, candidate->name, oc->opts[i].name);
212       else
213         candidate = &oc->opts[i];
214     }
215     if (!strncmp("no-", str, 3) && !strncmp(oc->opts[i].name, str+3, len-3)) {
216       if (strlen(oc->opts[i].name) == len-3) {
217         if (oc->opts[i].count++ && (oc->opts[i].flags & OPT_SINGLE))
218           opt_failure("Option %s appeared the second time.", oc->opts[i].name);
219
220         return &oc->opts[i];
221       }
222       if (candidate)
223         opt_failure("Ambiguous prefix %s: Found matching %s and %s.", str, candidate->name, oc->opts[i].name);
224       else
225         candidate = &oc->opts[i];
226     }
227   }
228
229   if (candidate)
230     return candidate;
231
232   opt_failure("Invalid option %s.", str);
233 }
234
235 #define OPT_PTR(type) ({ \
236   type * ptr; \
237   if (item->flags & OPT_MULTIPLE) { \
238     struct { \
239       cnode n; \
240       type v; \
241     } * n = xmalloc(sizeof(*n)); \
242     clist_add_tail(item->ptr, &(n->n)); \
243     ptr = &(n->v); \
244   } else \
245     ptr = item->ptr; \
246   ptr; })
247
248 #define OPT_NAME (longopt == 2 ? stk_printf("positional arg #%d", oc->positional_count) : (longopt == 1 ? stk_printf("--%s", opt->name) : stk_printf("-%c", item->letter)))
249 static void opt_parse_value(struct opt_context * oc, struct opt_precomputed * opt, char * value, int longopt) {
250   struct opt_item * item = opt->item;
251   for (int i=0;i<oc->hooks_before_value_count;i++)
252     oc->hooks_before_value[i]->u.call(item, value, oc->hooks_before_value[i]->ptr);
253
254   switch (item->cls) {
255     case OPT_CL_BOOL:
256       if (!value || !strcasecmp(value, "y") || !strcasecmp(value, "yes") || !strcasecmp(value, "true") || !strcasecmp(value, "1"))
257         *((int *) item->ptr) = 1 ^ (!!(opt->flags & OPT_NEGATIVE));
258       else if (!strcasecmp(value, "n") || !strcasecmp(value, "no") || !strcasecmp(value, "false") || !strcasecmp(value, "0"))
259         *((int *) item->ptr) = 0 ^ (!!(opt->flags & OPT_NEGATIVE));
260       else
261         opt_failure("Boolean argument for %s has a strange value. Supported (case insensitive): y/n, yes/no, true/false.", OPT_NAME);
262       break;
263     case OPT_CL_STATIC:
264       {
265         char * e = NULL;
266         switch (item->type) {
267           case CT_INT:
268             if (!value)
269               *OPT_PTR(int) = 0;
270             else
271               e = cf_parse_int(value, OPT_PTR(int));
272             if (e)
273               opt_failure("Integer value parsing failed for %s: %s", OPT_NAME, e);
274             break;
275           case CT_U64:
276             if (!value)
277               *OPT_PTR(u64) = 0;
278             else
279               e = cf_parse_u64(value, OPT_PTR(u64));
280             if (e)
281               opt_failure("Unsigned 64-bit value parsing failed for %s: %s", OPT_NAME, e);
282             break;
283           case CT_DOUBLE:
284             if (!value)
285               *OPT_PTR(double) = NAN;
286             else
287               e = cf_parse_double(value, OPT_PTR(double));
288             if (e)
289               opt_failure("Double value parsing failed for %s: %s", OPT_NAME, e);
290             break;
291           case CT_IP:
292             if (!value)
293               e = cf_parse_ip("0.0.0.0", OPT_PTR(u32));
294             else
295               e = cf_parse_ip(value, OPT_PTR(u32));
296             if (e)
297               opt_failure("IP parsing failed for %s: %s", OPT_NAME, e);
298             break;
299           case CT_STRING:
300             if (!value)
301               *OPT_PTR(const char *) = NULL;
302             else
303               *OPT_PTR(const char *) = xstrdup(value);
304             break;
305           default:
306             ASSERT(0);
307         }
308         break;
309       }
310     case OPT_CL_SWITCH:
311       if (*((int *)item->ptr) != -1)
312         opt_failure("Multiple switches: %s", OPT_NAME);
313       else
314         *((int *)item->ptr) = item->u.value;
315       break;
316     case OPT_CL_INC:
317       if (opt->flags & OPT_NEGATIVE)
318         (*((int *)item->ptr))--;
319       else
320         (*((int *)item->ptr))++;
321       break;
322     case OPT_CL_CALL:
323       item->u.call(item, value, item->ptr);
324       break;
325     case OPT_CL_USER:
326       {
327         char * e = NULL;
328         e = item->u.utype->parser(value, OPT_PTR(void*));
329         if (e)
330           opt_failure("User defined type value parsing failed for %s: %s", OPT_NAME, e);
331         break;
332       }
333     default:
334       ASSERT(0);
335   }
336
337   for (int i=0;i<oc->hooks_after_value_count;i++)
338     oc->hooks_after_value[i]->u.call(item, value, oc->hooks_after_value[i]->ptr);
339 }
340 #undef OPT_NAME
341
342 static int opt_longopt(struct opt_context * oc, char ** argv, int index) {
343   int eaten = 0;
344   char * name_in = argv[index] + 2; // skipping the -- on the beginning
345   uns pos = strchrnul(name_in, '=') - name_in;
346   struct opt_precomputed * opt = opt_find_item_longopt(oc, strndupa(name_in, pos));
347   char * value = NULL;
348
349   if (opt->item->cls == OPT_CL_BOOL && !strncmp(name_in, "no-", 3) && !strncmp(name_in+3, opt->item->name, pos-3))
350     value = "n";
351   else if (opt->flags & OPT_REQUIRED_VALUE) {
352     if (pos < strlen(name_in))
353       value = name_in + pos + 1;
354     else {
355       value = argv[index+1];
356       if (!value)
357         opt_failure("Argument --%s must have a value but nothing supplied.", opt->name);
358       eaten++;
359     }
360   }
361   else if (opt->flags & OPT_MAYBE_VALUE) {
362     if (pos < strlen(name_in))
363       value = name_in + pos + 1;
364   }
365   else {
366     if (pos < strlen(name_in))
367       opt_failure("Argument --%s must not have any value.", opt->name);
368   }
369   opt_parse_value(oc, opt, value, 1);
370   return eaten;
371 }
372
373 static int opt_shortopt(struct opt_context * oc, char ** argv, int index) {
374   int chr = 0;
375   struct opt_precomputed * opt;
376   int o;
377
378   while (o = argv[index][++chr]) {
379     if (o < 0 || o >= 128)
380       opt_failure("Invalid character 0x%02x in option name. Only ASCII is allowed.", o & 0xff);
381     opt = oc->shortopt[o];
382
383     if (!opt)
384       opt_failure("Unknown option -%c.", o);
385
386     if (opt->count && (opt->flags & OPT_SINGLE))
387       opt_failure("Option -%c must be specified at most once.", o);
388     opt->count++;
389
390     if (opt->flags & OPT_NO_VALUE)
391       opt_parse_value(oc, opt, NULL, 0);
392     else if (opt->flags & OPT_REQUIRED_VALUE) {
393       if (argv[index][chr+1]) {
394         opt_parse_value(oc, opt, argv[index] + chr + 1, 0);
395         return 0;
396       } else if (!argv[index+1])
397         opt_failure("Option -%c must have a value, but nothing supplied.", o);
398       else {
399         opt_parse_value(oc, opt, argv[index+1], 0);
400         return 1;
401       }
402     } else if (opt->flags & OPT_MAYBE_VALUE) {
403       if (argv[index][chr+1]) {
404         opt_parse_value(oc, opt, argv[index] + chr + 1, 0);
405         return 0;
406       } else
407         opt_parse_value(oc, opt, NULL, 0);
408     } else {
409       ASSERT(0);
410     }
411   }
412
413   return 0;
414 }
415
416 static void opt_positional(struct opt_context * oc, char * value) {
417   oc->positional_count++;
418   uns id = oc->positional_count > oc->positional_max ? OPT_POSITIONAL_TAIL : OPT_POSITIONAL(oc->positional_count);
419   struct opt_precomputed * opt = oc->shortopt[id];
420   if (!opt || (opt->flags & OPT_SINGLE) && opt->count)
421     opt_failure("Too many positional arguments.");
422   else {
423     opt->count++;
424     opt_parse_value(oc, opt, value, 2);
425   }
426 }
427
428 static void opt_count_items(struct opt_context *oc, const struct opt_section *sec)
429 {
430   for (const struct opt_item *item = sec->opt; item->cls != OPT_CL_END; item++) {
431     if (item->cls == OPT_CL_SECTION)
432       opt_count_items(oc, item->u.section);
433     else if (item->cls == OPT_CL_HOOK) {
434       if (item->flags & OPT_HOOK_BEFORE_ARG)
435         oc->hooks_before_arg_count++;
436       else if (item->flags & OPT_HOOK_BEFORE_VALUE)
437         oc->hooks_before_value_count++;
438       else if (item->flags & OPT_HOOK_AFTER_VALUE)
439         oc->hooks_after_value_count++;
440       else
441         ASSERT(0);
442     } else if (item->letter || item->name) {
443       oc->opt_count++;
444       if (item->letter > OPT_POSITIONAL_TAIL)
445         oc->positional_max++;
446     }
447   }
448 }
449
450 static void opt_add_default_flags(struct opt_precomputed *opt)
451 {
452   struct opt_item *item = opt->item;
453   uns flags = opt->flags;
454
455   if (item->letter >= OPT_POSITIONAL_TAIL) {
456     flags &= ~OPT_VALUE_FLAGS;
457     flags |= OPT_REQUIRED_VALUE;
458   }
459   if (!(flags & OPT_VALUE_FLAGS)) {
460     ASSERT(item->cls != OPT_CL_CALL && item->cls != OPT_CL_USER);
461     flags |= opt_default_value_flags[item->cls];
462   }
463
464   opt->flags = flags;
465 }
466
467 static void opt_prepare_items(struct opt_context *oc, const struct opt_section *sec)
468 {
469   for (struct opt_item *item = sec->opt; item->cls != OPT_CL_END; item++) {
470     if (item->cls == OPT_CL_SECTION)
471       opt_prepare_items(oc, item->u.section);
472     else if (item->cls == OPT_CL_HOOK) {
473       if (item->flags & OPT_HOOK_BEFORE_ARG)
474         oc->hooks_before_arg[oc->hooks_before_arg_count++] = item;
475       else if (item->flags & OPT_HOOK_BEFORE_VALUE)
476         oc->hooks_before_value[oc->hooks_before_value_count++] = item;
477       else if (item->flags & OPT_HOOK_AFTER_VALUE)
478         oc->hooks_after_value[oc->hooks_after_value_count++] = item;
479       else
480         ASSERT(0);
481     } else if (item->letter || item->name) {
482       struct opt_precomputed * opt = &oc->opts[oc->opt_count++];
483       opt->item = item;
484       opt->flags = item->flags;
485       opt->count = 0;
486       opt->name = item->name;
487       if (item->letter)
488         oc->shortopt[(int) item->letter] = opt;
489       opt_add_default_flags(opt);
490     }
491   }
492 }
493
494 static void opt_check_required(struct opt_context *oc)
495 {
496   for (int i = 0; i < oc->opt_count; i++) {
497     struct opt_precomputed *opt = &oc->opts[i];
498     if (!opt->count && (opt->flags & OPT_REQUIRED)) {
499       struct opt_item *item = opt->item;
500       if (item->letter > OPT_POSITIONAL_TAIL)
501         opt_failure("Required positional argument #%d not found.", i - OPT_POSITIONAL_TAIL);
502       else if (item->letter == OPT_POSITIONAL_TAIL)
503         opt_failure("Required positional argument not found.");
504       else if (item->letter && item->name)
505         opt_failure("Required option -%c/--%s not found.", item->letter, item->name);
506       else if (item->letter)
507         opt_failure("Required option -%c not found.", item->letter);
508       else
509         opt_failure("Required option --%s not found.", item->name);
510     }
511   }
512 }
513
514 void opt_parse(const struct opt_section * options, char ** argv) {
515   struct opt_context * oc = alloca(sizeof(*oc));
516   memset(oc, 0, sizeof (*oc));
517
518   opt_count_items(oc, options);
519   oc->opts = alloca(sizeof(*oc->opts) * oc->opt_count);
520   oc->shortopt = alloca(sizeof(*oc->shortopt) * (oc->positional_max + 257));
521   memset(oc->shortopt, 0, sizeof(*oc->shortopt) * (oc->positional_max + 257));
522   oc->hooks_before_arg = alloca(sizeof (*oc->hooks_before_arg) * oc->hooks_before_arg_count);
523   oc->hooks_before_value = alloca(sizeof (*oc->hooks_before_value) * oc->hooks_before_value_count);
524   oc->hooks_after_value = alloca(sizeof (*oc->hooks_after_value) * oc->hooks_after_value_count);
525
526   oc->opt_count = 0;
527   oc->hooks_before_arg_count = 0;
528   oc->hooks_before_value_count = 0;
529   oc->hooks_after_value_count = 0;
530   opt_prepare_items(oc, options);
531
532   int force_positional = 0;
533   for (int i = 0; argv[i]; i++) {
534     char *arg = argv[i];
535     for (int j = 0; j < oc->hooks_before_arg_count; j++)
536       oc->hooks_before_arg[j]->u.call(NULL, NULL, oc->hooks_before_arg[j]->ptr);
537     if (arg[0] != '-' || force_positional)
538       opt_positional(oc, arg);
539     else {
540       if (arg[1] == '-') {
541         if (arg[2] == '\0')
542           force_positional++;
543         else
544           i += opt_longopt(oc, argv, i);
545       } else if (arg[1])
546         i += opt_shortopt(oc, argv, i);
547       else
548         opt_positional(oc, arg);
549     }
550   }
551
552   opt_check_required(oc);
553 }
554
555 static void opt_conf_end_of_options(struct cf_context *cc) {
556   cf_load_default(cc);
557   if (cc->postpone_commit && cf_close_group())
558     opt_failure("Loading of configuration failed");
559 }
560
561 void opt_conf_internal(struct opt_item * opt, const char * value, void * data UNUSED) {
562   struct cf_context *cc = cf_get_context();
563   switch (opt->letter) {
564     case 'S':
565       cf_load_default(cc);
566       if (cf_set(value))
567         opt_failure("Cannot set %s", value);
568       break;
569     case 'C':
570       if (cf_load(value))
571         opt_failure("Cannot load config file %s", value);
572       break;
573 #ifdef CONFIG_UCW_DEBUG
574     case '0':
575       opt_conf_end_of_options(cc);
576       struct fastbuf *b = bfdopen(1, 4096);
577       cf_dump_sections(b);
578       bclose(b);
579       exit(0);
580       break;
581 #endif
582   }
583 }
584
585 void opt_conf_hook_internal(struct opt_item * opt, const char * value UNUSED, void * data UNUSED) {
586   static enum {
587     OPT_CONF_HOOK_BEGIN,
588     OPT_CONF_HOOK_CONFIG,
589     OPT_CONF_HOOK_OTHERS
590   } state = OPT_CONF_HOOK_BEGIN;
591
592   int confopt = 0;
593
594   if (opt->letter == 'S' || opt->letter == 'C' || (opt->name && !strcmp(opt->name, "dumpconfig")))
595     confopt = 1;
596
597   switch (state) {
598     case OPT_CONF_HOOK_BEGIN:
599       if (confopt)
600         state = OPT_CONF_HOOK_CONFIG;
601       else {
602         opt_conf_end_of_options(cf_get_context());
603         state = OPT_CONF_HOOK_OTHERS;
604       }
605       break;
606     case OPT_CONF_HOOK_CONFIG:
607       if (!confopt) {
608         opt_conf_end_of_options(cf_get_context());
609         state = OPT_CONF_HOOK_OTHERS;
610       }
611       break;
612     case OPT_CONF_HOOK_OTHERS:
613       if (confopt)
614         opt_failure("Config options (-C, -S) must stand before other options.");
615       break;
616     default:
617       ASSERT(0);
618   }
619 }