qapi/audio: add documentation for AudioFormat
[qemu/ar7.git] / softmmu / vl.c
blobff2685dff8450b0100ec1b6a5cd2fa7682f2d2c9
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-common.h"
27 #include "qemu/units.h"
28 #include "hw/boards.h"
29 #include "hw/qdev-properties.h"
30 #include "qapi/error.h"
31 #include "qemu-version.h"
32 #include "qemu/cutils.h"
33 #include "qemu/help_option.h"
34 #include "qemu/uuid.h"
35 #include "sysemu/reset.h"
36 #include "sysemu/runstate.h"
37 #include "sysemu/seccomp.h"
38 #include "sysemu/tcg.h"
40 #include "qemu/error-report.h"
41 #include "qemu/sockets.h"
42 #include "sysemu/accel.h"
43 #include "hw/usb.h"
44 #include "hw/isa/isa.h"
45 #include "hw/scsi/scsi.h"
46 #include "hw/display/vga.h"
47 #include "sysemu/watchdog.h"
48 #include "hw/firmware/smbios.h"
49 #include "hw/acpi/acpi.h"
50 #include "hw/xen/xen.h"
51 #include "hw/loader.h"
52 #include "monitor/qdev.h"
53 #include "net/net.h"
54 #include "net/slirp.h"
55 #include "monitor/monitor.h"
56 #include "ui/console.h"
57 #include "ui/input.h"
58 #include "sysemu/sysemu.h"
59 #include "sysemu/numa.h"
60 #include "sysemu/hostmem.h"
61 #include "exec/gdbstub.h"
62 #include "qemu/timer.h"
63 #include "chardev/char.h"
64 #include "qemu/bitmap.h"
65 #include "qemu/log.h"
66 #include "sysemu/blockdev.h"
67 #include "hw/block/block.h"
68 #include "migration/misc.h"
69 #include "migration/snapshot.h"
70 #include "migration/global_state.h"
71 #include "sysemu/tpm.h"
72 #include "sysemu/dma.h"
73 #include "hw/audio/soundhw.h"
74 #include "audio/audio.h"
75 #include "sysemu/cpus.h"
76 #include "migration/colo.h"
77 #include "migration/postcopy-ram.h"
78 #include "sysemu/kvm.h"
79 #include "sysemu/hax.h"
80 #include "qapi/qobject-input-visitor.h"
81 #include "qemu/option.h"
82 #include "qemu/config-file.h"
83 #include "qemu-options.h"
84 #include "qemu/main-loop.h"
85 #ifdef CONFIG_VIRTFS
86 #include "fsdev/qemu-fsdev.h"
87 #endif
88 #include "sysemu/qtest.h"
90 #include "disas/disas.h"
92 #include "trace-root.h"
93 #include "trace/control.h"
94 #include "qemu/plugin.h"
95 #include "qemu/queue.h"
96 #include "sysemu/arch_init.h"
98 #include "ui/qemu-spice.h"
99 #include "qapi/string-input-visitor.h"
100 #include "qapi/opts-visitor.h"
101 #include "qapi/clone-visitor.h"
102 #include "qom/object_interfaces.h"
103 #include "hw/semihosting/semihost.h"
104 #include "crypto/init.h"
105 #include "sysemu/replay.h"
106 #include "qapi/qapi-events-run-state.h"
107 #include "qapi/qapi-visit-block-core.h"
108 #include "qapi/qapi-visit-ui.h"
109 #include "qapi/qapi-commands-block-core.h"
110 #include "qapi/qapi-commands-run-state.h"
111 #include "qapi/qapi-commands-ui.h"
112 #include "qapi/qmp/qerror.h"
113 #include "sysemu/iothread.h"
114 #include "qemu/guest-random.h"
116 #define MAX_VIRTIO_CONSOLES 1
118 static const char *data_dir[16];
119 static int data_dir_idx;
120 const char *bios_name = NULL;
121 enum vga_retrace_method vga_retrace_method = VGA_RETRACE_DUMB;
122 int display_opengl;
123 const char* keyboard_layout = NULL;
124 ram_addr_t ram_size;
125 bool enable_mlock = false;
126 bool enable_cpu_pm = false;
127 int nb_nics;
128 NICInfo nd_table[MAX_NICS];
129 int autostart;
130 static enum {
131 RTC_BASE_UTC,
132 RTC_BASE_LOCALTIME,
133 RTC_BASE_DATETIME,
134 } rtc_base_type = RTC_BASE_UTC;
135 static time_t rtc_ref_start_datetime;
136 static int rtc_realtime_clock_offset; /* used only with QEMU_CLOCK_REALTIME */
137 static int rtc_host_datetime_offset = -1; /* valid & used only with
138 RTC_BASE_DATETIME */
139 QEMUClockType rtc_clock;
140 int vga_interface_type = VGA_NONE;
141 static DisplayOptions dpy;
142 static int num_serial_hds;
143 static Chardev **serial_hds;
144 Chardev *parallel_hds[MAX_PARALLEL_PORTS];
145 int win2k_install_hack = 0;
146 int singlestep = 0;
147 int acpi_enabled = 1;
148 int no_hpet = 0;
149 int fd_bootchk = 1;
150 static int no_reboot;
151 int no_shutdown = 0;
152 int graphic_rotate = 0;
153 const char *watchdog;
154 QEMUOptionRom option_rom[MAX_OPTION_ROMS];
155 int nb_option_roms;
156 int old_param = 0;
157 const char *qemu_name;
158 int alt_grab = 0;
159 int ctrl_grab = 0;
160 unsigned int nb_prom_envs = 0;
161 const char *prom_envs[MAX_PROM_ENVS];
162 int boot_menu;
163 bool boot_strict;
164 uint8_t *boot_splash_filedata;
165 int only_migratable; /* turn it off unless user states otherwise */
166 bool wakeup_suspend_enabled;
168 int icount_align_option;
170 /* The bytes in qemu_uuid are in the order specified by RFC4122, _not_ in the
171 * little-endian "wire format" described in the SMBIOS 2.6 specification.
173 QemuUUID qemu_uuid;
174 bool qemu_uuid_set;
176 static NotifierList exit_notifiers =
177 NOTIFIER_LIST_INITIALIZER(exit_notifiers);
179 static NotifierList machine_init_done_notifiers =
180 NOTIFIER_LIST_INITIALIZER(machine_init_done_notifiers);
182 bool xen_allowed;
183 uint32_t xen_domid;
184 enum xen_mode xen_mode = XEN_EMULATE;
185 bool xen_domid_restrict;
187 static int has_defaults = 1;
188 static int default_serial = 1;
189 static int default_parallel = 1;
190 static int default_monitor = 1;
191 static int default_floppy = 1;
192 static int default_cdrom = 1;
193 static int default_sdcard = 1;
194 static int default_vga = 1;
195 static int default_net = 1;
197 static struct {
198 const char *driver;
199 int *flag;
200 } default_list[] = {
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 = "ide-drive", .flag = &default_cdrom },
208 { .driver = "scsi-cd", .flag = &default_cdrom },
209 { .driver = "scsi-hd", .flag = &default_cdrom },
210 { .driver = "VGA", .flag = &default_vga },
211 { .driver = "isa-vga", .flag = &default_vga },
212 { .driver = "cirrus-vga", .flag = &default_vga },
213 { .driver = "isa-cirrus-vga", .flag = &default_vga },
214 { .driver = "vmware-svga", .flag = &default_vga },
215 { .driver = "qxl-vga", .flag = &default_vga },
216 { .driver = "virtio-vga", .flag = &default_vga },
217 { .driver = "ati-vga", .flag = &default_vga },
218 { .driver = "vhost-user-vga", .flag = &default_vga },
221 static QemuOptsList qemu_rtc_opts = {
222 .name = "rtc",
223 .head = QTAILQ_HEAD_INITIALIZER(qemu_rtc_opts.head),
224 .merge_lists = true,
225 .desc = {
227 .name = "base",
228 .type = QEMU_OPT_STRING,
230 .name = "clock",
231 .type = QEMU_OPT_STRING,
233 .name = "driftfix",
234 .type = QEMU_OPT_STRING,
236 { /* end of list */ }
240 static QemuOptsList qemu_option_rom_opts = {
241 .name = "option-rom",
242 .implied_opt_name = "romfile",
243 .head = QTAILQ_HEAD_INITIALIZER(qemu_option_rom_opts.head),
244 .desc = {
246 .name = "bootindex",
247 .type = QEMU_OPT_NUMBER,
248 }, {
249 .name = "romfile",
250 .type = QEMU_OPT_STRING,
252 { /* end of list */ }
256 static QemuOptsList qemu_machine_opts = {
257 .name = "machine",
258 .implied_opt_name = "type",
259 .merge_lists = true,
260 .head = QTAILQ_HEAD_INITIALIZER(qemu_machine_opts.head),
261 .desc = {
263 * no elements => accept any
264 * sanity checking will happen later
265 * when setting machine properties
271 static QemuOptsList qemu_accel_opts = {
272 .name = "accel",
273 .implied_opt_name = "accel",
274 .head = QTAILQ_HEAD_INITIALIZER(qemu_accel_opts.head),
275 .desc = {
277 * no elements => accept any
278 * sanity checking will happen later
279 * when setting accelerator properties
285 static QemuOptsList qemu_boot_opts = {
286 .name = "boot-opts",
287 .implied_opt_name = "order",
288 .merge_lists = true,
289 .head = QTAILQ_HEAD_INITIALIZER(qemu_boot_opts.head),
290 .desc = {
292 .name = "order",
293 .type = QEMU_OPT_STRING,
294 }, {
295 .name = "once",
296 .type = QEMU_OPT_STRING,
297 }, {
298 .name = "menu",
299 .type = QEMU_OPT_BOOL,
300 }, {
301 .name = "splash",
302 .type = QEMU_OPT_STRING,
303 }, {
304 .name = "splash-time",
305 .type = QEMU_OPT_NUMBER,
306 }, {
307 .name = "reboot-timeout",
308 .type = QEMU_OPT_NUMBER,
309 }, {
310 .name = "strict",
311 .type = QEMU_OPT_BOOL,
313 { /*End of list */ }
317 static QemuOptsList qemu_add_fd_opts = {
318 .name = "add-fd",
319 .head = QTAILQ_HEAD_INITIALIZER(qemu_add_fd_opts.head),
320 .desc = {
322 .name = "fd",
323 .type = QEMU_OPT_NUMBER,
324 .help = "file descriptor of which a duplicate is added to fd set",
326 .name = "set",
327 .type = QEMU_OPT_NUMBER,
328 .help = "ID of the fd set to add fd to",
330 .name = "opaque",
331 .type = QEMU_OPT_STRING,
332 .help = "free-form string used to describe fd",
334 { /* end of list */ }
338 static QemuOptsList qemu_object_opts = {
339 .name = "object",
340 .implied_opt_name = "qom-type",
341 .head = QTAILQ_HEAD_INITIALIZER(qemu_object_opts.head),
342 .desc = {
347 static QemuOptsList qemu_tpmdev_opts = {
348 .name = "tpmdev",
349 .implied_opt_name = "type",
350 .head = QTAILQ_HEAD_INITIALIZER(qemu_tpmdev_opts.head),
351 .desc = {
352 /* options are defined in the TPM backends */
353 { /* end of list */ }
357 static QemuOptsList qemu_realtime_opts = {
358 .name = "realtime",
359 .head = QTAILQ_HEAD_INITIALIZER(qemu_realtime_opts.head),
360 .desc = {
362 .name = "mlock",
363 .type = QEMU_OPT_BOOL,
365 { /* end of list */ }
369 static QemuOptsList qemu_overcommit_opts = {
370 .name = "overcommit",
371 .head = QTAILQ_HEAD_INITIALIZER(qemu_overcommit_opts.head),
372 .desc = {
374 .name = "mem-lock",
375 .type = QEMU_OPT_BOOL,
378 .name = "cpu-pm",
379 .type = QEMU_OPT_BOOL,
381 { /* end of list */ }
385 static QemuOptsList qemu_msg_opts = {
386 .name = "msg",
387 .head = QTAILQ_HEAD_INITIALIZER(qemu_msg_opts.head),
388 .desc = {
390 .name = "timestamp",
391 .type = QEMU_OPT_BOOL,
393 { /* end of list */ }
397 static QemuOptsList qemu_name_opts = {
398 .name = "name",
399 .implied_opt_name = "guest",
400 .merge_lists = true,
401 .head = QTAILQ_HEAD_INITIALIZER(qemu_name_opts.head),
402 .desc = {
404 .name = "guest",
405 .type = QEMU_OPT_STRING,
406 .help = "Sets the name of the guest.\n"
407 "This name will be displayed in the SDL window caption.\n"
408 "The name will also be used for the VNC server",
409 }, {
410 .name = "process",
411 .type = QEMU_OPT_STRING,
412 .help = "Sets the name of the QEMU process, as shown in top etc",
413 }, {
414 .name = "debug-threads",
415 .type = QEMU_OPT_BOOL,
416 .help = "When enabled, name the individual threads; defaults off.\n"
417 "NOTE: The thread names are for debugging and not a\n"
418 "stable API.",
420 { /* End of list */ }
424 static QemuOptsList qemu_mem_opts = {
425 .name = "memory",
426 .implied_opt_name = "size",
427 .head = QTAILQ_HEAD_INITIALIZER(qemu_mem_opts.head),
428 .merge_lists = true,
429 .desc = {
431 .name = "size",
432 .type = QEMU_OPT_SIZE,
435 .name = "slots",
436 .type = QEMU_OPT_NUMBER,
439 .name = "maxmem",
440 .type = QEMU_OPT_SIZE,
442 { /* end of list */ }
446 static QemuOptsList qemu_icount_opts = {
447 .name = "icount",
448 .implied_opt_name = "shift",
449 .merge_lists = true,
450 .head = QTAILQ_HEAD_INITIALIZER(qemu_icount_opts.head),
451 .desc = {
453 .name = "shift",
454 .type = QEMU_OPT_STRING,
455 }, {
456 .name = "align",
457 .type = QEMU_OPT_BOOL,
458 }, {
459 .name = "sleep",
460 .type = QEMU_OPT_BOOL,
461 }, {
462 .name = "rr",
463 .type = QEMU_OPT_STRING,
464 }, {
465 .name = "rrfile",
466 .type = QEMU_OPT_STRING,
467 }, {
468 .name = "rrsnapshot",
469 .type = QEMU_OPT_STRING,
471 { /* end of list */ }
475 static QemuOptsList qemu_fw_cfg_opts = {
476 .name = "fw_cfg",
477 .implied_opt_name = "name",
478 .head = QTAILQ_HEAD_INITIALIZER(qemu_fw_cfg_opts.head),
479 .desc = {
481 .name = "name",
482 .type = QEMU_OPT_STRING,
483 .help = "Sets the fw_cfg name of the blob to be inserted",
484 }, {
485 .name = "file",
486 .type = QEMU_OPT_STRING,
487 .help = "Sets the name of the file from which "
488 "the fw_cfg blob will be loaded",
489 }, {
490 .name = "string",
491 .type = QEMU_OPT_STRING,
492 .help = "Sets content of the blob to be inserted from a string",
494 { /* end of list */ }
499 * Get machine options
501 * Returns: machine options (never null).
503 QemuOpts *qemu_get_machine_opts(void)
505 return qemu_find_opts_singleton("machine");
508 const char *qemu_get_vm_name(void)
510 return qemu_name;
513 static void res_free(void)
515 g_free(boot_splash_filedata);
516 boot_splash_filedata = NULL;
519 static int default_driver_check(void *opaque, QemuOpts *opts, Error **errp)
521 const char *driver = qemu_opt_get(opts, "driver");
522 int i;
524 if (!driver)
525 return 0;
526 for (i = 0; i < ARRAY_SIZE(default_list); i++) {
527 if (strcmp(default_list[i].driver, driver) != 0)
528 continue;
529 *(default_list[i].flag) = 0;
531 return 0;
534 /***********************************************************/
535 /* QEMU state */
537 static RunState current_run_state = RUN_STATE_PRECONFIG;
539 /* We use RUN_STATE__MAX but any invalid value will do */
540 static RunState vmstop_requested = RUN_STATE__MAX;
541 static QemuMutex vmstop_lock;
543 typedef struct {
544 RunState from;
545 RunState to;
546 } RunStateTransition;
548 static const RunStateTransition runstate_transitions_def[] = {
549 /* from -> to */
550 { RUN_STATE_PRECONFIG, RUN_STATE_PRELAUNCH },
551 /* Early switch to inmigrate state to allow -incoming CLI option work
552 * as it used to. TODO: delay actual switching to inmigrate state to
553 * the point after machine is built and remove this hack.
555 { RUN_STATE_PRECONFIG, RUN_STATE_INMIGRATE },
557 { RUN_STATE_DEBUG, RUN_STATE_RUNNING },
558 { RUN_STATE_DEBUG, RUN_STATE_FINISH_MIGRATE },
559 { RUN_STATE_DEBUG, RUN_STATE_PRELAUNCH },
561 { RUN_STATE_INMIGRATE, RUN_STATE_INTERNAL_ERROR },
562 { RUN_STATE_INMIGRATE, RUN_STATE_IO_ERROR },
563 { RUN_STATE_INMIGRATE, RUN_STATE_PAUSED },
564 { RUN_STATE_INMIGRATE, RUN_STATE_RUNNING },
565 { RUN_STATE_INMIGRATE, RUN_STATE_SHUTDOWN },
566 { RUN_STATE_INMIGRATE, RUN_STATE_SUSPENDED },
567 { RUN_STATE_INMIGRATE, RUN_STATE_WATCHDOG },
568 { RUN_STATE_INMIGRATE, RUN_STATE_GUEST_PANICKED },
569 { RUN_STATE_INMIGRATE, RUN_STATE_FINISH_MIGRATE },
570 { RUN_STATE_INMIGRATE, RUN_STATE_PRELAUNCH },
571 { RUN_STATE_INMIGRATE, RUN_STATE_POSTMIGRATE },
572 { RUN_STATE_INMIGRATE, RUN_STATE_COLO },
574 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PAUSED },
575 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_FINISH_MIGRATE },
576 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PRELAUNCH },
578 { RUN_STATE_IO_ERROR, RUN_STATE_RUNNING },
579 { RUN_STATE_IO_ERROR, RUN_STATE_FINISH_MIGRATE },
580 { RUN_STATE_IO_ERROR, RUN_STATE_PRELAUNCH },
582 { RUN_STATE_PAUSED, RUN_STATE_RUNNING },
583 { RUN_STATE_PAUSED, RUN_STATE_FINISH_MIGRATE },
584 { RUN_STATE_PAUSED, RUN_STATE_POSTMIGRATE },
585 { RUN_STATE_PAUSED, RUN_STATE_PRELAUNCH },
586 { RUN_STATE_PAUSED, RUN_STATE_COLO},
588 { RUN_STATE_POSTMIGRATE, RUN_STATE_RUNNING },
589 { RUN_STATE_POSTMIGRATE, RUN_STATE_FINISH_MIGRATE },
590 { RUN_STATE_POSTMIGRATE, RUN_STATE_PRELAUNCH },
592 { RUN_STATE_PRELAUNCH, RUN_STATE_RUNNING },
593 { RUN_STATE_PRELAUNCH, RUN_STATE_FINISH_MIGRATE },
594 { RUN_STATE_PRELAUNCH, RUN_STATE_INMIGRATE },
596 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_RUNNING },
597 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PAUSED },
598 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_POSTMIGRATE },
599 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PRELAUNCH },
600 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_COLO},
602 { RUN_STATE_RESTORE_VM, RUN_STATE_RUNNING },
603 { RUN_STATE_RESTORE_VM, RUN_STATE_PRELAUNCH },
605 { RUN_STATE_COLO, RUN_STATE_RUNNING },
607 { RUN_STATE_RUNNING, RUN_STATE_DEBUG },
608 { RUN_STATE_RUNNING, RUN_STATE_INTERNAL_ERROR },
609 { RUN_STATE_RUNNING, RUN_STATE_IO_ERROR },
610 { RUN_STATE_RUNNING, RUN_STATE_PAUSED },
611 { RUN_STATE_RUNNING, RUN_STATE_FINISH_MIGRATE },
612 { RUN_STATE_RUNNING, RUN_STATE_RESTORE_VM },
613 { RUN_STATE_RUNNING, RUN_STATE_SAVE_VM },
614 { RUN_STATE_RUNNING, RUN_STATE_SHUTDOWN },
615 { RUN_STATE_RUNNING, RUN_STATE_WATCHDOG },
616 { RUN_STATE_RUNNING, RUN_STATE_GUEST_PANICKED },
617 { RUN_STATE_RUNNING, RUN_STATE_COLO},
619 { RUN_STATE_SAVE_VM, RUN_STATE_RUNNING },
621 { RUN_STATE_SHUTDOWN, RUN_STATE_PAUSED },
622 { RUN_STATE_SHUTDOWN, RUN_STATE_FINISH_MIGRATE },
623 { RUN_STATE_SHUTDOWN, RUN_STATE_PRELAUNCH },
625 { RUN_STATE_DEBUG, RUN_STATE_SUSPENDED },
626 { RUN_STATE_RUNNING, RUN_STATE_SUSPENDED },
627 { RUN_STATE_SUSPENDED, RUN_STATE_RUNNING },
628 { RUN_STATE_SUSPENDED, RUN_STATE_FINISH_MIGRATE },
629 { RUN_STATE_SUSPENDED, RUN_STATE_PRELAUNCH },
630 { RUN_STATE_SUSPENDED, RUN_STATE_COLO},
632 { RUN_STATE_WATCHDOG, RUN_STATE_RUNNING },
633 { RUN_STATE_WATCHDOG, RUN_STATE_FINISH_MIGRATE },
634 { RUN_STATE_WATCHDOG, RUN_STATE_PRELAUNCH },
635 { RUN_STATE_WATCHDOG, RUN_STATE_COLO},
637 { RUN_STATE_GUEST_PANICKED, RUN_STATE_RUNNING },
638 { RUN_STATE_GUEST_PANICKED, RUN_STATE_FINISH_MIGRATE },
639 { RUN_STATE_GUEST_PANICKED, RUN_STATE_PRELAUNCH },
641 { RUN_STATE__MAX, RUN_STATE__MAX },
644 static bool runstate_valid_transitions[RUN_STATE__MAX][RUN_STATE__MAX];
646 bool runstate_check(RunState state)
648 return current_run_state == state;
651 bool runstate_store(char *str, size_t size)
653 const char *state = RunState_str(current_run_state);
654 size_t len = strlen(state) + 1;
656 if (len > size) {
657 return false;
659 memcpy(str, state, len);
660 return true;
663 static void runstate_init(void)
665 const RunStateTransition *p;
667 memset(&runstate_valid_transitions, 0, sizeof(runstate_valid_transitions));
668 for (p = &runstate_transitions_def[0]; p->from != RUN_STATE__MAX; p++) {
669 runstate_valid_transitions[p->from][p->to] = true;
672 qemu_mutex_init(&vmstop_lock);
675 /* This function will abort() on invalid state transitions */
676 void runstate_set(RunState new_state)
678 assert(new_state < RUN_STATE__MAX);
680 trace_runstate_set(current_run_state, RunState_str(current_run_state),
681 new_state, RunState_str(new_state));
683 if (current_run_state == new_state) {
684 return;
687 if (!runstate_valid_transitions[current_run_state][new_state]) {
688 error_report("invalid runstate transition: '%s' -> '%s'",
689 RunState_str(current_run_state),
690 RunState_str(new_state));
691 abort();
694 current_run_state = new_state;
697 int runstate_is_running(void)
699 return runstate_check(RUN_STATE_RUNNING);
702 bool runstate_needs_reset(void)
704 return runstate_check(RUN_STATE_INTERNAL_ERROR) ||
705 runstate_check(RUN_STATE_SHUTDOWN);
708 StatusInfo *qmp_query_status(Error **errp)
710 StatusInfo *info = g_malloc0(sizeof(*info));
712 info->running = runstate_is_running();
713 info->singlestep = singlestep;
714 info->status = current_run_state;
716 return info;
719 bool qemu_vmstop_requested(RunState *r)
721 qemu_mutex_lock(&vmstop_lock);
722 *r = vmstop_requested;
723 vmstop_requested = RUN_STATE__MAX;
724 qemu_mutex_unlock(&vmstop_lock);
725 return *r < RUN_STATE__MAX;
728 void qemu_system_vmstop_request_prepare(void)
730 qemu_mutex_lock(&vmstop_lock);
733 void qemu_system_vmstop_request(RunState state)
735 vmstop_requested = state;
736 qemu_mutex_unlock(&vmstop_lock);
737 qemu_notify_event();
740 /***********************************************************/
741 /* RTC reference time/date access */
742 static time_t qemu_ref_timedate(QEMUClockType clock)
744 time_t value = qemu_clock_get_ms(clock) / 1000;
745 switch (clock) {
746 case QEMU_CLOCK_REALTIME:
747 value -= rtc_realtime_clock_offset;
748 /* fall through */
749 case QEMU_CLOCK_VIRTUAL:
750 value += rtc_ref_start_datetime;
751 break;
752 case QEMU_CLOCK_HOST:
753 if (rtc_base_type == RTC_BASE_DATETIME) {
754 value -= rtc_host_datetime_offset;
756 break;
757 default:
758 assert(0);
760 return value;
763 void qemu_get_timedate(struct tm *tm, int offset)
765 time_t ti = qemu_ref_timedate(rtc_clock);
767 ti += offset;
769 switch (rtc_base_type) {
770 case RTC_BASE_DATETIME:
771 case RTC_BASE_UTC:
772 gmtime_r(&ti, tm);
773 break;
774 case RTC_BASE_LOCALTIME:
775 localtime_r(&ti, tm);
776 break;
780 int qemu_timedate_diff(struct tm *tm)
782 time_t seconds;
784 switch (rtc_base_type) {
785 case RTC_BASE_DATETIME:
786 case RTC_BASE_UTC:
787 seconds = mktimegm(tm);
788 break;
789 case RTC_BASE_LOCALTIME:
791 struct tm tmp = *tm;
792 tmp.tm_isdst = -1; /* use timezone to figure it out */
793 seconds = mktime(&tmp);
794 break;
796 default:
797 abort();
800 return seconds - qemu_ref_timedate(QEMU_CLOCK_HOST);
803 static void configure_rtc_base_datetime(const char *startdate)
805 time_t rtc_start_datetime;
806 struct tm tm;
808 if (sscanf(startdate, "%d-%d-%dT%d:%d:%d", &tm.tm_year, &tm.tm_mon,
809 &tm.tm_mday, &tm.tm_hour, &tm.tm_min, &tm.tm_sec) == 6) {
810 /* OK */
811 } else if (sscanf(startdate, "%d-%d-%d",
812 &tm.tm_year, &tm.tm_mon, &tm.tm_mday) == 3) {
813 tm.tm_hour = 0;
814 tm.tm_min = 0;
815 tm.tm_sec = 0;
816 } else {
817 goto date_fail;
819 tm.tm_year -= 1900;
820 tm.tm_mon--;
821 rtc_start_datetime = mktimegm(&tm);
822 if (rtc_start_datetime == -1) {
823 date_fail:
824 error_report("invalid datetime format");
825 error_printf("valid formats: "
826 "'2006-06-17T16:01:21' or '2006-06-17'\n");
827 exit(1);
829 rtc_host_datetime_offset = rtc_ref_start_datetime - rtc_start_datetime;
830 rtc_ref_start_datetime = rtc_start_datetime;
833 static void configure_rtc(QemuOpts *opts)
835 const char *value;
837 /* Set defaults */
838 rtc_clock = QEMU_CLOCK_HOST;
839 rtc_ref_start_datetime = qemu_clock_get_ms(QEMU_CLOCK_HOST) / 1000;
840 rtc_realtime_clock_offset = qemu_clock_get_ms(QEMU_CLOCK_REALTIME) / 1000;
842 value = qemu_opt_get(opts, "base");
843 if (value) {
844 if (!strcmp(value, "utc")) {
845 rtc_base_type = RTC_BASE_UTC;
846 } else if (!strcmp(value, "localtime")) {
847 Error *blocker = NULL;
848 rtc_base_type = RTC_BASE_LOCALTIME;
849 error_setg(&blocker, QERR_REPLAY_NOT_SUPPORTED,
850 "-rtc base=localtime");
851 replay_add_blocker(blocker);
852 } else {
853 rtc_base_type = RTC_BASE_DATETIME;
854 configure_rtc_base_datetime(value);
857 value = qemu_opt_get(opts, "clock");
858 if (value) {
859 if (!strcmp(value, "host")) {
860 rtc_clock = QEMU_CLOCK_HOST;
861 } else if (!strcmp(value, "rt")) {
862 rtc_clock = QEMU_CLOCK_REALTIME;
863 } else if (!strcmp(value, "vm")) {
864 rtc_clock = QEMU_CLOCK_VIRTUAL;
865 } else {
866 error_report("invalid option value '%s'", value);
867 exit(1);
870 value = qemu_opt_get(opts, "driftfix");
871 if (value) {
872 if (!strcmp(value, "slew")) {
873 object_register_sugar_prop("mc146818rtc",
874 "lost_tick_policy",
875 "slew");
876 } else if (!strcmp(value, "none")) {
877 /* discard is default */
878 } else {
879 error_report("invalid option value '%s'", value);
880 exit(1);
885 static int parse_name(void *opaque, QemuOpts *opts, Error **errp)
887 const char *proc_name;
889 if (qemu_opt_get(opts, "debug-threads")) {
890 qemu_thread_naming(qemu_opt_get_bool(opts, "debug-threads", false));
892 qemu_name = qemu_opt_get(opts, "guest");
894 proc_name = qemu_opt_get(opts, "process");
895 if (proc_name) {
896 os_set_proc_name(proc_name);
899 return 0;
902 bool defaults_enabled(void)
904 return has_defaults;
907 #ifndef _WIN32
908 static int parse_add_fd(void *opaque, QemuOpts *opts, Error **errp)
910 int fd, dupfd, flags;
911 int64_t fdset_id;
912 const char *fd_opaque = NULL;
913 AddfdInfo *fdinfo;
915 fd = qemu_opt_get_number(opts, "fd", -1);
916 fdset_id = qemu_opt_get_number(opts, "set", -1);
917 fd_opaque = qemu_opt_get(opts, "opaque");
919 if (fd < 0) {
920 error_setg(errp, "fd option is required and must be non-negative");
921 return -1;
924 if (fd <= STDERR_FILENO) {
925 error_setg(errp, "fd cannot be a standard I/O stream");
926 return -1;
930 * All fds inherited across exec() necessarily have FD_CLOEXEC
931 * clear, while qemu sets FD_CLOEXEC on all other fds used internally.
933 flags = fcntl(fd, F_GETFD);
934 if (flags == -1 || (flags & FD_CLOEXEC)) {
935 error_setg(errp, "fd is not valid or already in use");
936 return -1;
939 if (fdset_id < 0) {
940 error_setg(errp, "set option is required and must be non-negative");
941 return -1;
944 #ifdef F_DUPFD_CLOEXEC
945 dupfd = fcntl(fd, F_DUPFD_CLOEXEC, 0);
946 #else
947 dupfd = dup(fd);
948 if (dupfd != -1) {
949 qemu_set_cloexec(dupfd);
951 #endif
952 if (dupfd == -1) {
953 error_setg(errp, "error duplicating fd: %s", strerror(errno));
954 return -1;
957 /* add the duplicate fd, and optionally the opaque string, to the fd set */
958 fdinfo = monitor_fdset_add_fd(dupfd, true, fdset_id, !!fd_opaque, fd_opaque,
959 &error_abort);
960 g_free(fdinfo);
962 return 0;
965 static int cleanup_add_fd(void *opaque, QemuOpts *opts, Error **errp)
967 int fd;
969 fd = qemu_opt_get_number(opts, "fd", -1);
970 close(fd);
972 return 0;
974 #endif
976 /***********************************************************/
977 /* QEMU Block devices */
979 #define HD_OPTS "media=disk"
980 #define CDROM_OPTS "media=cdrom"
981 #define FD_OPTS ""
982 #define PFLASH_OPTS ""
983 #define MTD_OPTS ""
984 #define SD_OPTS ""
986 static int drive_init_func(void *opaque, QemuOpts *opts, Error **errp)
988 BlockInterfaceType *block_default_type = opaque;
990 return drive_new(opts, *block_default_type, errp) == NULL;
993 static int drive_enable_snapshot(void *opaque, QemuOpts *opts, Error **errp)
995 if (qemu_opt_get(opts, "snapshot") == NULL) {
996 qemu_opt_set(opts, "snapshot", "on", &error_abort);
998 return 0;
1001 static void default_drive(int enable, int snapshot, BlockInterfaceType type,
1002 int index, const char *optstr)
1004 QemuOpts *opts;
1005 DriveInfo *dinfo;
1007 if (!enable || drive_get_by_index(type, index)) {
1008 return;
1011 opts = drive_add(type, index, NULL, optstr);
1012 if (snapshot) {
1013 drive_enable_snapshot(NULL, opts, NULL);
1016 dinfo = drive_new(opts, type, &error_abort);
1017 dinfo->is_default = true;
1021 typedef struct BlockdevOptionsQueueEntry {
1022 BlockdevOptions *bdo;
1023 Location loc;
1024 QSIMPLEQ_ENTRY(BlockdevOptionsQueueEntry) entry;
1025 } BlockdevOptionsQueueEntry;
1027 typedef QSIMPLEQ_HEAD(, BlockdevOptionsQueueEntry) BlockdevOptionsQueue;
1029 static void configure_blockdev(BlockdevOptionsQueue *bdo_queue,
1030 MachineClass *machine_class, int snapshot)
1033 * If the currently selected machine wishes to override the
1034 * units-per-bus property of its default HBA interface type, do so
1035 * now.
1037 if (machine_class->units_per_default_bus) {
1038 override_max_devs(machine_class->block_default_type,
1039 machine_class->units_per_default_bus);
1042 /* open the virtual block devices */
1043 while (!QSIMPLEQ_EMPTY(bdo_queue)) {
1044 BlockdevOptionsQueueEntry *bdo = QSIMPLEQ_FIRST(bdo_queue);
1046 QSIMPLEQ_REMOVE_HEAD(bdo_queue, entry);
1047 loc_push_restore(&bdo->loc);
1048 qmp_blockdev_add(bdo->bdo, &error_fatal);
1049 loc_pop(&bdo->loc);
1050 qapi_free_BlockdevOptions(bdo->bdo);
1051 g_free(bdo);
1053 if (snapshot) {
1054 qemu_opts_foreach(qemu_find_opts("drive"), drive_enable_snapshot,
1055 NULL, NULL);
1057 if (qemu_opts_foreach(qemu_find_opts("drive"), drive_init_func,
1058 &machine_class->block_default_type, &error_fatal)) {
1059 /* We printed help */
1060 exit(0);
1063 default_drive(default_cdrom, snapshot, machine_class->block_default_type, 2,
1064 CDROM_OPTS);
1065 default_drive(default_floppy, snapshot, IF_FLOPPY, 0, FD_OPTS);
1066 default_drive(default_sdcard, snapshot, IF_SD, 0, SD_OPTS);
1070 static QemuOptsList qemu_smp_opts = {
1071 .name = "smp-opts",
1072 .implied_opt_name = "cpus",
1073 .merge_lists = true,
1074 .head = QTAILQ_HEAD_INITIALIZER(qemu_smp_opts.head),
1075 .desc = {
1077 .name = "cpus",
1078 .type = QEMU_OPT_NUMBER,
1079 }, {
1080 .name = "sockets",
1081 .type = QEMU_OPT_NUMBER,
1082 }, {
1083 .name = "dies",
1084 .type = QEMU_OPT_NUMBER,
1085 }, {
1086 .name = "cores",
1087 .type = QEMU_OPT_NUMBER,
1088 }, {
1089 .name = "threads",
1090 .type = QEMU_OPT_NUMBER,
1091 }, {
1092 .name = "maxcpus",
1093 .type = QEMU_OPT_NUMBER,
1095 { /*End of list */ }
1099 static void realtime_init(void)
1101 if (enable_mlock) {
1102 if (os_mlock() < 0) {
1103 error_report("locking memory failed");
1104 exit(1);
1110 static void configure_msg(QemuOpts *opts)
1112 error_with_timestamp = qemu_opt_get_bool(opts, "timestamp", false);
1116 /***********************************************************/
1117 /* USB devices */
1119 static int usb_device_add(const char *devname)
1121 USBDevice *dev = NULL;
1123 if (!machine_usb(current_machine)) {
1124 return -1;
1127 dev = usbdevice_create(devname);
1128 if (!dev)
1129 return -1;
1131 return 0;
1134 static int usb_parse(const char *cmdline)
1136 int r;
1137 r = usb_device_add(cmdline);
1138 if (r < 0) {
1139 error_report("could not add USB device '%s'", cmdline);
1141 return r;
1144 /***********************************************************/
1145 /* machine registration */
1147 MachineState *current_machine;
1149 static MachineClass *find_machine(const char *name, GSList *machines)
1151 GSList *el;
1153 for (el = machines; el; el = el->next) {
1154 MachineClass *mc = el->data;
1156 if (!strcmp(mc->name, name) || !g_strcmp0(mc->alias, name)) {
1157 return mc;
1161 return NULL;
1164 static MachineClass *find_default_machine(GSList *machines)
1166 GSList *el;
1167 MachineClass *default_machineclass = NULL;
1169 for (el = machines; el; el = el->next) {
1170 MachineClass *mc = el->data;
1172 if (mc->is_default) {
1173 assert(default_machineclass == NULL && "Multiple default machines");
1174 default_machineclass = mc;
1178 return default_machineclass;
1181 static int machine_help_func(QemuOpts *opts, MachineState *machine)
1183 ObjectProperty *prop;
1184 ObjectPropertyIterator iter;
1186 if (!qemu_opt_has_help_opt(opts)) {
1187 return 0;
1190 object_property_iter_init(&iter, OBJECT(machine));
1191 while ((prop = object_property_iter_next(&iter))) {
1192 if (!prop->set) {
1193 continue;
1196 printf("%s.%s=%s", MACHINE_GET_CLASS(machine)->name,
1197 prop->name, prop->type);
1198 if (prop->description) {
1199 printf(" (%s)\n", prop->description);
1200 } else {
1201 printf("\n");
1205 return 1;
1208 struct VMChangeStateEntry {
1209 VMChangeStateHandler *cb;
1210 void *opaque;
1211 QTAILQ_ENTRY(VMChangeStateEntry) entries;
1212 int priority;
1215 static QTAILQ_HEAD(, VMChangeStateEntry) vm_change_state_head;
1218 * qemu_add_vm_change_state_handler_prio:
1219 * @cb: the callback to invoke
1220 * @opaque: user data passed to the callback
1221 * @priority: low priorities execute first when the vm runs and the reverse is
1222 * true when the vm stops
1224 * Register a callback function that is invoked when the vm starts or stops
1225 * running.
1227 * Returns: an entry to be freed using qemu_del_vm_change_state_handler()
1229 VMChangeStateEntry *qemu_add_vm_change_state_handler_prio(
1230 VMChangeStateHandler *cb, void *opaque, int priority)
1232 VMChangeStateEntry *e;
1233 VMChangeStateEntry *other;
1235 e = g_malloc0(sizeof(*e));
1236 e->cb = cb;
1237 e->opaque = opaque;
1238 e->priority = priority;
1240 /* Keep list sorted in ascending priority order */
1241 QTAILQ_FOREACH(other, &vm_change_state_head, entries) {
1242 if (priority < other->priority) {
1243 QTAILQ_INSERT_BEFORE(other, e, entries);
1244 return e;
1248 QTAILQ_INSERT_TAIL(&vm_change_state_head, e, entries);
1249 return e;
1252 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb,
1253 void *opaque)
1255 return qemu_add_vm_change_state_handler_prio(cb, opaque, 0);
1258 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e)
1260 QTAILQ_REMOVE(&vm_change_state_head, e, entries);
1261 g_free(e);
1264 void vm_state_notify(int running, RunState state)
1266 VMChangeStateEntry *e, *next;
1268 trace_vm_state_notify(running, state, RunState_str(state));
1270 if (running) {
1271 QTAILQ_FOREACH_SAFE(e, &vm_change_state_head, entries, next) {
1272 e->cb(e->opaque, running, state);
1274 } else {
1275 QTAILQ_FOREACH_REVERSE_SAFE(e, &vm_change_state_head, entries, next) {
1276 e->cb(e->opaque, running, state);
1281 static ShutdownCause reset_requested;
1282 static ShutdownCause shutdown_requested;
1283 static int shutdown_signal;
1284 static pid_t shutdown_pid;
1285 static int powerdown_requested;
1286 static int debug_requested;
1287 static int suspend_requested;
1288 static bool preconfig_exit_requested = true;
1289 static WakeupReason wakeup_reason;
1290 static NotifierList powerdown_notifiers =
1291 NOTIFIER_LIST_INITIALIZER(powerdown_notifiers);
1292 static NotifierList suspend_notifiers =
1293 NOTIFIER_LIST_INITIALIZER(suspend_notifiers);
1294 static NotifierList wakeup_notifiers =
1295 NOTIFIER_LIST_INITIALIZER(wakeup_notifiers);
1296 static NotifierList shutdown_notifiers =
1297 NOTIFIER_LIST_INITIALIZER(shutdown_notifiers);
1298 static uint32_t wakeup_reason_mask = ~(1 << QEMU_WAKEUP_REASON_NONE);
1300 ShutdownCause qemu_shutdown_requested_get(void)
1302 return shutdown_requested;
1305 ShutdownCause qemu_reset_requested_get(void)
1307 return reset_requested;
1310 static int qemu_shutdown_requested(void)
1312 return atomic_xchg(&shutdown_requested, SHUTDOWN_CAUSE_NONE);
1315 static void qemu_kill_report(void)
1317 if (!qtest_driver() && shutdown_signal) {
1318 if (shutdown_pid == 0) {
1319 /* This happens for eg ^C at the terminal, so it's worth
1320 * avoiding printing an odd message in that case.
1322 error_report("terminating on signal %d", shutdown_signal);
1323 } else {
1324 char *shutdown_cmd = qemu_get_pid_name(shutdown_pid);
1326 error_report("terminating on signal %d from pid " FMT_pid " (%s)",
1327 shutdown_signal, shutdown_pid,
1328 shutdown_cmd ? shutdown_cmd : "<unknown process>");
1329 g_free(shutdown_cmd);
1331 shutdown_signal = 0;
1335 static ShutdownCause qemu_reset_requested(void)
1337 ShutdownCause r = reset_requested;
1339 if (r && replay_checkpoint(CHECKPOINT_RESET_REQUESTED)) {
1340 reset_requested = SHUTDOWN_CAUSE_NONE;
1341 return r;
1343 return SHUTDOWN_CAUSE_NONE;
1346 static int qemu_suspend_requested(void)
1348 int r = suspend_requested;
1349 if (r && replay_checkpoint(CHECKPOINT_SUSPEND_REQUESTED)) {
1350 suspend_requested = 0;
1351 return r;
1353 return false;
1356 static WakeupReason qemu_wakeup_requested(void)
1358 return wakeup_reason;
1361 static int qemu_powerdown_requested(void)
1363 int r = powerdown_requested;
1364 powerdown_requested = 0;
1365 return r;
1368 static int qemu_debug_requested(void)
1370 int r = debug_requested;
1371 debug_requested = 0;
1372 return r;
1375 void qemu_exit_preconfig_request(void)
1377 preconfig_exit_requested = true;
1381 * Reset the VM. Issue an event unless @reason is SHUTDOWN_CAUSE_NONE.
1383 void qemu_system_reset(ShutdownCause reason)
1385 MachineClass *mc;
1387 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
1389 cpu_synchronize_all_states();
1391 if (mc && mc->reset) {
1392 mc->reset(current_machine);
1393 } else {
1394 qemu_devices_reset();
1396 if (reason && reason != SHUTDOWN_CAUSE_SUBSYSTEM_RESET) {
1397 qapi_event_send_reset(shutdown_caused_by_guest(reason), reason);
1399 cpu_synchronize_all_post_reset();
1403 * Wake the VM after suspend.
1405 static void qemu_system_wakeup(void)
1407 MachineClass *mc;
1409 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
1411 if (mc && mc->wakeup) {
1412 mc->wakeup(current_machine);
1416 void qemu_system_guest_panicked(GuestPanicInformation *info)
1418 qemu_log_mask(LOG_GUEST_ERROR, "Guest crashed");
1420 if (current_cpu) {
1421 current_cpu->crash_occurred = true;
1423 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_PAUSE,
1424 !!info, info);
1425 vm_stop(RUN_STATE_GUEST_PANICKED);
1426 if (!no_shutdown) {
1427 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_POWEROFF,
1428 !!info, info);
1429 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_PANIC);
1432 if (info) {
1433 if (info->type == GUEST_PANIC_INFORMATION_TYPE_HYPER_V) {
1434 qemu_log_mask(LOG_GUEST_ERROR, "\nHV crash parameters: (%#"PRIx64
1435 " %#"PRIx64" %#"PRIx64" %#"PRIx64" %#"PRIx64")\n",
1436 info->u.hyper_v.arg1,
1437 info->u.hyper_v.arg2,
1438 info->u.hyper_v.arg3,
1439 info->u.hyper_v.arg4,
1440 info->u.hyper_v.arg5);
1441 } else if (info->type == GUEST_PANIC_INFORMATION_TYPE_S390) {
1442 qemu_log_mask(LOG_GUEST_ERROR, " on cpu %d: %s\n"
1443 "PSW: 0x%016" PRIx64 " 0x%016" PRIx64"\n",
1444 info->u.s390.core,
1445 S390CrashReason_str(info->u.s390.reason),
1446 info->u.s390.psw_mask,
1447 info->u.s390.psw_addr);
1449 qapi_free_GuestPanicInformation(info);
1453 void qemu_system_guest_crashloaded(GuestPanicInformation *info)
1455 qemu_log_mask(LOG_GUEST_ERROR, "Guest crash loaded");
1457 qapi_event_send_guest_crashloaded(GUEST_PANIC_ACTION_RUN,
1458 !!info, info);
1460 if (info) {
1461 qapi_free_GuestPanicInformation(info);
1465 void qemu_system_reset_request(ShutdownCause reason)
1467 if (no_reboot && reason != SHUTDOWN_CAUSE_SUBSYSTEM_RESET) {
1468 shutdown_requested = reason;
1469 } else {
1470 reset_requested = reason;
1472 cpu_stop_current();
1473 qemu_notify_event();
1476 static void qemu_system_suspend(void)
1478 pause_all_vcpus();
1479 notifier_list_notify(&suspend_notifiers, NULL);
1480 runstate_set(RUN_STATE_SUSPENDED);
1481 qapi_event_send_suspend();
1484 void qemu_system_suspend_request(void)
1486 if (runstate_check(RUN_STATE_SUSPENDED)) {
1487 return;
1489 suspend_requested = 1;
1490 cpu_stop_current();
1491 qemu_notify_event();
1494 void qemu_register_suspend_notifier(Notifier *notifier)
1496 notifier_list_add(&suspend_notifiers, notifier);
1499 void qemu_system_wakeup_request(WakeupReason reason, Error **errp)
1501 trace_system_wakeup_request(reason);
1503 if (!runstate_check(RUN_STATE_SUSPENDED)) {
1504 error_setg(errp,
1505 "Unable to wake up: guest is not in suspended state");
1506 return;
1508 if (!(wakeup_reason_mask & (1 << reason))) {
1509 return;
1511 runstate_set(RUN_STATE_RUNNING);
1512 wakeup_reason = reason;
1513 qemu_notify_event();
1516 void qemu_system_wakeup_enable(WakeupReason reason, bool enabled)
1518 if (enabled) {
1519 wakeup_reason_mask |= (1 << reason);
1520 } else {
1521 wakeup_reason_mask &= ~(1 << reason);
1525 void qemu_register_wakeup_notifier(Notifier *notifier)
1527 notifier_list_add(&wakeup_notifiers, notifier);
1530 void qemu_register_wakeup_support(void)
1532 wakeup_suspend_enabled = true;
1535 bool qemu_wakeup_suspend_enabled(void)
1537 return wakeup_suspend_enabled;
1540 void qemu_system_killed(int signal, pid_t pid)
1542 shutdown_signal = signal;
1543 shutdown_pid = pid;
1544 no_shutdown = 0;
1546 /* Cannot call qemu_system_shutdown_request directly because
1547 * we are in a signal handler.
1549 shutdown_requested = SHUTDOWN_CAUSE_HOST_SIGNAL;
1550 qemu_notify_event();
1553 void qemu_system_shutdown_request(ShutdownCause reason)
1555 trace_qemu_system_shutdown_request(reason);
1556 replay_shutdown_request(reason);
1557 shutdown_requested = reason;
1558 qemu_notify_event();
1561 static void qemu_system_powerdown(void)
1563 qapi_event_send_powerdown();
1564 notifier_list_notify(&powerdown_notifiers, NULL);
1567 static void qemu_system_shutdown(ShutdownCause cause)
1569 qapi_event_send_shutdown(shutdown_caused_by_guest(cause), cause);
1570 notifier_list_notify(&shutdown_notifiers, &cause);
1573 void qemu_system_powerdown_request(void)
1575 trace_qemu_system_powerdown_request();
1576 powerdown_requested = 1;
1577 qemu_notify_event();
1580 void qemu_register_powerdown_notifier(Notifier *notifier)
1582 notifier_list_add(&powerdown_notifiers, notifier);
1585 void qemu_register_shutdown_notifier(Notifier *notifier)
1587 notifier_list_add(&shutdown_notifiers, notifier);
1590 void qemu_system_debug_request(void)
1592 debug_requested = 1;
1593 qemu_notify_event();
1596 static bool main_loop_should_exit(void)
1598 RunState r;
1599 ShutdownCause request;
1601 if (preconfig_exit_requested) {
1602 if (runstate_check(RUN_STATE_PRECONFIG)) {
1603 runstate_set(RUN_STATE_PRELAUNCH);
1605 preconfig_exit_requested = false;
1606 return true;
1608 if (qemu_debug_requested()) {
1609 vm_stop(RUN_STATE_DEBUG);
1611 if (qemu_suspend_requested()) {
1612 qemu_system_suspend();
1614 request = qemu_shutdown_requested();
1615 if (request) {
1616 qemu_kill_report();
1617 qemu_system_shutdown(request);
1618 if (no_shutdown) {
1619 vm_stop(RUN_STATE_SHUTDOWN);
1620 } else {
1621 return true;
1624 request = qemu_reset_requested();
1625 if (request) {
1626 pause_all_vcpus();
1627 qemu_system_reset(request);
1628 resume_all_vcpus();
1630 * runstate can change in pause_all_vcpus()
1631 * as iothread mutex is unlocked
1633 if (!runstate_check(RUN_STATE_RUNNING) &&
1634 !runstate_check(RUN_STATE_INMIGRATE) &&
1635 !runstate_check(RUN_STATE_FINISH_MIGRATE)) {
1636 runstate_set(RUN_STATE_PRELAUNCH);
1639 if (qemu_wakeup_requested()) {
1640 pause_all_vcpus();
1641 qemu_system_wakeup();
1642 notifier_list_notify(&wakeup_notifiers, &wakeup_reason);
1643 wakeup_reason = QEMU_WAKEUP_REASON_NONE;
1644 resume_all_vcpus();
1645 qapi_event_send_wakeup();
1647 if (qemu_powerdown_requested()) {
1648 qemu_system_powerdown();
1650 if (qemu_vmstop_requested(&r)) {
1651 vm_stop(r);
1653 return false;
1656 void qemu_main_loop(void)
1658 #ifdef CONFIG_PROFILER
1659 int64_t ti;
1660 #endif
1661 while (!main_loop_should_exit()) {
1662 #ifdef CONFIG_PROFILER
1663 ti = profile_getclock();
1664 #endif
1665 main_loop_wait(false);
1666 #ifdef CONFIG_PROFILER
1667 dev_time += profile_getclock() - ti;
1668 #endif
1672 static void version(void)
1674 printf("QEMU emulator version " QEMU_FULL_VERSION "\n"
1675 QEMU_COPYRIGHT "\n");
1678 static void help(int exitcode)
1680 version();
1681 printf("usage: %s [options] [disk_image]\n\n"
1682 "'disk_image' is a raw hard disk image for IDE hard disk 0\n\n",
1683 error_get_progname());
1685 #define QEMU_OPTIONS_GENERATE_HELP
1686 #include "qemu-options-wrapper.h"
1688 printf("\nDuring emulation, the following keys are useful:\n"
1689 "ctrl-alt-f toggle full screen\n"
1690 "ctrl-alt-n switch to virtual console 'n'\n"
1691 "ctrl-alt toggle mouse and keyboard grab\n"
1692 "\n"
1693 "When using -nographic, press 'ctrl-a h' to get some help.\n"
1694 "\n"
1695 QEMU_HELP_BOTTOM "\n");
1697 exit(exitcode);
1700 #define HAS_ARG 0x0001
1702 typedef struct QEMUOption {
1703 const char *name;
1704 int flags;
1705 int index;
1706 uint32_t arch_mask;
1707 } QEMUOption;
1709 static const QEMUOption qemu_options[] = {
1710 { "h", 0, QEMU_OPTION_h, QEMU_ARCH_ALL },
1711 #define QEMU_OPTIONS_GENERATE_OPTIONS
1712 #include "qemu-options-wrapper.h"
1713 { NULL },
1716 typedef struct VGAInterfaceInfo {
1717 const char *opt_name; /* option name */
1718 const char *name; /* human-readable name */
1719 /* Class names indicating that support is available.
1720 * If no class is specified, the interface is always available */
1721 const char *class_names[2];
1722 } VGAInterfaceInfo;
1724 static const VGAInterfaceInfo vga_interfaces[VGA_TYPE_MAX] = {
1725 [VGA_NONE] = {
1726 .opt_name = "none",
1727 .name = "no graphic card",
1729 [VGA_STD] = {
1730 .opt_name = "std",
1731 .name = "standard VGA",
1732 .class_names = { "VGA", "isa-vga" },
1734 [VGA_CIRRUS] = {
1735 .opt_name = "cirrus",
1736 .name = "Cirrus VGA",
1737 .class_names = { "cirrus-vga", "isa-cirrus-vga" },
1739 [VGA_VMWARE] = {
1740 .opt_name = "vmware",
1741 .name = "VMWare SVGA",
1742 .class_names = { "vmware-svga" },
1744 [VGA_VIRTIO] = {
1745 .opt_name = "virtio",
1746 .name = "Virtio VGA",
1747 .class_names = { "virtio-vga" },
1749 [VGA_QXL] = {
1750 .opt_name = "qxl",
1751 .name = "QXL VGA",
1752 .class_names = { "qxl-vga" },
1754 [VGA_TCX] = {
1755 .opt_name = "tcx",
1756 .name = "TCX framebuffer",
1757 .class_names = { "SUNW,tcx" },
1759 [VGA_CG3] = {
1760 .opt_name = "cg3",
1761 .name = "CG3 framebuffer",
1762 .class_names = { "cgthree" },
1764 [VGA_XENFB] = {
1765 .opt_name = "xenfb",
1766 .name = "Xen paravirtualized framebuffer",
1770 static bool vga_interface_available(VGAInterfaceType t)
1772 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1774 assert(t < VGA_TYPE_MAX);
1775 return !ti->class_names[0] ||
1776 object_class_by_name(ti->class_names[0]) ||
1777 object_class_by_name(ti->class_names[1]);
1780 static const char *
1781 get_default_vga_model(const MachineClass *machine_class)
1783 if (machine_class->default_display) {
1784 return machine_class->default_display;
1785 } else if (vga_interface_available(VGA_CIRRUS)) {
1786 return "cirrus";
1787 } else if (vga_interface_available(VGA_STD)) {
1788 return "std";
1791 return NULL;
1794 static void select_vgahw(const MachineClass *machine_class, const char *p)
1796 const char *opts;
1797 int t;
1799 if (g_str_equal(p, "help")) {
1800 const char *def = get_default_vga_model(machine_class);
1802 for (t = 0; t < VGA_TYPE_MAX; t++) {
1803 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1805 if (vga_interface_available(t) && ti->opt_name) {
1806 printf("%-20s %s%s\n", ti->opt_name, ti->name ?: "",
1807 g_str_equal(ti->opt_name, def) ? " (default)" : "");
1810 exit(0);
1813 assert(vga_interface_type == VGA_NONE);
1814 for (t = 0; t < VGA_TYPE_MAX; t++) {
1815 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1816 if (ti->opt_name && strstart(p, ti->opt_name, &opts)) {
1817 if (!vga_interface_available(t)) {
1818 error_report("%s not available", ti->name);
1819 exit(1);
1821 vga_interface_type = t;
1822 break;
1825 if (t == VGA_TYPE_MAX) {
1826 invalid_vga:
1827 error_report("unknown vga type: %s", p);
1828 exit(1);
1830 while (*opts) {
1831 const char *nextopt;
1833 if (strstart(opts, ",retrace=", &nextopt)) {
1834 opts = nextopt;
1835 if (strstart(opts, "dumb", &nextopt))
1836 vga_retrace_method = VGA_RETRACE_DUMB;
1837 else if (strstart(opts, "precise", &nextopt))
1838 vga_retrace_method = VGA_RETRACE_PRECISE;
1839 else goto invalid_vga;
1840 } else goto invalid_vga;
1841 opts = nextopt;
1845 static void parse_display_qapi(const char *optarg)
1847 DisplayOptions *opts;
1848 Visitor *v;
1850 v = qobject_input_visitor_new_str(optarg, "type", &error_fatal);
1852 visit_type_DisplayOptions(v, NULL, &opts, &error_fatal);
1853 QAPI_CLONE_MEMBERS(DisplayOptions, &dpy, opts);
1855 qapi_free_DisplayOptions(opts);
1856 visit_free(v);
1859 DisplayOptions *qmp_query_display_options(Error **errp)
1861 return QAPI_CLONE(DisplayOptions, &dpy);
1864 static void parse_display(const char *p)
1866 const char *opts;
1868 if (is_help_option(p)) {
1869 qemu_display_help();
1870 exit(0);
1873 if (strstart(p, "sdl", &opts)) {
1875 * sdl DisplayType needs hand-crafted parser instead of
1876 * parse_display_qapi() due to some options not in
1877 * DisplayOptions, specifically:
1878 * - frame
1879 * Already deprecated.
1880 * - ctrl_grab + alt_grab
1881 * Not clear yet what happens to them long-term. Should
1882 * replaced by something better or deprecated and dropped.
1884 dpy.type = DISPLAY_TYPE_SDL;
1885 while (*opts) {
1886 const char *nextopt;
1888 if (strstart(opts, ",alt_grab=", &nextopt)) {
1889 opts = nextopt;
1890 if (strstart(opts, "on", &nextopt)) {
1891 alt_grab = 1;
1892 } else if (strstart(opts, "off", &nextopt)) {
1893 alt_grab = 0;
1894 } else {
1895 goto invalid_sdl_args;
1897 } else if (strstart(opts, ",ctrl_grab=", &nextopt)) {
1898 opts = nextopt;
1899 if (strstart(opts, "on", &nextopt)) {
1900 ctrl_grab = 1;
1901 } else if (strstart(opts, "off", &nextopt)) {
1902 ctrl_grab = 0;
1903 } else {
1904 goto invalid_sdl_args;
1906 } else if (strstart(opts, ",window_close=", &nextopt)) {
1907 opts = nextopt;
1908 dpy.has_window_close = true;
1909 if (strstart(opts, "on", &nextopt)) {
1910 dpy.window_close = true;
1911 } else if (strstart(opts, "off", &nextopt)) {
1912 dpy.window_close = false;
1913 } else {
1914 goto invalid_sdl_args;
1916 } else if (strstart(opts, ",show-cursor=", &nextopt)) {
1917 opts = nextopt;
1918 dpy.has_show_cursor = true;
1919 if (strstart(opts, "on", &nextopt)) {
1920 dpy.show_cursor = true;
1921 } else if (strstart(opts, "off", &nextopt)) {
1922 dpy.show_cursor = false;
1923 } else {
1924 goto invalid_sdl_args;
1926 } else if (strstart(opts, ",gl=", &nextopt)) {
1927 opts = nextopt;
1928 dpy.has_gl = true;
1929 if (strstart(opts, "on", &nextopt)) {
1930 dpy.gl = DISPLAYGL_MODE_ON;
1931 } else if (strstart(opts, "core", &nextopt)) {
1932 dpy.gl = DISPLAYGL_MODE_CORE;
1933 } else if (strstart(opts, "es", &nextopt)) {
1934 dpy.gl = DISPLAYGL_MODE_ES;
1935 } else if (strstart(opts, "off", &nextopt)) {
1936 dpy.gl = DISPLAYGL_MODE_OFF;
1937 } else {
1938 goto invalid_sdl_args;
1940 } else {
1941 invalid_sdl_args:
1942 error_report("invalid SDL option string");
1943 exit(1);
1945 opts = nextopt;
1947 } else if (strstart(p, "vnc", &opts)) {
1949 * vnc isn't a (local) DisplayType but a protocol for remote
1950 * display access.
1952 if (*opts == '=') {
1953 vnc_parse(opts + 1, &error_fatal);
1954 } else {
1955 error_report("VNC requires a display argument vnc=<display>");
1956 exit(1);
1958 } else {
1959 parse_display_qapi(p);
1963 char *qemu_find_file(int type, const char *name)
1965 int i;
1966 const char *subdir;
1967 char *buf;
1969 /* Try the name as a straight path first */
1970 if (access(name, R_OK) == 0) {
1971 trace_load_file(name, name);
1972 return g_strdup(name);
1975 switch (type) {
1976 case QEMU_FILE_TYPE_BIOS:
1977 subdir = "";
1978 break;
1979 case QEMU_FILE_TYPE_KEYMAP:
1980 subdir = "keymaps/";
1981 break;
1982 default:
1983 abort();
1986 for (i = 0; i < data_dir_idx; i++) {
1987 buf = g_strdup_printf("%s/%s%s", data_dir[i], subdir, name);
1988 if (access(buf, R_OK) == 0) {
1989 trace_load_file(name, buf);
1990 return buf;
1992 g_free(buf);
1994 return NULL;
1997 static void qemu_add_data_dir(const char *path)
1999 int i;
2001 if (path == NULL) {
2002 return;
2004 if (data_dir_idx == ARRAY_SIZE(data_dir)) {
2005 return;
2007 for (i = 0; i < data_dir_idx; i++) {
2008 if (strcmp(data_dir[i], path) == 0) {
2009 return; /* duplicate */
2012 data_dir[data_dir_idx++] = g_strdup(path);
2015 static inline bool nonempty_str(const char *str)
2017 return str && *str;
2020 static int parse_fw_cfg(void *opaque, QemuOpts *opts, Error **errp)
2022 gchar *buf;
2023 size_t size;
2024 const char *name, *file, *str;
2025 FWCfgState *fw_cfg = (FWCfgState *) opaque;
2027 if (fw_cfg == NULL) {
2028 error_setg(errp, "fw_cfg device not available");
2029 return -1;
2031 name = qemu_opt_get(opts, "name");
2032 file = qemu_opt_get(opts, "file");
2033 str = qemu_opt_get(opts, "string");
2035 /* we need name and either a file or the content string */
2036 if (!(nonempty_str(name) && (nonempty_str(file) || nonempty_str(str)))) {
2037 error_setg(errp, "invalid argument(s)");
2038 return -1;
2040 if (nonempty_str(file) && nonempty_str(str)) {
2041 error_setg(errp, "file and string are mutually exclusive");
2042 return -1;
2044 if (strlen(name) > FW_CFG_MAX_FILE_PATH - 1) {
2045 error_setg(errp, "name too long (max. %d char)",
2046 FW_CFG_MAX_FILE_PATH - 1);
2047 return -1;
2049 if (strncmp(name, "opt/", 4) != 0) {
2050 warn_report("externally provided fw_cfg item names "
2051 "should be prefixed with \"opt/\"");
2053 if (nonempty_str(str)) {
2054 size = strlen(str); /* NUL terminator NOT included in fw_cfg blob */
2055 buf = g_memdup(str, size);
2056 } else {
2057 GError *err = NULL;
2058 if (!g_file_get_contents(file, &buf, &size, &err)) {
2059 error_setg(errp, "can't load %s: %s", file, err->message);
2060 g_error_free(err);
2061 return -1;
2064 /* For legacy, keep user files in a specific global order. */
2065 fw_cfg_set_order_override(fw_cfg, FW_CFG_ORDER_OVERRIDE_USER);
2066 fw_cfg_add_file(fw_cfg, name, buf, size);
2067 fw_cfg_reset_order_override(fw_cfg);
2068 return 0;
2071 static int device_help_func(void *opaque, QemuOpts *opts, Error **errp)
2073 return qdev_device_help(opts);
2076 static int device_init_func(void *opaque, QemuOpts *opts, Error **errp)
2078 DeviceState *dev;
2080 dev = qdev_device_add(opts, errp);
2081 if (!dev && *errp) {
2082 error_report_err(*errp);
2083 return -1;
2084 } else if (dev) {
2085 object_unref(OBJECT(dev));
2087 return 0;
2090 static int chardev_init_func(void *opaque, QemuOpts *opts, Error **errp)
2092 Error *local_err = NULL;
2094 if (!qemu_chr_new_from_opts(opts, NULL, &local_err)) {
2095 if (local_err) {
2096 error_propagate(errp, local_err);
2097 return -1;
2099 exit(0);
2101 return 0;
2104 #ifdef CONFIG_VIRTFS
2105 static int fsdev_init_func(void *opaque, QemuOpts *opts, Error **errp)
2107 return qemu_fsdev_add(opts, errp);
2109 #endif
2111 static int mon_init_func(void *opaque, QemuOpts *opts, Error **errp)
2113 return monitor_init_opts(opts, errp);
2116 static void monitor_parse(const char *optarg, const char *mode, bool pretty)
2118 static int monitor_device_index = 0;
2119 QemuOpts *opts;
2120 const char *p;
2121 char label[32];
2123 if (strstart(optarg, "chardev:", &p)) {
2124 snprintf(label, sizeof(label), "%s", p);
2125 } else {
2126 snprintf(label, sizeof(label), "compat_monitor%d",
2127 monitor_device_index);
2128 opts = qemu_chr_parse_compat(label, optarg, true);
2129 if (!opts) {
2130 error_report("parse error: %s", optarg);
2131 exit(1);
2135 opts = qemu_opts_create(qemu_find_opts("mon"), label, 1, &error_fatal);
2136 qemu_opt_set(opts, "mode", mode, &error_abort);
2137 qemu_opt_set(opts, "chardev", label, &error_abort);
2138 if (!strcmp(mode, "control")) {
2139 qemu_opt_set_bool(opts, "pretty", pretty, &error_abort);
2140 } else {
2141 assert(pretty == false);
2143 monitor_device_index++;
2146 struct device_config {
2147 enum {
2148 DEV_USB, /* -usbdevice */
2149 DEV_SERIAL, /* -serial */
2150 DEV_PARALLEL, /* -parallel */
2151 DEV_DEBUGCON, /* -debugcon */
2152 DEV_GDB, /* -gdb, -s */
2153 DEV_SCLP, /* s390 sclp */
2154 } type;
2155 const char *cmdline;
2156 Location loc;
2157 QTAILQ_ENTRY(device_config) next;
2160 static QTAILQ_HEAD(, device_config) device_configs =
2161 QTAILQ_HEAD_INITIALIZER(device_configs);
2163 static void add_device_config(int type, const char *cmdline)
2165 struct device_config *conf;
2167 conf = g_malloc0(sizeof(*conf));
2168 conf->type = type;
2169 conf->cmdline = cmdline;
2170 loc_save(&conf->loc);
2171 QTAILQ_INSERT_TAIL(&device_configs, conf, next);
2174 static int foreach_device_config(int type, int (*func)(const char *cmdline))
2176 struct device_config *conf;
2177 int rc;
2179 QTAILQ_FOREACH(conf, &device_configs, next) {
2180 if (conf->type != type)
2181 continue;
2182 loc_push_restore(&conf->loc);
2183 rc = func(conf->cmdline);
2184 loc_pop(&conf->loc);
2185 if (rc) {
2186 return rc;
2189 return 0;
2192 static int serial_parse(const char *devname)
2194 int index = num_serial_hds;
2195 char label[32];
2197 if (strcmp(devname, "none") == 0)
2198 return 0;
2199 snprintf(label, sizeof(label), "serial%d", index);
2200 serial_hds = g_renew(Chardev *, serial_hds, index + 1);
2202 serial_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
2203 if (!serial_hds[index]) {
2204 error_report("could not connect serial device"
2205 " to character backend '%s'", devname);
2206 return -1;
2208 num_serial_hds++;
2209 return 0;
2212 Chardev *serial_hd(int i)
2214 assert(i >= 0);
2215 if (i < num_serial_hds) {
2216 return serial_hds[i];
2218 return NULL;
2221 int serial_max_hds(void)
2223 return num_serial_hds;
2226 static int parallel_parse(const char *devname)
2228 static int index = 0;
2229 char label[32];
2231 if (strcmp(devname, "none") == 0)
2232 return 0;
2233 if (index == MAX_PARALLEL_PORTS) {
2234 error_report("too many parallel ports");
2235 exit(1);
2237 snprintf(label, sizeof(label), "parallel%d", index);
2238 parallel_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
2239 if (!parallel_hds[index]) {
2240 error_report("could not connect parallel device"
2241 " to character backend '%s'", devname);
2242 return -1;
2244 index++;
2245 return 0;
2248 static int debugcon_parse(const char *devname)
2250 QemuOpts *opts;
2252 if (!qemu_chr_new_mux_mon("debugcon", devname, NULL)) {
2253 error_report("invalid character backend '%s'", devname);
2254 exit(1);
2256 opts = qemu_opts_create(qemu_find_opts("device"), "debugcon", 1, NULL);
2257 if (!opts) {
2258 error_report("already have a debugcon device");
2259 exit(1);
2261 qemu_opt_set(opts, "driver", "isa-debugcon", &error_abort);
2262 qemu_opt_set(opts, "chardev", "debugcon", &error_abort);
2263 return 0;
2266 static gint machine_class_cmp(gconstpointer a, gconstpointer b)
2268 const MachineClass *mc1 = a, *mc2 = b;
2269 int res;
2271 if (mc1->family == NULL) {
2272 if (mc2->family == NULL) {
2273 /* Compare standalone machine types against each other; they sort
2274 * in increasing order.
2276 return strcmp(object_class_get_name(OBJECT_CLASS(mc1)),
2277 object_class_get_name(OBJECT_CLASS(mc2)));
2280 /* Standalone machine types sort after families. */
2281 return 1;
2284 if (mc2->family == NULL) {
2285 /* Families sort before standalone machine types. */
2286 return -1;
2289 /* Families sort between each other alphabetically increasingly. */
2290 res = strcmp(mc1->family, mc2->family);
2291 if (res != 0) {
2292 return res;
2295 /* Within the same family, machine types sort in decreasing order. */
2296 return strcmp(object_class_get_name(OBJECT_CLASS(mc2)),
2297 object_class_get_name(OBJECT_CLASS(mc1)));
2300 static MachineClass *machine_parse(const char *name, GSList *machines)
2302 MachineClass *mc;
2303 GSList *el;
2305 if (is_help_option(name)) {
2306 printf("Supported machines are:\n");
2307 machines = g_slist_sort(machines, machine_class_cmp);
2308 for (el = machines; el; el = el->next) {
2309 MachineClass *mc = el->data;
2310 if (mc->alias) {
2311 printf("%-20s %s (alias of %s)\n", mc->alias, mc->desc, mc->name);
2313 printf("%-20s %s%s%s\n", mc->name, mc->desc,
2314 mc->is_default ? " (default)" : "",
2315 mc->deprecation_reason ? " (deprecated)" : "");
2317 exit(0);
2320 mc = find_machine(name, machines);
2321 if (!mc) {
2322 error_report("unsupported machine type");
2323 error_printf("Use -machine help to list supported machines\n");
2324 exit(1);
2326 return mc;
2329 void qemu_add_exit_notifier(Notifier *notify)
2331 notifier_list_add(&exit_notifiers, notify);
2334 void qemu_remove_exit_notifier(Notifier *notify)
2336 notifier_remove(notify);
2339 static void qemu_run_exit_notifiers(void)
2341 notifier_list_notify(&exit_notifiers, NULL);
2344 static const char *pid_file;
2345 static Notifier qemu_unlink_pidfile_notifier;
2347 static void qemu_unlink_pidfile(Notifier *n, void *data)
2349 if (pid_file) {
2350 unlink(pid_file);
2354 bool machine_init_done;
2356 void qemu_add_machine_init_done_notifier(Notifier *notify)
2358 notifier_list_add(&machine_init_done_notifiers, notify);
2359 if (machine_init_done) {
2360 notify->notify(notify, NULL);
2364 void qemu_remove_machine_init_done_notifier(Notifier *notify)
2366 notifier_remove(notify);
2369 static void qemu_run_machine_init_done_notifiers(void)
2371 machine_init_done = true;
2372 notifier_list_notify(&machine_init_done_notifiers, NULL);
2375 static const QEMUOption *lookup_opt(int argc, char **argv,
2376 const char **poptarg, int *poptind)
2378 const QEMUOption *popt;
2379 int optind = *poptind;
2380 char *r = argv[optind];
2381 const char *optarg;
2383 loc_set_cmdline(argv, optind, 1);
2384 optind++;
2385 /* Treat --foo the same as -foo. */
2386 if (r[1] == '-')
2387 r++;
2388 popt = qemu_options;
2389 for(;;) {
2390 if (!popt->name) {
2391 error_report("invalid option");
2392 exit(1);
2394 if (!strcmp(popt->name, r + 1))
2395 break;
2396 popt++;
2398 if (popt->flags & HAS_ARG) {
2399 if (optind >= argc) {
2400 error_report("requires an argument");
2401 exit(1);
2403 optarg = argv[optind++];
2404 loc_set_cmdline(argv, optind - 2, 2);
2405 } else {
2406 optarg = NULL;
2409 *poptarg = optarg;
2410 *poptind = optind;
2412 return popt;
2415 static MachineClass *select_machine(void)
2417 GSList *machines = object_class_get_list(TYPE_MACHINE, false);
2418 MachineClass *machine_class = find_default_machine(machines);
2419 const char *optarg;
2420 QemuOpts *opts;
2421 Location loc;
2423 loc_push_none(&loc);
2425 opts = qemu_get_machine_opts();
2426 qemu_opts_loc_restore(opts);
2428 optarg = qemu_opt_get(opts, "type");
2429 if (optarg) {
2430 machine_class = machine_parse(optarg, machines);
2433 if (!machine_class) {
2434 error_report("No machine specified, and there is no default");
2435 error_printf("Use -machine help to list supported machines\n");
2436 exit(1);
2439 loc_pop(&loc);
2440 g_slist_free(machines);
2441 return machine_class;
2444 static int object_parse_property_opt(Object *obj,
2445 const char *name, const char *value,
2446 const char *skip, Error **errp)
2448 Error *local_err = NULL;
2450 if (g_str_equal(name, skip)) {
2451 return 0;
2454 object_property_parse(obj, value, name, &local_err);
2456 if (local_err) {
2457 error_propagate(errp, local_err);
2458 return -1;
2461 return 0;
2464 static int machine_set_property(void *opaque,
2465 const char *name, const char *value,
2466 Error **errp)
2468 g_autofree char *qom_name = g_strdup(name);
2469 char *p;
2471 for (p = qom_name; *p; p++) {
2472 if (*p == '_') {
2473 *p = '-';
2477 /* Legacy options do not correspond to MachineState properties. */
2478 if (g_str_equal(qom_name, "accel")) {
2479 return 0;
2481 if (g_str_equal(qom_name, "igd-passthru")) {
2482 object_register_sugar_prop(ACCEL_CLASS_NAME("xen"), qom_name, value);
2483 return 0;
2485 if (g_str_equal(qom_name, "kvm-shadow-mem") ||
2486 g_str_equal(qom_name, "kernel-irqchip")) {
2487 object_register_sugar_prop(ACCEL_CLASS_NAME("kvm"), qom_name, value);
2488 return 0;
2491 return object_parse_property_opt(opaque, name, value, "type", errp);
2495 * Initial object creation happens before all other
2496 * QEMU data types are created. The majority of objects
2497 * can be created at this point. The rng-egd object
2498 * cannot be created here, as it depends on the chardev
2499 * already existing.
2501 static bool object_create_initial(const char *type, QemuOpts *opts)
2503 if (user_creatable_print_help(type, opts)) {
2504 exit(0);
2508 * Objects should not be made "delayed" without a reason. If you
2509 * add one, state the reason in a comment!
2512 /* Reason: rng-egd property "chardev" */
2513 if (g_str_equal(type, "rng-egd")) {
2514 return false;
2517 #if defined(CONFIG_VHOST_USER) && defined(CONFIG_LINUX)
2518 /* Reason: cryptodev-vhost-user property "chardev" */
2519 if (g_str_equal(type, "cryptodev-vhost-user")) {
2520 return false;
2522 #endif
2525 * Reason: filter-* property "netdev" etc.
2527 if (g_str_equal(type, "filter-buffer") ||
2528 g_str_equal(type, "filter-dump") ||
2529 g_str_equal(type, "filter-mirror") ||
2530 g_str_equal(type, "filter-redirector") ||
2531 g_str_equal(type, "colo-compare") ||
2532 g_str_equal(type, "filter-rewriter") ||
2533 g_str_equal(type, "filter-replay")) {
2534 return false;
2537 /* Memory allocation by backends needs to be done
2538 * after configure_accelerator() (due to the tcg_enabled()
2539 * checks at memory_region_init_*()).
2541 * Also, allocation of large amounts of memory may delay
2542 * chardev initialization for too long, and trigger timeouts
2543 * on software that waits for a monitor socket to be created
2544 * (e.g. libvirt).
2546 if (g_str_has_prefix(type, "memory-backend-")) {
2547 return false;
2550 return true;
2555 * The remainder of object creation happens after the
2556 * creation of chardev, fsdev, net clients and device data types.
2558 static bool object_create_delayed(const char *type, QemuOpts *opts)
2560 return !object_create_initial(type, opts);
2564 static bool set_memory_options(uint64_t *ram_slots, ram_addr_t *maxram_size,
2565 MachineClass *mc)
2567 uint64_t sz;
2568 const char *mem_str;
2569 const ram_addr_t default_ram_size = mc->default_ram_size;
2570 QemuOpts *opts = qemu_find_opts_singleton("memory");
2571 Location loc;
2573 loc_push_none(&loc);
2574 qemu_opts_loc_restore(opts);
2576 sz = 0;
2577 mem_str = qemu_opt_get(opts, "size");
2578 if (mem_str) {
2579 if (!*mem_str) {
2580 error_report("missing 'size' option value");
2581 exit(EXIT_FAILURE);
2584 sz = qemu_opt_get_size(opts, "size", ram_size);
2586 /* Fix up legacy suffix-less format */
2587 if (g_ascii_isdigit(mem_str[strlen(mem_str) - 1])) {
2588 uint64_t overflow_check = sz;
2590 sz *= MiB;
2591 if (sz / MiB != overflow_check) {
2592 error_report("too large 'size' option value");
2593 exit(EXIT_FAILURE);
2598 /* backward compatibility behaviour for case "-m 0" */
2599 if (sz == 0) {
2600 sz = default_ram_size;
2603 sz = QEMU_ALIGN_UP(sz, 8192);
2604 ram_size = sz;
2605 if (ram_size != sz) {
2606 error_report("ram size too large");
2607 exit(EXIT_FAILURE);
2610 /* store value for the future use */
2611 qemu_opt_set_number(opts, "size", ram_size, &error_abort);
2612 *maxram_size = ram_size;
2614 if (qemu_opt_get(opts, "maxmem")) {
2615 uint64_t slots;
2617 sz = qemu_opt_get_size(opts, "maxmem", 0);
2618 slots = qemu_opt_get_number(opts, "slots", 0);
2619 if (sz < ram_size) {
2620 error_report("invalid value of -m option maxmem: "
2621 "maximum memory size (0x%" PRIx64 ") must be at least "
2622 "the initial memory size (0x" RAM_ADDR_FMT ")",
2623 sz, ram_size);
2624 exit(EXIT_FAILURE);
2625 } else if (slots && sz == ram_size) {
2626 error_report("invalid value of -m option maxmem: "
2627 "memory slots were specified but maximum memory size "
2628 "(0x%" PRIx64 ") is equal to the initial memory size "
2629 "(0x" RAM_ADDR_FMT ")", sz, ram_size);
2630 exit(EXIT_FAILURE);
2633 *maxram_size = sz;
2634 *ram_slots = slots;
2635 } else if (qemu_opt_get(opts, "slots")) {
2636 error_report("invalid -m option value: missing 'maxmem' option");
2637 exit(EXIT_FAILURE);
2640 loc_pop(&loc);
2641 return !!mem_str;
2644 static int global_init_func(void *opaque, QemuOpts *opts, Error **errp)
2646 GlobalProperty *g;
2648 g = g_malloc0(sizeof(*g));
2649 g->driver = qemu_opt_get(opts, "driver");
2650 g->property = qemu_opt_get(opts, "property");
2651 g->value = qemu_opt_get(opts, "value");
2652 qdev_prop_register_global(g);
2653 return 0;
2656 static int qemu_read_default_config_file(void)
2658 int ret;
2660 ret = qemu_read_config_file(CONFIG_QEMU_CONFDIR "/qemu.conf");
2661 if (ret < 0 && ret != -ENOENT) {
2662 return ret;
2665 return 0;
2668 static void user_register_global_props(void)
2670 qemu_opts_foreach(qemu_find_opts("global"),
2671 global_init_func, NULL, NULL);
2674 static int do_configure_icount(void *opaque, QemuOpts *opts, Error **errp)
2676 configure_icount(opts, errp);
2677 return 0;
2680 static int accelerator_set_property(void *opaque,
2681 const char *name, const char *value,
2682 Error **errp)
2684 return object_parse_property_opt(opaque, name, value, "accel", errp);
2687 static int do_configure_accelerator(void *opaque, QemuOpts *opts, Error **errp)
2689 bool *p_init_failed = opaque;
2690 const char *acc = qemu_opt_get(opts, "accel");
2691 AccelClass *ac = accel_find(acc);
2692 AccelState *accel;
2693 int ret;
2695 if (!ac) {
2696 *p_init_failed = true;
2697 error_report("invalid accelerator %s", acc);
2698 return 0;
2700 accel = ACCEL(object_new_with_class(OBJECT_CLASS(ac)));
2701 object_apply_compat_props(OBJECT(accel));
2702 qemu_opt_foreach(opts, accelerator_set_property,
2703 accel,
2704 &error_fatal);
2706 ret = accel_init_machine(accel, current_machine);
2707 if (ret < 0) {
2708 *p_init_failed = true;
2709 error_report("failed to initialize %s: %s",
2710 acc, strerror(-ret));
2711 return 0;
2714 return 1;
2717 static void configure_accelerators(const char *progname)
2719 const char *accel;
2720 bool init_failed = false;
2722 qemu_opts_foreach(qemu_find_opts("icount"),
2723 do_configure_icount, NULL, &error_fatal);
2725 accel = qemu_opt_get(qemu_get_machine_opts(), "accel");
2726 if (QTAILQ_EMPTY(&qemu_accel_opts.head)) {
2727 char **accel_list, **tmp;
2729 if (accel == NULL) {
2730 /* Select the default accelerator */
2731 bool have_tcg = accel_find("tcg");
2732 bool have_kvm = accel_find("kvm");
2734 if (have_tcg && have_kvm) {
2735 if (g_str_has_suffix(progname, "kvm")) {
2736 /* If the program name ends with "kvm", we prefer KVM */
2737 accel = "kvm:tcg";
2738 } else {
2739 accel = "tcg:kvm";
2741 } else if (have_kvm) {
2742 accel = "kvm";
2743 } else if (have_tcg) {
2744 accel = "tcg";
2745 } else {
2746 error_report("No accelerator selected and"
2747 " no default accelerator available");
2748 exit(1);
2751 accel_list = g_strsplit(accel, ":", 0);
2753 for (tmp = accel_list; *tmp; tmp++) {
2755 * Filter invalid accelerators here, to prevent obscenities
2756 * such as "-machine accel=tcg,,thread=single".
2758 if (accel_find(*tmp)) {
2759 qemu_opts_parse_noisily(qemu_find_opts("accel"), *tmp, true);
2760 } else {
2761 init_failed = true;
2762 error_report("invalid accelerator %s", *tmp);
2765 g_strfreev(accel_list);
2766 } else {
2767 if (accel != NULL) {
2768 error_report("The -accel and \"-machine accel=\" options are incompatible");
2769 exit(1);
2773 if (!qemu_opts_foreach(qemu_find_opts("accel"),
2774 do_configure_accelerator, &init_failed, &error_fatal)) {
2775 if (!init_failed) {
2776 error_report("no accelerator found");
2778 exit(1);
2781 if (init_failed) {
2782 AccelClass *ac = ACCEL_GET_CLASS(current_accel());
2783 error_report("falling back to %s", ac->name);
2786 if (use_icount && !(tcg_enabled() || qtest_enabled())) {
2787 error_report("-icount is not allowed with hardware virtualization");
2788 exit(1);
2792 static void create_default_memdev(MachineState *ms, const char *path)
2794 Object *obj;
2795 MachineClass *mc = MACHINE_GET_CLASS(ms);
2797 obj = object_new(path ? TYPE_MEMORY_BACKEND_FILE : TYPE_MEMORY_BACKEND_RAM);
2798 if (path) {
2799 object_property_set_str(obj, path, "mem-path", &error_fatal);
2801 object_property_set_int(obj, ms->ram_size, "size", &error_fatal);
2802 object_property_add_child(object_get_objects_root(), mc->default_ram_id,
2803 obj, &error_fatal);
2804 user_creatable_complete(USER_CREATABLE(obj), &error_fatal);
2805 object_unref(obj);
2806 object_property_set_str(OBJECT(ms), mc->default_ram_id, "memory-backend",
2807 &error_fatal);
2810 void qemu_init(int argc, char **argv, char **envp)
2812 int i;
2813 int snapshot, linux_boot;
2814 const char *initrd_filename;
2815 const char *kernel_filename, *kernel_cmdline;
2816 const char *boot_order = NULL;
2817 const char *boot_once = NULL;
2818 DisplayState *ds;
2819 QemuOpts *opts, *machine_opts;
2820 QemuOpts *icount_opts = NULL, *accel_opts = NULL;
2821 QemuOptsList *olist;
2822 int optind;
2823 const char *optarg;
2824 const char *loadvm = NULL;
2825 MachineClass *machine_class;
2826 const char *cpu_option;
2827 const char *vga_model = NULL;
2828 const char *qtest_chrdev = NULL;
2829 const char *qtest_log = NULL;
2830 const char *incoming = NULL;
2831 bool userconfig = true;
2832 bool nographic = false;
2833 int display_remote = 0;
2834 const char *log_mask = NULL;
2835 const char *log_file = NULL;
2836 char *trace_file = NULL;
2837 ram_addr_t maxram_size;
2838 uint64_t ram_slots = 0;
2839 FILE *vmstate_dump_file = NULL;
2840 Error *main_loop_err = NULL;
2841 Error *err = NULL;
2842 bool list_data_dirs = false;
2843 char *dir, **dirs;
2844 const char *mem_path = NULL;
2845 bool have_custom_ram_size;
2846 BlockdevOptionsQueue bdo_queue = QSIMPLEQ_HEAD_INITIALIZER(bdo_queue);
2847 QemuPluginList plugin_list = QTAILQ_HEAD_INITIALIZER(plugin_list);
2848 int mem_prealloc = 0; /* force preallocation of physical target memory */
2850 os_set_line_buffering();
2852 error_init(argv[0]);
2853 module_call_init(MODULE_INIT_TRACE);
2855 qemu_init_cpu_list();
2856 qemu_init_cpu_loop();
2858 qemu_mutex_lock_iothread();
2860 atexit(qemu_run_exit_notifiers);
2861 qemu_init_exec_dir(argv[0]);
2863 module_call_init(MODULE_INIT_QOM);
2864 module_call_init(MODULE_INIT_MIGRATION);
2866 qemu_add_opts(&qemu_drive_opts);
2867 qemu_add_drive_opts(&qemu_legacy_drive_opts);
2868 qemu_add_drive_opts(&qemu_common_drive_opts);
2869 qemu_add_drive_opts(&qemu_drive_opts);
2870 qemu_add_drive_opts(&bdrv_runtime_opts);
2871 qemu_add_opts(&qemu_chardev_opts);
2872 qemu_add_opts(&qemu_device_opts);
2873 qemu_add_opts(&qemu_netdev_opts);
2874 qemu_add_opts(&qemu_nic_opts);
2875 qemu_add_opts(&qemu_net_opts);
2876 qemu_add_opts(&qemu_rtc_opts);
2877 qemu_add_opts(&qemu_global_opts);
2878 qemu_add_opts(&qemu_mon_opts);
2879 qemu_add_opts(&qemu_trace_opts);
2880 qemu_plugin_add_opts();
2881 qemu_add_opts(&qemu_option_rom_opts);
2882 qemu_add_opts(&qemu_machine_opts);
2883 qemu_add_opts(&qemu_accel_opts);
2884 qemu_add_opts(&qemu_mem_opts);
2885 qemu_add_opts(&qemu_smp_opts);
2886 qemu_add_opts(&qemu_boot_opts);
2887 qemu_add_opts(&qemu_add_fd_opts);
2888 qemu_add_opts(&qemu_object_opts);
2889 qemu_add_opts(&qemu_tpmdev_opts);
2890 qemu_add_opts(&qemu_realtime_opts);
2891 qemu_add_opts(&qemu_overcommit_opts);
2892 qemu_add_opts(&qemu_msg_opts);
2893 qemu_add_opts(&qemu_name_opts);
2894 qemu_add_opts(&qemu_numa_opts);
2895 qemu_add_opts(&qemu_icount_opts);
2896 qemu_add_opts(&qemu_semihosting_config_opts);
2897 qemu_add_opts(&qemu_fw_cfg_opts);
2898 module_call_init(MODULE_INIT_OPTS);
2900 runstate_init();
2901 precopy_infrastructure_init();
2902 postcopy_infrastructure_init();
2903 monitor_init_globals();
2905 if (qcrypto_init(&err) < 0) {
2906 error_reportf_err(err, "cannot initialize crypto: ");
2907 exit(1);
2910 QTAILQ_INIT(&vm_change_state_head);
2911 os_setup_early_signal_handling();
2913 cpu_option = NULL;
2914 snapshot = 0;
2916 nb_nics = 0;
2918 bdrv_init_with_whitelist();
2920 autostart = 1;
2922 /* first pass of option parsing */
2923 optind = 1;
2924 while (optind < argc) {
2925 if (argv[optind][0] != '-') {
2926 /* disk image */
2927 optind++;
2928 } else {
2929 const QEMUOption *popt;
2931 popt = lookup_opt(argc, argv, &optarg, &optind);
2932 switch (popt->index) {
2933 case QEMU_OPTION_nouserconfig:
2934 userconfig = false;
2935 break;
2940 if (userconfig) {
2941 if (qemu_read_default_config_file() < 0) {
2942 exit(1);
2946 /* second pass of option parsing */
2947 optind = 1;
2948 for(;;) {
2949 if (optind >= argc)
2950 break;
2951 if (argv[optind][0] != '-') {
2952 loc_set_cmdline(argv, optind, 1);
2953 drive_add(IF_DEFAULT, 0, argv[optind++], HD_OPTS);
2954 } else {
2955 const QEMUOption *popt;
2957 popt = lookup_opt(argc, argv, &optarg, &optind);
2958 if (!(popt->arch_mask & arch_type)) {
2959 error_report("Option not supported for this target");
2960 exit(1);
2962 switch(popt->index) {
2963 case QEMU_OPTION_cpu:
2964 /* hw initialization will check this */
2965 cpu_option = optarg;
2966 break;
2967 case QEMU_OPTION_hda:
2968 case QEMU_OPTION_hdb:
2969 case QEMU_OPTION_hdc:
2970 case QEMU_OPTION_hdd:
2971 drive_add(IF_DEFAULT, popt->index - QEMU_OPTION_hda, optarg,
2972 HD_OPTS);
2973 break;
2974 case QEMU_OPTION_blockdev:
2976 Visitor *v;
2977 BlockdevOptionsQueueEntry *bdo;
2979 v = qobject_input_visitor_new_str(optarg, "driver",
2980 &error_fatal);
2982 bdo = g_new(BlockdevOptionsQueueEntry, 1);
2983 visit_type_BlockdevOptions(v, NULL, &bdo->bdo,
2984 &error_fatal);
2985 visit_free(v);
2986 loc_save(&bdo->loc);
2987 QSIMPLEQ_INSERT_TAIL(&bdo_queue, bdo, entry);
2988 break;
2990 case QEMU_OPTION_drive:
2991 if (drive_def(optarg) == NULL) {
2992 exit(1);
2994 break;
2995 case QEMU_OPTION_set:
2996 if (qemu_set_option(optarg) != 0)
2997 exit(1);
2998 break;
2999 case QEMU_OPTION_global:
3000 if (qemu_global_option(optarg) != 0)
3001 exit(1);
3002 break;
3003 case QEMU_OPTION_mtdblock:
3004 drive_add(IF_MTD, -1, optarg, MTD_OPTS);
3005 break;
3006 case QEMU_OPTION_sd:
3007 drive_add(IF_SD, -1, optarg, SD_OPTS);
3008 break;
3009 case QEMU_OPTION_pflash:
3010 drive_add(IF_PFLASH, -1, optarg, PFLASH_OPTS);
3011 break;
3012 case QEMU_OPTION_snapshot:
3014 Error *blocker = NULL;
3015 snapshot = 1;
3016 error_setg(&blocker, QERR_REPLAY_NOT_SUPPORTED,
3017 "-snapshot");
3018 replay_add_blocker(blocker);
3020 break;
3021 case QEMU_OPTION_numa:
3022 opts = qemu_opts_parse_noisily(qemu_find_opts("numa"),
3023 optarg, true);
3024 if (!opts) {
3025 exit(1);
3027 break;
3028 case QEMU_OPTION_display:
3029 parse_display(optarg);
3030 break;
3031 case QEMU_OPTION_nographic:
3032 olist = qemu_find_opts("machine");
3033 qemu_opts_parse_noisily(olist, "graphics=off", false);
3034 nographic = true;
3035 dpy.type = DISPLAY_TYPE_NONE;
3036 break;
3037 case QEMU_OPTION_curses:
3038 #ifdef CONFIG_CURSES
3039 dpy.type = DISPLAY_TYPE_CURSES;
3040 #else
3041 error_report("curses or iconv support is disabled");
3042 exit(1);
3043 #endif
3044 break;
3045 case QEMU_OPTION_portrait:
3046 graphic_rotate = 90;
3047 break;
3048 case QEMU_OPTION_rotate:
3049 graphic_rotate = strtol(optarg, (char **) &optarg, 10);
3050 if (graphic_rotate != 0 && graphic_rotate != 90 &&
3051 graphic_rotate != 180 && graphic_rotate != 270) {
3052 error_report("only 90, 180, 270 deg rotation is available");
3053 exit(1);
3055 break;
3056 case QEMU_OPTION_kernel:
3057 qemu_opts_set(qemu_find_opts("machine"), 0, "kernel", optarg,
3058 &error_abort);
3059 break;
3060 case QEMU_OPTION_initrd:
3061 qemu_opts_set(qemu_find_opts("machine"), 0, "initrd", optarg,
3062 &error_abort);
3063 break;
3064 case QEMU_OPTION_append:
3065 qemu_opts_set(qemu_find_opts("machine"), 0, "append", optarg,
3066 &error_abort);
3067 break;
3068 case QEMU_OPTION_dtb:
3069 qemu_opts_set(qemu_find_opts("machine"), 0, "dtb", optarg,
3070 &error_abort);
3071 break;
3072 case QEMU_OPTION_cdrom:
3073 drive_add(IF_DEFAULT, 2, optarg, CDROM_OPTS);
3074 break;
3075 case QEMU_OPTION_boot:
3076 opts = qemu_opts_parse_noisily(qemu_find_opts("boot-opts"),
3077 optarg, true);
3078 if (!opts) {
3079 exit(1);
3081 break;
3082 case QEMU_OPTION_fda:
3083 case QEMU_OPTION_fdb:
3084 drive_add(IF_FLOPPY, popt->index - QEMU_OPTION_fda,
3085 optarg, FD_OPTS);
3086 break;
3087 case QEMU_OPTION_no_fd_bootchk:
3088 fd_bootchk = 0;
3089 break;
3090 case QEMU_OPTION_netdev:
3091 default_net = 0;
3092 if (net_client_parse(qemu_find_opts("netdev"), optarg) == -1) {
3093 exit(1);
3095 break;
3096 case QEMU_OPTION_nic:
3097 default_net = 0;
3098 if (net_client_parse(qemu_find_opts("nic"), optarg) == -1) {
3099 exit(1);
3101 break;
3102 case QEMU_OPTION_net:
3103 default_net = 0;
3104 if (net_client_parse(qemu_find_opts("net"), optarg) == -1) {
3105 exit(1);
3107 break;
3108 #ifdef CONFIG_LIBISCSI
3109 case QEMU_OPTION_iscsi:
3110 opts = qemu_opts_parse_noisily(qemu_find_opts("iscsi"),
3111 optarg, false);
3112 if (!opts) {
3113 exit(1);
3115 break;
3116 #endif
3117 case QEMU_OPTION_audio_help:
3118 audio_legacy_help();
3119 exit (0);
3120 break;
3121 case QEMU_OPTION_audiodev:
3122 audio_parse_option(optarg);
3123 break;
3124 case QEMU_OPTION_soundhw:
3125 select_soundhw (optarg);
3126 break;
3127 case QEMU_OPTION_h:
3128 help(0);
3129 break;
3130 case QEMU_OPTION_version:
3131 version();
3132 exit(0);
3133 break;
3134 case QEMU_OPTION_m:
3135 opts = qemu_opts_parse_noisily(qemu_find_opts("memory"),
3136 optarg, true);
3137 if (!opts) {
3138 exit(EXIT_FAILURE);
3140 break;
3141 #ifdef CONFIG_TPM
3142 case QEMU_OPTION_tpmdev:
3143 if (tpm_config_parse(qemu_find_opts("tpmdev"), optarg) < 0) {
3144 exit(1);
3146 break;
3147 #endif
3148 case QEMU_OPTION_mempath:
3149 mem_path = optarg;
3150 break;
3151 case QEMU_OPTION_mem_prealloc:
3152 mem_prealloc = 1;
3153 break;
3154 case QEMU_OPTION_d:
3155 log_mask = optarg;
3156 break;
3157 case QEMU_OPTION_D:
3158 log_file = optarg;
3159 break;
3160 case QEMU_OPTION_DFILTER:
3161 qemu_set_dfilter_ranges(optarg, &error_fatal);
3162 break;
3163 case QEMU_OPTION_seed:
3164 qemu_guest_random_seed_main(optarg, &error_fatal);
3165 break;
3166 case QEMU_OPTION_s:
3167 add_device_config(DEV_GDB, "tcp::" DEFAULT_GDBSTUB_PORT);
3168 break;
3169 case QEMU_OPTION_gdb:
3170 add_device_config(DEV_GDB, optarg);
3171 break;
3172 case QEMU_OPTION_L:
3173 if (is_help_option(optarg)) {
3174 list_data_dirs = true;
3175 } else {
3176 qemu_add_data_dir(optarg);
3178 break;
3179 case QEMU_OPTION_bios:
3180 qemu_opts_set(qemu_find_opts("machine"), 0, "firmware", optarg,
3181 &error_abort);
3182 break;
3183 case QEMU_OPTION_singlestep:
3184 singlestep = 1;
3185 break;
3186 case QEMU_OPTION_S:
3187 autostart = 0;
3188 break;
3189 case QEMU_OPTION_k:
3190 keyboard_layout = optarg;
3191 break;
3192 case QEMU_OPTION_vga:
3193 vga_model = optarg;
3194 default_vga = 0;
3195 break;
3196 case QEMU_OPTION_g:
3198 const char *p;
3199 int w, h, depth;
3200 p = optarg;
3201 w = strtol(p, (char **)&p, 10);
3202 if (w <= 0) {
3203 graphic_error:
3204 error_report("invalid resolution or depth");
3205 exit(1);
3207 if (*p != 'x')
3208 goto graphic_error;
3209 p++;
3210 h = strtol(p, (char **)&p, 10);
3211 if (h <= 0)
3212 goto graphic_error;
3213 if (*p == 'x') {
3214 p++;
3215 depth = strtol(p, (char **)&p, 10);
3216 if (depth != 1 && depth != 2 && depth != 4 &&
3217 depth != 8 && depth != 15 && depth != 16 &&
3218 depth != 24 && depth != 32)
3219 goto graphic_error;
3220 } else if (*p == '\0') {
3221 depth = graphic_depth;
3222 } else {
3223 goto graphic_error;
3226 graphic_width = w;
3227 graphic_height = h;
3228 graphic_depth = depth;
3230 break;
3231 case QEMU_OPTION_echr:
3233 char *r;
3234 term_escape_char = strtol(optarg, &r, 0);
3235 if (r == optarg)
3236 printf("Bad argument to echr\n");
3237 break;
3239 case QEMU_OPTION_monitor:
3240 default_monitor = 0;
3241 if (strncmp(optarg, "none", 4)) {
3242 monitor_parse(optarg, "readline", false);
3244 break;
3245 case QEMU_OPTION_qmp:
3246 monitor_parse(optarg, "control", false);
3247 default_monitor = 0;
3248 break;
3249 case QEMU_OPTION_qmp_pretty:
3250 monitor_parse(optarg, "control", true);
3251 default_monitor = 0;
3252 break;
3253 case QEMU_OPTION_mon:
3254 opts = qemu_opts_parse_noisily(qemu_find_opts("mon"), optarg,
3255 true);
3256 if (!opts) {
3257 exit(1);
3259 default_monitor = 0;
3260 break;
3261 case QEMU_OPTION_chardev:
3262 opts = qemu_opts_parse_noisily(qemu_find_opts("chardev"),
3263 optarg, true);
3264 if (!opts) {
3265 exit(1);
3267 break;
3268 case QEMU_OPTION_fsdev:
3269 olist = qemu_find_opts("fsdev");
3270 if (!olist) {
3271 error_report("fsdev support is disabled");
3272 exit(1);
3274 opts = qemu_opts_parse_noisily(olist, optarg, true);
3275 if (!opts) {
3276 exit(1);
3278 break;
3279 case QEMU_OPTION_virtfs: {
3280 QemuOpts *fsdev;
3281 QemuOpts *device;
3282 const char *writeout, *sock_fd, *socket, *path, *security_model,
3283 *multidevs;
3285 olist = qemu_find_opts("virtfs");
3286 if (!olist) {
3287 error_report("virtfs support is disabled");
3288 exit(1);
3290 opts = qemu_opts_parse_noisily(olist, optarg, true);
3291 if (!opts) {
3292 exit(1);
3295 if (qemu_opt_get(opts, "fsdriver") == NULL ||
3296 qemu_opt_get(opts, "mount_tag") == NULL) {
3297 error_report("Usage: -virtfs fsdriver,mount_tag=tag");
3298 exit(1);
3300 fsdev = qemu_opts_create(qemu_find_opts("fsdev"),
3301 qemu_opts_id(opts) ?:
3302 qemu_opt_get(opts, "mount_tag"),
3303 1, NULL);
3304 if (!fsdev) {
3305 error_report("duplicate or invalid fsdev id: %s",
3306 qemu_opt_get(opts, "mount_tag"));
3307 exit(1);
3310 writeout = qemu_opt_get(opts, "writeout");
3311 if (writeout) {
3312 #ifdef CONFIG_SYNC_FILE_RANGE
3313 qemu_opt_set(fsdev, "writeout", writeout, &error_abort);
3314 #else
3315 error_report("writeout=immediate not supported "
3316 "on this platform");
3317 exit(1);
3318 #endif
3320 qemu_opt_set(fsdev, "fsdriver",
3321 qemu_opt_get(opts, "fsdriver"), &error_abort);
3322 path = qemu_opt_get(opts, "path");
3323 if (path) {
3324 qemu_opt_set(fsdev, "path", path, &error_abort);
3326 security_model = qemu_opt_get(opts, "security_model");
3327 if (security_model) {
3328 qemu_opt_set(fsdev, "security_model", security_model,
3329 &error_abort);
3331 socket = qemu_opt_get(opts, "socket");
3332 if (socket) {
3333 qemu_opt_set(fsdev, "socket", socket, &error_abort);
3335 sock_fd = qemu_opt_get(opts, "sock_fd");
3336 if (sock_fd) {
3337 qemu_opt_set(fsdev, "sock_fd", sock_fd, &error_abort);
3340 qemu_opt_set_bool(fsdev, "readonly",
3341 qemu_opt_get_bool(opts, "readonly", 0),
3342 &error_abort);
3343 multidevs = qemu_opt_get(opts, "multidevs");
3344 if (multidevs) {
3345 qemu_opt_set(fsdev, "multidevs", multidevs, &error_abort);
3347 device = qemu_opts_create(qemu_find_opts("device"), NULL, 0,
3348 &error_abort);
3349 qemu_opt_set(device, "driver", "virtio-9p-pci", &error_abort);
3350 qemu_opt_set(device, "fsdev",
3351 qemu_opts_id(fsdev), &error_abort);
3352 qemu_opt_set(device, "mount_tag",
3353 qemu_opt_get(opts, "mount_tag"), &error_abort);
3354 break;
3356 case QEMU_OPTION_serial:
3357 add_device_config(DEV_SERIAL, optarg);
3358 default_serial = 0;
3359 if (strncmp(optarg, "mon:", 4) == 0) {
3360 default_monitor = 0;
3362 break;
3363 case QEMU_OPTION_watchdog:
3364 if (watchdog) {
3365 error_report("only one watchdog option may be given");
3366 exit(1);
3368 watchdog = optarg;
3369 break;
3370 case QEMU_OPTION_watchdog_action:
3371 if (select_watchdog_action(optarg) == -1) {
3372 error_report("unknown -watchdog-action parameter");
3373 exit(1);
3375 break;
3376 case QEMU_OPTION_parallel:
3377 add_device_config(DEV_PARALLEL, optarg);
3378 default_parallel = 0;
3379 if (strncmp(optarg, "mon:", 4) == 0) {
3380 default_monitor = 0;
3382 break;
3383 case QEMU_OPTION_debugcon:
3384 add_device_config(DEV_DEBUGCON, optarg);
3385 break;
3386 case QEMU_OPTION_loadvm:
3387 loadvm = optarg;
3388 break;
3389 case QEMU_OPTION_full_screen:
3390 dpy.has_full_screen = true;
3391 dpy.full_screen = true;
3392 break;
3393 case QEMU_OPTION_alt_grab:
3394 alt_grab = 1;
3395 break;
3396 case QEMU_OPTION_ctrl_grab:
3397 ctrl_grab = 1;
3398 break;
3399 case QEMU_OPTION_no_quit:
3400 dpy.has_window_close = true;
3401 dpy.window_close = false;
3402 break;
3403 case QEMU_OPTION_sdl:
3404 #ifdef CONFIG_SDL
3405 dpy.type = DISPLAY_TYPE_SDL;
3406 break;
3407 #else
3408 error_report("SDL support is disabled");
3409 exit(1);
3410 #endif
3411 case QEMU_OPTION_pidfile:
3412 pid_file = optarg;
3413 break;
3414 case QEMU_OPTION_win2k_hack:
3415 win2k_install_hack = 1;
3416 break;
3417 case QEMU_OPTION_acpitable:
3418 opts = qemu_opts_parse_noisily(qemu_find_opts("acpi"),
3419 optarg, true);
3420 if (!opts) {
3421 exit(1);
3423 acpi_table_add(opts, &error_fatal);
3424 break;
3425 case QEMU_OPTION_smbios:
3426 opts = qemu_opts_parse_noisily(qemu_find_opts("smbios"),
3427 optarg, false);
3428 if (!opts) {
3429 exit(1);
3431 smbios_entry_add(opts, &error_fatal);
3432 break;
3433 case QEMU_OPTION_fwcfg:
3434 opts = qemu_opts_parse_noisily(qemu_find_opts("fw_cfg"),
3435 optarg, true);
3436 if (opts == NULL) {
3437 exit(1);
3439 break;
3440 case QEMU_OPTION_preconfig:
3441 preconfig_exit_requested = false;
3442 break;
3443 case QEMU_OPTION_enable_kvm:
3444 olist = qemu_find_opts("machine");
3445 qemu_opts_parse_noisily(olist, "accel=kvm", false);
3446 break;
3447 case QEMU_OPTION_M:
3448 case QEMU_OPTION_machine:
3449 olist = qemu_find_opts("machine");
3450 opts = qemu_opts_parse_noisily(olist, optarg, true);
3451 if (!opts) {
3452 exit(1);
3454 break;
3455 case QEMU_OPTION_no_kvm:
3456 olist = qemu_find_opts("machine");
3457 qemu_opts_parse_noisily(olist, "accel=tcg", false);
3458 break;
3459 case QEMU_OPTION_accel:
3460 accel_opts = qemu_opts_parse_noisily(qemu_find_opts("accel"),
3461 optarg, true);
3462 optarg = qemu_opt_get(accel_opts, "accel");
3463 if (!optarg || is_help_option(optarg)) {
3464 printf("Accelerators supported in QEMU binary:\n");
3465 GSList *el, *accel_list = object_class_get_list(TYPE_ACCEL,
3466 false);
3467 for (el = accel_list; el; el = el->next) {
3468 gchar *typename = g_strdup(object_class_get_name(
3469 OBJECT_CLASS(el->data)));
3470 /* omit qtest which is used for tests only */
3471 if (g_strcmp0(typename, ACCEL_CLASS_NAME("qtest")) &&
3472 g_str_has_suffix(typename, ACCEL_CLASS_SUFFIX)) {
3473 gchar **optname = g_strsplit(typename,
3474 ACCEL_CLASS_SUFFIX, 0);
3475 printf("%s\n", optname[0]);
3476 g_strfreev(optname);
3478 g_free(typename);
3480 g_slist_free(accel_list);
3481 exit(0);
3483 if (optarg && strchr(optarg, ':')) {
3484 error_report("Don't use ':' with -accel, "
3485 "use -M accel=... for now instead");
3486 exit(1);
3488 break;
3489 case QEMU_OPTION_usb:
3490 olist = qemu_find_opts("machine");
3491 qemu_opts_parse_noisily(olist, "usb=on", false);
3492 break;
3493 case QEMU_OPTION_usbdevice:
3494 error_report("'-usbdevice' is deprecated, please use "
3495 "'-device usb-...' instead");
3496 olist = qemu_find_opts("machine");
3497 qemu_opts_parse_noisily(olist, "usb=on", false);
3498 add_device_config(DEV_USB, optarg);
3499 break;
3500 case QEMU_OPTION_device:
3501 if (!qemu_opts_parse_noisily(qemu_find_opts("device"),
3502 optarg, true)) {
3503 exit(1);
3505 break;
3506 case QEMU_OPTION_smp:
3507 if (!qemu_opts_parse_noisily(qemu_find_opts("smp-opts"),
3508 optarg, true)) {
3509 exit(1);
3511 break;
3512 case QEMU_OPTION_vnc:
3513 vnc_parse(optarg, &error_fatal);
3514 break;
3515 case QEMU_OPTION_no_acpi:
3516 acpi_enabled = 0;
3517 break;
3518 case QEMU_OPTION_no_hpet:
3519 no_hpet = 1;
3520 break;
3521 case QEMU_OPTION_no_reboot:
3522 no_reboot = 1;
3523 break;
3524 case QEMU_OPTION_no_shutdown:
3525 no_shutdown = 1;
3526 break;
3527 case QEMU_OPTION_show_cursor:
3528 warn_report("The -show-cursor option is deprecated, "
3529 "use -display {sdl,gtk},show-cursor=on instead");
3530 dpy.has_show_cursor = true;
3531 dpy.show_cursor = true;
3532 break;
3533 case QEMU_OPTION_uuid:
3534 if (qemu_uuid_parse(optarg, &qemu_uuid) < 0) {
3535 error_report("failed to parse UUID string: wrong format");
3536 exit(1);
3538 qemu_uuid_set = true;
3539 break;
3540 case QEMU_OPTION_option_rom:
3541 if (nb_option_roms >= MAX_OPTION_ROMS) {
3542 error_report("too many option ROMs");
3543 exit(1);
3545 opts = qemu_opts_parse_noisily(qemu_find_opts("option-rom"),
3546 optarg, true);
3547 if (!opts) {
3548 exit(1);
3550 option_rom[nb_option_roms].name = qemu_opt_get(opts, "romfile");
3551 option_rom[nb_option_roms].bootindex =
3552 qemu_opt_get_number(opts, "bootindex", -1);
3553 if (!option_rom[nb_option_roms].name) {
3554 error_report("Option ROM file is not specified");
3555 exit(1);
3557 nb_option_roms++;
3558 break;
3559 case QEMU_OPTION_semihosting:
3560 qemu_semihosting_enable();
3561 break;
3562 case QEMU_OPTION_semihosting_config:
3563 if (qemu_semihosting_config_options(optarg) != 0) {
3564 exit(1);
3566 break;
3567 case QEMU_OPTION_name:
3568 opts = qemu_opts_parse_noisily(qemu_find_opts("name"),
3569 optarg, true);
3570 if (!opts) {
3571 exit(1);
3573 break;
3574 case QEMU_OPTION_prom_env:
3575 if (nb_prom_envs >= MAX_PROM_ENVS) {
3576 error_report("too many prom variables");
3577 exit(1);
3579 prom_envs[nb_prom_envs] = optarg;
3580 nb_prom_envs++;
3581 break;
3582 case QEMU_OPTION_old_param:
3583 old_param = 1;
3584 break;
3585 case QEMU_OPTION_rtc:
3586 opts = qemu_opts_parse_noisily(qemu_find_opts("rtc"), optarg,
3587 false);
3588 if (!opts) {
3589 exit(1);
3591 break;
3592 case QEMU_OPTION_tb_size:
3593 #ifndef CONFIG_TCG
3594 error_report("TCG is disabled");
3595 exit(1);
3596 #endif
3597 warn_report("The -tb-size option is deprecated, use -accel tcg,tb-size instead");
3598 object_register_sugar_prop(ACCEL_CLASS_NAME("tcg"), "tb-size", optarg);
3599 break;
3600 case QEMU_OPTION_icount:
3601 icount_opts = qemu_opts_parse_noisily(qemu_find_opts("icount"),
3602 optarg, true);
3603 if (!icount_opts) {
3604 exit(1);
3606 break;
3607 case QEMU_OPTION_incoming:
3608 if (!incoming) {
3609 runstate_set(RUN_STATE_INMIGRATE);
3611 incoming = optarg;
3612 break;
3613 case QEMU_OPTION_only_migratable:
3614 only_migratable = 1;
3615 break;
3616 case QEMU_OPTION_nodefaults:
3617 has_defaults = 0;
3618 break;
3619 case QEMU_OPTION_xen_domid:
3620 if (!(xen_available())) {
3621 error_report("Option not supported for this target");
3622 exit(1);
3624 xen_domid = atoi(optarg);
3625 break;
3626 case QEMU_OPTION_xen_attach:
3627 if (!(xen_available())) {
3628 error_report("Option not supported for this target");
3629 exit(1);
3631 xen_mode = XEN_ATTACH;
3632 break;
3633 case QEMU_OPTION_xen_domid_restrict:
3634 if (!(xen_available())) {
3635 error_report("Option not supported for this target");
3636 exit(1);
3638 xen_domid_restrict = true;
3639 break;
3640 case QEMU_OPTION_trace:
3641 g_free(trace_file);
3642 trace_file = trace_opt_parse(optarg);
3643 break;
3644 case QEMU_OPTION_plugin:
3645 qemu_plugin_opt_parse(optarg, &plugin_list);
3646 break;
3647 case QEMU_OPTION_readconfig:
3649 int ret = qemu_read_config_file(optarg);
3650 if (ret < 0) {
3651 error_report("read config %s: %s", optarg,
3652 strerror(-ret));
3653 exit(1);
3655 break;
3657 case QEMU_OPTION_spice:
3658 olist = qemu_find_opts("spice");
3659 if (!olist) {
3660 error_report("spice support is disabled");
3661 exit(1);
3663 opts = qemu_opts_parse_noisily(olist, optarg, false);
3664 if (!opts) {
3665 exit(1);
3667 display_remote++;
3668 break;
3669 case QEMU_OPTION_writeconfig:
3671 FILE *fp;
3672 if (strcmp(optarg, "-") == 0) {
3673 fp = stdout;
3674 } else {
3675 fp = fopen(optarg, "w");
3676 if (fp == NULL) {
3677 error_report("open %s: %s", optarg,
3678 strerror(errno));
3679 exit(1);
3682 qemu_config_write(fp);
3683 if (fp != stdout) {
3684 fclose(fp);
3686 break;
3688 case QEMU_OPTION_qtest:
3689 qtest_chrdev = optarg;
3690 break;
3691 case QEMU_OPTION_qtest_log:
3692 qtest_log = optarg;
3693 break;
3694 case QEMU_OPTION_sandbox:
3695 olist = qemu_find_opts("sandbox");
3696 if (!olist) {
3697 #ifndef CONFIG_SECCOMP
3698 error_report("-sandbox support is not enabled "
3699 "in this QEMU binary");
3700 #endif
3701 exit(1);
3704 opts = qemu_opts_parse_noisily(olist, optarg, true);
3705 if (!opts) {
3706 exit(1);
3708 break;
3709 case QEMU_OPTION_add_fd:
3710 #ifndef _WIN32
3711 opts = qemu_opts_parse_noisily(qemu_find_opts("add-fd"),
3712 optarg, false);
3713 if (!opts) {
3714 exit(1);
3716 #else
3717 error_report("File descriptor passing is disabled on this "
3718 "platform");
3719 exit(1);
3720 #endif
3721 break;
3722 case QEMU_OPTION_object:
3723 opts = qemu_opts_parse_noisily(qemu_find_opts("object"),
3724 optarg, true);
3725 if (!opts) {
3726 exit(1);
3728 break;
3729 case QEMU_OPTION_realtime:
3730 warn_report("'-realtime mlock=...' is deprecated, please use "
3731 "'-overcommit mem-lock=...' instead");
3732 opts = qemu_opts_parse_noisily(qemu_find_opts("realtime"),
3733 optarg, false);
3734 if (!opts) {
3735 exit(1);
3737 /* Don't override the -overcommit option if set */
3738 enable_mlock = enable_mlock ||
3739 qemu_opt_get_bool(opts, "mlock", true);
3740 break;
3741 case QEMU_OPTION_overcommit:
3742 opts = qemu_opts_parse_noisily(qemu_find_opts("overcommit"),
3743 optarg, false);
3744 if (!opts) {
3745 exit(1);
3747 /* Don't override the -realtime option if set */
3748 enable_mlock = enable_mlock ||
3749 qemu_opt_get_bool(opts, "mem-lock", false);
3750 enable_cpu_pm = qemu_opt_get_bool(opts, "cpu-pm", false);
3751 break;
3752 case QEMU_OPTION_msg:
3753 opts = qemu_opts_parse_noisily(qemu_find_opts("msg"), optarg,
3754 false);
3755 if (!opts) {
3756 exit(1);
3758 configure_msg(opts);
3759 break;
3760 case QEMU_OPTION_dump_vmstate:
3761 if (vmstate_dump_file) {
3762 error_report("only one '-dump-vmstate' "
3763 "option may be given");
3764 exit(1);
3766 vmstate_dump_file = fopen(optarg, "w");
3767 if (vmstate_dump_file == NULL) {
3768 error_report("open %s: %s", optarg, strerror(errno));
3769 exit(1);
3771 break;
3772 case QEMU_OPTION_enable_sync_profile:
3773 qsp_enable();
3774 break;
3775 case QEMU_OPTION_nouserconfig:
3776 /* Nothing to be parsed here. Especially, do not error out below. */
3777 break;
3778 default:
3779 if (os_parse_cmd_args(popt->index, optarg)) {
3780 error_report("Option not supported in this build");
3781 exit(1);
3787 * Clear error location left behind by the loop.
3788 * Best done right after the loop. Do not insert code here!
3790 loc_set_none();
3792 user_register_global_props();
3794 replay_configure(icount_opts);
3796 if (incoming && !preconfig_exit_requested) {
3797 error_report("'preconfig' and 'incoming' options are "
3798 "mutually exclusive");
3799 exit(EXIT_FAILURE);
3802 configure_rtc(qemu_find_opts_singleton("rtc"));
3804 machine_class = select_machine();
3805 object_set_machine_compat_props(machine_class->compat_props);
3807 have_custom_ram_size = set_memory_options(&ram_slots, &maxram_size,
3808 machine_class);
3810 os_daemonize();
3813 * If QTest is enabled, keep the rcu_atfork enabled, since system processes
3814 * may be forked testing purposes (e.g. fork-server based fuzzing) The fork
3815 * should happen before a signle cpu instruction is executed, to prevent
3816 * deadlocks. See commit 73c6e40, rcu: "completely disable pthread_atfork
3817 * callbacks as soon as possible"
3819 if (!qtest_enabled()) {
3820 rcu_disable_atfork();
3823 if (pid_file && !qemu_write_pidfile(pid_file, &err)) {
3824 error_reportf_err(err, "cannot create PID file: ");
3825 exit(1);
3828 qemu_unlink_pidfile_notifier.notify = qemu_unlink_pidfile;
3829 qemu_add_exit_notifier(&qemu_unlink_pidfile_notifier);
3831 if (qemu_init_main_loop(&main_loop_err)) {
3832 error_report_err(main_loop_err);
3833 exit(1);
3836 #ifdef CONFIG_SECCOMP
3837 olist = qemu_find_opts_err("sandbox", NULL);
3838 if (olist) {
3839 qemu_opts_foreach(olist, parse_sandbox, NULL, &error_fatal);
3841 #endif
3843 qemu_opts_foreach(qemu_find_opts("name"),
3844 parse_name, NULL, &error_fatal);
3846 #ifndef _WIN32
3847 qemu_opts_foreach(qemu_find_opts("add-fd"),
3848 parse_add_fd, NULL, &error_fatal);
3850 qemu_opts_foreach(qemu_find_opts("add-fd"),
3851 cleanup_add_fd, NULL, &error_fatal);
3852 #endif
3854 current_machine = MACHINE(object_new_with_class(OBJECT_CLASS(machine_class)));
3855 if (machine_help_func(qemu_get_machine_opts(), current_machine)) {
3856 exit(0);
3858 object_property_add_child(object_get_root(), "machine",
3859 OBJECT(current_machine), &error_abort);
3860 object_property_add_child(container_get(OBJECT(current_machine),
3861 "/unattached"),
3862 "sysbus", OBJECT(sysbus_get_default()),
3863 NULL);
3865 if (machine_class->minimum_page_bits) {
3866 if (!set_preferred_target_page_bits(machine_class->minimum_page_bits)) {
3867 /* This would be a board error: specifying a minimum smaller than
3868 * a target's compile-time fixed setting.
3870 g_assert_not_reached();
3874 cpu_exec_init_all();
3876 if (machine_class->hw_version) {
3877 qemu_set_hw_version(machine_class->hw_version);
3880 if (cpu_option && is_help_option(cpu_option)) {
3881 list_cpus(cpu_option);
3882 exit(0);
3885 if (!trace_init_backends()) {
3886 exit(1);
3888 trace_init_file(trace_file);
3890 /* Open the logfile at this point and set the log mask if necessary.
3892 qemu_set_log_filename(log_file, &error_fatal);
3893 if (log_mask) {
3894 int mask;
3895 mask = qemu_str_to_log_mask(log_mask);
3896 if (!mask) {
3897 qemu_print_log_usage(stdout);
3898 exit(1);
3900 qemu_set_log(mask);
3901 } else {
3902 qemu_set_log(0);
3905 /* add configured firmware directories */
3906 dirs = g_strsplit(CONFIG_QEMU_FIRMWAREPATH, G_SEARCHPATH_SEPARATOR_S, 0);
3907 for (i = 0; dirs[i] != NULL; i++) {
3908 qemu_add_data_dir(dirs[i]);
3910 g_strfreev(dirs);
3912 /* try to find datadir relative to the executable path */
3913 dir = os_find_datadir();
3914 qemu_add_data_dir(dir);
3915 g_free(dir);
3917 /* add the datadir specified when building */
3918 qemu_add_data_dir(CONFIG_QEMU_DATADIR);
3920 /* -L help lists the data directories and exits. */
3921 if (list_data_dirs) {
3922 for (i = 0; i < data_dir_idx; i++) {
3923 printf("%s\n", data_dir[i]);
3925 exit(0);
3928 /* machine_class: default to UP */
3929 machine_class->max_cpus = machine_class->max_cpus ?: 1;
3930 machine_class->min_cpus = machine_class->min_cpus ?: 1;
3931 machine_class->default_cpus = machine_class->default_cpus ?: 1;
3933 /* default to machine_class->default_cpus */
3934 current_machine->smp.cpus = machine_class->default_cpus;
3935 current_machine->smp.max_cpus = machine_class->default_cpus;
3936 current_machine->smp.cores = 1;
3937 current_machine->smp.threads = 1;
3939 machine_class->smp_parse(current_machine,
3940 qemu_opts_find(qemu_find_opts("smp-opts"), NULL));
3942 /* sanity-check smp_cpus and max_cpus against machine_class */
3943 if (current_machine->smp.cpus < machine_class->min_cpus) {
3944 error_report("Invalid SMP CPUs %d. The min CPUs "
3945 "supported by machine '%s' is %d",
3946 current_machine->smp.cpus,
3947 machine_class->name, machine_class->min_cpus);
3948 exit(1);
3950 if (current_machine->smp.max_cpus > machine_class->max_cpus) {
3951 error_report("Invalid SMP CPUs %d. The max CPUs "
3952 "supported by machine '%s' is %d",
3953 current_machine->smp.max_cpus,
3954 machine_class->name, machine_class->max_cpus);
3955 exit(1);
3958 if (mem_prealloc) {
3959 char *val;
3961 val = g_strdup_printf("%d", current_machine->smp.cpus);
3962 object_register_sugar_prop("memory-backend", "prealloc-threads", val);
3963 g_free(val);
3964 object_register_sugar_prop("memory-backend", "prealloc", "on");
3968 * Get the default machine options from the machine if it is not already
3969 * specified either by the configuration file or by the command line.
3971 if (machine_class->default_machine_opts) {
3972 qemu_opts_set_defaults(qemu_find_opts("machine"),
3973 machine_class->default_machine_opts, 0);
3976 /* process plugin before CPUs are created, but once -smp has been parsed */
3977 if (qemu_plugin_load_list(&plugin_list)) {
3978 exit(1);
3981 qemu_opts_foreach(qemu_find_opts("device"),
3982 default_driver_check, NULL, NULL);
3983 qemu_opts_foreach(qemu_find_opts("global"),
3984 default_driver_check, NULL, NULL);
3986 if (!vga_model && !default_vga) {
3987 vga_interface_type = VGA_DEVICE;
3989 if (!has_defaults || machine_class->no_serial) {
3990 default_serial = 0;
3992 if (!has_defaults || machine_class->no_parallel) {
3993 default_parallel = 0;
3995 if (!has_defaults || machine_class->no_floppy) {
3996 default_floppy = 0;
3998 if (!has_defaults || machine_class->no_cdrom) {
3999 default_cdrom = 0;
4001 if (!has_defaults || machine_class->no_sdcard) {
4002 default_sdcard = 0;
4004 if (!has_defaults) {
4005 default_monitor = 0;
4006 default_net = 0;
4007 default_vga = 0;
4010 if (is_daemonized()) {
4011 if (!preconfig_exit_requested) {
4012 error_report("'preconfig' and 'daemonize' options are "
4013 "mutually exclusive");
4014 exit(EXIT_FAILURE);
4017 /* According to documentation and historically, -nographic redirects
4018 * serial port, parallel port and monitor to stdio, which does not work
4019 * with -daemonize. We can redirect these to null instead, but since
4020 * -nographic is legacy, let's just error out.
4021 * We disallow -nographic only if all other ports are not redirected
4022 * explicitly, to not break existing legacy setups which uses
4023 * -nographic _and_ redirects all ports explicitly - this is valid
4024 * usage, -nographic is just a no-op in this case.
4026 if (nographic
4027 && (default_parallel || default_serial || default_monitor)) {
4028 error_report("-nographic cannot be used with -daemonize");
4029 exit(1);
4031 #ifdef CONFIG_CURSES
4032 if (dpy.type == DISPLAY_TYPE_CURSES) {
4033 error_report("curses display cannot be used with -daemonize");
4034 exit(1);
4036 #endif
4039 if (nographic) {
4040 if (default_parallel)
4041 add_device_config(DEV_PARALLEL, "null");
4042 if (default_serial && default_monitor) {
4043 add_device_config(DEV_SERIAL, "mon:stdio");
4044 } else {
4045 if (default_serial)
4046 add_device_config(DEV_SERIAL, "stdio");
4047 if (default_monitor)
4048 monitor_parse("stdio", "readline", false);
4050 } else {
4051 if (default_serial)
4052 add_device_config(DEV_SERIAL, "vc:80Cx24C");
4053 if (default_parallel)
4054 add_device_config(DEV_PARALLEL, "vc:80Cx24C");
4055 if (default_monitor)
4056 monitor_parse("vc:80Cx24C", "readline", false);
4059 #if defined(CONFIG_VNC)
4060 if (!QTAILQ_EMPTY(&(qemu_find_opts("vnc")->head))) {
4061 display_remote++;
4063 #endif
4064 if (dpy.type == DISPLAY_TYPE_DEFAULT && !display_remote) {
4065 if (!qemu_display_find_default(&dpy)) {
4066 dpy.type = DISPLAY_TYPE_NONE;
4067 #if defined(CONFIG_VNC)
4068 vnc_parse("localhost:0,to=99,id=default", &error_abort);
4069 #endif
4072 if (dpy.type == DISPLAY_TYPE_DEFAULT) {
4073 dpy.type = DISPLAY_TYPE_NONE;
4076 if ((alt_grab || ctrl_grab) && dpy.type != DISPLAY_TYPE_SDL) {
4077 error_report("-alt-grab and -ctrl-grab are only valid "
4078 "for SDL, ignoring option");
4080 if (dpy.has_window_close &&
4081 (dpy.type != DISPLAY_TYPE_GTK && dpy.type != DISPLAY_TYPE_SDL)) {
4082 error_report("-no-quit is only valid for GTK and SDL, "
4083 "ignoring option");
4086 qemu_display_early_init(&dpy);
4087 qemu_console_early_init();
4089 if (dpy.has_gl && dpy.gl != DISPLAYGL_MODE_OFF && display_opengl == 0) {
4090 #if defined(CONFIG_OPENGL)
4091 error_report("OpenGL is not supported by the display");
4092 #else
4093 error_report("OpenGL support is disabled");
4094 #endif
4095 exit(1);
4098 page_size_init();
4099 socket_init();
4101 qemu_opts_foreach(qemu_find_opts("object"),
4102 user_creatable_add_opts_foreach,
4103 object_create_initial, &error_fatal);
4105 qemu_opts_foreach(qemu_find_opts("chardev"),
4106 chardev_init_func, NULL, &error_fatal);
4107 /* now chardevs have been created we may have semihosting to connect */
4108 qemu_semihosting_connect_chardevs();
4110 #ifdef CONFIG_VIRTFS
4111 qemu_opts_foreach(qemu_find_opts("fsdev"),
4112 fsdev_init_func, NULL, &error_fatal);
4113 #endif
4115 if (qemu_opts_foreach(qemu_find_opts("device"),
4116 device_help_func, NULL, NULL)) {
4117 exit(0);
4121 * Note: we need to create block backends before
4122 * machine_set_property(), so machine properties can refer to
4123 * them.
4125 configure_blockdev(&bdo_queue, machine_class, snapshot);
4127 machine_opts = qemu_get_machine_opts();
4128 qemu_opt_foreach(machine_opts, machine_set_property, current_machine,
4129 &error_fatal);
4132 * Note: uses machine properties such as kernel-irqchip, must run
4133 * after machine_set_property().
4135 configure_accelerators(argv[0]);
4138 * Beware, QOM objects created before this point miss global and
4139 * compat properties.
4141 * Global properties get set up by qdev_prop_register_global(),
4142 * called from user_register_global_props(), and certain option
4143 * desugaring. Also in CPU feature desugaring (buried in
4144 * parse_cpu_option()), which happens below this point, but may
4145 * only target the CPU type, which can only be created after
4146 * parse_cpu_option() returned the type.
4148 * Machine compat properties: object_set_machine_compat_props().
4149 * Accelerator compat props: object_set_accelerator_compat_props(),
4150 * called from configure_accelerator().
4153 if (!qtest_enabled() && machine_class->deprecation_reason) {
4154 error_report("Machine type '%s' is deprecated: %s",
4155 machine_class->name, machine_class->deprecation_reason);
4159 * Note: creates a QOM object, must run only after global and
4160 * compat properties have been set up.
4162 migration_object_init();
4164 if (qtest_chrdev) {
4165 qtest_server_init(qtest_chrdev, qtest_log, &error_fatal);
4168 machine_opts = qemu_get_machine_opts();
4169 kernel_filename = qemu_opt_get(machine_opts, "kernel");
4170 initrd_filename = qemu_opt_get(machine_opts, "initrd");
4171 kernel_cmdline = qemu_opt_get(machine_opts, "append");
4172 bios_name = qemu_opt_get(machine_opts, "firmware");
4174 opts = qemu_opts_find(qemu_find_opts("boot-opts"), NULL);
4175 if (opts) {
4176 boot_order = qemu_opt_get(opts, "order");
4177 if (boot_order) {
4178 validate_bootdevices(boot_order, &error_fatal);
4181 boot_once = qemu_opt_get(opts, "once");
4182 if (boot_once) {
4183 validate_bootdevices(boot_once, &error_fatal);
4186 boot_menu = qemu_opt_get_bool(opts, "menu", boot_menu);
4187 boot_strict = qemu_opt_get_bool(opts, "strict", false);
4190 if (!boot_order) {
4191 boot_order = machine_class->default_boot_order;
4194 if (!kernel_cmdline) {
4195 kernel_cmdline = "";
4196 current_machine->kernel_cmdline = (char *)kernel_cmdline;
4199 linux_boot = (kernel_filename != NULL);
4201 if (!linux_boot && *kernel_cmdline != '\0') {
4202 error_report("-append only allowed with -kernel option");
4203 exit(1);
4206 if (!linux_boot && initrd_filename != NULL) {
4207 error_report("-initrd only allowed with -kernel option");
4208 exit(1);
4211 if (semihosting_enabled() && !semihosting_get_argc() && kernel_filename) {
4212 /* fall back to the -kernel/-append */
4213 semihosting_arg_fallback(kernel_filename, kernel_cmdline);
4216 /* spice needs the timers to be initialized by this point */
4217 qemu_spice_init();
4219 cpu_ticks_init();
4221 if (default_net) {
4222 QemuOptsList *net = qemu_find_opts("net");
4223 qemu_opts_set(net, NULL, "type", "nic", &error_abort);
4224 #ifdef CONFIG_SLIRP
4225 qemu_opts_set(net, NULL, "type", "user", &error_abort);
4226 #endif
4229 if (net_init_clients(&err) < 0) {
4230 error_report_err(err);
4231 exit(1);
4234 qemu_opts_foreach(qemu_find_opts("object"),
4235 user_creatable_add_opts_foreach,
4236 object_create_delayed, &error_fatal);
4238 tpm_init();
4240 blk_mig_init();
4241 ram_mig_init();
4242 dirty_bitmap_mig_init();
4244 qemu_opts_foreach(qemu_find_opts("mon"),
4245 mon_init_func, NULL, &error_fatal);
4247 /* connect semihosting console input if requested */
4248 qemu_semihosting_console_init();
4250 if (foreach_device_config(DEV_SERIAL, serial_parse) < 0)
4251 exit(1);
4252 if (foreach_device_config(DEV_PARALLEL, parallel_parse) < 0)
4253 exit(1);
4254 if (foreach_device_config(DEV_DEBUGCON, debugcon_parse) < 0)
4255 exit(1);
4257 /* If no default VGA is requested, the default is "none". */
4258 if (default_vga) {
4259 vga_model = get_default_vga_model(machine_class);
4261 if (vga_model) {
4262 select_vgahw(machine_class, vga_model);
4265 if (watchdog) {
4266 i = select_watchdog(watchdog);
4267 if (i > 0)
4268 exit (i == 1 ? 1 : 0);
4271 /* This checkpoint is required by replay to separate prior clock
4272 reading from the other reads, because timer polling functions query
4273 clock values from the log. */
4274 replay_checkpoint(CHECKPOINT_INIT);
4275 qdev_machine_init();
4277 current_machine->boot_order = boot_order;
4279 /* parse features once if machine provides default cpu_type */
4280 current_machine->cpu_type = machine_class->default_cpu_type;
4281 if (cpu_option) {
4282 current_machine->cpu_type = parse_cpu_option(cpu_option);
4285 if (current_machine->ram_memdev_id) {
4286 Object *backend;
4287 ram_addr_t backend_size;
4289 backend = object_resolve_path_type(current_machine->ram_memdev_id,
4290 TYPE_MEMORY_BACKEND, NULL);
4291 backend_size = object_property_get_uint(backend, "size", &error_abort);
4292 if (have_custom_ram_size && backend_size != ram_size) {
4293 error_report("Size specified by -m option must match size of "
4294 "explicitly specified 'memory-backend' property");
4295 exit(EXIT_FAILURE);
4297 ram_size = backend_size;
4300 if (!xen_enabled()) {
4301 /* On 32-bit hosts, QEMU is limited by virtual address space */
4302 if (ram_size > (2047 << 20) && HOST_LONG_BITS == 32) {
4303 error_report("at most 2047 MB RAM can be simulated");
4304 exit(1);
4308 current_machine->ram_size = ram_size;
4309 current_machine->maxram_size = maxram_size;
4310 current_machine->ram_slots = ram_slots;
4312 parse_numa_opts(current_machine);
4314 if (machine_class->default_ram_id && current_machine->ram_size &&
4315 numa_uses_legacy_mem() && !current_machine->ram_memdev_id) {
4316 create_default_memdev(current_machine, mem_path);
4318 /* do monitor/qmp handling at preconfig state if requested */
4319 qemu_main_loop();
4321 audio_init_audiodevs();
4323 /* from here on runstate is RUN_STATE_PRELAUNCH */
4324 machine_run_board_init(current_machine);
4326 realtime_init();
4328 soundhw_init();
4330 if (hax_enabled()) {
4331 hax_sync_vcpus();
4334 qemu_opts_foreach(qemu_find_opts("fw_cfg"),
4335 parse_fw_cfg, fw_cfg_find(), &error_fatal);
4337 /* init USB devices */
4338 if (machine_usb(current_machine)) {
4339 if (foreach_device_config(DEV_USB, usb_parse) < 0)
4340 exit(1);
4343 /* init generic devices */
4344 rom_set_order_override(FW_CFG_ORDER_OVERRIDE_DEVICE);
4345 qemu_opts_foreach(qemu_find_opts("device"),
4346 device_init_func, NULL, &error_fatal);
4348 cpu_synchronize_all_post_init();
4350 rom_reset_order_override();
4352 /* Did we create any drives that we failed to create a device for? */
4353 drive_check_orphaned();
4355 /* Don't warn about the default network setup that you get if
4356 * no command line -net or -netdev options are specified. There
4357 * are two cases that we would otherwise complain about:
4358 * (1) board doesn't support a NIC but the implicit "-net nic"
4359 * requested one
4360 * (2) CONFIG_SLIRP not set, in which case the implicit "-net nic"
4361 * sets up a nic that isn't connected to anything.
4363 if (!default_net && (!qtest_enabled() || has_defaults)) {
4364 net_check_clients();
4367 if (boot_once) {
4368 qemu_boot_set(boot_once, &error_fatal);
4369 qemu_register_reset(restore_boot_order, g_strdup(boot_order));
4372 /* init local displays */
4373 ds = init_displaystate();
4374 qemu_display_init(ds, &dpy);
4376 /* must be after terminal init, SDL library changes signal handlers */
4377 os_setup_signal_handling();
4379 /* init remote displays */
4380 #ifdef CONFIG_VNC
4381 qemu_opts_foreach(qemu_find_opts("vnc"),
4382 vnc_init_func, NULL, &error_fatal);
4383 #endif
4385 if (using_spice) {
4386 qemu_spice_display_init();
4389 if (foreach_device_config(DEV_GDB, gdbserver_start) < 0) {
4390 exit(1);
4393 qdev_machine_creation_done();
4395 /* TODO: once all bus devices are qdevified, this should be done
4396 * when bus is created by qdev.c */
4398 * TODO: If we had a main 'reset container' that the whole system
4399 * lived in, we could reset that using the multi-phase reset
4400 * APIs. For the moment, we just reset the sysbus, which will cause
4401 * all devices hanging off it (and all their child buses, recursively)
4402 * to be reset. Note that this will *not* reset any Device objects
4403 * which are not attached to some part of the qbus tree!
4405 qemu_register_reset(resettable_cold_reset_fn, sysbus_get_default());
4406 qemu_run_machine_init_done_notifiers();
4408 if (rom_check_and_register_reset() != 0) {
4409 error_report("rom check and register reset failed");
4410 exit(1);
4413 replay_start();
4415 /* This checkpoint is required by replay to separate prior clock
4416 reading from the other reads, because timer polling functions query
4417 clock values from the log. */
4418 replay_checkpoint(CHECKPOINT_RESET);
4419 qemu_system_reset(SHUTDOWN_CAUSE_NONE);
4420 register_global_state();
4421 if (loadvm) {
4422 Error *local_err = NULL;
4423 if (load_snapshot(loadvm, &local_err) < 0) {
4424 error_report_err(local_err);
4425 autostart = 0;
4426 exit(1);
4429 if (replay_mode != REPLAY_MODE_NONE) {
4430 replay_vmstate_init();
4433 qdev_prop_check_globals();
4434 if (vmstate_dump_file) {
4435 /* dump and exit */
4436 dump_vmstate_json_to_file(vmstate_dump_file);
4437 exit(0);
4440 if (incoming) {
4441 Error *local_err = NULL;
4442 qemu_start_incoming_migration(incoming, &local_err);
4443 if (local_err) {
4444 error_reportf_err(local_err, "-incoming %s: ", incoming);
4445 exit(1);
4447 } else if (autostart) {
4448 vm_start();
4451 accel_setup_post(current_machine);
4452 os_setup_post();
4454 return;
4457 void qemu_cleanup(void)
4459 gdbserver_cleanup();
4462 * cleaning up the migration object cancels any existing migration
4463 * try to do this early so that it also stops using devices.
4465 migration_shutdown();
4468 * We must cancel all block jobs while the block layer is drained,
4469 * or cancelling will be affected by throttling and thus may block
4470 * for an extended period of time.
4471 * vm_shutdown() will bdrv_drain_all(), so we may as well include
4472 * it in the drained section.
4473 * We do not need to end this section, because we do not want any
4474 * requests happening from here on anyway.
4476 bdrv_drain_all_begin();
4478 /* No more vcpu or device emulation activity beyond this point */
4479 vm_shutdown();
4480 replay_finish();
4482 job_cancel_sync_all();
4483 bdrv_close_all();
4485 res_free();
4487 /* vhost-user must be cleaned up before chardevs. */
4488 tpm_cleanup();
4489 net_cleanup();
4490 audio_cleanup();
4491 monitor_cleanup();
4492 qemu_chr_cleanup();
4493 user_creatable_cleanup();
4494 /* TODO: unref root container, check all devices are ok */