]>
Commit | Line | Data |
---|---|---|
d3f24367 KW |
1 | /* |
2 | * Commandline option parsing functions | |
3 | * | |
4 | * Copyright (c) 2003-2008 Fabrice Bellard | |
5 | * Copyright (c) 2009 Kevin Wolf <kwolf@redhat.com> | |
6 | * | |
7 | * Permission is hereby granted, free of charge, to any person obtaining a copy | |
8 | * of this software and associated documentation files (the "Software"), to deal | |
9 | * in the Software without restriction, including without limitation the rights | |
10 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
11 | * copies of the Software, and to permit persons to whom the Software is | |
12 | * furnished to do so, subject to the following conditions: | |
13 | * | |
14 | * The above copyright notice and this permission notice shall be included in | |
15 | * all copies or substantial portions of the Software. | |
16 | * | |
17 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
18 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
19 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
20 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
21 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
22 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
23 | * THE SOFTWARE. | |
24 | */ | |
25 | ||
26 | #include <stdio.h> | |
27 | #include <string.h> | |
28 | ||
29 | #include "qemu-common.h" | |
1de7afc9 | 30 | #include "qemu/error-report.h" |
7b1b5d19 PB |
31 | #include "qapi/qmp/types.h" |
32 | #include "qapi/error.h" | |
33 | #include "qapi/qmp/qerror.h" | |
1de7afc9 | 34 | #include "qemu/option_int.h" |
d3f24367 KW |
35 | |
36 | /* | |
37 | * Extracts the name of an option from the parameter string (p points at the | |
38 | * first byte of the option name) | |
39 | * | |
40 | * The option name is delimited by delim (usually , or =) or the string end | |
41 | * and is copied into buf. If the option name is longer than buf_size, it is | |
42 | * truncated. buf is always zero terminated. | |
43 | * | |
44 | * The return value is the position of the delimiter/zero byte after the option | |
45 | * name in p. | |
46 | */ | |
47 | const char *get_opt_name(char *buf, int buf_size, const char *p, char delim) | |
48 | { | |
49 | char *q; | |
50 | ||
51 | q = buf; | |
52 | while (*p != '\0' && *p != delim) { | |
53 | if (q && (q - buf) < buf_size - 1) | |
54 | *q++ = *p; | |
55 | p++; | |
56 | } | |
57 | if (q) | |
58 | *q = '\0'; | |
59 | ||
60 | return p; | |
61 | } | |
62 | ||
63 | /* | |
64 | * Extracts the value of an option from the parameter string p (p points at the | |
65 | * first byte of the option value) | |
66 | * | |
67 | * This function is comparable to get_opt_name with the difference that the | |
68 | * delimiter is fixed to be comma which starts a new option. To specify an | |
69 | * option value that contains commas, double each comma. | |
70 | */ | |
71 | const char *get_opt_value(char *buf, int buf_size, const char *p) | |
72 | { | |
73 | char *q; | |
74 | ||
75 | q = buf; | |
76 | while (*p != '\0') { | |
77 | if (*p == ',') { | |
78 | if (*(p + 1) != ',') | |
79 | break; | |
80 | p++; | |
81 | } | |
82 | if (q && (q - buf) < buf_size - 1) | |
83 | *q++ = *p; | |
84 | p++; | |
85 | } | |
86 | if (q) | |
87 | *q = '\0'; | |
88 | ||
89 | return p; | |
90 | } | |
91 | ||
62c5802e GH |
92 | int get_next_param_value(char *buf, int buf_size, |
93 | const char *tag, const char **pstr) | |
94 | { | |
95 | const char *p; | |
96 | char option[128]; | |
97 | ||
98 | p = *pstr; | |
99 | for(;;) { | |
100 | p = get_opt_name(option, sizeof(option), p, '='); | |
101 | if (*p != '=') | |
102 | break; | |
103 | p++; | |
104 | if (!strcmp(tag, option)) { | |
105 | *pstr = get_opt_value(buf, buf_size, p); | |
106 | if (**pstr == ',') { | |
107 | (*pstr)++; | |
108 | } | |
109 | return strlen(buf); | |
110 | } else { | |
111 | p = get_opt_value(NULL, 0, p); | |
112 | } | |
113 | if (*p != ',') | |
114 | break; | |
115 | p++; | |
116 | } | |
117 | return 0; | |
118 | } | |
119 | ||
120 | int get_param_value(char *buf, int buf_size, | |
121 | const char *tag, const char *str) | |
122 | { | |
123 | return get_next_param_value(buf, buf_size, tag, &str); | |
124 | } | |
125 | ||
d3f24367 KW |
126 | /* |
127 | * Searches an option list for an option with the given name | |
128 | */ | |
129 | QEMUOptionParameter *get_option_parameter(QEMUOptionParameter *list, | |
130 | const char *name) | |
131 | { | |
132 | while (list && list->name) { | |
133 | if (!strcmp(list->name, name)) { | |
134 | return list; | |
135 | } | |
136 | list++; | |
137 | } | |
138 | ||
139 | return NULL; | |
140 | } | |
141 | ||
cf62adfa LC |
142 | static void parse_option_bool(const char *name, const char *value, bool *ret, |
143 | Error **errp) | |
67b1355b GH |
144 | { |
145 | if (value != NULL) { | |
146 | if (!strcmp(value, "on")) { | |
147 | *ret = 1; | |
148 | } else if (!strcmp(value, "off")) { | |
149 | *ret = 0; | |
150 | } else { | |
cf62adfa | 151 | error_set(errp,QERR_INVALID_PARAMETER_VALUE, name, "'on' or 'off'"); |
67b1355b GH |
152 | } |
153 | } else { | |
154 | *ret = 1; | |
155 | } | |
67b1355b GH |
156 | } |
157 | ||
2f39df5b LC |
158 | static void parse_option_number(const char *name, const char *value, |
159 | uint64_t *ret, Error **errp) | |
e27c88fe GH |
160 | { |
161 | char *postfix; | |
162 | uint64_t number; | |
163 | ||
164 | if (value != NULL) { | |
165 | number = strtoull(value, &postfix, 0); | |
166 | if (*postfix != '\0') { | |
2f39df5b LC |
167 | error_set(errp, QERR_INVALID_PARAMETER_VALUE, name, "a number"); |
168 | return; | |
e27c88fe | 169 | } |
21c9f4cd | 170 | *ret = number; |
e27c88fe | 171 | } else { |
2f39df5b | 172 | error_set(errp, QERR_INVALID_PARAMETER_VALUE, name, "a number"); |
e27c88fe | 173 | } |
e27c88fe GH |
174 | } |
175 | ||
ec7b2ccb LC |
176 | static void parse_option_size(const char *name, const char *value, |
177 | uint64_t *ret, Error **errp) | |
7695019b GH |
178 | { |
179 | char *postfix; | |
180 | double sizef; | |
181 | ||
182 | if (value != NULL) { | |
183 | sizef = strtod(value, &postfix); | |
184 | switch (*postfix) { | |
185 | case 'T': | |
186 | sizef *= 1024; | |
0b0404bf | 187 | /* fall through */ |
7695019b GH |
188 | case 'G': |
189 | sizef *= 1024; | |
0b0404bf | 190 | /* fall through */ |
7695019b GH |
191 | case 'M': |
192 | sizef *= 1024; | |
0b0404bf | 193 | /* fall through */ |
7695019b GH |
194 | case 'K': |
195 | case 'k': | |
196 | sizef *= 1024; | |
0b0404bf | 197 | /* fall through */ |
7695019b GH |
198 | case 'b': |
199 | case '\0': | |
200 | *ret = (uint64_t) sizef; | |
201 | break; | |
202 | default: | |
ec7b2ccb | 203 | error_set(errp, QERR_INVALID_PARAMETER_VALUE, name, "a size"); |
7216ae3d | 204 | #if 0 /* conversion from qerror_report() to error_set() broke this: */ |
c64f27d4 | 205 | error_printf_unless_qmp("You may use k, M, G or T suffixes for " |
7695019b | 206 | "kilobytes, megabytes, gigabytes and terabytes.\n"); |
7216ae3d | 207 | #endif |
ec7b2ccb | 208 | return; |
7695019b GH |
209 | } |
210 | } else { | |
ec7b2ccb | 211 | error_set(errp, QERR_INVALID_PARAMETER_VALUE, name, "a size"); |
7695019b | 212 | } |
7695019b GH |
213 | } |
214 | ||
d3f24367 KW |
215 | /* |
216 | * Sets the value of a parameter in a given option list. The parsing of the | |
217 | * value depends on the type of option: | |
218 | * | |
219 | * OPT_FLAG (uses value.n): | |
220 | * If no value is given, the flag is set to 1. | |
221 | * Otherwise the value must be "on" (set to 1) or "off" (set to 0) | |
222 | * | |
223 | * OPT_STRING (uses value.s): | |
224 | * value is strdup()ed and assigned as option value | |
225 | * | |
226 | * OPT_SIZE (uses value.n): | |
227 | * The value is converted to an integer. Suffixes for kilobytes etc. are | |
228 | * allowed (powers of 1024). | |
229 | * | |
230 | * Returns 0 on succes, -1 in error cases | |
231 | */ | |
232 | int set_option_parameter(QEMUOptionParameter *list, const char *name, | |
233 | const char *value) | |
234 | { | |
f02b77c9 | 235 | bool flag; |
cf62adfa | 236 | Error *local_err = NULL; |
67b1355b | 237 | |
d3f24367 KW |
238 | // Find a matching parameter |
239 | list = get_option_parameter(list, name); | |
240 | if (list == NULL) { | |
241 | fprintf(stderr, "Unknown option '%s'\n", name); | |
242 | return -1; | |
243 | } | |
244 | ||
245 | // Process parameter | |
246 | switch (list->type) { | |
247 | case OPT_FLAG: | |
cf62adfa LC |
248 | parse_option_bool(name, value, &flag, &local_err); |
249 | if (!error_is_set(&local_err)) { | |
250 | list->value.n = flag; | |
251 | } | |
d3f24367 KW |
252 | break; |
253 | ||
254 | case OPT_STRING: | |
255 | if (value != NULL) { | |
7267c094 | 256 | list->value.s = g_strdup(value); |
d3f24367 KW |
257 | } else { |
258 | fprintf(stderr, "Option '%s' needs a parameter\n", name); | |
259 | return -1; | |
260 | } | |
261 | break; | |
262 | ||
263 | case OPT_SIZE: | |
ec7b2ccb | 264 | parse_option_size(name, value, &list->value.n, &local_err); |
d3f24367 | 265 | break; |
7695019b | 266 | |
d3f24367 KW |
267 | default: |
268 | fprintf(stderr, "Bug: Option '%s' has an unknown type\n", name); | |
269 | return -1; | |
270 | } | |
271 | ||
cf62adfa LC |
272 | if (error_is_set(&local_err)) { |
273 | qerror_report_err(local_err); | |
274 | error_free(local_err); | |
275 | return -1; | |
276 | } | |
277 | ||
d3f24367 KW |
278 | return 0; |
279 | } | |
280 | ||
281 | /* | |
282 | * Sets the given parameter to an integer instead of a string. | |
283 | * This function cannot be used to set string options. | |
284 | * | |
285 | * Returns 0 on success, -1 in error cases | |
286 | */ | |
287 | int set_option_parameter_int(QEMUOptionParameter *list, const char *name, | |
288 | uint64_t value) | |
289 | { | |
290 | // Find a matching parameter | |
291 | list = get_option_parameter(list, name); | |
292 | if (list == NULL) { | |
293 | fprintf(stderr, "Unknown option '%s'\n", name); | |
294 | return -1; | |
295 | } | |
296 | ||
297 | // Process parameter | |
298 | switch (list->type) { | |
299 | case OPT_FLAG: | |
300 | case OPT_NUMBER: | |
301 | case OPT_SIZE: | |
302 | list->value.n = value; | |
303 | break; | |
304 | ||
305 | default: | |
306 | return -1; | |
307 | } | |
308 | ||
309 | return 0; | |
310 | } | |
311 | ||
312 | /* | |
313 | * Frees a option list. If it contains strings, the strings are freed as well. | |
314 | */ | |
315 | void free_option_parameters(QEMUOptionParameter *list) | |
316 | { | |
317 | QEMUOptionParameter *cur = list; | |
318 | ||
319 | while (cur && cur->name) { | |
320 | if (cur->type == OPT_STRING) { | |
7267c094 | 321 | g_free(cur->value.s); |
d3f24367 KW |
322 | } |
323 | cur++; | |
324 | } | |
325 | ||
7267c094 | 326 | g_free(list); |
d3f24367 KW |
327 | } |
328 | ||
b50cbabc MK |
329 | /* |
330 | * Count valid options in list | |
331 | */ | |
332 | static size_t count_option_parameters(QEMUOptionParameter *list) | |
333 | { | |
334 | size_t num_options = 0; | |
335 | ||
336 | while (list && list->name) { | |
337 | num_options++; | |
338 | list++; | |
339 | } | |
340 | ||
341 | return num_options; | |
342 | } | |
343 | ||
344 | /* | |
345 | * Append an option list (list) to an option list (dest). | |
346 | * | |
347 | * If dest is NULL, a new copy of list is created. | |
348 | * | |
349 | * Returns a pointer to the first element of dest (or the newly allocated copy) | |
350 | */ | |
351 | QEMUOptionParameter *append_option_parameters(QEMUOptionParameter *dest, | |
352 | QEMUOptionParameter *list) | |
353 | { | |
354 | size_t num_options, num_dest_options; | |
355 | ||
356 | num_options = count_option_parameters(dest); | |
357 | num_dest_options = num_options; | |
358 | ||
359 | num_options += count_option_parameters(list); | |
360 | ||
7267c094 | 361 | dest = g_realloc(dest, (num_options + 1) * sizeof(QEMUOptionParameter)); |
bd69fe84 | 362 | dest[num_dest_options].name = NULL; |
b50cbabc MK |
363 | |
364 | while (list && list->name) { | |
365 | if (get_option_parameter(dest, list->name) == NULL) { | |
366 | dest[num_dest_options++] = *list; | |
367 | dest[num_dest_options].name = NULL; | |
368 | } | |
369 | list++; | |
370 | } | |
371 | ||
372 | return dest; | |
373 | } | |
374 | ||
d3f24367 KW |
375 | /* |
376 | * Parses a parameter string (param) into an option list (dest). | |
377 | * | |
0e72e753 SH |
378 | * list is the template option list. If dest is NULL, a new copy of list is |
379 | * created. If list is NULL, this function fails. | |
d3f24367 KW |
380 | * |
381 | * A parameter string consists of one or more parameters, separated by commas. | |
382 | * Each parameter consists of its name and possibly of a value. In the latter | |
383 | * case, the value is delimited by an = character. To specify a value which | |
384 | * contains commas, double each comma so it won't be recognized as the end of | |
385 | * the parameter. | |
386 | * | |
387 | * For more details of the parsing see above. | |
388 | * | |
389 | * Returns a pointer to the first element of dest (or the newly allocated copy) | |
390 | * or NULL in error cases | |
391 | */ | |
392 | QEMUOptionParameter *parse_option_parameters(const char *param, | |
393 | QEMUOptionParameter *list, QEMUOptionParameter *dest) | |
394 | { | |
d3f24367 KW |
395 | QEMUOptionParameter *allocated = NULL; |
396 | char name[256]; | |
397 | char value[256]; | |
398 | char *param_delim, *value_delim; | |
399 | char next_delim; | |
d3f24367 KW |
400 | |
401 | if (list == NULL) { | |
402 | return NULL; | |
403 | } | |
404 | ||
405 | if (dest == NULL) { | |
898c257b | 406 | dest = allocated = append_option_parameters(NULL, list); |
d3f24367 KW |
407 | } |
408 | ||
409 | while (*param) { | |
410 | ||
411 | // Find parameter name and value in the string | |
412 | param_delim = strchr(param, ','); | |
413 | value_delim = strchr(param, '='); | |
414 | ||
415 | if (value_delim && (value_delim < param_delim || !param_delim)) { | |
416 | next_delim = '='; | |
417 | } else { | |
418 | next_delim = ','; | |
419 | value_delim = NULL; | |
420 | } | |
421 | ||
422 | param = get_opt_name(name, sizeof(name), param, next_delim); | |
423 | if (value_delim) { | |
424 | param = get_opt_value(value, sizeof(value), param + 1); | |
425 | } | |
426 | if (*param != '\0') { | |
427 | param++; | |
428 | } | |
429 | ||
430 | // Set the parameter | |
431 | if (set_option_parameter(dest, name, value_delim ? value : NULL)) { | |
432 | goto fail; | |
433 | } | |
434 | } | |
435 | ||
436 | return dest; | |
437 | ||
438 | fail: | |
439 | // Only free the list if it was newly allocated | |
440 | free_option_parameters(allocated); | |
441 | return NULL; | |
442 | } | |
443 | ||
444 | /* | |
445 | * Prints all options of a list that have a value to stdout | |
446 | */ | |
447 | void print_option_parameters(QEMUOptionParameter *list) | |
448 | { | |
449 | while (list && list->name) { | |
450 | switch (list->type) { | |
451 | case OPT_STRING: | |
452 | if (list->value.s != NULL) { | |
453 | printf("%s='%s' ", list->name, list->value.s); | |
454 | } | |
455 | break; | |
456 | case OPT_FLAG: | |
457 | printf("%s=%s ", list->name, list->value.n ? "on" : "off"); | |
458 | break; | |
459 | case OPT_SIZE: | |
460 | case OPT_NUMBER: | |
461 | printf("%s=%" PRId64 " ", list->name, list->value.n); | |
462 | break; | |
463 | default: | |
07f35073 | 464 | printf("%s=(unknown type) ", list->name); |
d3f24367 KW |
465 | break; |
466 | } | |
467 | list++; | |
468 | } | |
469 | } | |
db08adf5 KW |
470 | |
471 | /* | |
472 | * Prints an overview of all available options | |
473 | */ | |
474 | void print_option_help(QEMUOptionParameter *list) | |
475 | { | |
476 | printf("Supported options:\n"); | |
477 | while (list && list->name) { | |
478 | printf("%-16s %s\n", list->name, | |
479 | list->help ? list->help : "No description available"); | |
480 | list++; | |
481 | } | |
482 | } | |
e27c88fe GH |
483 | |
484 | /* ------------------------------------------------------------------ */ | |
485 | ||
e27c88fe GH |
486 | static QemuOpt *qemu_opt_find(QemuOpts *opts, const char *name) |
487 | { | |
488 | QemuOpt *opt; | |
489 | ||
dc9ca4ba | 490 | QTAILQ_FOREACH_REVERSE(opt, &opts->head, QemuOptHead, next) { |
e27c88fe GH |
491 | if (strcmp(opt->name, name) != 0) |
492 | continue; | |
493 | return opt; | |
494 | } | |
495 | return NULL; | |
496 | } | |
497 | ||
498 | const char *qemu_opt_get(QemuOpts *opts, const char *name) | |
499 | { | |
500 | QemuOpt *opt = qemu_opt_find(opts, name); | |
501 | return opt ? opt->str : NULL; | |
502 | } | |
503 | ||
c8057f95 PM |
504 | bool qemu_opt_has_help_opt(QemuOpts *opts) |
505 | { | |
506 | QemuOpt *opt; | |
507 | ||
508 | QTAILQ_FOREACH_REVERSE(opt, &opts->head, QemuOptHead, next) { | |
509 | if (is_help_option(opt->name)) { | |
510 | return true; | |
511 | } | |
512 | } | |
513 | return false; | |
514 | } | |
515 | ||
f02b77c9 | 516 | bool qemu_opt_get_bool(QemuOpts *opts, const char *name, bool defval) |
e27c88fe GH |
517 | { |
518 | QemuOpt *opt = qemu_opt_find(opts, name); | |
519 | ||
520 | if (opt == NULL) | |
521 | return defval; | |
522 | assert(opt->desc && opt->desc->type == QEMU_OPT_BOOL); | |
1f5c1775 | 523 | return opt->value.boolean; |
e27c88fe GH |
524 | } |
525 | ||
526 | uint64_t qemu_opt_get_number(QemuOpts *opts, const char *name, uint64_t defval) | |
527 | { | |
528 | QemuOpt *opt = qemu_opt_find(opts, name); | |
529 | ||
530 | if (opt == NULL) | |
531 | return defval; | |
532 | assert(opt->desc && opt->desc->type == QEMU_OPT_NUMBER); | |
533 | return opt->value.uint; | |
534 | } | |
535 | ||
536 | uint64_t qemu_opt_get_size(QemuOpts *opts, const char *name, uint64_t defval) | |
537 | { | |
538 | QemuOpt *opt = qemu_opt_find(opts, name); | |
539 | ||
540 | if (opt == NULL) | |
541 | return defval; | |
542 | assert(opt->desc && opt->desc->type == QEMU_OPT_SIZE); | |
543 | return opt->value.uint; | |
544 | } | |
545 | ||
6c519404 | 546 | static void qemu_opt_parse(QemuOpt *opt, Error **errp) |
e27c88fe GH |
547 | { |
548 | if (opt->desc == NULL) | |
6c519404 | 549 | return; |
2f39df5b | 550 | |
e27c88fe GH |
551 | switch (opt->desc->type) { |
552 | case QEMU_OPT_STRING: | |
553 | /* nothing */ | |
6c519404 | 554 | return; |
e27c88fe | 555 | case QEMU_OPT_BOOL: |
6c519404 | 556 | parse_option_bool(opt->name, opt->str, &opt->value.boolean, errp); |
cf62adfa | 557 | break; |
e27c88fe | 558 | case QEMU_OPT_NUMBER: |
6c519404 | 559 | parse_option_number(opt->name, opt->str, &opt->value.uint, errp); |
2f39df5b | 560 | break; |
e27c88fe | 561 | case QEMU_OPT_SIZE: |
6c519404 | 562 | parse_option_size(opt->name, opt->str, &opt->value.uint, errp); |
ec7b2ccb | 563 | break; |
e27c88fe GH |
564 | default: |
565 | abort(); | |
566 | } | |
567 | } | |
568 | ||
569 | static void qemu_opt_del(QemuOpt *opt) | |
570 | { | |
72cf2d4f | 571 | QTAILQ_REMOVE(&opt->opts->head, opt, next); |
7267c094 AL |
572 | g_free((/* !const */ char*)opt->name); |
573 | g_free((/* !const */ char*)opt->str); | |
574 | g_free(opt); | |
e27c88fe GH |
575 | } |
576 | ||
c474ced8 DXW |
577 | static bool opts_accepts_any(const QemuOpts *opts) |
578 | { | |
579 | return opts->list->desc[0].name == NULL; | |
580 | } | |
581 | ||
582 | static const QemuOptDesc *find_desc_by_name(const QemuOptDesc *desc, | |
583 | const char *name) | |
e27c88fe | 584 | { |
dc9ca4ba | 585 | int i; |
e27c88fe | 586 | |
dc9ca4ba MM |
587 | for (i = 0; desc[i].name != NULL; i++) { |
588 | if (strcmp(desc[i].name, name) == 0) { | |
c474ced8 | 589 | return &desc[i]; |
e27c88fe | 590 | } |
dc9ca4ba | 591 | } |
c474ced8 DXW |
592 | |
593 | return NULL; | |
594 | } | |
595 | ||
0dd6c526 KW |
596 | int qemu_opt_unset(QemuOpts *opts, const char *name) |
597 | { | |
598 | QemuOpt *opt = qemu_opt_find(opts, name); | |
599 | ||
600 | assert(opts_accepts_any(opts)); | |
601 | ||
602 | if (opt == NULL) { | |
603 | return -1; | |
604 | } else { | |
605 | qemu_opt_del(opt); | |
606 | return 0; | |
607 | } | |
608 | } | |
609 | ||
c474ced8 DXW |
610 | static void opt_set(QemuOpts *opts, const char *name, const char *value, |
611 | bool prepend, Error **errp) | |
612 | { | |
613 | QemuOpt *opt; | |
614 | const QemuOptDesc *desc; | |
615 | Error *local_err = NULL; | |
616 | ||
617 | desc = find_desc_by_name(opts->list->desc, name); | |
618 | if (!desc && !opts_accepts_any(opts)) { | |
619 | error_set(errp, QERR_INVALID_PARAMETER, name); | |
620 | return; | |
e27c88fe | 621 | } |
dc9ca4ba | 622 | |
7267c094 AL |
623 | opt = g_malloc0(sizeof(*opt)); |
624 | opt->name = g_strdup(name); | |
dc9ca4ba | 625 | opt->opts = opts; |
4f6dd9af JK |
626 | if (prepend) { |
627 | QTAILQ_INSERT_HEAD(&opts->head, opt, next); | |
628 | } else { | |
629 | QTAILQ_INSERT_TAIL(&opts->head, opt, next); | |
630 | } | |
c474ced8 | 631 | opt->desc = desc; |
c64f50d1 | 632 | opt->str = g_strdup(value); |
6c519404 LC |
633 | qemu_opt_parse(opt, &local_err); |
634 | if (error_is_set(&local_err)) { | |
584d4064 | 635 | error_propagate(errp, local_err); |
e27c88fe | 636 | qemu_opt_del(opt); |
e27c88fe | 637 | } |
e27c88fe GH |
638 | } |
639 | ||
4f6dd9af JK |
640 | int qemu_opt_set(QemuOpts *opts, const char *name, const char *value) |
641 | { | |
584d4064 LC |
642 | Error *local_err = NULL; |
643 | ||
644 | opt_set(opts, name, value, false, &local_err); | |
645 | if (error_is_set(&local_err)) { | |
646 | qerror_report_err(local_err); | |
647 | error_free(local_err); | |
648 | return -1; | |
649 | } | |
650 | ||
651 | return 0; | |
4f6dd9af JK |
652 | } |
653 | ||
384f2139 LC |
654 | void qemu_opt_set_err(QemuOpts *opts, const char *name, const char *value, |
655 | Error **errp) | |
656 | { | |
657 | opt_set(opts, name, value, false, errp); | |
658 | } | |
659 | ||
f02b77c9 MK |
660 | int qemu_opt_set_bool(QemuOpts *opts, const char *name, bool val) |
661 | { | |
662 | QemuOpt *opt; | |
663 | const QemuOptDesc *desc = opts->list->desc; | |
f02b77c9 | 664 | |
ad718d01 DXW |
665 | opt = g_malloc0(sizeof(*opt)); |
666 | opt->desc = find_desc_by_name(desc, name); | |
667 | if (!opt->desc && !opts_accepts_any(opts)) { | |
668 | qerror_report(QERR_INVALID_PARAMETER, name); | |
669 | g_free(opt); | |
670 | return -1; | |
f02b77c9 MK |
671 | } |
672 | ||
f02b77c9 MK |
673 | opt->name = g_strdup(name); |
674 | opt->opts = opts; | |
f02b77c9 | 675 | opt->value.boolean = !!val; |
ad718d01 DXW |
676 | opt->str = g_strdup(val ? "on" : "off"); |
677 | QTAILQ_INSERT_TAIL(&opts->head, opt, next); | |
678 | ||
f02b77c9 MK |
679 | return 0; |
680 | } | |
681 | ||
b83c18e2 DXW |
682 | int qemu_opt_set_number(QemuOpts *opts, const char *name, int64_t val) |
683 | { | |
684 | QemuOpt *opt; | |
685 | const QemuOptDesc *desc = opts->list->desc; | |
686 | ||
687 | opt = g_malloc0(sizeof(*opt)); | |
688 | opt->desc = find_desc_by_name(desc, name); | |
689 | if (!opt->desc && !opts_accepts_any(opts)) { | |
690 | qerror_report(QERR_INVALID_PARAMETER, name); | |
691 | g_free(opt); | |
692 | return -1; | |
693 | } | |
694 | ||
695 | opt->name = g_strdup(name); | |
696 | opt->opts = opts; | |
697 | opt->value.uint = val; | |
698 | opt->str = g_strdup_printf("%" PRId64, val); | |
699 | QTAILQ_INSERT_TAIL(&opts->head, opt, next); | |
700 | ||
701 | return 0; | |
702 | } | |
703 | ||
48026075 GH |
704 | int qemu_opt_foreach(QemuOpts *opts, qemu_opt_loopfunc func, void *opaque, |
705 | int abort_on_failure) | |
706 | { | |
707 | QemuOpt *opt; | |
708 | int rc = 0; | |
709 | ||
72cf2d4f | 710 | QTAILQ_FOREACH(opt, &opts->head, next) { |
48026075 GH |
711 | rc = func(opt->name, opt->str, opaque); |
712 | if (abort_on_failure && rc != 0) | |
713 | break; | |
714 | } | |
715 | return rc; | |
716 | } | |
717 | ||
e27c88fe GH |
718 | QemuOpts *qemu_opts_find(QemuOptsList *list, const char *id) |
719 | { | |
720 | QemuOpts *opts; | |
721 | ||
72cf2d4f | 722 | QTAILQ_FOREACH(opts, &list->head, next) { |
96bc97eb MA |
723 | if (!opts->id && !id) { |
724 | return opts; | |
e27c88fe | 725 | } |
96bc97eb MA |
726 | if (opts->id && id && !strcmp(opts->id, id)) { |
727 | return opts; | |
e27c88fe | 728 | } |
e27c88fe GH |
729 | } |
730 | return NULL; | |
731 | } | |
732 | ||
b560a9ab MA |
733 | static int id_wellformed(const char *id) |
734 | { | |
735 | int i; | |
736 | ||
737 | if (!qemu_isalpha(id[0])) { | |
738 | return 0; | |
739 | } | |
740 | for (i = 1; id[i]; i++) { | |
741 | if (!qemu_isalnum(id[i]) && !strchr("-._", id[i])) { | |
742 | return 0; | |
743 | } | |
744 | } | |
745 | return 1; | |
746 | } | |
747 | ||
8be7e7e4 LC |
748 | QemuOpts *qemu_opts_create(QemuOptsList *list, const char *id, |
749 | int fail_if_exists, Error **errp) | |
e27c88fe GH |
750 | { |
751 | QemuOpts *opts = NULL; | |
752 | ||
753 | if (id) { | |
b560a9ab | 754 | if (!id_wellformed(id)) { |
8be7e7e4 | 755 | error_set(errp,QERR_INVALID_PARAMETER_VALUE, "id", "an identifier"); |
7216ae3d | 756 | #if 0 /* conversion from qerror_report() to error_set() broke this: */ |
b560a9ab | 757 | error_printf_unless_qmp("Identifiers consist of letters, digits, '-', '.', '_', starting with a letter.\n"); |
7216ae3d | 758 | #endif |
b560a9ab MA |
759 | return NULL; |
760 | } | |
e27c88fe GH |
761 | opts = qemu_opts_find(list, id); |
762 | if (opts != NULL) { | |
da93318a | 763 | if (fail_if_exists && !list->merge_lists) { |
8be7e7e4 | 764 | error_set(errp, QERR_DUPLICATE_ID, id, list->name); |
e27c88fe GH |
765 | return NULL; |
766 | } else { | |
767 | return opts; | |
768 | } | |
769 | } | |
da93318a PM |
770 | } else if (list->merge_lists) { |
771 | opts = qemu_opts_find(list, NULL); | |
772 | if (opts) { | |
773 | return opts; | |
774 | } | |
e27c88fe | 775 | } |
7267c094 | 776 | opts = g_malloc0(sizeof(*opts)); |
c64f50d1 | 777 | opts->id = g_strdup(id); |
e27c88fe | 778 | opts->list = list; |
827b0813 | 779 | loc_save(&opts->loc); |
72cf2d4f BS |
780 | QTAILQ_INIT(&opts->head); |
781 | QTAILQ_INSERT_TAIL(&list->head, opts, next); | |
e27c88fe GH |
782 | return opts; |
783 | } | |
784 | ||
dd392449 DXW |
785 | QemuOpts *qemu_opts_create_nofail(QemuOptsList *list) |
786 | { | |
787 | QemuOpts *opts; | |
788 | Error *errp = NULL; | |
789 | opts = qemu_opts_create(list, NULL, 0, &errp); | |
790 | assert_no_error(errp); | |
791 | return opts; | |
792 | } | |
793 | ||
bb67ab02 MA |
794 | void qemu_opts_reset(QemuOptsList *list) |
795 | { | |
796 | QemuOpts *opts, *next_opts; | |
797 | ||
798 | QTAILQ_FOREACH_SAFE(opts, &list->head, next, next_opts) { | |
799 | qemu_opts_del(opts); | |
800 | } | |
801 | } | |
802 | ||
94ac7268 MA |
803 | void qemu_opts_loc_restore(QemuOpts *opts) |
804 | { | |
805 | loc_restore(&opts->loc); | |
806 | } | |
807 | ||
e27c88fe GH |
808 | int qemu_opts_set(QemuOptsList *list, const char *id, |
809 | const char *name, const char *value) | |
810 | { | |
811 | QemuOpts *opts; | |
8be7e7e4 | 812 | Error *local_err = NULL; |
e27c88fe | 813 | |
8be7e7e4 LC |
814 | opts = qemu_opts_create(list, id, 1, &local_err); |
815 | if (error_is_set(&local_err)) { | |
816 | qerror_report_err(local_err); | |
817 | error_free(local_err); | |
e27c88fe GH |
818 | return -1; |
819 | } | |
820 | return qemu_opt_set(opts, name, value); | |
821 | } | |
822 | ||
48026075 GH |
823 | const char *qemu_opts_id(QemuOpts *opts) |
824 | { | |
825 | return opts->id; | |
826 | } | |
827 | ||
e27c88fe GH |
828 | void qemu_opts_del(QemuOpts *opts) |
829 | { | |
830 | QemuOpt *opt; | |
831 | ||
832 | for (;;) { | |
72cf2d4f | 833 | opt = QTAILQ_FIRST(&opts->head); |
e27c88fe GH |
834 | if (opt == NULL) |
835 | break; | |
836 | qemu_opt_del(opt); | |
837 | } | |
72cf2d4f | 838 | QTAILQ_REMOVE(&opts->list->head, opts, next); |
7267c094 AL |
839 | g_free(opts->id); |
840 | g_free(opts); | |
e27c88fe GH |
841 | } |
842 | ||
843 | int qemu_opts_print(QemuOpts *opts, void *dummy) | |
844 | { | |
845 | QemuOpt *opt; | |
846 | ||
847 | fprintf(stderr, "%s: %s:", opts->list->name, | |
848 | opts->id ? opts->id : "<noid>"); | |
72cf2d4f | 849 | QTAILQ_FOREACH(opt, &opts->head, next) { |
e27c88fe GH |
850 | fprintf(stderr, " %s=\"%s\"", opt->name, opt->str); |
851 | } | |
852 | fprintf(stderr, "\n"); | |
853 | return 0; | |
854 | } | |
855 | ||
4f6dd9af JK |
856 | static int opts_do_parse(QemuOpts *opts, const char *params, |
857 | const char *firstname, bool prepend) | |
e27c88fe | 858 | { |
d318ff99 | 859 | char option[128], value[1024]; |
e27c88fe | 860 | const char *p,*pe,*pc; |
584d4064 | 861 | Error *local_err = NULL; |
e27c88fe | 862 | |
2cfa571f | 863 | for (p = params; *p != '\0'; p++) { |
e27c88fe GH |
864 | pe = strchr(p, '='); |
865 | pc = strchr(p, ','); | |
866 | if (!pe || (pc && pc < pe)) { | |
867 | /* found "foo,more" */ | |
868 | if (p == params && firstname) { | |
869 | /* implicitly named first option */ | |
870 | pstrcpy(option, sizeof(option), firstname); | |
871 | p = get_opt_value(value, sizeof(value), p); | |
872 | } else { | |
873 | /* option without value, probably a flag */ | |
874 | p = get_opt_name(option, sizeof(option), p, ','); | |
96729cbd | 875 | if (strncmp(option, "no", 2) == 0) { |
e27c88fe GH |
876 | memmove(option, option+2, strlen(option+2)+1); |
877 | pstrcpy(value, sizeof(value), "off"); | |
878 | } else { | |
879 | pstrcpy(value, sizeof(value), "on"); | |
880 | } | |
881 | } | |
882 | } else { | |
883 | /* found "foo=bar,more" */ | |
884 | p = get_opt_name(option, sizeof(option), p, '='); | |
885 | if (*p != '=') { | |
886 | break; | |
887 | } | |
888 | p++; | |
889 | p = get_opt_value(value, sizeof(value), p); | |
890 | } | |
891 | if (strcmp(option, "id") != 0) { | |
892 | /* store and parse */ | |
584d4064 LC |
893 | opt_set(opts, option, value, prepend, &local_err); |
894 | if (error_is_set(&local_err)) { | |
895 | qerror_report_err(local_err); | |
896 | error_free(local_err); | |
96729cbd | 897 | return -1; |
e27c88fe GH |
898 | } |
899 | } | |
900 | if (*p != ',') { | |
901 | break; | |
902 | } | |
e27c88fe | 903 | } |
96729cbd GH |
904 | return 0; |
905 | } | |
906 | ||
4f6dd9af JK |
907 | int qemu_opts_do_parse(QemuOpts *opts, const char *params, const char *firstname) |
908 | { | |
909 | return opts_do_parse(opts, params, firstname, false); | |
910 | } | |
911 | ||
912 | static QemuOpts *opts_parse(QemuOptsList *list, const char *params, | |
913 | int permit_abbrev, bool defaults) | |
96729cbd | 914 | { |
8212c64f | 915 | const char *firstname; |
d318ff99 | 916 | char value[1024], *id = NULL; |
96729cbd GH |
917 | const char *p; |
918 | QemuOpts *opts; | |
8be7e7e4 | 919 | Error *local_err = NULL; |
96729cbd | 920 | |
8212c64f MA |
921 | assert(!permit_abbrev || list->implied_opt_name); |
922 | firstname = permit_abbrev ? list->implied_opt_name : NULL; | |
923 | ||
96729cbd GH |
924 | if (strncmp(params, "id=", 3) == 0) { |
925 | get_opt_value(value, sizeof(value), params+3); | |
d510c5cf | 926 | id = value; |
96729cbd GH |
927 | } else if ((p = strstr(params, ",id=")) != NULL) { |
928 | get_opt_value(value, sizeof(value), p+4); | |
d510c5cf | 929 | id = value; |
96729cbd | 930 | } |
6d4cd408 | 931 | opts = qemu_opts_create(list, id, !defaults, &local_err); |
8be7e7e4 LC |
932 | if (opts == NULL) { |
933 | if (error_is_set(&local_err)) { | |
934 | qerror_report_err(local_err); | |
935 | error_free(local_err); | |
936 | } | |
96729cbd | 937 | return NULL; |
8be7e7e4 | 938 | } |
96729cbd | 939 | |
4f6dd9af | 940 | if (opts_do_parse(opts, params, firstname, defaults) != 0) { |
96729cbd GH |
941 | qemu_opts_del(opts); |
942 | return NULL; | |
943 | } | |
944 | ||
e27c88fe GH |
945 | return opts; |
946 | } | |
947 | ||
4f6dd9af JK |
948 | QemuOpts *qemu_opts_parse(QemuOptsList *list, const char *params, |
949 | int permit_abbrev) | |
950 | { | |
951 | return opts_parse(list, params, permit_abbrev, false); | |
952 | } | |
953 | ||
954 | void qemu_opts_set_defaults(QemuOptsList *list, const char *params, | |
955 | int permit_abbrev) | |
956 | { | |
957 | QemuOpts *opts; | |
958 | ||
959 | opts = opts_parse(list, params, permit_abbrev, true); | |
960 | assert(opts); | |
961 | } | |
962 | ||
4e89978e LC |
963 | typedef struct OptsFromQDictState { |
964 | QemuOpts *opts; | |
965 | Error **errp; | |
966 | } OptsFromQDictState; | |
967 | ||
01e7f188 MA |
968 | static void qemu_opts_from_qdict_1(const char *key, QObject *obj, void *opaque) |
969 | { | |
4e89978e | 970 | OptsFromQDictState *state = opaque; |
01e7f188 MA |
971 | char buf[32]; |
972 | const char *value; | |
973 | int n; | |
974 | ||
4e89978e | 975 | if (!strcmp(key, "id") || error_is_set(state->errp)) { |
01e7f188 MA |
976 | return; |
977 | } | |
978 | ||
979 | switch (qobject_type(obj)) { | |
980 | case QTYPE_QSTRING: | |
981 | value = qstring_get_str(qobject_to_qstring(obj)); | |
982 | break; | |
983 | case QTYPE_QINT: | |
984 | n = snprintf(buf, sizeof(buf), "%" PRId64, | |
985 | qint_get_int(qobject_to_qint(obj))); | |
986 | assert(n < sizeof(buf)); | |
987 | value = buf; | |
988 | break; | |
989 | case QTYPE_QFLOAT: | |
990 | n = snprintf(buf, sizeof(buf), "%.17g", | |
991 | qfloat_get_double(qobject_to_qfloat(obj))); | |
992 | assert(n < sizeof(buf)); | |
993 | value = buf; | |
994 | break; | |
995 | case QTYPE_QBOOL: | |
d35215f8 BS |
996 | pstrcpy(buf, sizeof(buf), |
997 | qbool_get_int(qobject_to_qbool(obj)) ? "on" : "off"); | |
01e7f188 MA |
998 | value = buf; |
999 | break; | |
1000 | default: | |
1001 | return; | |
1002 | } | |
4e89978e LC |
1003 | |
1004 | qemu_opt_set_err(state->opts, key, value, state->errp); | |
01e7f188 MA |
1005 | } |
1006 | ||
1007 | /* | |
1008 | * Create QemuOpts from a QDict. | |
1009 | * Use value of key "id" as ID if it exists and is a QString. | |
1010 | * Only QStrings, QInts, QFloats and QBools are copied. Entries with | |
1011 | * other types are silently ignored. | |
1012 | */ | |
4e89978e LC |
1013 | QemuOpts *qemu_opts_from_qdict(QemuOptsList *list, const QDict *qdict, |
1014 | Error **errp) | |
01e7f188 | 1015 | { |
4e89978e | 1016 | OptsFromQDictState state; |
8be7e7e4 | 1017 | Error *local_err = NULL; |
4e89978e | 1018 | QemuOpts *opts; |
01e7f188 | 1019 | |
8be7e7e4 LC |
1020 | opts = qemu_opts_create(list, qdict_get_try_str(qdict, "id"), 1, |
1021 | &local_err); | |
1022 | if (error_is_set(&local_err)) { | |
4e89978e | 1023 | error_propagate(errp, local_err); |
01e7f188 | 1024 | return NULL; |
8be7e7e4 | 1025 | } |
01e7f188 | 1026 | |
8be7e7e4 | 1027 | assert(opts != NULL); |
4e89978e LC |
1028 | |
1029 | state.errp = &local_err; | |
1030 | state.opts = opts; | |
1031 | qdict_iter(qdict, qemu_opts_from_qdict_1, &state); | |
1032 | if (error_is_set(&local_err)) { | |
1033 | error_propagate(errp, local_err); | |
1034 | qemu_opts_del(opts); | |
1035 | return NULL; | |
1036 | } | |
1037 | ||
01e7f188 MA |
1038 | return opts; |
1039 | } | |
1040 | ||
376609cc KW |
1041 | /* |
1042 | * Adds all QDict entries to the QemuOpts that can be added and removes them | |
1043 | * from the QDict. When this function returns, the QDict contains only those | |
1044 | * entries that couldn't be added to the QemuOpts. | |
1045 | */ | |
1046 | void qemu_opts_absorb_qdict(QemuOpts *opts, QDict *qdict, Error **errp) | |
1047 | { | |
1048 | const QDictEntry *entry, *next; | |
1049 | ||
1050 | entry = qdict_first(qdict); | |
1051 | ||
1052 | while (entry != NULL) { | |
1053 | Error *local_err = NULL; | |
1054 | OptsFromQDictState state = { | |
1055 | .errp = &local_err, | |
1056 | .opts = opts, | |
1057 | }; | |
1058 | ||
1059 | next = qdict_next(qdict, entry); | |
1060 | ||
1061 | if (find_desc_by_name(opts->list->desc, entry->key)) { | |
1062 | qemu_opts_from_qdict_1(entry->key, entry->value, &state); | |
1063 | if (error_is_set(&local_err)) { | |
1064 | error_propagate(errp, local_err); | |
1065 | return; | |
1066 | } else { | |
1067 | qdict_del(qdict, entry->key); | |
1068 | } | |
1069 | } | |
1070 | ||
1071 | entry = next; | |
1072 | } | |
1073 | } | |
1074 | ||
01e7f188 MA |
1075 | /* |
1076 | * Convert from QemuOpts to QDict. | |
1077 | * The QDict values are of type QString. | |
1078 | * TODO We'll want to use types appropriate for opt->desc->type, but | |
1079 | * this is enough for now. | |
1080 | */ | |
1081 | QDict *qemu_opts_to_qdict(QemuOpts *opts, QDict *qdict) | |
1082 | { | |
1083 | QemuOpt *opt; | |
1084 | QObject *val; | |
1085 | ||
1086 | if (!qdict) { | |
1087 | qdict = qdict_new(); | |
1088 | } | |
1089 | if (opts->id) { | |
1090 | qdict_put(qdict, "id", qstring_from_str(opts->id)); | |
1091 | } | |
1092 | QTAILQ_FOREACH(opt, &opts->head, next) { | |
1093 | val = QOBJECT(qstring_from_str(opt->str)); | |
1094 | qdict_put_obj(qdict, opt->name, val); | |
1095 | } | |
1096 | return qdict; | |
1097 | } | |
1098 | ||
5dc519ef MM |
1099 | /* Validate parsed opts against descriptions where no |
1100 | * descriptions were provided in the QemuOptsList. | |
1101 | */ | |
29952866 | 1102 | void qemu_opts_validate(QemuOpts *opts, const QemuOptDesc *desc, Error **errp) |
5dc519ef MM |
1103 | { |
1104 | QemuOpt *opt; | |
6c519404 | 1105 | Error *local_err = NULL; |
5dc519ef | 1106 | |
db97ceba | 1107 | assert(opts_accepts_any(opts)); |
5dc519ef MM |
1108 | |
1109 | QTAILQ_FOREACH(opt, &opts->head, next) { | |
db97ceba DXW |
1110 | opt->desc = find_desc_by_name(desc, opt->name); |
1111 | if (!opt->desc) { | |
29952866 LC |
1112 | error_set(errp, QERR_INVALID_PARAMETER, opt->name); |
1113 | return; | |
5dc519ef MM |
1114 | } |
1115 | ||
6c519404 LC |
1116 | qemu_opt_parse(opt, &local_err); |
1117 | if (error_is_set(&local_err)) { | |
29952866 LC |
1118 | error_propagate(errp, local_err); |
1119 | return; | |
5dc519ef MM |
1120 | } |
1121 | } | |
5dc519ef MM |
1122 | } |
1123 | ||
e27c88fe GH |
1124 | int qemu_opts_foreach(QemuOptsList *list, qemu_opts_loopfunc func, void *opaque, |
1125 | int abort_on_failure) | |
1126 | { | |
827b0813 | 1127 | Location loc; |
e27c88fe GH |
1128 | QemuOpts *opts; |
1129 | int rc = 0; | |
1130 | ||
827b0813 | 1131 | loc_push_none(&loc); |
72cf2d4f | 1132 | QTAILQ_FOREACH(opts, &list->head, next) { |
827b0813 | 1133 | loc_restore(&opts->loc); |
4a2594dd | 1134 | rc |= func(opts, opaque); |
e27c88fe GH |
1135 | if (abort_on_failure && rc != 0) |
1136 | break; | |
1137 | } | |
827b0813 | 1138 | loc_pop(&loc); |
e27c88fe GH |
1139 | return rc; |
1140 | } |