qapi: Divorce QAPIDoc from QAPIParseError
[qemu/armbru.git] / system / vl.c
blobb8469d9965da79a9374aa9fe339efc1429810064
1 /*
2 * QEMU System Emulator
4 * Copyright (c) 2003-2008 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/osdep.h"
26 #include "qemu/help-texts.h"
27 #include "qemu/datadir.h"
28 #include "qemu/units.h"
29 #include "exec/cpu-common.h"
30 #include "exec/page-vary.h"
31 #include "hw/qdev-properties.h"
32 #include "qapi/compat-policy.h"
33 #include "qapi/error.h"
34 #include "qapi/qmp/qdict.h"
35 #include "qapi/qmp/qstring.h"
36 #include "qapi/qmp/qjson.h"
37 #include "qemu-version.h"
38 #include "qemu/cutils.h"
39 #include "qemu/help_option.h"
40 #include "qemu/hw-version.h"
41 #include "qemu/uuid.h"
42 #include "sysemu/reset.h"
43 #include "sysemu/runstate.h"
44 #include "sysemu/runstate-action.h"
45 #include "sysemu/seccomp.h"
46 #include "sysemu/tcg.h"
47 #include "sysemu/xen.h"
49 #include "qemu/error-report.h"
50 #include "qemu/sockets.h"
51 #include "qemu/accel.h"
52 #include "qemu/async-teardown.h"
53 #include "hw/usb.h"
54 #include "hw/isa/isa.h"
55 #include "hw/scsi/scsi.h"
56 #include "hw/display/vga.h"
57 #include "hw/firmware/smbios.h"
58 #include "hw/acpi/acpi.h"
59 #include "hw/xen/xen.h"
60 #include "hw/loader.h"
61 #include "monitor/qdev.h"
62 #include "net/net.h"
63 #include "net/slirp.h"
64 #include "monitor/monitor.h"
65 #include "ui/console.h"
66 #include "ui/input.h"
67 #include "sysemu/sysemu.h"
68 #include "sysemu/numa.h"
69 #include "sysemu/hostmem.h"
70 #include "exec/gdbstub.h"
71 #include "qemu/timer.h"
72 #include "chardev/char.h"
73 #include "qemu/bitmap.h"
74 #include "qemu/log.h"
75 #include "sysemu/blockdev.h"
76 #include "hw/block/block.h"
77 #include "hw/i386/x86.h"
78 #include "hw/i386/pc.h"
79 #include "migration/misc.h"
80 #include "migration/snapshot.h"
81 #include "sysemu/tpm.h"
82 #include "sysemu/dma.h"
83 #include "hw/audio/soundhw.h"
84 #include "audio/audio.h"
85 #include "sysemu/cpus.h"
86 #include "sysemu/cpu-timers.h"
87 #include "migration/colo.h"
88 #include "migration/postcopy-ram.h"
89 #include "sysemu/kvm.h"
90 #include "qapi/qobject-input-visitor.h"
91 #include "qemu/option.h"
92 #include "qemu/config-file.h"
93 #include "qemu/main-loop.h"
94 #ifdef CONFIG_VIRTFS
95 #include "fsdev/qemu-fsdev.h"
96 #endif
97 #include "sysemu/qtest.h"
98 #ifdef CONFIG_TCG
99 #include "tcg/perf.h"
100 #endif
102 #include "disas/disas.h"
104 #include "trace.h"
105 #include "trace/control.h"
106 #include "qemu/plugin.h"
107 #include "qemu/queue.h"
108 #include "sysemu/arch_init.h"
109 #include "exec/confidential-guest-support.h"
111 #include "ui/qemu-spice.h"
112 #include "qapi/string-input-visitor.h"
113 #include "qapi/opts-visitor.h"
114 #include "qapi/clone-visitor.h"
115 #include "qom/object_interfaces.h"
116 #include "semihosting/semihost.h"
117 #include "crypto/init.h"
118 #include "sysemu/replay.h"
119 #include "qapi/qapi-events-run-state.h"
120 #include "qapi/qapi-types-audio.h"
121 #include "qapi/qapi-visit-audio.h"
122 #include "qapi/qapi-visit-block-core.h"
123 #include "qapi/qapi-visit-compat.h"
124 #include "qapi/qapi-visit-machine.h"
125 #include "qapi/qapi-visit-ui.h"
126 #include "qapi/qapi-commands-block-core.h"
127 #include "qapi/qapi-commands-migration.h"
128 #include "qapi/qapi-commands-misc.h"
129 #include "qapi/qapi-visit-qom.h"
130 #include "qapi/qapi-commands-ui.h"
131 #include "block/qdict.h"
132 #include "qapi/qmp/qerror.h"
133 #include "sysemu/iothread.h"
134 #include "qemu/guest-random.h"
135 #include "qemu/keyval.h"
137 #define MAX_VIRTIO_CONSOLES 1
139 typedef struct BlockdevOptionsQueueEntry {
140 BlockdevOptions *bdo;
141 Location loc;
142 QSIMPLEQ_ENTRY(BlockdevOptionsQueueEntry) entry;
143 } BlockdevOptionsQueueEntry;
145 typedef QSIMPLEQ_HEAD(, BlockdevOptionsQueueEntry) BlockdevOptionsQueue;
147 typedef struct ObjectOption {
148 ObjectOptions *opts;
149 QTAILQ_ENTRY(ObjectOption) next;
150 } ObjectOption;
152 typedef struct DeviceOption {
153 QDict *opts;
154 Location loc;
155 QTAILQ_ENTRY(DeviceOption) next;
156 } DeviceOption;
158 static const char *cpu_option;
159 static const char *mem_path;
160 static const char *incoming;
161 static const char *loadvm;
162 static const char *accelerators;
163 static bool have_custom_ram_size;
164 static const char *ram_memdev_id;
165 static QDict *machine_opts_dict;
166 static QTAILQ_HEAD(, ObjectOption) object_opts = QTAILQ_HEAD_INITIALIZER(object_opts);
167 static QTAILQ_HEAD(, DeviceOption) device_opts = QTAILQ_HEAD_INITIALIZER(device_opts);
168 static int display_remote;
169 static int snapshot;
170 static bool preconfig_requested;
171 static QemuPluginList plugin_list = QTAILQ_HEAD_INITIALIZER(plugin_list);
172 static BlockdevOptionsQueue bdo_queue = QSIMPLEQ_HEAD_INITIALIZER(bdo_queue);
173 static bool nographic = false;
174 static int mem_prealloc; /* force preallocation of physical target memory */
175 static const char *vga_model = NULL;
176 static DisplayOptions dpy;
177 static int num_serial_hds;
178 static Chardev **serial_hds;
179 static const char *log_mask;
180 static const char *log_file;
181 static bool list_data_dirs;
182 static const char *qtest_chrdev;
183 static const char *qtest_log;
185 static int has_defaults = 1;
186 static int default_audio = 1;
187 static int default_serial = 1;
188 static int default_parallel = 1;
189 static int default_monitor = 1;
190 static int default_floppy = 1;
191 static int default_cdrom = 1;
192 static int default_sdcard = 1;
193 static int default_vga = 1;
194 static int default_net = 1;
196 static const struct {
197 const char *driver;
198 int *flag;
199 } default_list[] = {
200 { .driver = "xen-console", .flag = &default_serial },
201 { .driver = "isa-serial", .flag = &default_serial },
202 { .driver = "isa-parallel", .flag = &default_parallel },
203 { .driver = "isa-fdc", .flag = &default_floppy },
204 { .driver = "floppy", .flag = &default_floppy },
205 { .driver = "ide-cd", .flag = &default_cdrom },
206 { .driver = "ide-hd", .flag = &default_cdrom },
207 { .driver = "scsi-cd", .flag = &default_cdrom },
208 { .driver = "scsi-hd", .flag = &default_cdrom },
209 { .driver = "VGA", .flag = &default_vga },
210 { .driver = "isa-vga", .flag = &default_vga },
211 { .driver = "cirrus-vga", .flag = &default_vga },
212 { .driver = "isa-cirrus-vga", .flag = &default_vga },
213 { .driver = "vmware-svga", .flag = &default_vga },
214 { .driver = "qxl-vga", .flag = &default_vga },
215 { .driver = "virtio-vga", .flag = &default_vga },
216 { .driver = "ati-vga", .flag = &default_vga },
217 { .driver = "vhost-user-vga", .flag = &default_vga },
218 { .driver = "virtio-vga-gl", .flag = &default_vga },
219 { .driver = "virtio-vga-rutabaga", .flag = &default_vga },
222 static QemuOptsList qemu_rtc_opts = {
223 .name = "rtc",
224 .head = QTAILQ_HEAD_INITIALIZER(qemu_rtc_opts.head),
225 .merge_lists = true,
226 .desc = {
228 .name = "base",
229 .type = QEMU_OPT_STRING,
231 .name = "clock",
232 .type = QEMU_OPT_STRING,
234 .name = "driftfix",
235 .type = QEMU_OPT_STRING,
237 { /* end of list */ }
241 static QemuOptsList qemu_option_rom_opts = {
242 .name = "option-rom",
243 .implied_opt_name = "romfile",
244 .head = QTAILQ_HEAD_INITIALIZER(qemu_option_rom_opts.head),
245 .desc = {
247 .name = "bootindex",
248 .type = QEMU_OPT_NUMBER,
249 }, {
250 .name = "romfile",
251 .type = QEMU_OPT_STRING,
253 { /* end of list */ }
257 static QemuOptsList qemu_accel_opts = {
258 .name = "accel",
259 .implied_opt_name = "accel",
260 .head = QTAILQ_HEAD_INITIALIZER(qemu_accel_opts.head),
261 .desc = {
263 * no elements => accept any
264 * sanity checking will happen later
265 * when setting accelerator properties
271 static QemuOptsList qemu_boot_opts = {
272 .name = "boot-opts",
273 .implied_opt_name = "order",
274 .merge_lists = true,
275 .head = QTAILQ_HEAD_INITIALIZER(qemu_boot_opts.head),
276 .desc = {
278 .name = "order",
279 .type = QEMU_OPT_STRING,
280 }, {
281 .name = "once",
282 .type = QEMU_OPT_STRING,
283 }, {
284 .name = "menu",
285 .type = QEMU_OPT_BOOL,
286 }, {
287 .name = "splash",
288 .type = QEMU_OPT_STRING,
289 }, {
290 .name = "splash-time",
291 .type = QEMU_OPT_NUMBER,
292 }, {
293 .name = "reboot-timeout",
294 .type = QEMU_OPT_NUMBER,
295 }, {
296 .name = "strict",
297 .type = QEMU_OPT_BOOL,
299 { /*End of list */ }
303 static QemuOptsList qemu_add_fd_opts = {
304 .name = "add-fd",
305 .head = QTAILQ_HEAD_INITIALIZER(qemu_add_fd_opts.head),
306 .desc = {
308 .name = "fd",
309 .type = QEMU_OPT_NUMBER,
310 .help = "file descriptor of which a duplicate is added to fd set",
312 .name = "set",
313 .type = QEMU_OPT_NUMBER,
314 .help = "ID of the fd set to add fd to",
316 .name = "opaque",
317 .type = QEMU_OPT_STRING,
318 .help = "free-form string used to describe fd",
320 { /* end of list */ }
324 static QemuOptsList qemu_object_opts = {
325 .name = "object",
326 .implied_opt_name = "qom-type",
327 .head = QTAILQ_HEAD_INITIALIZER(qemu_object_opts.head),
328 .desc = {
333 static QemuOptsList qemu_tpmdev_opts = {
334 .name = "tpmdev",
335 .implied_opt_name = "type",
336 .head = QTAILQ_HEAD_INITIALIZER(qemu_tpmdev_opts.head),
337 .desc = {
338 /* options are defined in the TPM backends */
339 { /* end of list */ }
343 static QemuOptsList qemu_overcommit_opts = {
344 .name = "overcommit",
345 .head = QTAILQ_HEAD_INITIALIZER(qemu_overcommit_opts.head),
346 .desc = {
348 .name = "mem-lock",
349 .type = QEMU_OPT_BOOL,
352 .name = "cpu-pm",
353 .type = QEMU_OPT_BOOL,
355 { /* end of list */ }
359 static QemuOptsList qemu_msg_opts = {
360 .name = "msg",
361 .head = QTAILQ_HEAD_INITIALIZER(qemu_msg_opts.head),
362 .desc = {
364 .name = "timestamp",
365 .type = QEMU_OPT_BOOL,
368 .name = "guest-name",
369 .type = QEMU_OPT_BOOL,
370 .help = "Prepends guest name for error messages but only if "
371 "-name guest is set otherwise option is ignored\n",
373 { /* end of list */ }
377 static QemuOptsList qemu_name_opts = {
378 .name = "name",
379 .implied_opt_name = "guest",
380 .merge_lists = true,
381 .head = QTAILQ_HEAD_INITIALIZER(qemu_name_opts.head),
382 .desc = {
384 .name = "guest",
385 .type = QEMU_OPT_STRING,
386 .help = "Sets the name of the guest.\n"
387 "This name will be displayed in the SDL window caption.\n"
388 "The name will also be used for the VNC server",
389 }, {
390 .name = "process",
391 .type = QEMU_OPT_STRING,
392 .help = "Sets the name of the QEMU process, as shown in top etc",
393 }, {
394 .name = "debug-threads",
395 .type = QEMU_OPT_BOOL,
396 .help = "When enabled, name the individual threads; defaults off.\n"
397 "NOTE: The thread names are for debugging and not a\n"
398 "stable API.",
400 { /* End of list */ }
404 static QemuOptsList qemu_mem_opts = {
405 .name = "memory",
406 .implied_opt_name = "size",
407 .head = QTAILQ_HEAD_INITIALIZER(qemu_mem_opts.head),
408 .merge_lists = true,
409 .desc = {
411 .name = "size",
412 .type = QEMU_OPT_SIZE,
415 .name = "slots",
416 .type = QEMU_OPT_NUMBER,
419 .name = "maxmem",
420 .type = QEMU_OPT_SIZE,
422 { /* end of list */ }
426 static QemuOptsList qemu_icount_opts = {
427 .name = "icount",
428 .implied_opt_name = "shift",
429 .merge_lists = true,
430 .head = QTAILQ_HEAD_INITIALIZER(qemu_icount_opts.head),
431 .desc = {
433 .name = "shift",
434 .type = QEMU_OPT_STRING,
435 }, {
436 .name = "align",
437 .type = QEMU_OPT_BOOL,
438 }, {
439 .name = "sleep",
440 .type = QEMU_OPT_BOOL,
441 }, {
442 .name = "rr",
443 .type = QEMU_OPT_STRING,
444 }, {
445 .name = "rrfile",
446 .type = QEMU_OPT_STRING,
447 }, {
448 .name = "rrsnapshot",
449 .type = QEMU_OPT_STRING,
451 { /* end of list */ }
455 static QemuOptsList qemu_fw_cfg_opts = {
456 .name = "fw_cfg",
457 .implied_opt_name = "name",
458 .head = QTAILQ_HEAD_INITIALIZER(qemu_fw_cfg_opts.head),
459 .desc = {
461 .name = "name",
462 .type = QEMU_OPT_STRING,
463 .help = "Sets the fw_cfg name of the blob to be inserted",
464 }, {
465 .name = "file",
466 .type = QEMU_OPT_STRING,
467 .help = "Sets the name of the file from which "
468 "the fw_cfg blob will be loaded",
469 }, {
470 .name = "string",
471 .type = QEMU_OPT_STRING,
472 .help = "Sets content of the blob to be inserted from a string",
473 }, {
474 .name = "gen_id",
475 .type = QEMU_OPT_STRING,
476 .help = "Sets id of the object generating the fw_cfg blob "
477 "to be inserted",
479 { /* end of list */ }
483 static QemuOptsList qemu_action_opts = {
484 .name = "action",
485 .merge_lists = true,
486 .head = QTAILQ_HEAD_INITIALIZER(qemu_action_opts.head),
487 .desc = {
489 .name = "shutdown",
490 .type = QEMU_OPT_STRING,
492 .name = "reboot",
493 .type = QEMU_OPT_STRING,
495 .name = "panic",
496 .type = QEMU_OPT_STRING,
498 .name = "watchdog",
499 .type = QEMU_OPT_STRING,
501 { /* end of list */ }
505 const char *qemu_get_vm_name(void)
507 return qemu_name;
510 static void default_driver_disable(const char *driver)
512 int i;
514 if (!driver) {
515 return;
518 for (i = 0; i < ARRAY_SIZE(default_list); i++) {
519 if (strcmp(default_list[i].driver, driver) != 0)
520 continue;
521 *(default_list[i].flag) = 0;
525 static int default_driver_check(void *opaque, QemuOpts *opts, Error **errp)
527 const char *driver = qemu_opt_get(opts, "driver");
529 default_driver_disable(driver);
530 return 0;
533 static void default_driver_check_json(void)
535 DeviceOption *opt;
537 QTAILQ_FOREACH(opt, &device_opts, next) {
538 const char *driver = qdict_get_try_str(opt->opts, "driver");
539 default_driver_disable(driver);
543 static int parse_name(void *opaque, QemuOpts *opts, Error **errp)
545 const char *proc_name;
547 if (qemu_opt_get(opts, "debug-threads")) {
548 qemu_thread_naming(qemu_opt_get_bool(opts, "debug-threads", false));
550 qemu_name = qemu_opt_get(opts, "guest");
552 proc_name = qemu_opt_get(opts, "process");
553 if (proc_name) {
554 os_set_proc_name(proc_name);
557 return 0;
560 bool defaults_enabled(void)
562 return has_defaults;
565 #ifndef _WIN32
566 static int parse_add_fd(void *opaque, QemuOpts *opts, Error **errp)
568 int fd, dupfd, flags;
569 int64_t fdset_id;
570 const char *fd_opaque = NULL;
571 AddfdInfo *fdinfo;
573 fd = qemu_opt_get_number(opts, "fd", -1);
574 fdset_id = qemu_opt_get_number(opts, "set", -1);
575 fd_opaque = qemu_opt_get(opts, "opaque");
577 if (fd < 0) {
578 error_setg(errp, "fd option is required and must be non-negative");
579 return -1;
582 if (fd <= STDERR_FILENO) {
583 error_setg(errp, "fd cannot be a standard I/O stream");
584 return -1;
588 * All fds inherited across exec() necessarily have FD_CLOEXEC
589 * clear, while qemu sets FD_CLOEXEC on all other fds used internally.
591 flags = fcntl(fd, F_GETFD);
592 if (flags == -1 || (flags & FD_CLOEXEC)) {
593 error_setg(errp, "fd is not valid or already in use");
594 return -1;
597 if (fdset_id < 0) {
598 error_setg(errp, "set option is required and must be non-negative");
599 return -1;
602 #ifdef F_DUPFD_CLOEXEC
603 dupfd = fcntl(fd, F_DUPFD_CLOEXEC, 0);
604 #else
605 dupfd = dup(fd);
606 if (dupfd != -1) {
607 qemu_set_cloexec(dupfd);
609 #endif
610 if (dupfd == -1) {
611 error_setg(errp, "error duplicating fd: %s", strerror(errno));
612 return -1;
615 /* add the duplicate fd, and optionally the opaque string, to the fd set */
616 fdinfo = monitor_fdset_add_fd(dupfd, true, fdset_id, fd_opaque,
617 &error_abort);
618 g_free(fdinfo);
620 return 0;
623 static int cleanup_add_fd(void *opaque, QemuOpts *opts, Error **errp)
625 int fd;
627 fd = qemu_opt_get_number(opts, "fd", -1);
628 close(fd);
630 return 0;
632 #endif
634 /***********************************************************/
635 /* QEMU Block devices */
637 #define HD_OPTS "media=disk"
638 #define CDROM_OPTS "media=cdrom"
639 #define FD_OPTS ""
640 #define PFLASH_OPTS ""
641 #define MTD_OPTS ""
642 #define SD_OPTS ""
644 static int drive_init_func(void *opaque, QemuOpts *opts, Error **errp)
646 BlockInterfaceType *block_default_type = opaque;
648 return drive_new(opts, *block_default_type, errp) == NULL;
651 static int drive_enable_snapshot(void *opaque, QemuOpts *opts, Error **errp)
653 if (qemu_opt_get(opts, "snapshot") == NULL) {
654 qemu_opt_set(opts, "snapshot", "on", &error_abort);
656 return 0;
659 static void default_drive(int enable, int snapshot, BlockInterfaceType type,
660 int index, const char *optstr)
662 QemuOpts *opts;
663 DriveInfo *dinfo;
665 if (!enable || drive_get_by_index(type, index)) {
666 return;
669 opts = drive_add(type, index, NULL, optstr);
670 if (snapshot) {
671 drive_enable_snapshot(NULL, opts, NULL);
674 dinfo = drive_new(opts, type, &error_abort);
675 dinfo->is_default = true;
679 static void configure_blockdev(BlockdevOptionsQueue *bdo_queue,
680 MachineClass *machine_class, int snapshot)
683 * If the currently selected machine wishes to override the
684 * units-per-bus property of its default HBA interface type, do so
685 * now.
687 if (machine_class->units_per_default_bus) {
688 override_max_devs(machine_class->block_default_type,
689 machine_class->units_per_default_bus);
692 /* open the virtual block devices */
693 while (!QSIMPLEQ_EMPTY(bdo_queue)) {
694 BlockdevOptionsQueueEntry *bdo = QSIMPLEQ_FIRST(bdo_queue);
696 QSIMPLEQ_REMOVE_HEAD(bdo_queue, entry);
697 loc_push_restore(&bdo->loc);
698 qmp_blockdev_add(bdo->bdo, &error_fatal);
699 loc_pop(&bdo->loc);
700 qapi_free_BlockdevOptions(bdo->bdo);
701 g_free(bdo);
703 if (snapshot) {
704 qemu_opts_foreach(qemu_find_opts("drive"), drive_enable_snapshot,
705 NULL, NULL);
707 if (qemu_opts_foreach(qemu_find_opts("drive"), drive_init_func,
708 &machine_class->block_default_type, &error_fatal)) {
709 /* We printed help */
710 exit(0);
713 default_drive(default_cdrom, snapshot, machine_class->block_default_type, 2,
714 CDROM_OPTS);
715 default_drive(default_floppy, snapshot, IF_FLOPPY, 0, FD_OPTS);
716 default_drive(default_sdcard, snapshot, IF_SD, 0, SD_OPTS);
720 static QemuOptsList qemu_smp_opts = {
721 .name = "smp-opts",
722 .implied_opt_name = "cpus",
723 .merge_lists = true,
724 .head = QTAILQ_HEAD_INITIALIZER(qemu_smp_opts.head),
725 .desc = {
727 .name = "cpus",
728 .type = QEMU_OPT_NUMBER,
729 }, {
730 .name = "drawers",
731 .type = QEMU_OPT_NUMBER,
732 }, {
733 .name = "books",
734 .type = QEMU_OPT_NUMBER,
735 }, {
736 .name = "sockets",
737 .type = QEMU_OPT_NUMBER,
738 }, {
739 .name = "dies",
740 .type = QEMU_OPT_NUMBER,
741 }, {
742 .name = "clusters",
743 .type = QEMU_OPT_NUMBER,
744 }, {
745 .name = "cores",
746 .type = QEMU_OPT_NUMBER,
747 }, {
748 .name = "threads",
749 .type = QEMU_OPT_NUMBER,
750 }, {
751 .name = "maxcpus",
752 .type = QEMU_OPT_NUMBER,
754 { /*End of list */ }
758 #if defined(CONFIG_POSIX)
759 static QemuOptsList qemu_run_with_opts = {
760 .name = "run-with",
761 .head = QTAILQ_HEAD_INITIALIZER(qemu_run_with_opts.head),
762 .desc = {
763 #if defined(CONFIG_LINUX)
765 .name = "async-teardown",
766 .type = QEMU_OPT_BOOL,
768 #endif
770 .name = "chroot",
771 .type = QEMU_OPT_STRING,
773 { /* end of list */ }
777 #define qemu_add_run_with_opts() qemu_add_opts(&qemu_run_with_opts)
779 #else
781 #define qemu_add_run_with_opts()
783 #endif /* CONFIG_POSIX */
785 static void realtime_init(void)
787 if (enable_mlock) {
788 if (os_mlock() < 0) {
789 error_report("locking memory failed");
790 exit(1);
796 static void configure_msg(QemuOpts *opts)
798 message_with_timestamp = qemu_opt_get_bool(opts, "timestamp", false);
799 error_with_guestname = qemu_opt_get_bool(opts, "guest-name", false);
803 /***********************************************************/
804 /* USB devices */
806 static int usb_device_add(const char *devname)
808 USBDevice *dev = NULL;
810 if (!machine_usb(current_machine)) {
811 return -1;
814 dev = usbdevice_create(devname);
815 if (!dev)
816 return -1;
818 return 0;
821 static int usb_parse(const char *cmdline)
823 int r;
824 r = usb_device_add(cmdline);
825 if (r < 0) {
826 error_report("could not add USB device '%s'", cmdline);
828 return r;
831 /***********************************************************/
832 /* machine registration */
834 static MachineClass *find_machine(const char *name, GSList *machines)
836 GSList *el;
838 for (el = machines; el; el = el->next) {
839 MachineClass *mc = el->data;
841 if (!strcmp(mc->name, name) || !g_strcmp0(mc->alias, name)) {
842 return mc;
846 return NULL;
849 static MachineClass *find_default_machine(GSList *machines)
851 GSList *el;
852 MachineClass *default_machineclass = NULL;
854 for (el = machines; el; el = el->next) {
855 MachineClass *mc = el->data;
857 if (mc->is_default) {
858 assert(default_machineclass == NULL && "Multiple default machines");
859 default_machineclass = mc;
863 return default_machineclass;
866 static void version(void)
868 printf("QEMU emulator version " QEMU_FULL_VERSION "\n"
869 QEMU_COPYRIGHT "\n");
872 static void help(int exitcode)
874 version();
875 printf("usage: %s [options] [disk_image]\n\n"
876 "'disk_image' is a raw hard disk image for IDE hard disk 0\n\n",
877 g_get_prgname());
879 #define DEF(option, opt_arg, opt_enum, opt_help, arch_mask) \
880 if ((arch_mask) & arch_type) \
881 fputs(opt_help, stdout);
883 #define ARCHHEADING(text, arch_mask) \
884 if ((arch_mask) & arch_type) \
885 puts(stringify(text));
887 #define DEFHEADING(text) ARCHHEADING(text, QEMU_ARCH_ALL)
889 #include "qemu-options.def"
891 printf("\nDuring emulation, the following keys are useful:\n"
892 "ctrl-alt-f toggle full screen\n"
893 "ctrl-alt-n switch to virtual console 'n'\n"
894 "ctrl-alt-g toggle mouse and keyboard grab\n"
895 "\n"
896 "When using -nographic, press 'ctrl-a h' to get some help.\n"
897 "\n"
898 QEMU_HELP_BOTTOM "\n");
900 exit(exitcode);
903 enum {
905 #define DEF(option, opt_arg, opt_enum, opt_help, arch_mask) \
906 opt_enum,
907 #define DEFHEADING(text)
908 #define ARCHHEADING(text, arch_mask)
910 #include "qemu-options.def"
913 #define HAS_ARG 0x0001
915 typedef struct QEMUOption {
916 const char *name;
917 int flags;
918 int index;
919 uint32_t arch_mask;
920 } QEMUOption;
922 static const QEMUOption qemu_options[] = {
923 { "h", 0, QEMU_OPTION_h, QEMU_ARCH_ALL },
925 #define DEF(option, opt_arg, opt_enum, opt_help, arch_mask) \
926 { option, opt_arg, opt_enum, arch_mask },
927 #define DEFHEADING(text)
928 #define ARCHHEADING(text, arch_mask)
930 #include "qemu-options.def"
931 { /* end of list */ }
934 typedef struct VGAInterfaceInfo {
935 const char *opt_name; /* option name */
936 const char *name; /* human-readable name */
937 /* Class names indicating that support is available.
938 * If no class is specified, the interface is always available */
939 const char *class_names[2];
940 } VGAInterfaceInfo;
942 static const VGAInterfaceInfo vga_interfaces[VGA_TYPE_MAX] = {
943 [VGA_NONE] = {
944 .opt_name = "none",
945 .name = "no graphic card",
947 [VGA_STD] = {
948 .opt_name = "std",
949 .name = "standard VGA",
950 .class_names = { "VGA", "isa-vga" },
952 [VGA_CIRRUS] = {
953 .opt_name = "cirrus",
954 .name = "Cirrus VGA",
955 .class_names = { "cirrus-vga", "isa-cirrus-vga" },
957 [VGA_VMWARE] = {
958 .opt_name = "vmware",
959 .name = "VMWare SVGA",
960 .class_names = { "vmware-svga" },
962 [VGA_VIRTIO] = {
963 .opt_name = "virtio",
964 .name = "Virtio VGA",
965 .class_names = { "virtio-vga" },
967 [VGA_QXL] = {
968 .opt_name = "qxl",
969 .name = "QXL VGA",
970 .class_names = { "qxl-vga" },
972 [VGA_TCX] = {
973 .opt_name = "tcx",
974 .name = "TCX framebuffer",
975 .class_names = { "sun-tcx" },
977 [VGA_CG3] = {
978 .opt_name = "cg3",
979 .name = "CG3 framebuffer",
980 .class_names = { "cgthree" },
982 #ifdef CONFIG_XEN_BACKEND
983 [VGA_XENFB] = {
984 .opt_name = "xenfb",
985 .name = "Xen paravirtualized framebuffer",
987 #endif
990 static bool vga_interface_available(VGAInterfaceType t)
992 const VGAInterfaceInfo *ti = &vga_interfaces[t];
994 assert(t < VGA_TYPE_MAX);
995 return !ti->class_names[0] ||
996 module_object_class_by_name(ti->class_names[0]) ||
997 module_object_class_by_name(ti->class_names[1]);
1000 static const char *
1001 get_default_vga_model(const MachineClass *machine_class)
1003 if (machine_class->default_display) {
1004 for (int t = 0; t < VGA_TYPE_MAX; t++) {
1005 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1007 if (ti->opt_name && vga_interface_available(t) &&
1008 g_str_equal(ti->opt_name, machine_class->default_display)) {
1009 return machine_class->default_display;
1013 warn_report_once("Default display '%s' is not available in this binary",
1014 machine_class->default_display);
1015 return NULL;
1016 } else if (vga_interface_available(VGA_CIRRUS)) {
1017 return "cirrus";
1018 } else if (vga_interface_available(VGA_STD)) {
1019 return "std";
1022 return NULL;
1025 static void select_vgahw(const MachineClass *machine_class, const char *p)
1027 const char *opts;
1028 int t;
1030 if (g_str_equal(p, "help")) {
1031 const char *def = get_default_vga_model(machine_class);
1033 for (t = 0; t < VGA_TYPE_MAX; t++) {
1034 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1036 if (vga_interface_available(t) && ti->opt_name) {
1037 printf("%-20s %s%s\n", ti->opt_name, ti->name ?: "",
1038 (def && g_str_equal(ti->opt_name, def)) ?
1039 " (default)" : "");
1042 exit(0);
1045 assert(vga_interface_type == VGA_NONE);
1046 for (t = 0; t < VGA_TYPE_MAX; t++) {
1047 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1048 if (ti->opt_name && strstart(p, ti->opt_name, &opts)) {
1049 if (!vga_interface_available(t)) {
1050 error_report("%s not available", ti->name);
1051 exit(1);
1053 vga_interface_type = t;
1054 break;
1057 if (t == VGA_TYPE_MAX) {
1058 invalid_vga:
1059 error_report("unknown vga type: %s", p);
1060 exit(1);
1062 while (*opts) {
1063 const char *nextopt;
1065 if (strstart(opts, ",retrace=", &nextopt)) {
1066 opts = nextopt;
1067 if (strstart(opts, "dumb", &nextopt))
1068 vga_retrace_method = VGA_RETRACE_DUMB;
1069 else if (strstart(opts, "precise", &nextopt))
1070 vga_retrace_method = VGA_RETRACE_PRECISE;
1071 else goto invalid_vga;
1072 } else goto invalid_vga;
1073 opts = nextopt;
1077 static void parse_display_qapi(const char *str)
1079 DisplayOptions *opts;
1080 Visitor *v;
1082 v = qobject_input_visitor_new_str(str, "type", &error_fatal);
1084 visit_type_DisplayOptions(v, NULL, &opts, &error_fatal);
1085 QAPI_CLONE_MEMBERS(DisplayOptions, &dpy, opts);
1087 qapi_free_DisplayOptions(opts);
1088 visit_free(v);
1091 DisplayOptions *qmp_query_display_options(Error **errp)
1093 return QAPI_CLONE(DisplayOptions, &dpy);
1096 static void parse_display(const char *p)
1098 if (is_help_option(p)) {
1099 qemu_display_help();
1100 exit(0);
1103 #ifdef CONFIG_VNC
1104 const char *opts;
1106 if (strstart(p, "vnc", &opts)) {
1108 * vnc isn't a (local) DisplayType but a protocol for remote
1109 * display access.
1111 if (*opts == '=') {
1112 vnc_parse(opts + 1);
1113 display_remote++;
1114 } else {
1115 error_report("VNC requires a display argument vnc=<display>");
1116 exit(1);
1118 return;
1120 #endif
1122 parse_display_qapi(p);
1125 static inline bool nonempty_str(const char *str)
1127 return str && *str;
1130 static int parse_fw_cfg(void *opaque, QemuOpts *opts, Error **errp)
1132 gchar *buf;
1133 size_t size;
1134 const char *name, *file, *str, *gen_id;
1135 FWCfgState *fw_cfg = (FWCfgState *) opaque;
1137 if (fw_cfg == NULL) {
1138 error_setg(errp, "fw_cfg device not available");
1139 return -1;
1141 name = qemu_opt_get(opts, "name");
1142 file = qemu_opt_get(opts, "file");
1143 str = qemu_opt_get(opts, "string");
1144 gen_id = qemu_opt_get(opts, "gen_id");
1146 /* we need the name, and exactly one of: file, content string, gen_id */
1147 if (!nonempty_str(name) ||
1148 nonempty_str(file) + nonempty_str(str) + nonempty_str(gen_id) != 1) {
1149 error_setg(errp, "name, plus exactly one of file,"
1150 " string and gen_id, are needed");
1151 return -1;
1153 if (strlen(name) > FW_CFG_MAX_FILE_PATH - 1) {
1154 error_setg(errp, "name too long (max. %d char)",
1155 FW_CFG_MAX_FILE_PATH - 1);
1156 return -1;
1158 if (nonempty_str(gen_id)) {
1160 * In this particular case where the content is populated
1161 * internally, the "etc/" namespace protection is relaxed,
1162 * so do not emit a warning.
1164 } else if (strncmp(name, "opt/", 4) != 0) {
1165 warn_report("externally provided fw_cfg item names "
1166 "should be prefixed with \"opt/\"");
1168 if (nonempty_str(str)) {
1169 size = strlen(str); /* NUL terminator NOT included in fw_cfg blob */
1170 buf = g_memdup(str, size);
1171 } else if (nonempty_str(gen_id)) {
1172 if (!fw_cfg_add_from_generator(fw_cfg, name, gen_id, errp)) {
1173 return -1;
1175 return 0;
1176 } else {
1177 GError *err = NULL;
1178 if (!g_file_get_contents(file, &buf, &size, &err)) {
1179 error_setg(errp, "can't load %s: %s", file, err->message);
1180 g_error_free(err);
1181 return -1;
1184 /* For legacy, keep user files in a specific global order. */
1185 fw_cfg_set_order_override(fw_cfg, FW_CFG_ORDER_OVERRIDE_USER);
1186 fw_cfg_add_file(fw_cfg, name, buf, size);
1187 fw_cfg_reset_order_override(fw_cfg);
1188 return 0;
1191 static int device_help_func(void *opaque, QemuOpts *opts, Error **errp)
1193 return qdev_device_help(opts);
1196 static int device_init_func(void *opaque, QemuOpts *opts, Error **errp)
1198 DeviceState *dev;
1200 dev = qdev_device_add(opts, errp);
1201 if (!dev && *errp) {
1202 error_report_err(*errp);
1203 return -1;
1204 } else if (dev) {
1205 object_unref(OBJECT(dev));
1207 return 0;
1210 static int chardev_init_func(void *opaque, QemuOpts *opts, Error **errp)
1212 Error *local_err = NULL;
1214 if (!qemu_chr_new_from_opts(opts, NULL, &local_err)) {
1215 if (local_err) {
1216 error_propagate(errp, local_err);
1217 return -1;
1219 exit(0);
1221 return 0;
1224 #ifdef CONFIG_VIRTFS
1225 static int fsdev_init_func(void *opaque, QemuOpts *opts, Error **errp)
1227 return qemu_fsdev_add(opts, errp);
1229 #endif
1231 static int mon_init_func(void *opaque, QemuOpts *opts, Error **errp)
1233 return monitor_init_opts(opts, errp);
1236 static void monitor_parse(const char *str, const char *mode, bool pretty)
1238 static int monitor_device_index = 0;
1239 QemuOpts *opts;
1240 const char *p;
1241 char label[32];
1243 if (strstart(str, "chardev:", &p)) {
1244 snprintf(label, sizeof(label), "%s", p);
1245 } else {
1246 snprintf(label, sizeof(label), "compat_monitor%d",
1247 monitor_device_index);
1248 opts = qemu_chr_parse_compat(label, str, true);
1249 if (!opts) {
1250 error_report("parse error: %s", str);
1251 exit(1);
1255 opts = qemu_opts_create(qemu_find_opts("mon"), label, 1, &error_fatal);
1256 qemu_opt_set(opts, "mode", mode, &error_abort);
1257 qemu_opt_set(opts, "chardev", label, &error_abort);
1258 if (!strcmp(mode, "control")) {
1259 qemu_opt_set_bool(opts, "pretty", pretty, &error_abort);
1260 } else {
1261 assert(pretty == false);
1263 monitor_device_index++;
1266 struct device_config {
1267 enum {
1268 DEV_USB, /* -usbdevice */
1269 DEV_SERIAL, /* -serial */
1270 DEV_PARALLEL, /* -parallel */
1271 DEV_DEBUGCON, /* -debugcon */
1272 DEV_GDB, /* -gdb, -s */
1273 DEV_SCLP, /* s390 sclp */
1274 } type;
1275 const char *cmdline;
1276 Location loc;
1277 QTAILQ_ENTRY(device_config) next;
1280 static QTAILQ_HEAD(, device_config) device_configs =
1281 QTAILQ_HEAD_INITIALIZER(device_configs);
1283 static void add_device_config(int type, const char *cmdline)
1285 struct device_config *conf;
1287 conf = g_malloc0(sizeof(*conf));
1288 conf->type = type;
1289 conf->cmdline = cmdline;
1290 loc_save(&conf->loc);
1291 QTAILQ_INSERT_TAIL(&device_configs, conf, next);
1294 static int foreach_device_config(int type, int (*func)(const char *cmdline))
1296 struct device_config *conf;
1297 int rc;
1299 QTAILQ_FOREACH(conf, &device_configs, next) {
1300 if (conf->type != type)
1301 continue;
1302 loc_push_restore(&conf->loc);
1303 rc = func(conf->cmdline);
1304 loc_pop(&conf->loc);
1305 if (rc) {
1306 return rc;
1309 return 0;
1312 static void qemu_disable_default_devices(void)
1314 MachineClass *machine_class = MACHINE_GET_CLASS(current_machine);
1316 default_driver_check_json();
1317 qemu_opts_foreach(qemu_find_opts("device"),
1318 default_driver_check, NULL, NULL);
1319 qemu_opts_foreach(qemu_find_opts("global"),
1320 default_driver_check, NULL, NULL);
1322 if (!vga_model && !default_vga) {
1323 vga_interface_type = VGA_DEVICE;
1324 vga_interface_created = true;
1326 if (!has_defaults || machine_class->no_serial) {
1327 default_serial = 0;
1329 if (!has_defaults || machine_class->no_parallel) {
1330 default_parallel = 0;
1332 if (!has_defaults || machine_class->no_floppy) {
1333 default_floppy = 0;
1335 if (!has_defaults || machine_class->no_cdrom) {
1336 default_cdrom = 0;
1338 if (!has_defaults || machine_class->no_sdcard) {
1339 default_sdcard = 0;
1341 if (!has_defaults) {
1342 default_audio = 0;
1343 default_monitor = 0;
1344 default_net = 0;
1345 default_vga = 0;
1346 } else {
1347 if (default_net && machine_class->default_nic &&
1348 !module_object_class_by_name(machine_class->default_nic)) {
1349 warn_report("Default NIC '%s' is not available in this binary",
1350 machine_class->default_nic);
1351 default_net = 0;
1356 static void qemu_setup_display(void)
1358 if (dpy.type == DISPLAY_TYPE_DEFAULT && !display_remote) {
1359 if (!qemu_display_find_default(&dpy)) {
1360 dpy.type = DISPLAY_TYPE_NONE;
1361 #if defined(CONFIG_VNC)
1362 vnc_parse("localhost:0,to=99,id=default");
1363 display_remote++;
1364 #endif
1367 if (dpy.type == DISPLAY_TYPE_DEFAULT) {
1368 dpy.type = DISPLAY_TYPE_NONE;
1371 qemu_display_early_init(&dpy);
1374 static void qemu_create_default_devices(void)
1376 MachineClass *machine_class = MACHINE_GET_CLASS(current_machine);
1377 const char *vc = qemu_display_get_vc(&dpy);
1379 if (is_daemonized()) {
1380 /* According to documentation and historically, -nographic redirects
1381 * serial port, parallel port and monitor to stdio, which does not work
1382 * with -daemonize. We can redirect these to null instead, but since
1383 * -nographic is legacy, let's just error out.
1384 * We disallow -nographic only if all other ports are not redirected
1385 * explicitly, to not break existing legacy setups which uses
1386 * -nographic _and_ redirects all ports explicitly - this is valid
1387 * usage, -nographic is just a no-op in this case.
1389 if (nographic
1390 && (default_parallel || default_serial || default_monitor)) {
1391 error_report("-nographic cannot be used with -daemonize");
1392 exit(1);
1396 if (nographic) {
1397 if (default_parallel) {
1398 add_device_config(DEV_PARALLEL, "null");
1400 if (default_serial && default_monitor) {
1401 add_device_config(DEV_SERIAL, "mon:stdio");
1402 } else {
1403 if (default_serial) {
1404 add_device_config(DEV_SERIAL, "stdio");
1406 if (default_monitor) {
1407 monitor_parse("stdio", "readline", false);
1410 } else {
1411 if (default_serial) {
1412 add_device_config(DEV_SERIAL, vc ?: "null");
1414 if (default_parallel) {
1415 add_device_config(DEV_PARALLEL, vc ?: "null");
1417 if (default_monitor && vc) {
1418 monitor_parse(vc, "readline", false);
1422 if (default_net) {
1423 QemuOptsList *net = qemu_find_opts("net");
1424 qemu_opts_parse(net, "nic", true, &error_abort);
1425 #ifdef CONFIG_SLIRP
1426 qemu_opts_parse(net, "user", true, &error_abort);
1427 #endif
1430 /* If no default VGA is requested, the default is "none". */
1431 if (default_vga) {
1432 vga_model = get_default_vga_model(machine_class);
1434 if (vga_model) {
1435 select_vgahw(machine_class, vga_model);
1439 static int serial_parse(const char *devname)
1441 int index = num_serial_hds;
1443 serial_hds = g_renew(Chardev *, serial_hds, index + 1);
1445 if (strcmp(devname, "none") == 0) {
1446 /* Don't allocate a serial device for this index */
1447 serial_hds[index] = NULL;
1448 } else {
1449 char label[32];
1450 snprintf(label, sizeof(label), "serial%d", index);
1452 serial_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
1453 if (!serial_hds[index]) {
1454 error_report("could not connect serial device"
1455 " to character backend '%s'", devname);
1456 return -1;
1459 num_serial_hds++;
1460 return 0;
1463 Chardev *serial_hd(int i)
1465 assert(i >= 0);
1466 if (i < num_serial_hds) {
1467 return serial_hds[i];
1469 return NULL;
1472 static int parallel_parse(const char *devname)
1474 static int index = 0;
1475 char label[32];
1477 if (strcmp(devname, "none") == 0)
1478 return 0;
1479 if (index == MAX_PARALLEL_PORTS) {
1480 error_report("too many parallel ports");
1481 exit(1);
1483 snprintf(label, sizeof(label), "parallel%d", index);
1484 parallel_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
1485 if (!parallel_hds[index]) {
1486 error_report("could not connect parallel device"
1487 " to character backend '%s'", devname);
1488 return -1;
1490 index++;
1491 return 0;
1494 static int debugcon_parse(const char *devname)
1496 QemuOpts *opts;
1498 if (!qemu_chr_new_mux_mon("debugcon", devname, NULL)) {
1499 error_report("invalid character backend '%s'", devname);
1500 exit(1);
1502 opts = qemu_opts_create(qemu_find_opts("device"), "debugcon", 1, NULL);
1503 if (!opts) {
1504 error_report("already have a debugcon device");
1505 exit(1);
1507 qemu_opt_set(opts, "driver", "isa-debugcon", &error_abort);
1508 qemu_opt_set(opts, "chardev", "debugcon", &error_abort);
1509 return 0;
1512 static gint machine_class_cmp(gconstpointer a, gconstpointer b)
1514 const MachineClass *mc1 = a, *mc2 = b;
1515 int res;
1517 if (mc1->family == NULL) {
1518 if (mc2->family == NULL) {
1519 /* Compare standalone machine types against each other; they sort
1520 * in increasing order.
1522 return strcmp(object_class_get_name(OBJECT_CLASS(mc1)),
1523 object_class_get_name(OBJECT_CLASS(mc2)));
1526 /* Standalone machine types sort after families. */
1527 return 1;
1530 if (mc2->family == NULL) {
1531 /* Families sort before standalone machine types. */
1532 return -1;
1535 /* Families sort between each other alphabetically increasingly. */
1536 res = strcmp(mc1->family, mc2->family);
1537 if (res != 0) {
1538 return res;
1541 /* Within the same family, machine types sort in decreasing order. */
1542 return strcmp(object_class_get_name(OBJECT_CLASS(mc2)),
1543 object_class_get_name(OBJECT_CLASS(mc1)));
1546 static void machine_help_func(const QDict *qdict)
1548 g_autoptr(GSList) machines = NULL;
1549 GSList *el;
1550 const char *type = qdict_get_try_str(qdict, "type");
1552 machines = object_class_get_list(TYPE_MACHINE, false);
1553 if (type) {
1554 ObjectClass *machine_class = OBJECT_CLASS(find_machine(type, machines));
1555 if (machine_class) {
1556 type_print_class_properties(object_class_get_name(machine_class));
1557 return;
1561 printf("Supported machines are:\n");
1562 machines = g_slist_sort(machines, machine_class_cmp);
1563 for (el = machines; el; el = el->next) {
1564 MachineClass *mc = el->data;
1565 if (mc->alias) {
1566 printf("%-20s %s (alias of %s)\n", mc->alias, mc->desc, mc->name);
1568 printf("%-20s %s%s%s\n", mc->name, mc->desc,
1569 mc->is_default ? " (default)" : "",
1570 mc->deprecation_reason ? " (deprecated)" : "");
1574 static void
1575 machine_merge_property(const char *propname, QDict *prop, Error **errp)
1577 QDict *opts;
1579 opts = qdict_new();
1580 /* Preserve the caller's reference to prop. */
1581 qobject_ref(prop);
1582 qdict_put(opts, propname, prop);
1583 keyval_merge(machine_opts_dict, opts, errp);
1584 qobject_unref(opts);
1587 static void
1588 machine_parse_property_opt(QemuOptsList *opts_list, const char *propname,
1589 const char *arg)
1591 QDict *prop = NULL;
1592 bool help = false;
1594 prop = keyval_parse(arg, opts_list->implied_opt_name, &help, &error_fatal);
1595 if (help) {
1596 qemu_opts_print_help(opts_list, true);
1597 exit(0);
1599 machine_merge_property(propname, prop, &error_fatal);
1600 qobject_unref(prop);
1603 static const char *pid_file;
1604 struct UnlinkPidfileNotifier {
1605 Notifier notifier;
1606 char *pid_file_realpath;
1608 static struct UnlinkPidfileNotifier qemu_unlink_pidfile_notifier;
1610 static void qemu_unlink_pidfile(Notifier *n, void *data)
1612 struct UnlinkPidfileNotifier *upn;
1614 upn = DO_UPCAST(struct UnlinkPidfileNotifier, notifier, n);
1615 unlink(upn->pid_file_realpath);
1618 static const QEMUOption *lookup_opt(int argc, char **argv,
1619 const char **poptarg, int *poptind)
1621 const QEMUOption *popt;
1622 int optind = *poptind;
1623 char *r = argv[optind];
1624 const char *optarg;
1626 loc_set_cmdline(argv, optind, 1);
1627 optind++;
1628 /* Treat --foo the same as -foo. */
1629 if (r[1] == '-')
1630 r++;
1631 popt = qemu_options;
1632 for(;;) {
1633 if (!popt->name) {
1634 error_report("invalid option");
1635 exit(1);
1637 if (!strcmp(popt->name, r + 1))
1638 break;
1639 popt++;
1641 if (popt->flags & HAS_ARG) {
1642 if (optind >= argc) {
1643 error_report("requires an argument");
1644 exit(1);
1646 optarg = argv[optind++];
1647 loc_set_cmdline(argv, optind - 2, 2);
1648 } else {
1649 optarg = NULL;
1652 *poptarg = optarg;
1653 *poptind = optind;
1655 return popt;
1658 static MachineClass *select_machine(QDict *qdict, Error **errp)
1660 const char *machine_type = qdict_get_try_str(qdict, "type");
1661 GSList *machines = object_class_get_list(TYPE_MACHINE, false);
1662 MachineClass *machine_class;
1663 Error *local_err = NULL;
1665 if (machine_type) {
1666 machine_class = find_machine(machine_type, machines);
1667 qdict_del(qdict, "type");
1668 if (!machine_class) {
1669 error_setg(&local_err, "unsupported machine type");
1671 } else {
1672 machine_class = find_default_machine(machines);
1673 if (!machine_class) {
1674 error_setg(&local_err, "No machine specified, and there is no default");
1678 g_slist_free(machines);
1679 if (local_err) {
1680 error_append_hint(&local_err, "Use -machine help to list supported machines\n");
1681 error_propagate(errp, local_err);
1683 return machine_class;
1686 static int object_parse_property_opt(Object *obj,
1687 const char *name, const char *value,
1688 const char *skip, Error **errp)
1690 if (g_str_equal(name, skip)) {
1691 return 0;
1694 if (!object_property_parse(obj, name, value, errp)) {
1695 return -1;
1698 return 0;
1701 /* *Non*recursively replace underscores with dashes in QDict keys. */
1702 static void keyval_dashify(QDict *qdict, Error **errp)
1704 const QDictEntry *ent, *next;
1705 char *p;
1707 for (ent = qdict_first(qdict); ent; ent = next) {
1708 g_autofree char *new_key = NULL;
1710 next = qdict_next(qdict, ent);
1711 if (!strchr(ent->key, '_')) {
1712 continue;
1714 new_key = g_strdup(ent->key);
1715 for (p = new_key; *p; p++) {
1716 if (*p == '_') {
1717 *p = '-';
1720 if (qdict_haskey(qdict, new_key)) {
1721 error_setg(errp, "Conflict between '%s' and '%s'", ent->key, new_key);
1722 return;
1724 qobject_ref(ent->value);
1725 qdict_put_obj(qdict, new_key, ent->value);
1726 qdict_del(qdict, ent->key);
1730 static void qemu_apply_legacy_machine_options(QDict *qdict)
1732 const char *value;
1733 QObject *prop;
1735 keyval_dashify(qdict, &error_fatal);
1737 /* Legacy options do not correspond to MachineState properties. */
1738 value = qdict_get_try_str(qdict, "accel");
1739 if (value) {
1740 accelerators = g_strdup(value);
1741 qdict_del(qdict, "accel");
1744 value = qdict_get_try_str(qdict, "igd-passthru");
1745 if (value) {
1746 object_register_sugar_prop(ACCEL_CLASS_NAME("xen"), "igd-passthru", value,
1747 false);
1748 qdict_del(qdict, "igd-passthru");
1751 value = qdict_get_try_str(qdict, "kvm-shadow-mem");
1752 if (value) {
1753 object_register_sugar_prop(ACCEL_CLASS_NAME("kvm"), "kvm-shadow-mem", value,
1754 false);
1755 qdict_del(qdict, "kvm-shadow-mem");
1758 value = qdict_get_try_str(qdict, "kernel-irqchip");
1759 if (value) {
1760 object_register_sugar_prop(ACCEL_CLASS_NAME("kvm"), "kernel-irqchip", value,
1761 false);
1762 object_register_sugar_prop(ACCEL_CLASS_NAME("whpx"), "kernel-irqchip", value,
1763 false);
1764 qdict_del(qdict, "kernel-irqchip");
1767 value = qdict_get_try_str(qdict, "memory-backend");
1768 if (value) {
1769 if (mem_path) {
1770 error_report("'-mem-path' can't be used together with"
1771 "'-machine memory-backend'");
1772 exit(EXIT_FAILURE);
1775 /* Resolved later. */
1776 ram_memdev_id = g_strdup(value);
1777 qdict_del(qdict, "memory-backend");
1780 prop = qdict_get(qdict, "memory");
1781 if (prop) {
1782 have_custom_ram_size =
1783 qobject_type(prop) == QTYPE_QDICT &&
1784 qdict_haskey(qobject_to(QDict, prop), "size");
1788 static void object_option_foreach_add(bool (*type_opt_predicate)(const char *))
1790 ObjectOption *opt, *next;
1792 QTAILQ_FOREACH_SAFE(opt, &object_opts, next, next) {
1793 const char *type = ObjectType_str(opt->opts->qom_type);
1794 if (type_opt_predicate(type)) {
1795 user_creatable_add_qapi(opt->opts, &error_fatal);
1796 qapi_free_ObjectOptions(opt->opts);
1797 QTAILQ_REMOVE(&object_opts, opt, next);
1798 g_free(opt);
1803 static void object_option_add_visitor(Visitor *v)
1805 ObjectOption *opt = g_new0(ObjectOption, 1);
1806 visit_type_ObjectOptions(v, NULL, &opt->opts, &error_fatal);
1807 QTAILQ_INSERT_TAIL(&object_opts, opt, next);
1810 static void object_option_parse(const char *str)
1812 QemuOpts *opts;
1813 const char *type;
1814 Visitor *v;
1816 if (str[0] == '{') {
1817 QObject *obj = qobject_from_json(str, &error_fatal);
1819 v = qobject_input_visitor_new(obj);
1820 qobject_unref(obj);
1821 } else {
1822 opts = qemu_opts_parse_noisily(qemu_find_opts("object"),
1823 str, true);
1824 if (!opts) {
1825 exit(1);
1828 type = qemu_opt_get(opts, "qom-type");
1829 if (!type) {
1830 error_setg(&error_fatal, QERR_MISSING_PARAMETER, "qom-type");
1832 if (user_creatable_print_help(type, opts)) {
1833 exit(0);
1836 v = opts_visitor_new(opts);
1839 object_option_add_visitor(v);
1840 visit_free(v);
1844 * Very early object creation, before the sandbox options have been activated.
1846 static bool object_create_pre_sandbox(const char *type)
1849 * Objects should in general not get initialized "too early" without
1850 * a reason. If you add one, state the reason in a comment!
1854 * Reason: -sandbox on,resourcecontrol=deny disallows setting CPU
1855 * affinity of threads.
1857 if (g_str_equal(type, "thread-context")) {
1858 return true;
1861 return false;
1865 * Initial object creation happens before all other
1866 * QEMU data types are created. The majority of objects
1867 * can be created at this point. The rng-egd object
1868 * cannot be created here, as it depends on the chardev
1869 * already existing.
1871 static bool object_create_early(const char *type)
1874 * Objects should not be made "delayed" without a reason. If you
1875 * add one, state the reason in a comment!
1878 /* Reason: already created. */
1879 if (object_create_pre_sandbox(type)) {
1880 return false;
1883 /* Reason: property "chardev" */
1884 if (g_str_equal(type, "rng-egd") ||
1885 g_str_equal(type, "qtest")) {
1886 return false;
1889 #if defined(CONFIG_VHOST_USER) && defined(CONFIG_LINUX)
1890 /* Reason: cryptodev-vhost-user property "chardev" */
1891 if (g_str_equal(type, "cryptodev-vhost-user")) {
1892 return false;
1894 #endif
1896 /* Reason: vhost-user-blk-server property "node-name" */
1897 if (g_str_equal(type, "vhost-user-blk-server")) {
1898 return false;
1901 * Reason: filter-* property "netdev" etc.
1903 if (g_str_equal(type, "filter-buffer") ||
1904 g_str_equal(type, "filter-dump") ||
1905 g_str_equal(type, "filter-mirror") ||
1906 g_str_equal(type, "filter-redirector") ||
1907 g_str_equal(type, "colo-compare") ||
1908 g_str_equal(type, "filter-rewriter") ||
1909 g_str_equal(type, "filter-replay")) {
1910 return false;
1914 * Allocation of large amounts of memory may delay
1915 * chardev initialization for too long, and trigger timeouts
1916 * on software that waits for a monitor socket to be created
1918 if (g_str_has_prefix(type, "memory-backend-")) {
1919 return false;
1922 return true;
1925 static void qemu_apply_machine_options(QDict *qdict)
1927 object_set_properties_from_keyval(OBJECT(current_machine), qdict, false, &error_fatal);
1929 if (semihosting_enabled(false) && !semihosting_get_argc()) {
1930 /* fall back to the -kernel/-append */
1931 semihosting_arg_fallback(current_machine->kernel_filename, current_machine->kernel_cmdline);
1934 if (current_machine->smp.cpus > 1) {
1935 replay_add_blocker("smp");
1939 static void qemu_create_early_backends(void)
1941 MachineClass *machine_class = MACHINE_GET_CLASS(current_machine);
1942 #if defined(CONFIG_SDL)
1943 const bool use_sdl = (dpy.type == DISPLAY_TYPE_SDL);
1944 #else
1945 const bool use_sdl = false;
1946 #endif
1947 #if defined(CONFIG_GTK)
1948 const bool use_gtk = (dpy.type == DISPLAY_TYPE_GTK);
1949 #else
1950 const bool use_gtk = false;
1951 #endif
1953 if (dpy.has_window_close && !use_gtk && !use_sdl) {
1954 error_report("window-close is only valid for GTK and SDL, "
1955 "ignoring option");
1958 qemu_console_early_init();
1960 if (dpy.has_gl && dpy.gl != DISPLAYGL_MODE_OFF && display_opengl == 0) {
1961 #if defined(CONFIG_OPENGL)
1962 error_report("OpenGL is not supported by the display");
1963 #else
1964 error_report("OpenGL support is disabled");
1965 #endif
1966 exit(1);
1969 object_option_foreach_add(object_create_early);
1971 /* spice needs the timers to be initialized by this point */
1972 /* spice must initialize before audio as it changes the default audiodev */
1973 /* spice must initialize before chardevs (for spicevmc and spiceport) */
1974 qemu_spice.init();
1976 qemu_opts_foreach(qemu_find_opts("chardev"),
1977 chardev_init_func, NULL, &error_fatal);
1979 #ifdef CONFIG_VIRTFS
1980 qemu_opts_foreach(qemu_find_opts("fsdev"),
1981 fsdev_init_func, NULL, &error_fatal);
1982 #endif
1985 * Note: we need to create audio and block backends before
1986 * setting machine properties, so they can be referred to.
1988 configure_blockdev(&bdo_queue, machine_class, snapshot);
1989 audio_init_audiodevs();
1990 if (default_audio) {
1991 audio_create_default_audiodevs();
1997 * The remainder of object creation happens after the
1998 * creation of chardev, fsdev, net clients and device data types.
2000 static bool object_create_late(const char *type)
2002 return !object_create_early(type) && !object_create_pre_sandbox(type);
2005 static void qemu_create_late_backends(void)
2007 if (qtest_chrdev) {
2008 qtest_server_init(qtest_chrdev, qtest_log, &error_fatal);
2011 net_init_clients();
2013 object_option_foreach_add(object_create_late);
2016 * Wait for any outstanding memory prealloc from created memory
2017 * backends to complete.
2019 if (!qemu_finish_async_prealloc_mem(&error_fatal)) {
2020 exit(1);
2023 if (tpm_init() < 0) {
2024 exit(1);
2027 qemu_opts_foreach(qemu_find_opts("mon"),
2028 mon_init_func, NULL, &error_fatal);
2030 if (foreach_device_config(DEV_SERIAL, serial_parse) < 0)
2031 exit(1);
2032 if (foreach_device_config(DEV_PARALLEL, parallel_parse) < 0)
2033 exit(1);
2034 if (foreach_device_config(DEV_DEBUGCON, debugcon_parse) < 0)
2035 exit(1);
2037 /* now chardevs have been created we may have semihosting to connect */
2038 qemu_semihosting_chardev_init();
2041 static void qemu_resolve_machine_memdev(void)
2043 if (ram_memdev_id) {
2044 Object *backend;
2045 ram_addr_t backend_size;
2047 backend = object_resolve_path_type(ram_memdev_id,
2048 TYPE_MEMORY_BACKEND, NULL);
2049 if (!backend) {
2050 error_report("Memory backend '%s' not found", ram_memdev_id);
2051 exit(EXIT_FAILURE);
2053 if (!have_custom_ram_size) {
2054 backend_size = object_property_get_uint(backend, "size", &error_abort);
2055 current_machine->ram_size = backend_size;
2057 object_property_set_link(OBJECT(current_machine),
2058 "memory-backend", backend, &error_fatal);
2062 static void parse_memory_options(void)
2064 QemuOpts *opts = qemu_find_opts_singleton("memory");
2065 QDict *dict, *prop;
2066 const char *mem_str;
2067 Location loc;
2069 loc_push_none(&loc);
2070 qemu_opts_loc_restore(opts);
2072 prop = qdict_new();
2074 if (qemu_opt_get_size(opts, "size", 0) != 0) {
2075 /* Fix up legacy suffix-less format */
2076 mem_str = qemu_opt_get(opts, "size");
2077 if (g_ascii_isdigit(mem_str[strlen(mem_str) - 1])) {
2078 g_autofree char *mib_str = g_strdup_printf("%sM", mem_str);
2079 qdict_put_str(prop, "size", mib_str);
2080 } else {
2081 qdict_put_str(prop, "size", mem_str);
2085 if (qemu_opt_get(opts, "maxmem")) {
2086 qdict_put_str(prop, "max-size", qemu_opt_get(opts, "maxmem"));
2088 if (qemu_opt_get(opts, "slots")) {
2089 qdict_put_str(prop, "slots", qemu_opt_get(opts, "slots"));
2092 dict = qdict_new();
2093 qdict_put(dict, "memory", prop);
2094 keyval_merge(machine_opts_dict, dict, &error_fatal);
2095 qobject_unref(dict);
2096 loc_pop(&loc);
2099 static void qemu_create_machine(QDict *qdict)
2101 MachineClass *machine_class = select_machine(qdict, &error_fatal);
2102 object_set_machine_compat_props(machine_class->compat_props);
2104 current_machine = MACHINE(object_new_with_class(OBJECT_CLASS(machine_class)));
2105 object_property_add_child(object_get_root(), "machine",
2106 OBJECT(current_machine));
2107 object_property_add_child(container_get(OBJECT(current_machine),
2108 "/unattached"),
2109 "sysbus", OBJECT(sysbus_get_default()));
2111 if (machine_class->minimum_page_bits) {
2112 if (!set_preferred_target_page_bits(machine_class->minimum_page_bits)) {
2113 /* This would be a board error: specifying a minimum smaller than
2114 * a target's compile-time fixed setting.
2116 g_assert_not_reached();
2120 cpu_exec_init_all();
2121 page_size_init();
2123 if (machine_class->hw_version) {
2124 qemu_set_hw_version(machine_class->hw_version);
2128 * Get the default machine options from the machine if it is not already
2129 * specified either by the configuration file or by the command line.
2131 if (machine_class->default_machine_opts) {
2132 QDict *default_opts =
2133 keyval_parse(machine_class->default_machine_opts, NULL, NULL,
2134 &error_abort);
2135 qemu_apply_legacy_machine_options(default_opts);
2136 object_set_properties_from_keyval(OBJECT(current_machine), default_opts,
2137 false, &error_abort);
2138 qobject_unref(default_opts);
2142 static int global_init_func(void *opaque, QemuOpts *opts, Error **errp)
2144 GlobalProperty *g;
2146 g = g_malloc0(sizeof(*g));
2147 g->driver = qemu_opt_get(opts, "driver");
2148 g->property = qemu_opt_get(opts, "property");
2149 g->value = qemu_opt_get(opts, "value");
2150 qdev_prop_register_global(g);
2151 return 0;
2155 * Return whether configuration group @group is stored in QemuOpts, or
2156 * recorded as one or more QDicts by qemu_record_config_group.
2158 static bool is_qemuopts_group(const char *group)
2160 if (g_str_equal(group, "object") ||
2161 g_str_equal(group, "audiodev") ||
2162 g_str_equal(group, "machine") ||
2163 g_str_equal(group, "smp-opts") ||
2164 g_str_equal(group, "boot-opts")) {
2165 return false;
2167 return true;
2170 static void qemu_record_config_group(const char *group, QDict *dict,
2171 bool from_json, Error **errp)
2173 if (g_str_equal(group, "object")) {
2174 Visitor *v = qobject_input_visitor_new_keyval(QOBJECT(dict));
2175 object_option_add_visitor(v);
2176 visit_free(v);
2178 } else if (g_str_equal(group, "audiodev")) {
2179 Audiodev *dev = NULL;
2180 Visitor *v = qobject_input_visitor_new_keyval(QOBJECT(dict));
2181 if (visit_type_Audiodev(v, NULL, &dev, errp)) {
2182 audio_define(dev);
2184 visit_free(v);
2186 } else if (g_str_equal(group, "machine")) {
2188 * Cannot merge string-valued and type-safe dictionaries, so JSON
2189 * is not accepted yet for -M.
2191 assert(!from_json);
2192 keyval_merge(machine_opts_dict, dict, errp);
2193 } else if (g_str_equal(group, "smp-opts")) {
2194 machine_merge_property("smp", dict, &error_fatal);
2195 } else if (g_str_equal(group, "boot-opts")) {
2196 machine_merge_property("boot", dict, &error_fatal);
2197 } else {
2198 abort();
2203 * Parse non-QemuOpts config file groups, pass the rest to
2204 * qemu_config_do_parse.
2206 static void qemu_parse_config_group(const char *group, QDict *qdict,
2207 void *opaque, Error **errp)
2209 QObject *crumpled;
2210 if (is_qemuopts_group(group)) {
2211 qemu_config_do_parse(group, qdict, opaque, errp);
2212 return;
2215 crumpled = qdict_crumple(qdict, errp);
2216 if (!crumpled) {
2217 return;
2219 switch (qobject_type(crumpled)) {
2220 case QTYPE_QDICT:
2221 qemu_record_config_group(group, qobject_to(QDict, crumpled), false, errp);
2222 break;
2223 case QTYPE_QLIST:
2224 error_setg(errp, "Lists cannot be at top level of a configuration section");
2225 break;
2226 default:
2227 g_assert_not_reached();
2229 qobject_unref(crumpled);
2232 static void qemu_read_default_config_file(Error **errp)
2234 ERRP_GUARD();
2235 int ret;
2236 g_autofree char *file = get_relocated_path(CONFIG_QEMU_CONFDIR "/qemu.conf");
2238 ret = qemu_read_config_file(file, qemu_parse_config_group, errp);
2239 if (ret < 0) {
2240 if (ret == -ENOENT) {
2241 error_free(*errp);
2242 *errp = NULL;
2247 static void qemu_set_option(const char *str, Error **errp)
2249 char group[64], id[64], arg[64];
2250 QemuOptsList *list;
2251 QemuOpts *opts;
2252 int rc, offset;
2254 rc = sscanf(str, "%63[^.].%63[^.].%63[^=]%n", group, id, arg, &offset);
2255 if (rc < 3 || str[offset] != '=') {
2256 error_setg(errp, "can't parse: \"%s\"", str);
2257 return;
2260 if (!is_qemuopts_group(group)) {
2261 error_setg(errp, "-set is not supported with %s", group);
2262 } else {
2263 list = qemu_find_opts_err(group, errp);
2264 if (list) {
2265 opts = qemu_opts_find(list, id);
2266 if (!opts) {
2267 error_setg(errp, "there is no %s \"%s\" defined", group, id);
2268 return;
2270 qemu_opt_set(opts, arg, str + offset + 1, errp);
2275 static void user_register_global_props(void)
2277 qemu_opts_foreach(qemu_find_opts("global"),
2278 global_init_func, NULL, NULL);
2281 static int do_configure_icount(void *opaque, QemuOpts *opts, Error **errp)
2283 return !icount_configure(opts, errp);
2286 static int accelerator_set_property(void *opaque,
2287 const char *name, const char *value,
2288 Error **errp)
2290 return object_parse_property_opt(opaque, name, value, "accel", errp);
2293 static int do_configure_accelerator(void *opaque, QemuOpts *opts, Error **errp)
2295 bool *p_init_failed = opaque;
2296 const char *acc = qemu_opt_get(opts, "accel");
2297 AccelClass *ac = accel_find(acc);
2298 AccelState *accel;
2299 int ret;
2300 bool qtest_with_kvm;
2302 if (!acc) {
2303 error_setg(errp, QERR_MISSING_PARAMETER, "accel");
2304 goto bad;
2307 qtest_with_kvm = g_str_equal(acc, "kvm") && qtest_chrdev != NULL;
2309 if (!ac) {
2310 if (!qtest_with_kvm) {
2311 error_report("invalid accelerator %s", acc);
2313 goto bad;
2315 accel = ACCEL(object_new_with_class(OBJECT_CLASS(ac)));
2316 object_apply_compat_props(OBJECT(accel));
2317 qemu_opt_foreach(opts, accelerator_set_property,
2318 accel,
2319 &error_fatal);
2321 ret = accel_init_machine(accel, current_machine);
2322 if (ret < 0) {
2323 if (!qtest_with_kvm || ret != -ENOENT) {
2324 error_report("failed to initialize %s: %s", acc, strerror(-ret));
2326 goto bad;
2329 return 1;
2331 bad:
2332 *p_init_failed = true;
2333 return 0;
2336 static void configure_accelerators(const char *progname)
2338 bool init_failed = false;
2340 qemu_opts_foreach(qemu_find_opts("icount"),
2341 do_configure_icount, NULL, &error_fatal);
2343 if (QTAILQ_EMPTY(&qemu_accel_opts.head)) {
2344 char **accel_list, **tmp;
2346 if (accelerators == NULL) {
2347 /* Select the default accelerator */
2348 bool have_tcg = accel_find("tcg");
2349 bool have_kvm = accel_find("kvm");
2351 if (have_tcg && have_kvm) {
2352 if (g_str_has_suffix(progname, "kvm")) {
2353 /* If the program name ends with "kvm", we prefer KVM */
2354 accelerators = "kvm:tcg";
2355 } else {
2356 accelerators = "tcg:kvm";
2358 } else if (have_kvm) {
2359 accelerators = "kvm";
2360 } else if (have_tcg) {
2361 accelerators = "tcg";
2362 } else {
2363 error_report("No accelerator selected and"
2364 " no default accelerator available");
2365 exit(1);
2368 accel_list = g_strsplit(accelerators, ":", 0);
2370 for (tmp = accel_list; *tmp; tmp++) {
2372 * Filter invalid accelerators here, to prevent obscenities
2373 * such as "-machine accel=tcg,,thread=single".
2375 if (accel_find(*tmp)) {
2376 qemu_opts_parse_noisily(qemu_find_opts("accel"), *tmp, true);
2377 } else {
2378 init_failed = true;
2379 error_report("invalid accelerator %s", *tmp);
2382 g_strfreev(accel_list);
2383 } else {
2384 if (accelerators != NULL) {
2385 error_report("The -accel and \"-machine accel=\" options are incompatible");
2386 exit(1);
2390 if (!qemu_opts_foreach(qemu_find_opts("accel"),
2391 do_configure_accelerator, &init_failed, &error_fatal)) {
2392 if (!init_failed) {
2393 error_report("no accelerator found");
2395 exit(1);
2398 if (init_failed && !qtest_chrdev) {
2399 error_report("falling back to %s", current_accel_name());
2402 if (icount_enabled() && !tcg_enabled()) {
2403 error_report("-icount is not allowed with hardware virtualization");
2404 exit(1);
2408 static void qemu_validate_options(const QDict *machine_opts)
2410 const char *kernel_filename = qdict_get_try_str(machine_opts, "kernel");
2411 const char *initrd_filename = qdict_get_try_str(machine_opts, "initrd");
2412 const char *kernel_cmdline = qdict_get_try_str(machine_opts, "append");
2414 if (kernel_filename == NULL) {
2415 if (kernel_cmdline != NULL) {
2416 error_report("-append only allowed with -kernel option");
2417 exit(1);
2420 if (initrd_filename != NULL) {
2421 error_report("-initrd only allowed with -kernel option");
2422 exit(1);
2426 if (loadvm && incoming) {
2427 error_report("'incoming' and 'loadvm' options are mutually exclusive");
2428 exit(EXIT_FAILURE);
2430 if (loadvm && preconfig_requested) {
2431 error_report("'preconfig' and 'loadvm' options are "
2432 "mutually exclusive");
2433 exit(EXIT_FAILURE);
2435 if (incoming && preconfig_requested && strcmp(incoming, "defer") != 0) {
2436 error_report("'preconfig' supports '-incoming defer' only");
2437 exit(EXIT_FAILURE);
2440 #ifdef CONFIG_CURSES
2441 if (is_daemonized() && dpy.type == DISPLAY_TYPE_CURSES) {
2442 error_report("curses display cannot be used with -daemonize");
2443 exit(1);
2445 #endif
2448 static void qemu_process_sugar_options(void)
2450 if (mem_prealloc) {
2451 QObject *smp = qdict_get(machine_opts_dict, "smp");
2452 if (smp && qobject_type(smp) == QTYPE_QDICT) {
2453 QObject *cpus = qdict_get(qobject_to(QDict, smp), "cpus");
2454 if (cpus && qobject_type(cpus) == QTYPE_QSTRING) {
2455 const char *val = qstring_get_str(qobject_to(QString, cpus));
2456 object_register_sugar_prop("memory-backend", "prealloc-threads",
2457 val, false);
2460 object_register_sugar_prop("memory-backend", "prealloc", "on", false);
2464 /* -action processing */
2467 * Process all the -action parameters parsed from cmdline.
2469 static int process_runstate_actions(void *opaque, QemuOpts *opts, Error **errp)
2471 Error *local_err = NULL;
2472 QDict *qdict = qemu_opts_to_qdict(opts, NULL);
2473 QObject *ret = NULL;
2474 qmp_marshal_set_action(qdict, &ret, &local_err);
2475 qobject_unref(ret);
2476 qobject_unref(qdict);
2477 if (local_err) {
2478 error_propagate(errp, local_err);
2479 return 1;
2481 return 0;
2484 static void qemu_process_early_options(void)
2486 qemu_opts_foreach(qemu_find_opts("name"),
2487 parse_name, NULL, &error_fatal);
2489 object_option_foreach_add(object_create_pre_sandbox);
2491 #ifdef CONFIG_SECCOMP
2492 QemuOptsList *olist = qemu_find_opts_err("sandbox", NULL);
2493 if (olist) {
2494 qemu_opts_foreach(olist, parse_sandbox, NULL, &error_fatal);
2496 #endif
2498 if (qemu_opts_foreach(qemu_find_opts("action"),
2499 process_runstate_actions, NULL, &error_fatal)) {
2500 exit(1);
2503 #ifndef _WIN32
2504 qemu_opts_foreach(qemu_find_opts("add-fd"),
2505 parse_add_fd, NULL, &error_fatal);
2507 qemu_opts_foreach(qemu_find_opts("add-fd"),
2508 cleanup_add_fd, NULL, &error_fatal);
2509 #endif
2511 /* Open the logfile at this point and set the log mask if necessary. */
2513 int mask = 0;
2514 if (log_mask) {
2515 mask = qemu_str_to_log_mask(log_mask);
2516 if (!mask) {
2517 qemu_print_log_usage(stdout);
2518 exit(1);
2521 qemu_set_log_filename_flags(log_file, mask, &error_fatal);
2524 qemu_add_default_firmwarepath();
2527 static void qemu_process_help_options(void)
2530 * Check for -cpu help and -device help before we call select_machine(),
2531 * which will return an error if the architecture has no default machine
2532 * type and the user did not specify one, so that the user doesn't need
2533 * to say '-cpu help -machine something'.
2535 if (cpu_option && is_help_option(cpu_option)) {
2536 list_cpus();
2537 exit(0);
2540 if (qemu_opts_foreach(qemu_find_opts("device"),
2541 device_help_func, NULL, NULL)) {
2542 exit(0);
2545 /* -L help lists the data directories and exits. */
2546 if (list_data_dirs) {
2547 qemu_list_data_dirs();
2548 exit(0);
2552 static void qemu_maybe_daemonize(const char *pid_file)
2554 Error *err = NULL;
2556 os_daemonize();
2557 rcu_disable_atfork();
2559 if (pid_file) {
2560 char *pid_file_realpath = NULL;
2562 if (!qemu_write_pidfile(pid_file, &err)) {
2563 error_reportf_err(err, "cannot create PID file: ");
2564 exit(1);
2567 pid_file_realpath = g_malloc0(PATH_MAX);
2568 if (!realpath(pid_file, pid_file_realpath)) {
2569 if (errno != ENOENT) {
2570 warn_report("not removing PID file on exit: cannot resolve PID "
2571 "file path: %s: %s", pid_file, strerror(errno));
2573 return;
2576 qemu_unlink_pidfile_notifier = (struct UnlinkPidfileNotifier) {
2577 .notifier = {
2578 .notify = qemu_unlink_pidfile,
2580 .pid_file_realpath = pid_file_realpath,
2582 qemu_add_exit_notifier(&qemu_unlink_pidfile_notifier.notifier);
2586 static void qemu_init_displays(void)
2588 DisplayState *ds;
2590 /* init local displays */
2591 ds = init_displaystate();
2592 qemu_display_init(ds, &dpy);
2594 /* must be after terminal init, SDL library changes signal handlers */
2595 os_setup_signal_handling();
2597 /* init remote displays */
2598 #ifdef CONFIG_VNC
2599 qemu_opts_foreach(qemu_find_opts("vnc"),
2600 vnc_init_func, NULL, &error_fatal);
2601 #endif
2603 if (using_spice) {
2604 qemu_spice.display_init();
2608 static void qemu_init_board(void)
2610 /* process plugin before CPUs are created, but once -smp has been parsed */
2611 qemu_plugin_load_list(&plugin_list, &error_fatal);
2613 /* From here on we enter MACHINE_PHASE_INITIALIZED. */
2614 machine_run_board_init(current_machine, mem_path, &error_fatal);
2616 drive_check_orphaned();
2618 realtime_init();
2621 static void qemu_create_cli_devices(void)
2623 DeviceOption *opt;
2625 soundhw_init();
2627 qemu_opts_foreach(qemu_find_opts("fw_cfg"),
2628 parse_fw_cfg, fw_cfg_find(), &error_fatal);
2630 /* init USB devices */
2631 if (machine_usb(current_machine)) {
2632 if (foreach_device_config(DEV_USB, usb_parse) < 0)
2633 exit(1);
2636 /* init generic devices */
2637 rom_set_order_override(FW_CFG_ORDER_OVERRIDE_DEVICE);
2638 qemu_opts_foreach(qemu_find_opts("device"),
2639 device_init_func, NULL, &error_fatal);
2640 QTAILQ_FOREACH(opt, &device_opts, next) {
2641 DeviceState *dev;
2642 loc_push_restore(&opt->loc);
2644 * TODO Eventually we should call qmp_device_add() here to make sure it
2645 * behaves the same, but QMP still has to accept incorrectly typed
2646 * options until libvirt is fixed and we want to be strict on the CLI
2647 * from the start, so call qdev_device_add_from_qdict() directly for
2648 * now.
2650 dev = qdev_device_add_from_qdict(opt->opts, true, &error_fatal);
2651 object_unref(OBJECT(dev));
2652 loc_pop(&opt->loc);
2654 rom_reset_order_override();
2657 static void qemu_machine_creation_done(void)
2659 MachineState *machine = MACHINE(qdev_get_machine());
2661 /* Did we create any drives that we failed to create a device for? */
2662 drive_check_orphaned();
2664 /* Don't warn about the default network setup that you get if
2665 * no command line -net or -netdev options are specified. There
2666 * are two cases that we would otherwise complain about:
2667 * (1) board doesn't support a NIC but the implicit "-net nic"
2668 * requested one
2669 * (2) CONFIG_SLIRP not set, in which case the implicit "-net nic"
2670 * sets up a nic that isn't connected to anything.
2672 if (!default_net && (!qtest_enabled() || has_defaults)) {
2673 net_check_clients();
2676 qdev_prop_check_globals();
2678 qdev_machine_creation_done();
2680 if (machine->cgs) {
2682 * Verify that Confidential Guest Support has actually been initialized
2684 assert(machine->cgs->ready);
2687 if (foreach_device_config(DEV_GDB, gdbserver_start) < 0) {
2688 exit(1);
2690 if (!vga_interface_created && !default_vga &&
2691 vga_interface_type != VGA_NONE) {
2692 warn_report("A -vga option was passed but this machine "
2693 "type does not use that option; "
2694 "No VGA device has been created");
2698 void qmp_x_exit_preconfig(Error **errp)
2700 if (phase_check(PHASE_MACHINE_INITIALIZED)) {
2701 error_setg(errp, "The command is permitted only before machine initialization");
2702 return;
2705 qemu_init_board();
2706 qemu_create_cli_devices();
2707 qemu_machine_creation_done();
2709 if (loadvm) {
2710 RunState state = autostart ? RUN_STATE_RUNNING : runstate_get();
2711 load_snapshot(loadvm, NULL, false, NULL, &error_fatal);
2712 load_snapshot_resume(state);
2714 if (replay_mode != REPLAY_MODE_NONE) {
2715 replay_vmstate_init();
2718 if (incoming) {
2719 Error *local_err = NULL;
2720 if (strcmp(incoming, "defer") != 0) {
2721 qmp_migrate_incoming(incoming, false, NULL, &local_err);
2722 if (local_err) {
2723 error_reportf_err(local_err, "-incoming %s: ", incoming);
2724 exit(1);
2727 } else if (autostart) {
2728 qmp_cont(NULL);
2732 void qemu_init(int argc, char **argv)
2734 QemuOpts *opts;
2735 QemuOpts *icount_opts = NULL, *accel_opts = NULL;
2736 QemuOptsList *olist;
2737 int optind;
2738 const char *optarg;
2739 MachineClass *machine_class;
2740 bool userconfig = true;
2741 FILE *vmstate_dump_file = NULL;
2743 qemu_add_opts(&qemu_drive_opts);
2744 qemu_add_drive_opts(&qemu_legacy_drive_opts);
2745 qemu_add_drive_opts(&qemu_common_drive_opts);
2746 qemu_add_drive_opts(&qemu_drive_opts);
2747 qemu_add_drive_opts(&bdrv_runtime_opts);
2748 qemu_add_opts(&qemu_chardev_opts);
2749 qemu_add_opts(&qemu_device_opts);
2750 qemu_add_opts(&qemu_netdev_opts);
2751 qemu_add_opts(&qemu_nic_opts);
2752 qemu_add_opts(&qemu_net_opts);
2753 qemu_add_opts(&qemu_rtc_opts);
2754 qemu_add_opts(&qemu_global_opts);
2755 qemu_add_opts(&qemu_mon_opts);
2756 qemu_add_opts(&qemu_trace_opts);
2757 qemu_plugin_add_opts();
2758 qemu_add_opts(&qemu_option_rom_opts);
2759 qemu_add_opts(&qemu_accel_opts);
2760 qemu_add_opts(&qemu_mem_opts);
2761 qemu_add_opts(&qemu_smp_opts);
2762 qemu_add_opts(&qemu_boot_opts);
2763 qemu_add_opts(&qemu_add_fd_opts);
2764 qemu_add_opts(&qemu_object_opts);
2765 qemu_add_opts(&qemu_tpmdev_opts);
2766 qemu_add_opts(&qemu_overcommit_opts);
2767 qemu_add_opts(&qemu_msg_opts);
2768 qemu_add_opts(&qemu_name_opts);
2769 qemu_add_opts(&qemu_numa_opts);
2770 qemu_add_opts(&qemu_icount_opts);
2771 qemu_add_opts(&qemu_semihosting_config_opts);
2772 qemu_add_opts(&qemu_fw_cfg_opts);
2773 qemu_add_opts(&qemu_action_opts);
2774 qemu_add_run_with_opts();
2775 module_call_init(MODULE_INIT_OPTS);
2777 error_init(argv[0]);
2778 qemu_init_exec_dir(argv[0]);
2780 os_setup_limits();
2782 qemu_init_arch_modules();
2784 qemu_init_subsystems();
2786 /* first pass of option parsing */
2787 optind = 1;
2788 while (optind < argc) {
2789 if (argv[optind][0] != '-') {
2790 /* disk image */
2791 optind++;
2792 } else {
2793 const QEMUOption *popt;
2795 popt = lookup_opt(argc, argv, &optarg, &optind);
2796 switch (popt->index) {
2797 case QEMU_OPTION_nouserconfig:
2798 userconfig = false;
2799 break;
2804 machine_opts_dict = qdict_new();
2805 if (userconfig) {
2806 qemu_read_default_config_file(&error_fatal);
2809 /* second pass of option parsing */
2810 optind = 1;
2811 for(;;) {
2812 if (optind >= argc)
2813 break;
2814 if (argv[optind][0] != '-') {
2815 loc_set_cmdline(argv, optind, 1);
2816 drive_add(IF_DEFAULT, 0, argv[optind++], HD_OPTS);
2817 } else {
2818 const QEMUOption *popt;
2820 popt = lookup_opt(argc, argv, &optarg, &optind);
2821 if (!(popt->arch_mask & arch_type)) {
2822 error_report("Option not supported for this target");
2823 exit(1);
2825 switch(popt->index) {
2826 case QEMU_OPTION_cpu:
2827 /* hw initialization will check this */
2828 cpu_option = optarg;
2829 break;
2830 case QEMU_OPTION_hda:
2831 case QEMU_OPTION_hdb:
2832 case QEMU_OPTION_hdc:
2833 case QEMU_OPTION_hdd:
2834 drive_add(IF_DEFAULT, popt->index - QEMU_OPTION_hda, optarg,
2835 HD_OPTS);
2836 break;
2837 case QEMU_OPTION_blockdev:
2839 Visitor *v;
2840 BlockdevOptionsQueueEntry *bdo;
2842 v = qobject_input_visitor_new_str(optarg, "driver",
2843 &error_fatal);
2845 bdo = g_new(BlockdevOptionsQueueEntry, 1);
2846 visit_type_BlockdevOptions(v, NULL, &bdo->bdo,
2847 &error_fatal);
2848 visit_free(v);
2849 loc_save(&bdo->loc);
2850 QSIMPLEQ_INSERT_TAIL(&bdo_queue, bdo, entry);
2851 break;
2853 case QEMU_OPTION_drive:
2854 opts = qemu_opts_parse_noisily(qemu_find_opts("drive"),
2855 optarg, false);
2856 if (opts == NULL) {
2857 exit(1);
2859 break;
2860 case QEMU_OPTION_set:
2861 qemu_set_option(optarg, &error_fatal);
2862 break;
2863 case QEMU_OPTION_global:
2864 if (qemu_global_option(optarg) != 0)
2865 exit(1);
2866 break;
2867 case QEMU_OPTION_mtdblock:
2868 drive_add(IF_MTD, -1, optarg, MTD_OPTS);
2869 break;
2870 case QEMU_OPTION_sd:
2871 drive_add(IF_SD, -1, optarg, SD_OPTS);
2872 break;
2873 case QEMU_OPTION_pflash:
2874 drive_add(IF_PFLASH, -1, optarg, PFLASH_OPTS);
2875 break;
2876 case QEMU_OPTION_snapshot:
2877 snapshot = 1;
2878 replay_add_blocker("-snapshot");
2879 break;
2880 case QEMU_OPTION_numa:
2881 opts = qemu_opts_parse_noisily(qemu_find_opts("numa"),
2882 optarg, true);
2883 if (!opts) {
2884 exit(1);
2886 break;
2887 case QEMU_OPTION_display:
2888 parse_display(optarg);
2889 break;
2890 case QEMU_OPTION_nographic:
2891 qdict_put_str(machine_opts_dict, "graphics", "off");
2892 nographic = true;
2893 dpy.type = DISPLAY_TYPE_NONE;
2894 break;
2895 case QEMU_OPTION_portrait:
2896 graphic_rotate = 90;
2897 break;
2898 case QEMU_OPTION_rotate:
2899 graphic_rotate = strtol(optarg, (char **) &optarg, 10);
2900 if (graphic_rotate != 0 && graphic_rotate != 90 &&
2901 graphic_rotate != 180 && graphic_rotate != 270) {
2902 error_report("only 90, 180, 270 deg rotation is available");
2903 exit(1);
2905 break;
2906 case QEMU_OPTION_kernel:
2907 qdict_put_str(machine_opts_dict, "kernel", optarg);
2908 break;
2909 case QEMU_OPTION_initrd:
2910 qdict_put_str(machine_opts_dict, "initrd", optarg);
2911 break;
2912 case QEMU_OPTION_append:
2913 qdict_put_str(machine_opts_dict, "append", optarg);
2914 break;
2915 case QEMU_OPTION_dtb:
2916 qdict_put_str(machine_opts_dict, "dtb", optarg);
2917 break;
2918 case QEMU_OPTION_cdrom:
2919 drive_add(IF_DEFAULT, 2, optarg, CDROM_OPTS);
2920 break;
2921 case QEMU_OPTION_boot:
2922 machine_parse_property_opt(qemu_find_opts("boot-opts"), "boot", optarg);
2923 break;
2924 case QEMU_OPTION_fda:
2925 case QEMU_OPTION_fdb:
2926 drive_add(IF_FLOPPY, popt->index - QEMU_OPTION_fda,
2927 optarg, FD_OPTS);
2928 break;
2929 case QEMU_OPTION_no_fd_bootchk:
2930 fd_bootchk = 0;
2931 break;
2932 case QEMU_OPTION_netdev:
2933 default_net = 0;
2934 if (netdev_is_modern(optarg)) {
2935 netdev_parse_modern(optarg);
2936 } else {
2937 net_client_parse(qemu_find_opts("netdev"), optarg);
2939 break;
2940 case QEMU_OPTION_nic:
2941 default_net = 0;
2942 net_client_parse(qemu_find_opts("nic"), optarg);
2943 break;
2944 case QEMU_OPTION_net:
2945 default_net = 0;
2946 net_client_parse(qemu_find_opts("net"), optarg);
2947 break;
2948 #ifdef CONFIG_LIBISCSI
2949 case QEMU_OPTION_iscsi:
2950 opts = qemu_opts_parse_noisily(qemu_find_opts("iscsi"),
2951 optarg, false);
2952 if (!opts) {
2953 exit(1);
2955 break;
2956 #endif
2957 case QEMU_OPTION_audiodev:
2958 default_audio = 0;
2959 audio_parse_option(optarg);
2960 break;
2961 case QEMU_OPTION_audio: {
2962 bool help;
2963 char *model = NULL;
2964 Audiodev *dev = NULL;
2965 Visitor *v;
2966 QDict *dict = keyval_parse(optarg, "driver", &help, &error_fatal);
2967 default_audio = 0;
2968 if (help || (qdict_haskey(dict, "driver") &&
2969 is_help_option(qdict_get_str(dict, "driver")))) {
2970 audio_help();
2971 exit(EXIT_SUCCESS);
2973 if (!qdict_haskey(dict, "id")) {
2974 qdict_put_str(dict, "id", "audiodev0");
2976 if (qdict_haskey(dict, "model")) {
2977 model = g_strdup(qdict_get_str(dict, "model"));
2978 qdict_del(dict, "model");
2979 if (is_help_option(model)) {
2980 show_valid_soundhw();
2981 exit(0);
2984 v = qobject_input_visitor_new_keyval(QOBJECT(dict));
2985 qobject_unref(dict);
2986 visit_type_Audiodev(v, NULL, &dev, &error_fatal);
2987 visit_free(v);
2988 if (model) {
2989 audio_define(dev);
2990 select_soundhw(model, dev->id);
2991 g_free(model);
2992 } else {
2993 audio_define_default(dev, &error_fatal);
2995 break;
2997 case QEMU_OPTION_h:
2998 help(0);
2999 break;
3000 case QEMU_OPTION_version:
3001 version();
3002 exit(0);
3003 break;
3004 case QEMU_OPTION_m:
3005 opts = qemu_opts_parse_noisily(qemu_find_opts("memory"), optarg, true);
3006 if (opts == NULL) {
3007 exit(1);
3009 break;
3010 #ifdef CONFIG_TPM
3011 case QEMU_OPTION_tpmdev:
3012 if (tpm_config_parse(qemu_find_opts("tpmdev"), optarg) < 0) {
3013 exit(1);
3015 break;
3016 #endif
3017 case QEMU_OPTION_mempath:
3018 mem_path = optarg;
3019 break;
3020 case QEMU_OPTION_mem_prealloc:
3021 mem_prealloc = 1;
3022 break;
3023 case QEMU_OPTION_d:
3024 log_mask = optarg;
3025 break;
3026 case QEMU_OPTION_D:
3027 log_file = optarg;
3028 break;
3029 case QEMU_OPTION_DFILTER:
3030 qemu_set_dfilter_ranges(optarg, &error_fatal);
3031 break;
3032 #if defined(CONFIG_TCG) && defined(CONFIG_LINUX)
3033 case QEMU_OPTION_perfmap:
3034 perf_enable_perfmap();
3035 break;
3036 case QEMU_OPTION_jitdump:
3037 perf_enable_jitdump();
3038 break;
3039 #endif
3040 case QEMU_OPTION_seed:
3041 qemu_guest_random_seed_main(optarg, &error_fatal);
3042 break;
3043 case QEMU_OPTION_s:
3044 add_device_config(DEV_GDB, "tcp::" DEFAULT_GDBSTUB_PORT);
3045 break;
3046 case QEMU_OPTION_gdb:
3047 add_device_config(DEV_GDB, optarg);
3048 break;
3049 case QEMU_OPTION_L:
3050 if (is_help_option(optarg)) {
3051 list_data_dirs = true;
3052 } else {
3053 qemu_add_data_dir(g_strdup(optarg));
3055 break;
3056 case QEMU_OPTION_bios:
3057 qdict_put_str(machine_opts_dict, "firmware", optarg);
3058 break;
3059 case QEMU_OPTION_S:
3060 autostart = 0;
3061 break;
3062 case QEMU_OPTION_k:
3063 keyboard_layout = optarg;
3064 break;
3065 case QEMU_OPTION_vga:
3066 vga_model = optarg;
3067 default_vga = 0;
3068 break;
3069 case QEMU_OPTION_g:
3071 const char *p;
3072 int w, h, depth;
3073 p = optarg;
3074 w = strtol(p, (char **)&p, 10);
3075 if (w <= 0) {
3076 graphic_error:
3077 error_report("invalid resolution or depth");
3078 exit(1);
3080 if (*p != 'x')
3081 goto graphic_error;
3082 p++;
3083 h = strtol(p, (char **)&p, 10);
3084 if (h <= 0)
3085 goto graphic_error;
3086 if (*p == 'x') {
3087 p++;
3088 depth = strtol(p, (char **)&p, 10);
3089 if (depth != 1 && depth != 2 && depth != 4 &&
3090 depth != 8 && depth != 15 && depth != 16 &&
3091 depth != 24 && depth != 32)
3092 goto graphic_error;
3093 } else if (*p == '\0') {
3094 depth = graphic_depth;
3095 } else {
3096 goto graphic_error;
3099 graphic_width = w;
3100 graphic_height = h;
3101 graphic_depth = depth;
3103 break;
3104 case QEMU_OPTION_echr:
3106 char *r;
3107 term_escape_char = strtol(optarg, &r, 0);
3108 if (r == optarg)
3109 printf("Bad argument to echr\n");
3110 break;
3112 case QEMU_OPTION_monitor:
3113 default_monitor = 0;
3114 if (strncmp(optarg, "none", 4)) {
3115 monitor_parse(optarg, "readline", false);
3117 break;
3118 case QEMU_OPTION_qmp:
3119 monitor_parse(optarg, "control", false);
3120 default_monitor = 0;
3121 break;
3122 case QEMU_OPTION_qmp_pretty:
3123 monitor_parse(optarg, "control", true);
3124 default_monitor = 0;
3125 break;
3126 case QEMU_OPTION_mon:
3127 opts = qemu_opts_parse_noisily(qemu_find_opts("mon"), optarg,
3128 true);
3129 if (!opts) {
3130 exit(1);
3132 default_monitor = 0;
3133 break;
3134 case QEMU_OPTION_chardev:
3135 opts = qemu_opts_parse_noisily(qemu_find_opts("chardev"),
3136 optarg, true);
3137 if (!opts) {
3138 exit(1);
3140 break;
3141 case QEMU_OPTION_fsdev:
3142 olist = qemu_find_opts("fsdev");
3143 if (!olist) {
3144 error_report("fsdev support is disabled");
3145 exit(1);
3147 opts = qemu_opts_parse_noisily(olist, optarg, true);
3148 if (!opts) {
3149 exit(1);
3151 break;
3152 case QEMU_OPTION_virtfs: {
3153 QemuOpts *fsdev;
3154 QemuOpts *device;
3155 const char *writeout, *sock_fd, *socket, *path, *security_model,
3156 *multidevs;
3158 olist = qemu_find_opts("virtfs");
3159 if (!olist) {
3160 error_report("virtfs support is disabled");
3161 exit(1);
3163 opts = qemu_opts_parse_noisily(olist, optarg, true);
3164 if (!opts) {
3165 exit(1);
3168 if (qemu_opt_get(opts, "fsdriver") == NULL ||
3169 qemu_opt_get(opts, "mount_tag") == NULL) {
3170 error_report("Usage: -virtfs fsdriver,mount_tag=tag");
3171 exit(1);
3173 fsdev = qemu_opts_create(qemu_find_opts("fsdev"),
3174 qemu_opts_id(opts) ?:
3175 qemu_opt_get(opts, "mount_tag"),
3176 1, NULL);
3177 if (!fsdev) {
3178 error_report("duplicate or invalid fsdev id: %s",
3179 qemu_opt_get(opts, "mount_tag"));
3180 exit(1);
3183 writeout = qemu_opt_get(opts, "writeout");
3184 if (writeout) {
3185 #ifdef CONFIG_SYNC_FILE_RANGE
3186 qemu_opt_set(fsdev, "writeout", writeout, &error_abort);
3187 #else
3188 error_report("writeout=immediate not supported "
3189 "on this platform");
3190 exit(1);
3191 #endif
3193 qemu_opt_set(fsdev, "fsdriver",
3194 qemu_opt_get(opts, "fsdriver"), &error_abort);
3195 path = qemu_opt_get(opts, "path");
3196 if (path) {
3197 qemu_opt_set(fsdev, "path", path, &error_abort);
3199 security_model = qemu_opt_get(opts, "security_model");
3200 if (security_model) {
3201 qemu_opt_set(fsdev, "security_model", security_model,
3202 &error_abort);
3204 socket = qemu_opt_get(opts, "socket");
3205 if (socket) {
3206 qemu_opt_set(fsdev, "socket", socket, &error_abort);
3208 sock_fd = qemu_opt_get(opts, "sock_fd");
3209 if (sock_fd) {
3210 qemu_opt_set(fsdev, "sock_fd", sock_fd, &error_abort);
3213 qemu_opt_set_bool(fsdev, "readonly",
3214 qemu_opt_get_bool(opts, "readonly", 0),
3215 &error_abort);
3216 multidevs = qemu_opt_get(opts, "multidevs");
3217 if (multidevs) {
3218 qemu_opt_set(fsdev, "multidevs", multidevs, &error_abort);
3220 device = qemu_opts_create(qemu_find_opts("device"), NULL, 0,
3221 &error_abort);
3222 qemu_opt_set(device, "driver", "virtio-9p-pci", &error_abort);
3223 qemu_opt_set(device, "fsdev",
3224 qemu_opts_id(fsdev), &error_abort);
3225 qemu_opt_set(device, "mount_tag",
3226 qemu_opt_get(opts, "mount_tag"), &error_abort);
3227 break;
3229 case QEMU_OPTION_serial:
3230 add_device_config(DEV_SERIAL, optarg);
3231 default_serial = 0;
3232 if (strncmp(optarg, "mon:", 4) == 0) {
3233 default_monitor = 0;
3235 break;
3236 case QEMU_OPTION_action:
3237 olist = qemu_find_opts("action");
3238 if (!qemu_opts_parse_noisily(olist, optarg, false)) {
3239 exit(1);
3241 break;
3242 case QEMU_OPTION_watchdog_action: {
3243 opts = qemu_opts_create(qemu_find_opts("action"), NULL, 0, &error_abort);
3244 qemu_opt_set(opts, "watchdog", optarg, &error_abort);
3245 break;
3247 case QEMU_OPTION_parallel:
3248 add_device_config(DEV_PARALLEL, optarg);
3249 default_parallel = 0;
3250 if (strncmp(optarg, "mon:", 4) == 0) {
3251 default_monitor = 0;
3253 break;
3254 case QEMU_OPTION_debugcon:
3255 add_device_config(DEV_DEBUGCON, optarg);
3256 break;
3257 case QEMU_OPTION_loadvm:
3258 loadvm = optarg;
3259 break;
3260 case QEMU_OPTION_full_screen:
3261 dpy.has_full_screen = true;
3262 dpy.full_screen = true;
3263 break;
3264 case QEMU_OPTION_pidfile:
3265 pid_file = optarg;
3266 break;
3267 case QEMU_OPTION_win2k_hack:
3268 win2k_install_hack = 1;
3269 break;
3270 case QEMU_OPTION_acpitable:
3271 opts = qemu_opts_parse_noisily(qemu_find_opts("acpi"),
3272 optarg, true);
3273 if (!opts) {
3274 exit(1);
3276 acpi_table_add(opts, &error_fatal);
3277 break;
3278 case QEMU_OPTION_smbios:
3279 opts = qemu_opts_parse_noisily(qemu_find_opts("smbios"),
3280 optarg, false);
3281 if (!opts) {
3282 exit(1);
3284 smbios_entry_add(opts, &error_fatal);
3285 break;
3286 case QEMU_OPTION_fwcfg:
3287 opts = qemu_opts_parse_noisily(qemu_find_opts("fw_cfg"),
3288 optarg, true);
3289 if (opts == NULL) {
3290 exit(1);
3292 break;
3293 case QEMU_OPTION_preconfig:
3294 preconfig_requested = true;
3295 break;
3296 case QEMU_OPTION_enable_kvm:
3297 qdict_put_str(machine_opts_dict, "accel", "kvm");
3298 break;
3299 case QEMU_OPTION_M:
3300 case QEMU_OPTION_machine:
3302 bool help;
3304 keyval_parse_into(machine_opts_dict, optarg, "type", &help, &error_fatal);
3305 if (help) {
3306 machine_help_func(machine_opts_dict);
3307 exit(EXIT_SUCCESS);
3309 break;
3311 case QEMU_OPTION_accel:
3312 accel_opts = qemu_opts_parse_noisily(qemu_find_opts("accel"),
3313 optarg, true);
3314 optarg = qemu_opt_get(accel_opts, "accel");
3315 if (!optarg || is_help_option(optarg)) {
3316 printf("Accelerators supported in QEMU binary:\n");
3317 GSList *el, *accel_list = object_class_get_list(TYPE_ACCEL,
3318 false);
3319 for (el = accel_list; el; el = el->next) {
3320 gchar *typename = g_strdup(object_class_get_name(
3321 OBJECT_CLASS(el->data)));
3322 /* omit qtest which is used for tests only */
3323 if (g_strcmp0(typename, ACCEL_CLASS_NAME("qtest")) &&
3324 g_str_has_suffix(typename, ACCEL_CLASS_SUFFIX)) {
3325 gchar **optname = g_strsplit(typename,
3326 ACCEL_CLASS_SUFFIX, 0);
3327 printf("%s\n", optname[0]);
3328 g_strfreev(optname);
3330 g_free(typename);
3332 g_slist_free(accel_list);
3333 exit(0);
3335 break;
3336 case QEMU_OPTION_usb:
3337 qdict_put_str(machine_opts_dict, "usb", "on");
3338 break;
3339 case QEMU_OPTION_usbdevice:
3340 qdict_put_str(machine_opts_dict, "usb", "on");
3341 add_device_config(DEV_USB, optarg);
3342 break;
3343 case QEMU_OPTION_device:
3344 if (optarg[0] == '{') {
3345 QObject *obj = qobject_from_json(optarg, &error_fatal);
3346 DeviceOption *opt = g_new0(DeviceOption, 1);
3347 opt->opts = qobject_to(QDict, obj);
3348 loc_save(&opt->loc);
3349 assert(opt->opts != NULL);
3350 QTAILQ_INSERT_TAIL(&device_opts, opt, next);
3351 } else {
3352 if (!qemu_opts_parse_noisily(qemu_find_opts("device"),
3353 optarg, true)) {
3354 exit(1);
3357 break;
3358 case QEMU_OPTION_smp:
3359 machine_parse_property_opt(qemu_find_opts("smp-opts"),
3360 "smp", optarg);
3361 break;
3362 #ifdef CONFIG_VNC
3363 case QEMU_OPTION_vnc:
3364 vnc_parse(optarg);
3365 display_remote++;
3366 break;
3367 #endif
3368 case QEMU_OPTION_no_reboot:
3369 olist = qemu_find_opts("action");
3370 qemu_opts_parse_noisily(olist, "reboot=shutdown", false);
3371 break;
3372 case QEMU_OPTION_no_shutdown:
3373 olist = qemu_find_opts("action");
3374 qemu_opts_parse_noisily(olist, "shutdown=pause", false);
3375 break;
3376 case QEMU_OPTION_uuid:
3377 if (qemu_uuid_parse(optarg, &qemu_uuid) < 0) {
3378 error_report("failed to parse UUID string: wrong format");
3379 exit(1);
3381 qemu_uuid_set = true;
3382 break;
3383 case QEMU_OPTION_option_rom:
3384 if (nb_option_roms >= MAX_OPTION_ROMS) {
3385 error_report("too many option ROMs");
3386 exit(1);
3388 opts = qemu_opts_parse_noisily(qemu_find_opts("option-rom"),
3389 optarg, true);
3390 if (!opts) {
3391 exit(1);
3393 option_rom[nb_option_roms].name = qemu_opt_get(opts, "romfile");
3394 option_rom[nb_option_roms].bootindex =
3395 qemu_opt_get_number(opts, "bootindex", -1);
3396 if (!option_rom[nb_option_roms].name) {
3397 error_report("Option ROM file is not specified");
3398 exit(1);
3400 nb_option_roms++;
3401 break;
3402 case QEMU_OPTION_semihosting:
3403 qemu_semihosting_enable();
3404 break;
3405 case QEMU_OPTION_semihosting_config:
3406 if (qemu_semihosting_config_options(optarg) != 0) {
3407 exit(1);
3409 break;
3410 case QEMU_OPTION_name:
3411 opts = qemu_opts_parse_noisily(qemu_find_opts("name"),
3412 optarg, true);
3413 if (!opts) {
3414 exit(1);
3416 /* Capture guest name if -msg guest-name is used later */
3417 error_guest_name = qemu_opt_get(opts, "guest");
3418 break;
3419 case QEMU_OPTION_prom_env:
3420 if (nb_prom_envs >= MAX_PROM_ENVS) {
3421 error_report("too many prom variables");
3422 exit(1);
3424 prom_envs[nb_prom_envs] = optarg;
3425 nb_prom_envs++;
3426 break;
3427 case QEMU_OPTION_old_param:
3428 old_param = 1;
3429 break;
3430 case QEMU_OPTION_rtc:
3431 opts = qemu_opts_parse_noisily(qemu_find_opts("rtc"), optarg,
3432 false);
3433 if (!opts) {
3434 exit(1);
3436 break;
3437 case QEMU_OPTION_icount:
3438 icount_opts = qemu_opts_parse_noisily(qemu_find_opts("icount"),
3439 optarg, true);
3440 if (!icount_opts) {
3441 exit(1);
3443 break;
3444 case QEMU_OPTION_incoming:
3445 if (!incoming) {
3446 runstate_set(RUN_STATE_INMIGRATE);
3448 incoming = optarg;
3449 break;
3450 case QEMU_OPTION_only_migratable:
3451 only_migratable = 1;
3452 break;
3453 case QEMU_OPTION_nodefaults:
3454 has_defaults = 0;
3455 break;
3456 case QEMU_OPTION_xen_domid:
3457 if (!(accel_find("xen")) && !(accel_find("kvm"))) {
3458 error_report("Option not supported for this target");
3459 exit(1);
3461 xen_domid = atoi(optarg);
3462 break;
3463 case QEMU_OPTION_xen_attach:
3464 if (!(accel_find("xen"))) {
3465 error_report("Option not supported for this target");
3466 exit(1);
3468 xen_mode = XEN_ATTACH;
3469 break;
3470 case QEMU_OPTION_xen_domid_restrict:
3471 if (!(accel_find("xen"))) {
3472 error_report("Option not supported for this target");
3473 exit(1);
3475 xen_domid_restrict = true;
3476 break;
3477 case QEMU_OPTION_trace:
3478 trace_opt_parse(optarg);
3479 break;
3480 case QEMU_OPTION_plugin:
3481 qemu_plugin_opt_parse(optarg, &plugin_list);
3482 break;
3483 case QEMU_OPTION_readconfig:
3484 qemu_read_config_file(optarg, qemu_parse_config_group, &error_fatal);
3485 break;
3486 #ifdef CONFIG_SPICE
3487 case QEMU_OPTION_spice:
3488 opts = qemu_opts_parse_noisily(qemu_find_opts("spice"), optarg, false);
3489 if (!opts) {
3490 exit(1);
3492 display_remote++;
3493 break;
3494 #endif
3495 case QEMU_OPTION_qtest:
3496 qtest_chrdev = optarg;
3497 break;
3498 case QEMU_OPTION_qtest_log:
3499 qtest_log = optarg;
3500 break;
3501 case QEMU_OPTION_sandbox:
3502 olist = qemu_find_opts("sandbox");
3503 if (!olist) {
3504 #ifndef CONFIG_SECCOMP
3505 error_report("-sandbox support is not enabled "
3506 "in this QEMU binary");
3507 #endif
3508 exit(1);
3511 opts = qemu_opts_parse_noisily(olist, optarg, true);
3512 if (!opts) {
3513 exit(1);
3515 break;
3516 case QEMU_OPTION_add_fd:
3517 #ifndef _WIN32
3518 opts = qemu_opts_parse_noisily(qemu_find_opts("add-fd"),
3519 optarg, false);
3520 if (!opts) {
3521 exit(1);
3523 #else
3524 error_report("File descriptor passing is disabled on this "
3525 "platform");
3526 exit(1);
3527 #endif
3528 break;
3529 case QEMU_OPTION_object:
3530 object_option_parse(optarg);
3531 break;
3532 case QEMU_OPTION_overcommit:
3533 opts = qemu_opts_parse_noisily(qemu_find_opts("overcommit"),
3534 optarg, false);
3535 if (!opts) {
3536 exit(1);
3538 enable_mlock = qemu_opt_get_bool(opts, "mem-lock", false);
3539 enable_cpu_pm = qemu_opt_get_bool(opts, "cpu-pm", false);
3540 break;
3541 case QEMU_OPTION_compat:
3543 CompatPolicy *opts_policy;
3544 Visitor *v;
3546 v = qobject_input_visitor_new_str(optarg, NULL,
3547 &error_fatal);
3549 visit_type_CompatPolicy(v, NULL, &opts_policy, &error_fatal);
3550 QAPI_CLONE_MEMBERS(CompatPolicy, &compat_policy, opts_policy);
3552 qapi_free_CompatPolicy(opts_policy);
3553 visit_free(v);
3554 break;
3556 case QEMU_OPTION_msg:
3557 opts = qemu_opts_parse_noisily(qemu_find_opts("msg"), optarg,
3558 false);
3559 if (!opts) {
3560 exit(1);
3562 configure_msg(opts);
3563 break;
3564 case QEMU_OPTION_dump_vmstate:
3565 if (vmstate_dump_file) {
3566 error_report("only one '-dump-vmstate' "
3567 "option may be given");
3568 exit(1);
3570 vmstate_dump_file = fopen(optarg, "w");
3571 if (vmstate_dump_file == NULL) {
3572 error_report("open %s: %s", optarg, strerror(errno));
3573 exit(1);
3575 break;
3576 case QEMU_OPTION_enable_sync_profile:
3577 qsp_enable();
3578 break;
3579 case QEMU_OPTION_nouserconfig:
3580 /* Nothing to be parsed here. Especially, do not error out below. */
3581 break;
3582 #if defined(CONFIG_POSIX)
3583 case QEMU_OPTION_runas:
3584 if (!os_set_runas(optarg)) {
3585 error_report("User \"%s\" doesn't exist"
3586 " (and is not <uid>:<gid>)",
3587 optarg);
3588 exit(1);
3590 break;
3591 case QEMU_OPTION_daemonize:
3592 os_set_daemonize(true);
3593 break;
3594 case QEMU_OPTION_run_with: {
3595 const char *str;
3596 opts = qemu_opts_parse_noisily(qemu_find_opts("run-with"),
3597 optarg, false);
3598 if (!opts) {
3599 exit(1);
3601 #if defined(CONFIG_LINUX)
3602 if (qemu_opt_get_bool(opts, "async-teardown", false)) {
3603 init_async_teardown();
3605 #endif
3606 str = qemu_opt_get(opts, "chroot");
3607 if (str) {
3608 os_set_chroot(str);
3610 break;
3612 #endif /* CONFIG_POSIX */
3614 default:
3615 error_report("Option not supported in this build");
3616 exit(1);
3621 * Clear error location left behind by the loop.
3622 * Best done right after the loop. Do not insert code here!
3624 loc_set_none();
3626 qemu_validate_options(machine_opts_dict);
3627 qemu_process_sugar_options();
3630 * These options affect everything else and should be processed
3631 * before daemonizing.
3633 qemu_process_early_options();
3635 qemu_process_help_options();
3636 qemu_maybe_daemonize(pid_file);
3639 * The trace backend must be initialized after daemonizing.
3640 * trace_init_backends() will call st_init(), which will create the
3641 * trace thread in the parent, and also register st_flush_trace_buffer()
3642 * in atexit(). This function will force the parent to wait for the
3643 * writeout thread to finish, which will not occur, and the parent
3644 * process will be left in the host.
3646 if (!trace_init_backends()) {
3647 exit(1);
3649 trace_init_file();
3651 qemu_init_main_loop(&error_fatal);
3652 cpu_timers_init();
3654 user_register_global_props();
3655 replay_configure(icount_opts);
3657 configure_rtc(qemu_find_opts_singleton("rtc"));
3659 /* Transfer QemuOpts options into machine options */
3660 parse_memory_options();
3662 qemu_create_machine(machine_opts_dict);
3664 suspend_mux_open();
3666 qemu_disable_default_devices();
3667 qemu_setup_display();
3668 qemu_create_default_devices();
3669 qemu_create_early_backends();
3671 qemu_apply_legacy_machine_options(machine_opts_dict);
3672 qemu_apply_machine_options(machine_opts_dict);
3673 qobject_unref(machine_opts_dict);
3674 phase_advance(PHASE_MACHINE_CREATED);
3677 * Note: uses machine properties such as kernel-irqchip, must run
3678 * after qemu_apply_machine_options.
3680 configure_accelerators(argv[0]);
3681 phase_advance(PHASE_ACCEL_CREATED);
3684 * Beware, QOM objects created before this point miss global and
3685 * compat properties.
3687 * Global properties get set up by qdev_prop_register_global(),
3688 * called from user_register_global_props(), and certain option
3689 * desugaring. Also in CPU feature desugaring (buried in
3690 * parse_cpu_option()), which happens below this point, but may
3691 * only target the CPU type, which can only be created after
3692 * parse_cpu_option() returned the type.
3694 * Machine compat properties: object_set_machine_compat_props().
3695 * Accelerator compat props: object_set_accelerator_compat_props(),
3696 * called from do_configure_accelerator().
3699 machine_class = MACHINE_GET_CLASS(current_machine);
3700 if (!qtest_enabled() && machine_class->deprecation_reason) {
3701 warn_report("Machine type '%s' is deprecated: %s",
3702 machine_class->name, machine_class->deprecation_reason);
3706 * Create backends before creating migration objects, so that it can
3707 * check against compatibilities on the backend memories (e.g. postcopy
3708 * over memory-backend-file objects).
3710 qemu_create_late_backends();
3711 phase_advance(PHASE_LATE_BACKENDS_CREATED);
3714 * Note: creates a QOM object, must run only after global and
3715 * compat properties have been set up.
3717 migration_object_init();
3719 /* parse features once if machine provides default cpu_type */
3720 current_machine->cpu_type = machine_class_default_cpu_type(machine_class);
3721 if (cpu_option) {
3722 current_machine->cpu_type = parse_cpu_option(cpu_option);
3724 /* NB: for machine none cpu_type could STILL be NULL here! */
3726 qemu_resolve_machine_memdev();
3727 parse_numa_opts(current_machine);
3729 if (vmstate_dump_file) {
3730 /* dump and exit */
3731 module_load_qom_all();
3732 dump_vmstate_json_to_file(vmstate_dump_file);
3733 exit(0);
3736 if (!preconfig_requested) {
3737 qmp_x_exit_preconfig(&error_fatal);
3739 qemu_init_displays();
3740 accel_setup_post(current_machine);
3741 os_setup_post();
3742 resume_mux_open();