QMP: Update README file
[qemu.git] / qemu-config.c
blob730ffd9be3cd2bf92b86828c648ab2f40f721a04
1 #include "qemu-common.h"
2 #include "qemu-error.h"
3 #include "qemu-option.h"
4 #include "qemu-config.h"
5 #include "sysemu.h"
6 #include "hw/qdev.h"
8 QemuOptsList qemu_drive_opts = {
9 .name = "drive",
10 .head = QTAILQ_HEAD_INITIALIZER(qemu_drive_opts.head),
11 .desc = {
13 .name = "bus",
14 .type = QEMU_OPT_NUMBER,
15 .help = "bus number",
16 },{
17 .name = "unit",
18 .type = QEMU_OPT_NUMBER,
19 .help = "unit number (i.e. lun for scsi)",
20 },{
21 .name = "if",
22 .type = QEMU_OPT_STRING,
23 .help = "interface (ide, scsi, sd, mtd, floppy, pflash, virtio)",
24 },{
25 .name = "index",
26 .type = QEMU_OPT_NUMBER,
27 },{
28 .name = "cyls",
29 .type = QEMU_OPT_NUMBER,
30 .help = "number of cylinders (ide disk geometry)",
31 },{
32 .name = "heads",
33 .type = QEMU_OPT_NUMBER,
34 .help = "number of heads (ide disk geometry)",
35 },{
36 .name = "secs",
37 .type = QEMU_OPT_NUMBER,
38 .help = "number of sectors (ide disk geometry)",
39 },{
40 .name = "trans",
41 .type = QEMU_OPT_STRING,
42 .help = "chs translation (auto, lba. none)",
43 },{
44 .name = "media",
45 .type = QEMU_OPT_STRING,
46 .help = "media type (disk, cdrom)",
47 },{
48 .name = "snapshot",
49 .type = QEMU_OPT_BOOL,
50 },{
51 .name = "file",
52 .type = QEMU_OPT_STRING,
53 .help = "disk image",
54 },{
55 .name = "cache",
56 .type = QEMU_OPT_STRING,
57 .help = "host cache usage (none, writeback, writethrough, unsafe)",
58 },{
59 .name = "aio",
60 .type = QEMU_OPT_STRING,
61 .help = "host AIO implementation (threads, native)",
62 },{
63 .name = "format",
64 .type = QEMU_OPT_STRING,
65 .help = "disk format (raw, qcow2, ...)",
66 },{
67 .name = "serial",
68 .type = QEMU_OPT_STRING,
69 },{
70 .name = "rerror",
71 .type = QEMU_OPT_STRING,
72 },{
73 .name = "werror",
74 .type = QEMU_OPT_STRING,
75 },{
76 .name = "addr",
77 .type = QEMU_OPT_STRING,
78 .help = "pci address (virtio only)",
79 },{
80 .name = "readonly",
81 .type = QEMU_OPT_BOOL,
83 { /* end if list */ }
87 QemuOptsList qemu_chardev_opts = {
88 .name = "chardev",
89 .implied_opt_name = "backend",
90 .head = QTAILQ_HEAD_INITIALIZER(qemu_chardev_opts.head),
91 .desc = {
93 .name = "backend",
94 .type = QEMU_OPT_STRING,
95 },{
96 .name = "path",
97 .type = QEMU_OPT_STRING,
98 },{
99 .name = "host",
100 .type = QEMU_OPT_STRING,
102 .name = "port",
103 .type = QEMU_OPT_STRING,
105 .name = "localaddr",
106 .type = QEMU_OPT_STRING,
108 .name = "localport",
109 .type = QEMU_OPT_STRING,
111 .name = "to",
112 .type = QEMU_OPT_NUMBER,
114 .name = "ipv4",
115 .type = QEMU_OPT_BOOL,
117 .name = "ipv6",
118 .type = QEMU_OPT_BOOL,
120 .name = "wait",
121 .type = QEMU_OPT_BOOL,
123 .name = "server",
124 .type = QEMU_OPT_BOOL,
126 .name = "delay",
127 .type = QEMU_OPT_BOOL,
129 .name = "telnet",
130 .type = QEMU_OPT_BOOL,
132 .name = "width",
133 .type = QEMU_OPT_NUMBER,
135 .name = "height",
136 .type = QEMU_OPT_NUMBER,
138 .name = "cols",
139 .type = QEMU_OPT_NUMBER,
141 .name = "rows",
142 .type = QEMU_OPT_NUMBER,
144 .name = "mux",
145 .type = QEMU_OPT_BOOL,
147 .name = "signal",
148 .type = QEMU_OPT_BOOL,
150 { /* end if list */ }
154 #ifdef CONFIG_LINUX
155 QemuOptsList qemu_fsdev_opts = {
156 .name = "fsdev",
157 .implied_opt_name = "fstype",
158 .head = QTAILQ_HEAD_INITIALIZER(qemu_fsdev_opts.head),
159 .desc = {
161 .name = "fstype",
162 .type = QEMU_OPT_STRING,
163 }, {
164 .name = "path",
165 .type = QEMU_OPT_STRING,
166 }, {
167 .name = "security_model",
168 .type = QEMU_OPT_STRING,
170 { /*End of list */ }
173 #endif
175 #ifdef CONFIG_LINUX
176 QemuOptsList qemu_virtfs_opts = {
177 .name = "virtfs",
178 .implied_opt_name = "fstype",
179 .head = QTAILQ_HEAD_INITIALIZER(qemu_virtfs_opts.head),
180 .desc = {
182 .name = "fstype",
183 .type = QEMU_OPT_STRING,
184 }, {
185 .name = "path",
186 .type = QEMU_OPT_STRING,
187 }, {
188 .name = "mount_tag",
189 .type = QEMU_OPT_STRING,
190 }, {
191 .name = "security_model",
192 .type = QEMU_OPT_STRING,
195 { /*End of list */ }
198 #endif
200 QemuOptsList qemu_device_opts = {
201 .name = "device",
202 .implied_opt_name = "driver",
203 .head = QTAILQ_HEAD_INITIALIZER(qemu_device_opts.head),
204 .desc = {
206 * no elements => accept any
207 * sanity checking will happen later
208 * when setting device properties
210 { /* end if list */ }
214 QemuOptsList qemu_netdev_opts = {
215 .name = "netdev",
216 .implied_opt_name = "type",
217 .head = QTAILQ_HEAD_INITIALIZER(qemu_netdev_opts.head),
218 .desc = {
220 * no elements => accept any params
221 * validation will happen later
223 { /* end of list */ }
227 QemuOptsList qemu_net_opts = {
228 .name = "net",
229 .implied_opt_name = "type",
230 .head = QTAILQ_HEAD_INITIALIZER(qemu_net_opts.head),
231 .desc = {
233 * no elements => accept any params
234 * validation will happen later
236 { /* end of list */ }
240 QemuOptsList qemu_rtc_opts = {
241 .name = "rtc",
242 .head = QTAILQ_HEAD_INITIALIZER(qemu_rtc_opts.head),
243 .desc = {
245 .name = "base",
246 .type = QEMU_OPT_STRING,
248 .name = "clock",
249 .type = QEMU_OPT_STRING,
251 .name = "driftfix",
252 .type = QEMU_OPT_STRING,
254 { /* end if list */ }
258 QemuOptsList qemu_global_opts = {
259 .name = "global",
260 .head = QTAILQ_HEAD_INITIALIZER(qemu_global_opts.head),
261 .desc = {
263 .name = "driver",
264 .type = QEMU_OPT_STRING,
266 .name = "property",
267 .type = QEMU_OPT_STRING,
269 .name = "value",
270 .type = QEMU_OPT_STRING,
272 { /* end if list */ }
276 QemuOptsList qemu_mon_opts = {
277 .name = "mon",
278 .implied_opt_name = "chardev",
279 .head = QTAILQ_HEAD_INITIALIZER(qemu_mon_opts.head),
280 .desc = {
282 .name = "mode",
283 .type = QEMU_OPT_STRING,
285 .name = "chardev",
286 .type = QEMU_OPT_STRING,
288 .name = "default",
289 .type = QEMU_OPT_BOOL,
291 { /* end if list */ }
295 QemuOptsList qemu_cpudef_opts = {
296 .name = "cpudef",
297 .head = QTAILQ_HEAD_INITIALIZER(qemu_cpudef_opts.head),
298 .desc = {
300 .name = "name",
301 .type = QEMU_OPT_STRING,
303 .name = "level",
304 .type = QEMU_OPT_NUMBER,
306 .name = "vendor",
307 .type = QEMU_OPT_STRING,
309 .name = "family",
310 .type = QEMU_OPT_NUMBER,
312 .name = "model",
313 .type = QEMU_OPT_NUMBER,
315 .name = "stepping",
316 .type = QEMU_OPT_NUMBER,
318 .name = "feature_edx", /* cpuid 0000_0001.edx */
319 .type = QEMU_OPT_STRING,
321 .name = "feature_ecx", /* cpuid 0000_0001.ecx */
322 .type = QEMU_OPT_STRING,
324 .name = "extfeature_edx", /* cpuid 8000_0001.edx */
325 .type = QEMU_OPT_STRING,
327 .name = "extfeature_ecx", /* cpuid 8000_0001.ecx */
328 .type = QEMU_OPT_STRING,
330 .name = "xlevel",
331 .type = QEMU_OPT_NUMBER,
333 .name = "model_id",
334 .type = QEMU_OPT_STRING,
336 .name = "vendor_override",
337 .type = QEMU_OPT_NUMBER,
339 { /* end of list */ }
343 static QemuOptsList *vm_config_groups[] = {
344 &qemu_drive_opts,
345 &qemu_chardev_opts,
346 &qemu_device_opts,
347 &qemu_netdev_opts,
348 &qemu_net_opts,
349 &qemu_rtc_opts,
350 &qemu_global_opts,
351 &qemu_mon_opts,
352 &qemu_cpudef_opts,
353 NULL,
356 static QemuOptsList *find_list(QemuOptsList **lists, const char *group)
358 int i;
360 for (i = 0; lists[i] != NULL; i++) {
361 if (strcmp(lists[i]->name, group) == 0)
362 break;
364 if (lists[i] == NULL) {
365 error_report("there is no option group \"%s\"", group);
367 return lists[i];
370 QemuOptsList *qemu_find_opts(const char *group)
372 return find_list(vm_config_groups, group);
375 int qemu_set_option(const char *str)
377 char group[64], id[64], arg[64];
378 QemuOptsList *list;
379 QemuOpts *opts;
380 int rc, offset;
382 rc = sscanf(str, "%63[^.].%63[^.].%63[^=]%n", group, id, arg, &offset);
383 if (rc < 3 || str[offset] != '=') {
384 error_report("can't parse: \"%s\"", str);
385 return -1;
388 list = qemu_find_opts(group);
389 if (list == NULL) {
390 return -1;
393 opts = qemu_opts_find(list, id);
394 if (!opts) {
395 error_report("there is no %s \"%s\" defined",
396 list->name, id);
397 return -1;
400 if (qemu_opt_set(opts, arg, str+offset+1) == -1) {
401 return -1;
403 return 0;
406 int qemu_global_option(const char *str)
408 char driver[64], property[64];
409 QemuOpts *opts;
410 int rc, offset;
412 rc = sscanf(str, "%63[^.].%63[^=]%n", driver, property, &offset);
413 if (rc < 2 || str[offset] != '=') {
414 error_report("can't parse: \"%s\"", str);
415 return -1;
418 opts = qemu_opts_create(&qemu_global_opts, NULL, 0);
419 qemu_opt_set(opts, "driver", driver);
420 qemu_opt_set(opts, "property", property);
421 qemu_opt_set(opts, "value", str+offset+1);
422 return 0;
425 struct ConfigWriteData {
426 QemuOptsList *list;
427 FILE *fp;
430 static int config_write_opt(const char *name, const char *value, void *opaque)
432 struct ConfigWriteData *data = opaque;
434 fprintf(data->fp, " %s = \"%s\"\n", name, value);
435 return 0;
438 static int config_write_opts(QemuOpts *opts, void *opaque)
440 struct ConfigWriteData *data = opaque;
441 const char *id = qemu_opts_id(opts);
443 if (id) {
444 fprintf(data->fp, "[%s \"%s\"]\n", data->list->name, id);
445 } else {
446 fprintf(data->fp, "[%s]\n", data->list->name);
448 qemu_opt_foreach(opts, config_write_opt, data, 0);
449 fprintf(data->fp, "\n");
450 return 0;
453 void qemu_config_write(FILE *fp)
455 struct ConfigWriteData data = { .fp = fp };
456 QemuOptsList **lists = vm_config_groups;
457 int i;
459 fprintf(fp, "# qemu config file\n\n");
460 for (i = 0; lists[i] != NULL; i++) {
461 data.list = lists[i];
462 qemu_opts_foreach(data.list, config_write_opts, &data, 0);
466 int qemu_config_parse(FILE *fp, QemuOptsList **lists, const char *fname)
468 char line[1024], group[64], id[64], arg[64], value[1024];
469 Location loc;
470 QemuOptsList *list = NULL;
471 QemuOpts *opts = NULL;
472 int res = -1, lno = 0;
474 loc_push_none(&loc);
475 while (fgets(line, sizeof(line), fp) != NULL) {
476 loc_set_file(fname, ++lno);
477 if (line[0] == '\n') {
478 /* skip empty lines */
479 continue;
481 if (line[0] == '#') {
482 /* comment */
483 continue;
485 if (sscanf(line, "[%63s \"%63[^\"]\"]", group, id) == 2) {
486 /* group with id */
487 list = find_list(lists, group);
488 if (list == NULL)
489 goto out;
490 opts = qemu_opts_create(list, id, 1);
491 continue;
493 if (sscanf(line, "[%63[^]]]", group) == 1) {
494 /* group without id */
495 list = find_list(lists, group);
496 if (list == NULL)
497 goto out;
498 opts = qemu_opts_create(list, NULL, 0);
499 continue;
501 if (sscanf(line, " %63s = \"%1023[^\"]\"", arg, value) == 2) {
502 /* arg = value */
503 if (opts == NULL) {
504 error_report("no group defined");
505 goto out;
507 if (qemu_opt_set(opts, arg, value) != 0) {
508 goto out;
510 continue;
512 error_report("parse error");
513 goto out;
515 if (ferror(fp)) {
516 error_report("error reading file");
517 goto out;
519 res = 0;
520 out:
521 loc_pop(&loc);
522 return res;
525 int qemu_read_config_file(const char *filename)
527 FILE *f = fopen(filename, "r");
528 int ret;
530 if (f == NULL) {
531 return -errno;
534 ret = qemu_config_parse(f, vm_config_groups, filename);
535 fclose(f);
537 if (ret == 0) {
538 return 0;
539 } else {
540 return -EINVAL;