vl.c: run preconfig loop before creating default RAM backend
[qemu/kevin.git] / softmmu / vl.c
blob055472da66fca7d1dc50309fca82ebea7be2dcb8
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 no_hpet = 0;
148 int fd_bootchk = 1;
149 static int no_reboot;
150 int no_shutdown = 0;
151 int graphic_rotate = 0;
152 const char *watchdog;
153 QEMUOptionRom option_rom[MAX_OPTION_ROMS];
154 int nb_option_roms;
155 int old_param = 0;
156 const char *qemu_name;
157 int alt_grab = 0;
158 int ctrl_grab = 0;
159 unsigned int nb_prom_envs = 0;
160 const char *prom_envs[MAX_PROM_ENVS];
161 int boot_menu;
162 bool boot_strict;
163 uint8_t *boot_splash_filedata;
164 int only_migratable; /* turn it off unless user states otherwise */
165 bool wakeup_suspend_enabled;
167 int icount_align_option;
169 /* The bytes in qemu_uuid are in the order specified by RFC4122, _not_ in the
170 * little-endian "wire format" described in the SMBIOS 2.6 specification.
172 QemuUUID qemu_uuid;
173 bool qemu_uuid_set;
175 static NotifierList exit_notifiers =
176 NOTIFIER_LIST_INITIALIZER(exit_notifiers);
178 static NotifierList machine_init_done_notifiers =
179 NOTIFIER_LIST_INITIALIZER(machine_init_done_notifiers);
181 bool xen_allowed;
182 uint32_t xen_domid;
183 enum xen_mode xen_mode = XEN_EMULATE;
184 bool xen_domid_restrict;
186 static int has_defaults = 1;
187 static int default_serial = 1;
188 static int default_parallel = 1;
189 static int default_monitor = 1;
190 static int default_floppy = 1;
191 static int default_cdrom = 1;
192 static int default_sdcard = 1;
193 static int default_vga = 1;
194 static int default_net = 1;
196 static struct {
197 const char *driver;
198 int *flag;
199 } default_list[] = {
200 { .driver = "isa-serial", .flag = &default_serial },
201 { .driver = "isa-parallel", .flag = &default_parallel },
202 { .driver = "isa-fdc", .flag = &default_floppy },
203 { .driver = "floppy", .flag = &default_floppy },
204 { .driver = "ide-cd", .flag = &default_cdrom },
205 { .driver = "ide-hd", .flag = &default_cdrom },
206 { .driver = "ide-drive", .flag = &default_cdrom },
207 { .driver = "scsi-cd", .flag = &default_cdrom },
208 { .driver = "scsi-hd", .flag = &default_cdrom },
209 { .driver = "VGA", .flag = &default_vga },
210 { .driver = "isa-vga", .flag = &default_vga },
211 { .driver = "cirrus-vga", .flag = &default_vga },
212 { .driver = "isa-cirrus-vga", .flag = &default_vga },
213 { .driver = "vmware-svga", .flag = &default_vga },
214 { .driver = "qxl-vga", .flag = &default_vga },
215 { .driver = "virtio-vga", .flag = &default_vga },
216 { .driver = "ati-vga", .flag = &default_vga },
217 { .driver = "vhost-user-vga", .flag = &default_vga },
220 static QemuOptsList qemu_rtc_opts = {
221 .name = "rtc",
222 .head = QTAILQ_HEAD_INITIALIZER(qemu_rtc_opts.head),
223 .merge_lists = true,
224 .desc = {
226 .name = "base",
227 .type = QEMU_OPT_STRING,
229 .name = "clock",
230 .type = QEMU_OPT_STRING,
232 .name = "driftfix",
233 .type = QEMU_OPT_STRING,
235 { /* end of list */ }
239 static QemuOptsList qemu_option_rom_opts = {
240 .name = "option-rom",
241 .implied_opt_name = "romfile",
242 .head = QTAILQ_HEAD_INITIALIZER(qemu_option_rom_opts.head),
243 .desc = {
245 .name = "bootindex",
246 .type = QEMU_OPT_NUMBER,
247 }, {
248 .name = "romfile",
249 .type = QEMU_OPT_STRING,
251 { /* end of list */ }
255 static QemuOptsList qemu_machine_opts = {
256 .name = "machine",
257 .implied_opt_name = "type",
258 .merge_lists = true,
259 .head = QTAILQ_HEAD_INITIALIZER(qemu_machine_opts.head),
260 .desc = {
262 * no elements => accept any
263 * sanity checking will happen later
264 * when setting machine properties
270 static QemuOptsList qemu_accel_opts = {
271 .name = "accel",
272 .implied_opt_name = "accel",
273 .head = QTAILQ_HEAD_INITIALIZER(qemu_accel_opts.head),
274 .desc = {
276 * no elements => accept any
277 * sanity checking will happen later
278 * when setting accelerator properties
284 static QemuOptsList qemu_boot_opts = {
285 .name = "boot-opts",
286 .implied_opt_name = "order",
287 .merge_lists = true,
288 .head = QTAILQ_HEAD_INITIALIZER(qemu_boot_opts.head),
289 .desc = {
291 .name = "order",
292 .type = QEMU_OPT_STRING,
293 }, {
294 .name = "once",
295 .type = QEMU_OPT_STRING,
296 }, {
297 .name = "menu",
298 .type = QEMU_OPT_BOOL,
299 }, {
300 .name = "splash",
301 .type = QEMU_OPT_STRING,
302 }, {
303 .name = "splash-time",
304 .type = QEMU_OPT_NUMBER,
305 }, {
306 .name = "reboot-timeout",
307 .type = QEMU_OPT_NUMBER,
308 }, {
309 .name = "strict",
310 .type = QEMU_OPT_BOOL,
312 { /*End of list */ }
316 static QemuOptsList qemu_add_fd_opts = {
317 .name = "add-fd",
318 .head = QTAILQ_HEAD_INITIALIZER(qemu_add_fd_opts.head),
319 .desc = {
321 .name = "fd",
322 .type = QEMU_OPT_NUMBER,
323 .help = "file descriptor of which a duplicate is added to fd set",
325 .name = "set",
326 .type = QEMU_OPT_NUMBER,
327 .help = "ID of the fd set to add fd to",
329 .name = "opaque",
330 .type = QEMU_OPT_STRING,
331 .help = "free-form string used to describe fd",
333 { /* end of list */ }
337 static QemuOptsList qemu_object_opts = {
338 .name = "object",
339 .implied_opt_name = "qom-type",
340 .head = QTAILQ_HEAD_INITIALIZER(qemu_object_opts.head),
341 .desc = {
346 static QemuOptsList qemu_tpmdev_opts = {
347 .name = "tpmdev",
348 .implied_opt_name = "type",
349 .head = QTAILQ_HEAD_INITIALIZER(qemu_tpmdev_opts.head),
350 .desc = {
351 /* options are defined in the TPM backends */
352 { /* end of list */ }
356 static QemuOptsList qemu_realtime_opts = {
357 .name = "realtime",
358 .head = QTAILQ_HEAD_INITIALIZER(qemu_realtime_opts.head),
359 .desc = {
361 .name = "mlock",
362 .type = QEMU_OPT_BOOL,
364 { /* end of list */ }
368 static QemuOptsList qemu_overcommit_opts = {
369 .name = "overcommit",
370 .head = QTAILQ_HEAD_INITIALIZER(qemu_overcommit_opts.head),
371 .desc = {
373 .name = "mem-lock",
374 .type = QEMU_OPT_BOOL,
377 .name = "cpu-pm",
378 .type = QEMU_OPT_BOOL,
380 { /* end of list */ }
384 static QemuOptsList qemu_msg_opts = {
385 .name = "msg",
386 .head = QTAILQ_HEAD_INITIALIZER(qemu_msg_opts.head),
387 .desc = {
389 .name = "timestamp",
390 .type = QEMU_OPT_BOOL,
392 { /* end of list */ }
396 static QemuOptsList qemu_name_opts = {
397 .name = "name",
398 .implied_opt_name = "guest",
399 .merge_lists = true,
400 .head = QTAILQ_HEAD_INITIALIZER(qemu_name_opts.head),
401 .desc = {
403 .name = "guest",
404 .type = QEMU_OPT_STRING,
405 .help = "Sets the name of the guest.\n"
406 "This name will be displayed in the SDL window caption.\n"
407 "The name will also be used for the VNC server",
408 }, {
409 .name = "process",
410 .type = QEMU_OPT_STRING,
411 .help = "Sets the name of the QEMU process, as shown in top etc",
412 }, {
413 .name = "debug-threads",
414 .type = QEMU_OPT_BOOL,
415 .help = "When enabled, name the individual threads; defaults off.\n"
416 "NOTE: The thread names are for debugging and not a\n"
417 "stable API.",
419 { /* End of list */ }
423 static QemuOptsList qemu_mem_opts = {
424 .name = "memory",
425 .implied_opt_name = "size",
426 .head = QTAILQ_HEAD_INITIALIZER(qemu_mem_opts.head),
427 .merge_lists = true,
428 .desc = {
430 .name = "size",
431 .type = QEMU_OPT_SIZE,
434 .name = "slots",
435 .type = QEMU_OPT_NUMBER,
438 .name = "maxmem",
439 .type = QEMU_OPT_SIZE,
441 { /* end of list */ }
445 static QemuOptsList qemu_icount_opts = {
446 .name = "icount",
447 .implied_opt_name = "shift",
448 .merge_lists = true,
449 .head = QTAILQ_HEAD_INITIALIZER(qemu_icount_opts.head),
450 .desc = {
452 .name = "shift",
453 .type = QEMU_OPT_STRING,
454 }, {
455 .name = "align",
456 .type = QEMU_OPT_BOOL,
457 }, {
458 .name = "sleep",
459 .type = QEMU_OPT_BOOL,
460 }, {
461 .name = "rr",
462 .type = QEMU_OPT_STRING,
463 }, {
464 .name = "rrfile",
465 .type = QEMU_OPT_STRING,
466 }, {
467 .name = "rrsnapshot",
468 .type = QEMU_OPT_STRING,
470 { /* end of list */ }
474 static QemuOptsList qemu_fw_cfg_opts = {
475 .name = "fw_cfg",
476 .implied_opt_name = "name",
477 .head = QTAILQ_HEAD_INITIALIZER(qemu_fw_cfg_opts.head),
478 .desc = {
480 .name = "name",
481 .type = QEMU_OPT_STRING,
482 .help = "Sets the fw_cfg name of the blob to be inserted",
483 }, {
484 .name = "file",
485 .type = QEMU_OPT_STRING,
486 .help = "Sets the name of the file from which "
487 "the fw_cfg blob will be loaded",
488 }, {
489 .name = "string",
490 .type = QEMU_OPT_STRING,
491 .help = "Sets content of the blob to be inserted from a string",
493 { /* end of list */ }
498 * Get machine options
500 * Returns: machine options (never null).
502 QemuOpts *qemu_get_machine_opts(void)
504 return qemu_find_opts_singleton("machine");
507 const char *qemu_get_vm_name(void)
509 return qemu_name;
512 static void res_free(void)
514 g_free(boot_splash_filedata);
515 boot_splash_filedata = NULL;
518 static int default_driver_check(void *opaque, QemuOpts *opts, Error **errp)
520 const char *driver = qemu_opt_get(opts, "driver");
521 int i;
523 if (!driver)
524 return 0;
525 for (i = 0; i < ARRAY_SIZE(default_list); i++) {
526 if (strcmp(default_list[i].driver, driver) != 0)
527 continue;
528 *(default_list[i].flag) = 0;
530 return 0;
533 /***********************************************************/
534 /* QEMU state */
536 static RunState current_run_state = RUN_STATE_PRECONFIG;
538 /* We use RUN_STATE__MAX but any invalid value will do */
539 static RunState vmstop_requested = RUN_STATE__MAX;
540 static QemuMutex vmstop_lock;
542 typedef struct {
543 RunState from;
544 RunState to;
545 } RunStateTransition;
547 static const RunStateTransition runstate_transitions_def[] = {
548 /* from -> to */
549 { RUN_STATE_PRECONFIG, RUN_STATE_PRELAUNCH },
550 /* Early switch to inmigrate state to allow -incoming CLI option work
551 * as it used to. TODO: delay actual switching to inmigrate state to
552 * the point after machine is built and remove this hack.
554 { RUN_STATE_PRECONFIG, RUN_STATE_INMIGRATE },
556 { RUN_STATE_DEBUG, RUN_STATE_RUNNING },
557 { RUN_STATE_DEBUG, RUN_STATE_FINISH_MIGRATE },
558 { RUN_STATE_DEBUG, RUN_STATE_PRELAUNCH },
560 { RUN_STATE_INMIGRATE, RUN_STATE_INTERNAL_ERROR },
561 { RUN_STATE_INMIGRATE, RUN_STATE_IO_ERROR },
562 { RUN_STATE_INMIGRATE, RUN_STATE_PAUSED },
563 { RUN_STATE_INMIGRATE, RUN_STATE_RUNNING },
564 { RUN_STATE_INMIGRATE, RUN_STATE_SHUTDOWN },
565 { RUN_STATE_INMIGRATE, RUN_STATE_SUSPENDED },
566 { RUN_STATE_INMIGRATE, RUN_STATE_WATCHDOG },
567 { RUN_STATE_INMIGRATE, RUN_STATE_GUEST_PANICKED },
568 { RUN_STATE_INMIGRATE, RUN_STATE_FINISH_MIGRATE },
569 { RUN_STATE_INMIGRATE, RUN_STATE_PRELAUNCH },
570 { RUN_STATE_INMIGRATE, RUN_STATE_POSTMIGRATE },
571 { RUN_STATE_INMIGRATE, RUN_STATE_COLO },
573 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PAUSED },
574 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_FINISH_MIGRATE },
575 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PRELAUNCH },
577 { RUN_STATE_IO_ERROR, RUN_STATE_RUNNING },
578 { RUN_STATE_IO_ERROR, RUN_STATE_FINISH_MIGRATE },
579 { RUN_STATE_IO_ERROR, RUN_STATE_PRELAUNCH },
581 { RUN_STATE_PAUSED, RUN_STATE_RUNNING },
582 { RUN_STATE_PAUSED, RUN_STATE_FINISH_MIGRATE },
583 { RUN_STATE_PAUSED, RUN_STATE_POSTMIGRATE },
584 { RUN_STATE_PAUSED, RUN_STATE_PRELAUNCH },
585 { RUN_STATE_PAUSED, RUN_STATE_COLO},
587 { RUN_STATE_POSTMIGRATE, RUN_STATE_RUNNING },
588 { RUN_STATE_POSTMIGRATE, RUN_STATE_FINISH_MIGRATE },
589 { RUN_STATE_POSTMIGRATE, RUN_STATE_PRELAUNCH },
591 { RUN_STATE_PRELAUNCH, RUN_STATE_RUNNING },
592 { RUN_STATE_PRELAUNCH, RUN_STATE_FINISH_MIGRATE },
593 { RUN_STATE_PRELAUNCH, RUN_STATE_INMIGRATE },
595 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_RUNNING },
596 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PAUSED },
597 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_POSTMIGRATE },
598 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PRELAUNCH },
599 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_COLO},
601 { RUN_STATE_RESTORE_VM, RUN_STATE_RUNNING },
602 { RUN_STATE_RESTORE_VM, RUN_STATE_PRELAUNCH },
604 { RUN_STATE_COLO, RUN_STATE_RUNNING },
606 { RUN_STATE_RUNNING, RUN_STATE_DEBUG },
607 { RUN_STATE_RUNNING, RUN_STATE_INTERNAL_ERROR },
608 { RUN_STATE_RUNNING, RUN_STATE_IO_ERROR },
609 { RUN_STATE_RUNNING, RUN_STATE_PAUSED },
610 { RUN_STATE_RUNNING, RUN_STATE_FINISH_MIGRATE },
611 { RUN_STATE_RUNNING, RUN_STATE_RESTORE_VM },
612 { RUN_STATE_RUNNING, RUN_STATE_SAVE_VM },
613 { RUN_STATE_RUNNING, RUN_STATE_SHUTDOWN },
614 { RUN_STATE_RUNNING, RUN_STATE_WATCHDOG },
615 { RUN_STATE_RUNNING, RUN_STATE_GUEST_PANICKED },
616 { RUN_STATE_RUNNING, RUN_STATE_COLO},
618 { RUN_STATE_SAVE_VM, RUN_STATE_RUNNING },
620 { RUN_STATE_SHUTDOWN, RUN_STATE_PAUSED },
621 { RUN_STATE_SHUTDOWN, RUN_STATE_FINISH_MIGRATE },
622 { RUN_STATE_SHUTDOWN, RUN_STATE_PRELAUNCH },
624 { RUN_STATE_DEBUG, RUN_STATE_SUSPENDED },
625 { RUN_STATE_RUNNING, RUN_STATE_SUSPENDED },
626 { RUN_STATE_SUSPENDED, RUN_STATE_RUNNING },
627 { RUN_STATE_SUSPENDED, RUN_STATE_FINISH_MIGRATE },
628 { RUN_STATE_SUSPENDED, RUN_STATE_PRELAUNCH },
629 { RUN_STATE_SUSPENDED, RUN_STATE_COLO},
631 { RUN_STATE_WATCHDOG, RUN_STATE_RUNNING },
632 { RUN_STATE_WATCHDOG, RUN_STATE_FINISH_MIGRATE },
633 { RUN_STATE_WATCHDOG, RUN_STATE_PRELAUNCH },
634 { RUN_STATE_WATCHDOG, RUN_STATE_COLO},
636 { RUN_STATE_GUEST_PANICKED, RUN_STATE_RUNNING },
637 { RUN_STATE_GUEST_PANICKED, RUN_STATE_FINISH_MIGRATE },
638 { RUN_STATE_GUEST_PANICKED, RUN_STATE_PRELAUNCH },
640 { RUN_STATE__MAX, RUN_STATE__MAX },
643 static bool runstate_valid_transitions[RUN_STATE__MAX][RUN_STATE__MAX];
645 bool runstate_check(RunState state)
647 return current_run_state == state;
650 bool runstate_store(char *str, size_t size)
652 const char *state = RunState_str(current_run_state);
653 size_t len = strlen(state) + 1;
655 if (len > size) {
656 return false;
658 memcpy(str, state, len);
659 return true;
662 static void runstate_init(void)
664 const RunStateTransition *p;
666 memset(&runstate_valid_transitions, 0, sizeof(runstate_valid_transitions));
667 for (p = &runstate_transitions_def[0]; p->from != RUN_STATE__MAX; p++) {
668 runstate_valid_transitions[p->from][p->to] = true;
671 qemu_mutex_init(&vmstop_lock);
674 /* This function will abort() on invalid state transitions */
675 void runstate_set(RunState new_state)
677 assert(new_state < RUN_STATE__MAX);
679 trace_runstate_set(current_run_state, RunState_str(current_run_state),
680 new_state, RunState_str(new_state));
682 if (current_run_state == new_state) {
683 return;
686 if (!runstate_valid_transitions[current_run_state][new_state]) {
687 error_report("invalid runstate transition: '%s' -> '%s'",
688 RunState_str(current_run_state),
689 RunState_str(new_state));
690 abort();
693 current_run_state = new_state;
696 int runstate_is_running(void)
698 return runstate_check(RUN_STATE_RUNNING);
701 bool runstate_needs_reset(void)
703 return runstate_check(RUN_STATE_INTERNAL_ERROR) ||
704 runstate_check(RUN_STATE_SHUTDOWN);
707 StatusInfo *qmp_query_status(Error **errp)
709 StatusInfo *info = g_malloc0(sizeof(*info));
711 info->running = runstate_is_running();
712 info->singlestep = singlestep;
713 info->status = current_run_state;
715 return info;
718 bool qemu_vmstop_requested(RunState *r)
720 qemu_mutex_lock(&vmstop_lock);
721 *r = vmstop_requested;
722 vmstop_requested = RUN_STATE__MAX;
723 qemu_mutex_unlock(&vmstop_lock);
724 return *r < RUN_STATE__MAX;
727 void qemu_system_vmstop_request_prepare(void)
729 qemu_mutex_lock(&vmstop_lock);
732 void qemu_system_vmstop_request(RunState state)
734 vmstop_requested = state;
735 qemu_mutex_unlock(&vmstop_lock);
736 qemu_notify_event();
739 /***********************************************************/
740 /* RTC reference time/date access */
741 static time_t qemu_ref_timedate(QEMUClockType clock)
743 time_t value = qemu_clock_get_ms(clock) / 1000;
744 switch (clock) {
745 case QEMU_CLOCK_REALTIME:
746 value -= rtc_realtime_clock_offset;
747 /* fall through */
748 case QEMU_CLOCK_VIRTUAL:
749 value += rtc_ref_start_datetime;
750 break;
751 case QEMU_CLOCK_HOST:
752 if (rtc_base_type == RTC_BASE_DATETIME) {
753 value -= rtc_host_datetime_offset;
755 break;
756 default:
757 assert(0);
759 return value;
762 void qemu_get_timedate(struct tm *tm, int offset)
764 time_t ti = qemu_ref_timedate(rtc_clock);
766 ti += offset;
768 switch (rtc_base_type) {
769 case RTC_BASE_DATETIME:
770 case RTC_BASE_UTC:
771 gmtime_r(&ti, tm);
772 break;
773 case RTC_BASE_LOCALTIME:
774 localtime_r(&ti, tm);
775 break;
779 int qemu_timedate_diff(struct tm *tm)
781 time_t seconds;
783 switch (rtc_base_type) {
784 case RTC_BASE_DATETIME:
785 case RTC_BASE_UTC:
786 seconds = mktimegm(tm);
787 break;
788 case RTC_BASE_LOCALTIME:
790 struct tm tmp = *tm;
791 tmp.tm_isdst = -1; /* use timezone to figure it out */
792 seconds = mktime(&tmp);
793 break;
795 default:
796 abort();
799 return seconds - qemu_ref_timedate(QEMU_CLOCK_HOST);
802 static void configure_rtc_base_datetime(const char *startdate)
804 time_t rtc_start_datetime;
805 struct tm tm;
807 if (sscanf(startdate, "%d-%d-%dT%d:%d:%d", &tm.tm_year, &tm.tm_mon,
808 &tm.tm_mday, &tm.tm_hour, &tm.tm_min, &tm.tm_sec) == 6) {
809 /* OK */
810 } else if (sscanf(startdate, "%d-%d-%d",
811 &tm.tm_year, &tm.tm_mon, &tm.tm_mday) == 3) {
812 tm.tm_hour = 0;
813 tm.tm_min = 0;
814 tm.tm_sec = 0;
815 } else {
816 goto date_fail;
818 tm.tm_year -= 1900;
819 tm.tm_mon--;
820 rtc_start_datetime = mktimegm(&tm);
821 if (rtc_start_datetime == -1) {
822 date_fail:
823 error_report("invalid datetime format");
824 error_printf("valid formats: "
825 "'2006-06-17T16:01:21' or '2006-06-17'\n");
826 exit(1);
828 rtc_host_datetime_offset = rtc_ref_start_datetime - rtc_start_datetime;
829 rtc_ref_start_datetime = rtc_start_datetime;
832 static void configure_rtc(QemuOpts *opts)
834 const char *value;
836 /* Set defaults */
837 rtc_clock = QEMU_CLOCK_HOST;
838 rtc_ref_start_datetime = qemu_clock_get_ms(QEMU_CLOCK_HOST) / 1000;
839 rtc_realtime_clock_offset = qemu_clock_get_ms(QEMU_CLOCK_REALTIME) / 1000;
841 value = qemu_opt_get(opts, "base");
842 if (value) {
843 if (!strcmp(value, "utc")) {
844 rtc_base_type = RTC_BASE_UTC;
845 } else if (!strcmp(value, "localtime")) {
846 Error *blocker = NULL;
847 rtc_base_type = RTC_BASE_LOCALTIME;
848 error_setg(&blocker, QERR_REPLAY_NOT_SUPPORTED,
849 "-rtc base=localtime");
850 replay_add_blocker(blocker);
851 } else {
852 rtc_base_type = RTC_BASE_DATETIME;
853 configure_rtc_base_datetime(value);
856 value = qemu_opt_get(opts, "clock");
857 if (value) {
858 if (!strcmp(value, "host")) {
859 rtc_clock = QEMU_CLOCK_HOST;
860 } else if (!strcmp(value, "rt")) {
861 rtc_clock = QEMU_CLOCK_REALTIME;
862 } else if (!strcmp(value, "vm")) {
863 rtc_clock = QEMU_CLOCK_VIRTUAL;
864 } else {
865 error_report("invalid option value '%s'", value);
866 exit(1);
869 value = qemu_opt_get(opts, "driftfix");
870 if (value) {
871 if (!strcmp(value, "slew")) {
872 object_register_sugar_prop("mc146818rtc",
873 "lost_tick_policy",
874 "slew");
875 } else if (!strcmp(value, "none")) {
876 /* discard is default */
877 } else {
878 error_report("invalid option value '%s'", value);
879 exit(1);
884 static int parse_name(void *opaque, QemuOpts *opts, Error **errp)
886 const char *proc_name;
888 if (qemu_opt_get(opts, "debug-threads")) {
889 qemu_thread_naming(qemu_opt_get_bool(opts, "debug-threads", false));
891 qemu_name = qemu_opt_get(opts, "guest");
893 proc_name = qemu_opt_get(opts, "process");
894 if (proc_name) {
895 os_set_proc_name(proc_name);
898 return 0;
901 bool defaults_enabled(void)
903 return has_defaults;
906 #ifndef _WIN32
907 static int parse_add_fd(void *opaque, QemuOpts *opts, Error **errp)
909 int fd, dupfd, flags;
910 int64_t fdset_id;
911 const char *fd_opaque = NULL;
912 AddfdInfo *fdinfo;
914 fd = qemu_opt_get_number(opts, "fd", -1);
915 fdset_id = qemu_opt_get_number(opts, "set", -1);
916 fd_opaque = qemu_opt_get(opts, "opaque");
918 if (fd < 0) {
919 error_setg(errp, "fd option is required and must be non-negative");
920 return -1;
923 if (fd <= STDERR_FILENO) {
924 error_setg(errp, "fd cannot be a standard I/O stream");
925 return -1;
929 * All fds inherited across exec() necessarily have FD_CLOEXEC
930 * clear, while qemu sets FD_CLOEXEC on all other fds used internally.
932 flags = fcntl(fd, F_GETFD);
933 if (flags == -1 || (flags & FD_CLOEXEC)) {
934 error_setg(errp, "fd is not valid or already in use");
935 return -1;
938 if (fdset_id < 0) {
939 error_setg(errp, "set option is required and must be non-negative");
940 return -1;
943 #ifdef F_DUPFD_CLOEXEC
944 dupfd = fcntl(fd, F_DUPFD_CLOEXEC, 0);
945 #else
946 dupfd = dup(fd);
947 if (dupfd != -1) {
948 qemu_set_cloexec(dupfd);
950 #endif
951 if (dupfd == -1) {
952 error_setg(errp, "error duplicating fd: %s", strerror(errno));
953 return -1;
956 /* add the duplicate fd, and optionally the opaque string, to the fd set */
957 fdinfo = monitor_fdset_add_fd(dupfd, true, fdset_id, !!fd_opaque, fd_opaque,
958 &error_abort);
959 g_free(fdinfo);
961 return 0;
964 static int cleanup_add_fd(void *opaque, QemuOpts *opts, Error **errp)
966 int fd;
968 fd = qemu_opt_get_number(opts, "fd", -1);
969 close(fd);
971 return 0;
973 #endif
975 /***********************************************************/
976 /* QEMU Block devices */
978 #define HD_OPTS "media=disk"
979 #define CDROM_OPTS "media=cdrom"
980 #define FD_OPTS ""
981 #define PFLASH_OPTS ""
982 #define MTD_OPTS ""
983 #define SD_OPTS ""
985 static int drive_init_func(void *opaque, QemuOpts *opts, Error **errp)
987 BlockInterfaceType *block_default_type = opaque;
989 return drive_new(opts, *block_default_type, errp) == NULL;
992 static int drive_enable_snapshot(void *opaque, QemuOpts *opts, Error **errp)
994 if (qemu_opt_get(opts, "snapshot") == NULL) {
995 qemu_opt_set(opts, "snapshot", "on", &error_abort);
997 return 0;
1000 static void default_drive(int enable, int snapshot, BlockInterfaceType type,
1001 int index, const char *optstr)
1003 QemuOpts *opts;
1004 DriveInfo *dinfo;
1006 if (!enable || drive_get_by_index(type, index)) {
1007 return;
1010 opts = drive_add(type, index, NULL, optstr);
1011 if (snapshot) {
1012 drive_enable_snapshot(NULL, opts, NULL);
1015 dinfo = drive_new(opts, type, &error_abort);
1016 dinfo->is_default = true;
1020 typedef struct BlockdevOptionsQueueEntry {
1021 BlockdevOptions *bdo;
1022 Location loc;
1023 QSIMPLEQ_ENTRY(BlockdevOptionsQueueEntry) entry;
1024 } BlockdevOptionsQueueEntry;
1026 typedef QSIMPLEQ_HEAD(, BlockdevOptionsQueueEntry) BlockdevOptionsQueue;
1028 static void configure_blockdev(BlockdevOptionsQueue *bdo_queue,
1029 MachineClass *machine_class, int snapshot)
1032 * If the currently selected machine wishes to override the
1033 * units-per-bus property of its default HBA interface type, do so
1034 * now.
1036 if (machine_class->units_per_default_bus) {
1037 override_max_devs(machine_class->block_default_type,
1038 machine_class->units_per_default_bus);
1041 /* open the virtual block devices */
1042 while (!QSIMPLEQ_EMPTY(bdo_queue)) {
1043 BlockdevOptionsQueueEntry *bdo = QSIMPLEQ_FIRST(bdo_queue);
1045 QSIMPLEQ_REMOVE_HEAD(bdo_queue, entry);
1046 loc_push_restore(&bdo->loc);
1047 qmp_blockdev_add(bdo->bdo, &error_fatal);
1048 loc_pop(&bdo->loc);
1049 qapi_free_BlockdevOptions(bdo->bdo);
1050 g_free(bdo);
1052 if (snapshot) {
1053 qemu_opts_foreach(qemu_find_opts("drive"), drive_enable_snapshot,
1054 NULL, NULL);
1056 if (qemu_opts_foreach(qemu_find_opts("drive"), drive_init_func,
1057 &machine_class->block_default_type, &error_fatal)) {
1058 /* We printed help */
1059 exit(0);
1062 default_drive(default_cdrom, snapshot, machine_class->block_default_type, 2,
1063 CDROM_OPTS);
1064 default_drive(default_floppy, snapshot, IF_FLOPPY, 0, FD_OPTS);
1065 default_drive(default_sdcard, snapshot, IF_SD, 0, SD_OPTS);
1069 static QemuOptsList qemu_smp_opts = {
1070 .name = "smp-opts",
1071 .implied_opt_name = "cpus",
1072 .merge_lists = true,
1073 .head = QTAILQ_HEAD_INITIALIZER(qemu_smp_opts.head),
1074 .desc = {
1076 .name = "cpus",
1077 .type = QEMU_OPT_NUMBER,
1078 }, {
1079 .name = "sockets",
1080 .type = QEMU_OPT_NUMBER,
1081 }, {
1082 .name = "dies",
1083 .type = QEMU_OPT_NUMBER,
1084 }, {
1085 .name = "cores",
1086 .type = QEMU_OPT_NUMBER,
1087 }, {
1088 .name = "threads",
1089 .type = QEMU_OPT_NUMBER,
1090 }, {
1091 .name = "maxcpus",
1092 .type = QEMU_OPT_NUMBER,
1094 { /*End of list */ }
1098 static void realtime_init(void)
1100 if (enable_mlock) {
1101 if (os_mlock() < 0) {
1102 error_report("locking memory failed");
1103 exit(1);
1109 static void configure_msg(QemuOpts *opts)
1111 error_with_timestamp = qemu_opt_get_bool(opts, "timestamp", false);
1115 /***********************************************************/
1116 /* USB devices */
1118 static int usb_device_add(const char *devname)
1120 USBDevice *dev = NULL;
1122 if (!machine_usb(current_machine)) {
1123 return -1;
1126 dev = usbdevice_create(devname);
1127 if (!dev)
1128 return -1;
1130 return 0;
1133 static int usb_parse(const char *cmdline)
1135 int r;
1136 r = usb_device_add(cmdline);
1137 if (r < 0) {
1138 error_report("could not add USB device '%s'", cmdline);
1140 return r;
1143 /***********************************************************/
1144 /* machine registration */
1146 MachineState *current_machine;
1148 static MachineClass *find_machine(const char *name, GSList *machines)
1150 GSList *el;
1152 for (el = machines; el; el = el->next) {
1153 MachineClass *mc = el->data;
1155 if (!strcmp(mc->name, name) || !g_strcmp0(mc->alias, name)) {
1156 return mc;
1160 return NULL;
1163 static MachineClass *find_default_machine(GSList *machines)
1165 GSList *el;
1166 MachineClass *default_machineclass = NULL;
1168 for (el = machines; el; el = el->next) {
1169 MachineClass *mc = el->data;
1171 if (mc->is_default) {
1172 assert(default_machineclass == NULL && "Multiple default machines");
1173 default_machineclass = mc;
1177 return default_machineclass;
1180 static int machine_help_func(QemuOpts *opts, MachineState *machine)
1182 ObjectProperty *prop;
1183 ObjectPropertyIterator iter;
1185 if (!qemu_opt_has_help_opt(opts)) {
1186 return 0;
1189 object_property_iter_init(&iter, OBJECT(machine));
1190 while ((prop = object_property_iter_next(&iter))) {
1191 if (!prop->set) {
1192 continue;
1195 printf("%s.%s=%s", MACHINE_GET_CLASS(machine)->name,
1196 prop->name, prop->type);
1197 if (prop->description) {
1198 printf(" (%s)\n", prop->description);
1199 } else {
1200 printf("\n");
1204 return 1;
1207 struct VMChangeStateEntry {
1208 VMChangeStateHandler *cb;
1209 void *opaque;
1210 QTAILQ_ENTRY(VMChangeStateEntry) entries;
1211 int priority;
1214 static QTAILQ_HEAD(, VMChangeStateEntry) vm_change_state_head;
1217 * qemu_add_vm_change_state_handler_prio:
1218 * @cb: the callback to invoke
1219 * @opaque: user data passed to the callback
1220 * @priority: low priorities execute first when the vm runs and the reverse is
1221 * true when the vm stops
1223 * Register a callback function that is invoked when the vm starts or stops
1224 * running.
1226 * Returns: an entry to be freed using qemu_del_vm_change_state_handler()
1228 VMChangeStateEntry *qemu_add_vm_change_state_handler_prio(
1229 VMChangeStateHandler *cb, void *opaque, int priority)
1231 VMChangeStateEntry *e;
1232 VMChangeStateEntry *other;
1234 e = g_malloc0(sizeof(*e));
1235 e->cb = cb;
1236 e->opaque = opaque;
1237 e->priority = priority;
1239 /* Keep list sorted in ascending priority order */
1240 QTAILQ_FOREACH(other, &vm_change_state_head, entries) {
1241 if (priority < other->priority) {
1242 QTAILQ_INSERT_BEFORE(other, e, entries);
1243 return e;
1247 QTAILQ_INSERT_TAIL(&vm_change_state_head, e, entries);
1248 return e;
1251 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb,
1252 void *opaque)
1254 return qemu_add_vm_change_state_handler_prio(cb, opaque, 0);
1257 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e)
1259 QTAILQ_REMOVE(&vm_change_state_head, e, entries);
1260 g_free(e);
1263 void vm_state_notify(int running, RunState state)
1265 VMChangeStateEntry *e, *next;
1267 trace_vm_state_notify(running, state, RunState_str(state));
1269 if (running) {
1270 QTAILQ_FOREACH_SAFE(e, &vm_change_state_head, entries, next) {
1271 e->cb(e->opaque, running, state);
1273 } else {
1274 QTAILQ_FOREACH_REVERSE_SAFE(e, &vm_change_state_head, entries, next) {
1275 e->cb(e->opaque, running, state);
1280 static ShutdownCause reset_requested;
1281 static ShutdownCause shutdown_requested;
1282 static int shutdown_signal;
1283 static pid_t shutdown_pid;
1284 static int powerdown_requested;
1285 static int debug_requested;
1286 static int suspend_requested;
1287 static bool preconfig_exit_requested = true;
1288 static WakeupReason wakeup_reason;
1289 static NotifierList powerdown_notifiers =
1290 NOTIFIER_LIST_INITIALIZER(powerdown_notifiers);
1291 static NotifierList suspend_notifiers =
1292 NOTIFIER_LIST_INITIALIZER(suspend_notifiers);
1293 static NotifierList wakeup_notifiers =
1294 NOTIFIER_LIST_INITIALIZER(wakeup_notifiers);
1295 static NotifierList shutdown_notifiers =
1296 NOTIFIER_LIST_INITIALIZER(shutdown_notifiers);
1297 static uint32_t wakeup_reason_mask = ~(1 << QEMU_WAKEUP_REASON_NONE);
1299 ShutdownCause qemu_shutdown_requested_get(void)
1301 return shutdown_requested;
1304 ShutdownCause qemu_reset_requested_get(void)
1306 return reset_requested;
1309 static int qemu_shutdown_requested(void)
1311 return atomic_xchg(&shutdown_requested, SHUTDOWN_CAUSE_NONE);
1314 static void qemu_kill_report(void)
1316 if (!qtest_driver() && shutdown_signal) {
1317 if (shutdown_pid == 0) {
1318 /* This happens for eg ^C at the terminal, so it's worth
1319 * avoiding printing an odd message in that case.
1321 error_report("terminating on signal %d", shutdown_signal);
1322 } else {
1323 char *shutdown_cmd = qemu_get_pid_name(shutdown_pid);
1325 error_report("terminating on signal %d from pid " FMT_pid " (%s)",
1326 shutdown_signal, shutdown_pid,
1327 shutdown_cmd ? shutdown_cmd : "<unknown process>");
1328 g_free(shutdown_cmd);
1330 shutdown_signal = 0;
1334 static ShutdownCause qemu_reset_requested(void)
1336 ShutdownCause r = reset_requested;
1338 if (r && replay_checkpoint(CHECKPOINT_RESET_REQUESTED)) {
1339 reset_requested = SHUTDOWN_CAUSE_NONE;
1340 return r;
1342 return SHUTDOWN_CAUSE_NONE;
1345 static int qemu_suspend_requested(void)
1347 int r = suspend_requested;
1348 if (r && replay_checkpoint(CHECKPOINT_SUSPEND_REQUESTED)) {
1349 suspend_requested = 0;
1350 return r;
1352 return false;
1355 static WakeupReason qemu_wakeup_requested(void)
1357 return wakeup_reason;
1360 static int qemu_powerdown_requested(void)
1362 int r = powerdown_requested;
1363 powerdown_requested = 0;
1364 return r;
1367 static int qemu_debug_requested(void)
1369 int r = debug_requested;
1370 debug_requested = 0;
1371 return r;
1374 void qemu_exit_preconfig_request(void)
1376 preconfig_exit_requested = true;
1380 * Reset the VM. Issue an event unless @reason is SHUTDOWN_CAUSE_NONE.
1382 void qemu_system_reset(ShutdownCause reason)
1384 MachineClass *mc;
1386 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
1388 cpu_synchronize_all_states();
1390 if (mc && mc->reset) {
1391 mc->reset(current_machine);
1392 } else {
1393 qemu_devices_reset();
1395 if (reason && reason != SHUTDOWN_CAUSE_SUBSYSTEM_RESET) {
1396 qapi_event_send_reset(shutdown_caused_by_guest(reason), reason);
1398 cpu_synchronize_all_post_reset();
1402 * Wake the VM after suspend.
1404 static void qemu_system_wakeup(void)
1406 MachineClass *mc;
1408 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
1410 if (mc && mc->wakeup) {
1411 mc->wakeup(current_machine);
1415 void qemu_system_guest_panicked(GuestPanicInformation *info)
1417 qemu_log_mask(LOG_GUEST_ERROR, "Guest crashed");
1419 if (current_cpu) {
1420 current_cpu->crash_occurred = true;
1422 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_PAUSE,
1423 !!info, info);
1424 vm_stop(RUN_STATE_GUEST_PANICKED);
1425 if (!no_shutdown) {
1426 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_POWEROFF,
1427 !!info, info);
1428 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_PANIC);
1431 if (info) {
1432 if (info->type == GUEST_PANIC_INFORMATION_TYPE_HYPER_V) {
1433 qemu_log_mask(LOG_GUEST_ERROR, "\nHV crash parameters: (%#"PRIx64
1434 " %#"PRIx64" %#"PRIx64" %#"PRIx64" %#"PRIx64")\n",
1435 info->u.hyper_v.arg1,
1436 info->u.hyper_v.arg2,
1437 info->u.hyper_v.arg3,
1438 info->u.hyper_v.arg4,
1439 info->u.hyper_v.arg5);
1440 } else if (info->type == GUEST_PANIC_INFORMATION_TYPE_S390) {
1441 qemu_log_mask(LOG_GUEST_ERROR, " on cpu %d: %s\n"
1442 "PSW: 0x%016" PRIx64 " 0x%016" PRIx64"\n",
1443 info->u.s390.core,
1444 S390CrashReason_str(info->u.s390.reason),
1445 info->u.s390.psw_mask,
1446 info->u.s390.psw_addr);
1448 qapi_free_GuestPanicInformation(info);
1452 void qemu_system_guest_crashloaded(GuestPanicInformation *info)
1454 qemu_log_mask(LOG_GUEST_ERROR, "Guest crash loaded");
1456 qapi_event_send_guest_crashloaded(GUEST_PANIC_ACTION_RUN,
1457 !!info, info);
1459 if (info) {
1460 qapi_free_GuestPanicInformation(info);
1464 void qemu_system_reset_request(ShutdownCause reason)
1466 if (no_reboot && reason != SHUTDOWN_CAUSE_SUBSYSTEM_RESET) {
1467 shutdown_requested = reason;
1468 } else {
1469 reset_requested = reason;
1471 cpu_stop_current();
1472 qemu_notify_event();
1475 static void qemu_system_suspend(void)
1477 pause_all_vcpus();
1478 notifier_list_notify(&suspend_notifiers, NULL);
1479 runstate_set(RUN_STATE_SUSPENDED);
1480 qapi_event_send_suspend();
1483 void qemu_system_suspend_request(void)
1485 if (runstate_check(RUN_STATE_SUSPENDED)) {
1486 return;
1488 suspend_requested = 1;
1489 cpu_stop_current();
1490 qemu_notify_event();
1493 void qemu_register_suspend_notifier(Notifier *notifier)
1495 notifier_list_add(&suspend_notifiers, notifier);
1498 void qemu_system_wakeup_request(WakeupReason reason, Error **errp)
1500 trace_system_wakeup_request(reason);
1502 if (!runstate_check(RUN_STATE_SUSPENDED)) {
1503 error_setg(errp,
1504 "Unable to wake up: guest is not in suspended state");
1505 return;
1507 if (!(wakeup_reason_mask & (1 << reason))) {
1508 return;
1510 runstate_set(RUN_STATE_RUNNING);
1511 wakeup_reason = reason;
1512 qemu_notify_event();
1515 void qemu_system_wakeup_enable(WakeupReason reason, bool enabled)
1517 if (enabled) {
1518 wakeup_reason_mask |= (1 << reason);
1519 } else {
1520 wakeup_reason_mask &= ~(1 << reason);
1524 void qemu_register_wakeup_notifier(Notifier *notifier)
1526 notifier_list_add(&wakeup_notifiers, notifier);
1529 void qemu_register_wakeup_support(void)
1531 wakeup_suspend_enabled = true;
1534 bool qemu_wakeup_suspend_enabled(void)
1536 return wakeup_suspend_enabled;
1539 void qemu_system_killed(int signal, pid_t pid)
1541 shutdown_signal = signal;
1542 shutdown_pid = pid;
1543 no_shutdown = 0;
1545 /* Cannot call qemu_system_shutdown_request directly because
1546 * we are in a signal handler.
1548 shutdown_requested = SHUTDOWN_CAUSE_HOST_SIGNAL;
1549 qemu_notify_event();
1552 void qemu_system_shutdown_request(ShutdownCause reason)
1554 trace_qemu_system_shutdown_request(reason);
1555 replay_shutdown_request(reason);
1556 shutdown_requested = reason;
1557 qemu_notify_event();
1560 static void qemu_system_powerdown(void)
1562 qapi_event_send_powerdown();
1563 notifier_list_notify(&powerdown_notifiers, NULL);
1566 static void qemu_system_shutdown(ShutdownCause cause)
1568 qapi_event_send_shutdown(shutdown_caused_by_guest(cause), cause);
1569 notifier_list_notify(&shutdown_notifiers, &cause);
1572 void qemu_system_powerdown_request(void)
1574 trace_qemu_system_powerdown_request();
1575 powerdown_requested = 1;
1576 qemu_notify_event();
1579 void qemu_register_powerdown_notifier(Notifier *notifier)
1581 notifier_list_add(&powerdown_notifiers, notifier);
1584 void qemu_register_shutdown_notifier(Notifier *notifier)
1586 notifier_list_add(&shutdown_notifiers, notifier);
1589 void qemu_system_debug_request(void)
1591 debug_requested = 1;
1592 qemu_notify_event();
1595 static bool main_loop_should_exit(void)
1597 RunState r;
1598 ShutdownCause request;
1600 if (preconfig_exit_requested) {
1601 if (runstate_check(RUN_STATE_PRECONFIG)) {
1602 runstate_set(RUN_STATE_PRELAUNCH);
1604 preconfig_exit_requested = false;
1605 return true;
1607 if (qemu_debug_requested()) {
1608 vm_stop(RUN_STATE_DEBUG);
1610 if (qemu_suspend_requested()) {
1611 qemu_system_suspend();
1613 request = qemu_shutdown_requested();
1614 if (request) {
1615 qemu_kill_report();
1616 qemu_system_shutdown(request);
1617 if (no_shutdown) {
1618 vm_stop(RUN_STATE_SHUTDOWN);
1619 } else {
1620 return true;
1623 request = qemu_reset_requested();
1624 if (request) {
1625 pause_all_vcpus();
1626 qemu_system_reset(request);
1627 resume_all_vcpus();
1629 * runstate can change in pause_all_vcpus()
1630 * as iothread mutex is unlocked
1632 if (!runstate_check(RUN_STATE_RUNNING) &&
1633 !runstate_check(RUN_STATE_INMIGRATE) &&
1634 !runstate_check(RUN_STATE_FINISH_MIGRATE)) {
1635 runstate_set(RUN_STATE_PRELAUNCH);
1638 if (qemu_wakeup_requested()) {
1639 pause_all_vcpus();
1640 qemu_system_wakeup();
1641 notifier_list_notify(&wakeup_notifiers, &wakeup_reason);
1642 wakeup_reason = QEMU_WAKEUP_REASON_NONE;
1643 resume_all_vcpus();
1644 qapi_event_send_wakeup();
1646 if (qemu_powerdown_requested()) {
1647 qemu_system_powerdown();
1649 if (qemu_vmstop_requested(&r)) {
1650 vm_stop(r);
1652 return false;
1655 void qemu_main_loop(void)
1657 #ifdef CONFIG_PROFILER
1658 int64_t ti;
1659 #endif
1660 while (!main_loop_should_exit()) {
1661 #ifdef CONFIG_PROFILER
1662 ti = profile_getclock();
1663 #endif
1664 main_loop_wait(false);
1665 #ifdef CONFIG_PROFILER
1666 dev_time += profile_getclock() - ti;
1667 #endif
1671 static void version(void)
1673 printf("QEMU emulator version " QEMU_FULL_VERSION "\n"
1674 QEMU_COPYRIGHT "\n");
1677 static void help(int exitcode)
1679 version();
1680 printf("usage: %s [options] [disk_image]\n\n"
1681 "'disk_image' is a raw hard disk image for IDE hard disk 0\n\n",
1682 error_get_progname());
1684 #define QEMU_OPTIONS_GENERATE_HELP
1685 #include "qemu-options-wrapper.h"
1687 printf("\nDuring emulation, the following keys are useful:\n"
1688 "ctrl-alt-f toggle full screen\n"
1689 "ctrl-alt-n switch to virtual console 'n'\n"
1690 "ctrl-alt toggle mouse and keyboard grab\n"
1691 "\n"
1692 "When using -nographic, press 'ctrl-a h' to get some help.\n"
1693 "\n"
1694 QEMU_HELP_BOTTOM "\n");
1696 exit(exitcode);
1699 #define HAS_ARG 0x0001
1701 typedef struct QEMUOption {
1702 const char *name;
1703 int flags;
1704 int index;
1705 uint32_t arch_mask;
1706 } QEMUOption;
1708 static const QEMUOption qemu_options[] = {
1709 { "h", 0, QEMU_OPTION_h, QEMU_ARCH_ALL },
1710 #define QEMU_OPTIONS_GENERATE_OPTIONS
1711 #include "qemu-options-wrapper.h"
1712 { NULL },
1715 typedef struct VGAInterfaceInfo {
1716 const char *opt_name; /* option name */
1717 const char *name; /* human-readable name */
1718 /* Class names indicating that support is available.
1719 * If no class is specified, the interface is always available */
1720 const char *class_names[2];
1721 } VGAInterfaceInfo;
1723 static const VGAInterfaceInfo vga_interfaces[VGA_TYPE_MAX] = {
1724 [VGA_NONE] = {
1725 .opt_name = "none",
1726 .name = "no graphic card",
1728 [VGA_STD] = {
1729 .opt_name = "std",
1730 .name = "standard VGA",
1731 .class_names = { "VGA", "isa-vga" },
1733 [VGA_CIRRUS] = {
1734 .opt_name = "cirrus",
1735 .name = "Cirrus VGA",
1736 .class_names = { "cirrus-vga", "isa-cirrus-vga" },
1738 [VGA_VMWARE] = {
1739 .opt_name = "vmware",
1740 .name = "VMWare SVGA",
1741 .class_names = { "vmware-svga" },
1743 [VGA_VIRTIO] = {
1744 .opt_name = "virtio",
1745 .name = "Virtio VGA",
1746 .class_names = { "virtio-vga" },
1748 [VGA_QXL] = {
1749 .opt_name = "qxl",
1750 .name = "QXL VGA",
1751 .class_names = { "qxl-vga" },
1753 [VGA_TCX] = {
1754 .opt_name = "tcx",
1755 .name = "TCX framebuffer",
1756 .class_names = { "SUNW,tcx" },
1758 [VGA_CG3] = {
1759 .opt_name = "cg3",
1760 .name = "CG3 framebuffer",
1761 .class_names = { "cgthree" },
1763 [VGA_XENFB] = {
1764 .opt_name = "xenfb",
1765 .name = "Xen paravirtualized framebuffer",
1769 static bool vga_interface_available(VGAInterfaceType t)
1771 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1773 assert(t < VGA_TYPE_MAX);
1774 return !ti->class_names[0] ||
1775 object_class_by_name(ti->class_names[0]) ||
1776 object_class_by_name(ti->class_names[1]);
1779 static const char *
1780 get_default_vga_model(const MachineClass *machine_class)
1782 if (machine_class->default_display) {
1783 return machine_class->default_display;
1784 } else if (vga_interface_available(VGA_CIRRUS)) {
1785 return "cirrus";
1786 } else if (vga_interface_available(VGA_STD)) {
1787 return "std";
1790 return NULL;
1793 static void select_vgahw(const MachineClass *machine_class, const char *p)
1795 const char *opts;
1796 int t;
1798 if (g_str_equal(p, "help")) {
1799 const char *def = get_default_vga_model(machine_class);
1801 for (t = 0; t < VGA_TYPE_MAX; t++) {
1802 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1804 if (vga_interface_available(t) && ti->opt_name) {
1805 printf("%-20s %s%s\n", ti->opt_name, ti->name ?: "",
1806 g_str_equal(ti->opt_name, def) ? " (default)" : "");
1809 exit(0);
1812 assert(vga_interface_type == VGA_NONE);
1813 for (t = 0; t < VGA_TYPE_MAX; t++) {
1814 const VGAInterfaceInfo *ti = &vga_interfaces[t];
1815 if (ti->opt_name && strstart(p, ti->opt_name, &opts)) {
1816 if (!vga_interface_available(t)) {
1817 error_report("%s not available", ti->name);
1818 exit(1);
1820 vga_interface_type = t;
1821 break;
1824 if (t == VGA_TYPE_MAX) {
1825 invalid_vga:
1826 error_report("unknown vga type: %s", p);
1827 exit(1);
1829 while (*opts) {
1830 const char *nextopt;
1832 if (strstart(opts, ",retrace=", &nextopt)) {
1833 opts = nextopt;
1834 if (strstart(opts, "dumb", &nextopt))
1835 vga_retrace_method = VGA_RETRACE_DUMB;
1836 else if (strstart(opts, "precise", &nextopt))
1837 vga_retrace_method = VGA_RETRACE_PRECISE;
1838 else goto invalid_vga;
1839 } else goto invalid_vga;
1840 opts = nextopt;
1844 static void parse_display_qapi(const char *optarg)
1846 DisplayOptions *opts;
1847 Visitor *v;
1849 v = qobject_input_visitor_new_str(optarg, "type", &error_fatal);
1851 visit_type_DisplayOptions(v, NULL, &opts, &error_fatal);
1852 QAPI_CLONE_MEMBERS(DisplayOptions, &dpy, opts);
1854 qapi_free_DisplayOptions(opts);
1855 visit_free(v);
1858 DisplayOptions *qmp_query_display_options(Error **errp)
1860 return QAPI_CLONE(DisplayOptions, &dpy);
1863 static void parse_display(const char *p)
1865 const char *opts;
1867 if (is_help_option(p)) {
1868 qemu_display_help();
1869 exit(0);
1872 if (strstart(p, "sdl", &opts)) {
1874 * sdl DisplayType needs hand-crafted parser instead of
1875 * parse_display_qapi() due to some options not in
1876 * DisplayOptions, specifically:
1877 * - frame
1878 * Already deprecated.
1879 * - ctrl_grab + alt_grab
1880 * Not clear yet what happens to them long-term. Should
1881 * replaced by something better or deprecated and dropped.
1883 dpy.type = DISPLAY_TYPE_SDL;
1884 while (*opts) {
1885 const char *nextopt;
1887 if (strstart(opts, ",alt_grab=", &nextopt)) {
1888 opts = nextopt;
1889 if (strstart(opts, "on", &nextopt)) {
1890 alt_grab = 1;
1891 } else if (strstart(opts, "off", &nextopt)) {
1892 alt_grab = 0;
1893 } else {
1894 goto invalid_sdl_args;
1896 } else if (strstart(opts, ",ctrl_grab=", &nextopt)) {
1897 opts = nextopt;
1898 if (strstart(opts, "on", &nextopt)) {
1899 ctrl_grab = 1;
1900 } else if (strstart(opts, "off", &nextopt)) {
1901 ctrl_grab = 0;
1902 } else {
1903 goto invalid_sdl_args;
1905 } else if (strstart(opts, ",window_close=", &nextopt)) {
1906 opts = nextopt;
1907 dpy.has_window_close = true;
1908 if (strstart(opts, "on", &nextopt)) {
1909 dpy.window_close = true;
1910 } else if (strstart(opts, "off", &nextopt)) {
1911 dpy.window_close = false;
1912 } else {
1913 goto invalid_sdl_args;
1915 } else if (strstart(opts, ",show-cursor=", &nextopt)) {
1916 opts = nextopt;
1917 dpy.has_show_cursor = true;
1918 if (strstart(opts, "on", &nextopt)) {
1919 dpy.show_cursor = true;
1920 } else if (strstart(opts, "off", &nextopt)) {
1921 dpy.show_cursor = false;
1922 } else {
1923 goto invalid_sdl_args;
1925 } else if (strstart(opts, ",gl=", &nextopt)) {
1926 opts = nextopt;
1927 dpy.has_gl = true;
1928 if (strstart(opts, "on", &nextopt)) {
1929 dpy.gl = DISPLAYGL_MODE_ON;
1930 } else if (strstart(opts, "core", &nextopt)) {
1931 dpy.gl = DISPLAYGL_MODE_CORE;
1932 } else if (strstart(opts, "es", &nextopt)) {
1933 dpy.gl = DISPLAYGL_MODE_ES;
1934 } else if (strstart(opts, "off", &nextopt)) {
1935 dpy.gl = DISPLAYGL_MODE_OFF;
1936 } else {
1937 goto invalid_sdl_args;
1939 } else {
1940 invalid_sdl_args:
1941 error_report("invalid SDL option string");
1942 exit(1);
1944 opts = nextopt;
1946 } else if (strstart(p, "vnc", &opts)) {
1948 * vnc isn't a (local) DisplayType but a protocol for remote
1949 * display access.
1951 if (*opts == '=') {
1952 vnc_parse(opts + 1, &error_fatal);
1953 } else {
1954 error_report("VNC requires a display argument vnc=<display>");
1955 exit(1);
1957 } else {
1958 parse_display_qapi(p);
1962 char *qemu_find_file(int type, const char *name)
1964 int i;
1965 const char *subdir;
1966 char *buf;
1968 /* Try the name as a straight path first */
1969 if (access(name, R_OK) == 0) {
1970 trace_load_file(name, name);
1971 return g_strdup(name);
1974 switch (type) {
1975 case QEMU_FILE_TYPE_BIOS:
1976 subdir = "";
1977 break;
1978 case QEMU_FILE_TYPE_KEYMAP:
1979 subdir = "keymaps/";
1980 break;
1981 default:
1982 abort();
1985 for (i = 0; i < data_dir_idx; i++) {
1986 buf = g_strdup_printf("%s/%s%s", data_dir[i], subdir, name);
1987 if (access(buf, R_OK) == 0) {
1988 trace_load_file(name, buf);
1989 return buf;
1991 g_free(buf);
1993 return NULL;
1996 void qemu_add_data_dir(const char *path)
1998 int i;
2000 if (path == NULL) {
2001 return;
2003 if (data_dir_idx == ARRAY_SIZE(data_dir)) {
2004 return;
2006 for (i = 0; i < data_dir_idx; i++) {
2007 if (strcmp(data_dir[i], path) == 0) {
2008 return; /* duplicate */
2011 data_dir[data_dir_idx++] = g_strdup(path);
2014 static inline bool nonempty_str(const char *str)
2016 return str && *str;
2019 static int parse_fw_cfg(void *opaque, QemuOpts *opts, Error **errp)
2021 gchar *buf;
2022 size_t size;
2023 const char *name, *file, *str;
2024 FWCfgState *fw_cfg = (FWCfgState *) opaque;
2026 if (fw_cfg == NULL) {
2027 error_setg(errp, "fw_cfg device not available");
2028 return -1;
2030 name = qemu_opt_get(opts, "name");
2031 file = qemu_opt_get(opts, "file");
2032 str = qemu_opt_get(opts, "string");
2034 /* we need name and either a file or the content string */
2035 if (!(nonempty_str(name) && (nonempty_str(file) || nonempty_str(str)))) {
2036 error_setg(errp, "invalid argument(s)");
2037 return -1;
2039 if (nonempty_str(file) && nonempty_str(str)) {
2040 error_setg(errp, "file and string are mutually exclusive");
2041 return -1;
2043 if (strlen(name) > FW_CFG_MAX_FILE_PATH - 1) {
2044 error_setg(errp, "name too long (max. %d char)",
2045 FW_CFG_MAX_FILE_PATH - 1);
2046 return -1;
2048 if (strncmp(name, "opt/", 4) != 0) {
2049 warn_report("externally provided fw_cfg item names "
2050 "should be prefixed with \"opt/\"");
2052 if (nonempty_str(str)) {
2053 size = strlen(str); /* NUL terminator NOT included in fw_cfg blob */
2054 buf = g_memdup(str, size);
2055 } else {
2056 GError *err = NULL;
2057 if (!g_file_get_contents(file, &buf, &size, &err)) {
2058 error_setg(errp, "can't load %s: %s", file, err->message);
2059 g_error_free(err);
2060 return -1;
2063 /* For legacy, keep user files in a specific global order. */
2064 fw_cfg_set_order_override(fw_cfg, FW_CFG_ORDER_OVERRIDE_USER);
2065 fw_cfg_add_file(fw_cfg, name, buf, size);
2066 fw_cfg_reset_order_override(fw_cfg);
2067 return 0;
2070 static int device_help_func(void *opaque, QemuOpts *opts, Error **errp)
2072 return qdev_device_help(opts);
2075 static int device_init_func(void *opaque, QemuOpts *opts, Error **errp)
2077 DeviceState *dev;
2079 dev = qdev_device_add(opts, errp);
2080 if (!dev && *errp) {
2081 error_report_err(*errp);
2082 return -1;
2083 } else if (dev) {
2084 object_unref(OBJECT(dev));
2086 return 0;
2089 static int chardev_init_func(void *opaque, QemuOpts *opts, Error **errp)
2091 Error *local_err = NULL;
2093 if (!qemu_chr_new_from_opts(opts, NULL, &local_err)) {
2094 if (local_err) {
2095 error_propagate(errp, local_err);
2096 return -1;
2098 exit(0);
2100 return 0;
2103 #ifdef CONFIG_VIRTFS
2104 static int fsdev_init_func(void *opaque, QemuOpts *opts, Error **errp)
2106 return qemu_fsdev_add(opts, errp);
2108 #endif
2110 static int mon_init_func(void *opaque, QemuOpts *opts, Error **errp)
2112 return monitor_init_opts(opts, errp);
2115 static void monitor_parse(const char *optarg, const char *mode, bool pretty)
2117 static int monitor_device_index = 0;
2118 QemuOpts *opts;
2119 const char *p;
2120 char label[32];
2122 if (strstart(optarg, "chardev:", &p)) {
2123 snprintf(label, sizeof(label), "%s", p);
2124 } else {
2125 snprintf(label, sizeof(label), "compat_monitor%d",
2126 monitor_device_index);
2127 opts = qemu_chr_parse_compat(label, optarg, true);
2128 if (!opts) {
2129 error_report("parse error: %s", optarg);
2130 exit(1);
2134 opts = qemu_opts_create(qemu_find_opts("mon"), label, 1, &error_fatal);
2135 qemu_opt_set(opts, "mode", mode, &error_abort);
2136 qemu_opt_set(opts, "chardev", label, &error_abort);
2137 if (!strcmp(mode, "control")) {
2138 qemu_opt_set_bool(opts, "pretty", pretty, &error_abort);
2139 } else {
2140 assert(pretty == false);
2142 monitor_device_index++;
2145 struct device_config {
2146 enum {
2147 DEV_USB, /* -usbdevice */
2148 DEV_SERIAL, /* -serial */
2149 DEV_PARALLEL, /* -parallel */
2150 DEV_DEBUGCON, /* -debugcon */
2151 DEV_GDB, /* -gdb, -s */
2152 DEV_SCLP, /* s390 sclp */
2153 } type;
2154 const char *cmdline;
2155 Location loc;
2156 QTAILQ_ENTRY(device_config) next;
2159 static QTAILQ_HEAD(, device_config) device_configs =
2160 QTAILQ_HEAD_INITIALIZER(device_configs);
2162 static void add_device_config(int type, const char *cmdline)
2164 struct device_config *conf;
2166 conf = g_malloc0(sizeof(*conf));
2167 conf->type = type;
2168 conf->cmdline = cmdline;
2169 loc_save(&conf->loc);
2170 QTAILQ_INSERT_TAIL(&device_configs, conf, next);
2173 static int foreach_device_config(int type, int (*func)(const char *cmdline))
2175 struct device_config *conf;
2176 int rc;
2178 QTAILQ_FOREACH(conf, &device_configs, next) {
2179 if (conf->type != type)
2180 continue;
2181 loc_push_restore(&conf->loc);
2182 rc = func(conf->cmdline);
2183 loc_pop(&conf->loc);
2184 if (rc) {
2185 return rc;
2188 return 0;
2191 static int serial_parse(const char *devname)
2193 int index = num_serial_hds;
2194 char label[32];
2196 if (strcmp(devname, "none") == 0)
2197 return 0;
2198 snprintf(label, sizeof(label), "serial%d", index);
2199 serial_hds = g_renew(Chardev *, serial_hds, index + 1);
2201 serial_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
2202 if (!serial_hds[index]) {
2203 error_report("could not connect serial device"
2204 " to character backend '%s'", devname);
2205 return -1;
2207 num_serial_hds++;
2208 return 0;
2211 Chardev *serial_hd(int i)
2213 assert(i >= 0);
2214 if (i < num_serial_hds) {
2215 return serial_hds[i];
2217 return NULL;
2220 int serial_max_hds(void)
2222 return num_serial_hds;
2225 static int parallel_parse(const char *devname)
2227 static int index = 0;
2228 char label[32];
2230 if (strcmp(devname, "none") == 0)
2231 return 0;
2232 if (index == MAX_PARALLEL_PORTS) {
2233 error_report("too many parallel ports");
2234 exit(1);
2236 snprintf(label, sizeof(label), "parallel%d", index);
2237 parallel_hds[index] = qemu_chr_new_mux_mon(label, devname, NULL);
2238 if (!parallel_hds[index]) {
2239 error_report("could not connect parallel device"
2240 " to character backend '%s'", devname);
2241 return -1;
2243 index++;
2244 return 0;
2247 static int debugcon_parse(const char *devname)
2249 QemuOpts *opts;
2251 if (!qemu_chr_new_mux_mon("debugcon", devname, NULL)) {
2252 error_report("invalid character backend '%s'", devname);
2253 exit(1);
2255 opts = qemu_opts_create(qemu_find_opts("device"), "debugcon", 1, NULL);
2256 if (!opts) {
2257 error_report("already have a debugcon device");
2258 exit(1);
2260 qemu_opt_set(opts, "driver", "isa-debugcon", &error_abort);
2261 qemu_opt_set(opts, "chardev", "debugcon", &error_abort);
2262 return 0;
2265 static gint machine_class_cmp(gconstpointer a, gconstpointer b)
2267 const MachineClass *mc1 = a, *mc2 = b;
2268 int res;
2270 if (mc1->family == NULL) {
2271 if (mc2->family == NULL) {
2272 /* Compare standalone machine types against each other; they sort
2273 * in increasing order.
2275 return strcmp(object_class_get_name(OBJECT_CLASS(mc1)),
2276 object_class_get_name(OBJECT_CLASS(mc2)));
2279 /* Standalone machine types sort after families. */
2280 return 1;
2283 if (mc2->family == NULL) {
2284 /* Families sort before standalone machine types. */
2285 return -1;
2288 /* Families sort between each other alphabetically increasingly. */
2289 res = strcmp(mc1->family, mc2->family);
2290 if (res != 0) {
2291 return res;
2294 /* Within the same family, machine types sort in decreasing order. */
2295 return strcmp(object_class_get_name(OBJECT_CLASS(mc2)),
2296 object_class_get_name(OBJECT_CLASS(mc1)));
2299 static MachineClass *machine_parse(const char *name, GSList *machines)
2301 MachineClass *mc;
2302 GSList *el;
2304 if (is_help_option(name)) {
2305 printf("Supported machines are:\n");
2306 machines = g_slist_sort(machines, machine_class_cmp);
2307 for (el = machines; el; el = el->next) {
2308 MachineClass *mc = el->data;
2309 if (mc->alias) {
2310 printf("%-20s %s (alias of %s)\n", mc->alias, mc->desc, mc->name);
2312 printf("%-20s %s%s%s\n", mc->name, mc->desc,
2313 mc->is_default ? " (default)" : "",
2314 mc->deprecation_reason ? " (deprecated)" : "");
2316 exit(0);
2319 mc = find_machine(name, machines);
2320 if (!mc) {
2321 error_report("unsupported machine type");
2322 error_printf("Use -machine help to list supported machines\n");
2323 exit(1);
2325 return mc;
2328 void qemu_add_exit_notifier(Notifier *notify)
2330 notifier_list_add(&exit_notifiers, notify);
2333 void qemu_remove_exit_notifier(Notifier *notify)
2335 notifier_remove(notify);
2338 static void qemu_run_exit_notifiers(void)
2340 notifier_list_notify(&exit_notifiers, NULL);
2343 static const char *pid_file;
2344 static Notifier qemu_unlink_pidfile_notifier;
2346 static void qemu_unlink_pidfile(Notifier *n, void *data)
2348 if (pid_file) {
2349 unlink(pid_file);
2353 bool machine_init_done;
2355 void qemu_add_machine_init_done_notifier(Notifier *notify)
2357 notifier_list_add(&machine_init_done_notifiers, notify);
2358 if (machine_init_done) {
2359 notify->notify(notify, NULL);
2363 void qemu_remove_machine_init_done_notifier(Notifier *notify)
2365 notifier_remove(notify);
2368 static void qemu_run_machine_init_done_notifiers(void)
2370 machine_init_done = true;
2371 notifier_list_notify(&machine_init_done_notifiers, NULL);
2374 static const QEMUOption *lookup_opt(int argc, char **argv,
2375 const char **poptarg, int *poptind)
2377 const QEMUOption *popt;
2378 int optind = *poptind;
2379 char *r = argv[optind];
2380 const char *optarg;
2382 loc_set_cmdline(argv, optind, 1);
2383 optind++;
2384 /* Treat --foo the same as -foo. */
2385 if (r[1] == '-')
2386 r++;
2387 popt = qemu_options;
2388 for(;;) {
2389 if (!popt->name) {
2390 error_report("invalid option");
2391 exit(1);
2393 if (!strcmp(popt->name, r + 1))
2394 break;
2395 popt++;
2397 if (popt->flags & HAS_ARG) {
2398 if (optind >= argc) {
2399 error_report("requires an argument");
2400 exit(1);
2402 optarg = argv[optind++];
2403 loc_set_cmdline(argv, optind - 2, 2);
2404 } else {
2405 optarg = NULL;
2408 *poptarg = optarg;
2409 *poptind = optind;
2411 return popt;
2414 static MachineClass *select_machine(void)
2416 GSList *machines = object_class_get_list(TYPE_MACHINE, false);
2417 MachineClass *machine_class = find_default_machine(machines);
2418 const char *optarg;
2419 QemuOpts *opts;
2420 Location loc;
2422 loc_push_none(&loc);
2424 opts = qemu_get_machine_opts();
2425 qemu_opts_loc_restore(opts);
2427 optarg = qemu_opt_get(opts, "type");
2428 if (optarg) {
2429 machine_class = machine_parse(optarg, machines);
2432 if (!machine_class) {
2433 error_report("No machine specified, and there is no default");
2434 error_printf("Use -machine help to list supported machines\n");
2435 exit(1);
2438 loc_pop(&loc);
2439 g_slist_free(machines);
2440 return machine_class;
2443 static int object_parse_property_opt(Object *obj,
2444 const char *name, const char *value,
2445 const char *skip, Error **errp)
2447 Error *local_err = NULL;
2449 if (g_str_equal(name, skip)) {
2450 return 0;
2453 object_property_parse(obj, value, name, &local_err);
2455 if (local_err) {
2456 error_propagate(errp, local_err);
2457 return -1;
2460 return 0;
2463 static int machine_set_property(void *opaque,
2464 const char *name, const char *value,
2465 Error **errp)
2467 g_autofree char *qom_name = g_strdup(name);
2468 char *p;
2470 for (p = qom_name; *p; p++) {
2471 if (*p == '_') {
2472 *p = '-';
2476 /* Legacy options do not correspond to MachineState properties. */
2477 if (g_str_equal(qom_name, "accel")) {
2478 return 0;
2480 if (g_str_equal(qom_name, "igd-passthru")) {
2481 object_register_sugar_prop(ACCEL_CLASS_NAME("xen"), qom_name, value);
2482 return 0;
2484 if (g_str_equal(qom_name, "kvm-shadow-mem") ||
2485 g_str_equal(qom_name, "kernel-irqchip")) {
2486 object_register_sugar_prop(ACCEL_CLASS_NAME("kvm"), qom_name, value);
2487 return 0;
2490 return object_parse_property_opt(opaque, name, value, "type", errp);
2494 * Initial object creation happens before all other
2495 * QEMU data types are created. The majority of objects
2496 * can be created at this point. The rng-egd object
2497 * cannot be created here, as it depends on the chardev
2498 * already existing.
2500 static bool object_create_initial(const char *type, QemuOpts *opts)
2502 if (user_creatable_print_help(type, opts)) {
2503 exit(0);
2507 * Objects should not be made "delayed" without a reason. If you
2508 * add one, state the reason in a comment!
2511 /* Reason: rng-egd property "chardev" */
2512 if (g_str_equal(type, "rng-egd")) {
2513 return false;
2516 #if defined(CONFIG_VHOST_USER) && defined(CONFIG_LINUX)
2517 /* Reason: cryptodev-vhost-user property "chardev" */
2518 if (g_str_equal(type, "cryptodev-vhost-user")) {
2519 return false;
2521 #endif
2524 * Reason: filter-* property "netdev" etc.
2526 if (g_str_equal(type, "filter-buffer") ||
2527 g_str_equal(type, "filter-dump") ||
2528 g_str_equal(type, "filter-mirror") ||
2529 g_str_equal(type, "filter-redirector") ||
2530 g_str_equal(type, "colo-compare") ||
2531 g_str_equal(type, "filter-rewriter") ||
2532 g_str_equal(type, "filter-replay")) {
2533 return false;
2536 /* Memory allocation by backends needs to be done
2537 * after configure_accelerator() (due to the tcg_enabled()
2538 * checks at memory_region_init_*()).
2540 * Also, allocation of large amounts of memory may delay
2541 * chardev initialization for too long, and trigger timeouts
2542 * on software that waits for a monitor socket to be created
2543 * (e.g. libvirt).
2545 if (g_str_has_prefix(type, "memory-backend-")) {
2546 return false;
2549 return true;
2554 * The remainder of object creation happens after the
2555 * creation of chardev, fsdev, net clients and device data types.
2557 static bool object_create_delayed(const char *type, QemuOpts *opts)
2559 return !object_create_initial(type, opts);
2563 static bool set_memory_options(uint64_t *ram_slots, ram_addr_t *maxram_size,
2564 MachineClass *mc)
2566 uint64_t sz;
2567 const char *mem_str;
2568 const ram_addr_t default_ram_size = mc->default_ram_size;
2569 QemuOpts *opts = qemu_find_opts_singleton("memory");
2570 Location loc;
2572 loc_push_none(&loc);
2573 qemu_opts_loc_restore(opts);
2575 sz = 0;
2576 mem_str = qemu_opt_get(opts, "size");
2577 if (mem_str) {
2578 if (!*mem_str) {
2579 error_report("missing 'size' option value");
2580 exit(EXIT_FAILURE);
2583 sz = qemu_opt_get_size(opts, "size", ram_size);
2585 /* Fix up legacy suffix-less format */
2586 if (g_ascii_isdigit(mem_str[strlen(mem_str) - 1])) {
2587 uint64_t overflow_check = sz;
2589 sz *= MiB;
2590 if (sz / MiB != overflow_check) {
2591 error_report("too large 'size' option value");
2592 exit(EXIT_FAILURE);
2597 /* backward compatibility behaviour for case "-m 0" */
2598 if (sz == 0) {
2599 sz = default_ram_size;
2602 sz = QEMU_ALIGN_UP(sz, 8192);
2603 if (mc->fixup_ram_size) {
2604 sz = mc->fixup_ram_size(sz);
2606 ram_size = sz;
2607 if (ram_size != sz) {
2608 error_report("ram size too large");
2609 exit(EXIT_FAILURE);
2612 /* store value for the future use */
2613 qemu_opt_set_number(opts, "size", ram_size, &error_abort);
2614 *maxram_size = ram_size;
2616 if (qemu_opt_get(opts, "maxmem")) {
2617 uint64_t slots;
2619 sz = qemu_opt_get_size(opts, "maxmem", 0);
2620 slots = qemu_opt_get_number(opts, "slots", 0);
2621 if (sz < ram_size) {
2622 error_report("invalid value of -m option maxmem: "
2623 "maximum memory size (0x%" PRIx64 ") must be at least "
2624 "the initial memory size (0x" RAM_ADDR_FMT ")",
2625 sz, ram_size);
2626 exit(EXIT_FAILURE);
2627 } else if (slots && sz == ram_size) {
2628 error_report("invalid value of -m option maxmem: "
2629 "memory slots were specified but maximum memory size "
2630 "(0x%" PRIx64 ") is equal to the initial memory size "
2631 "(0x" RAM_ADDR_FMT ")", sz, ram_size);
2632 exit(EXIT_FAILURE);
2635 *maxram_size = sz;
2636 *ram_slots = slots;
2637 } else if (qemu_opt_get(opts, "slots")) {
2638 error_report("invalid -m option value: missing 'maxmem' option");
2639 exit(EXIT_FAILURE);
2642 loc_pop(&loc);
2643 return !!mem_str;
2646 static int global_init_func(void *opaque, QemuOpts *opts, Error **errp)
2648 GlobalProperty *g;
2650 g = g_malloc0(sizeof(*g));
2651 g->driver = qemu_opt_get(opts, "driver");
2652 g->property = qemu_opt_get(opts, "property");
2653 g->value = qemu_opt_get(opts, "value");
2654 qdev_prop_register_global(g);
2655 return 0;
2658 static int qemu_read_default_config_file(void)
2660 int ret;
2662 ret = qemu_read_config_file(CONFIG_QEMU_CONFDIR "/qemu.conf");
2663 if (ret < 0 && ret != -ENOENT) {
2664 return ret;
2667 return 0;
2670 static void user_register_global_props(void)
2672 qemu_opts_foreach(qemu_find_opts("global"),
2673 global_init_func, NULL, NULL);
2676 static int do_configure_icount(void *opaque, QemuOpts *opts, Error **errp)
2678 configure_icount(opts, errp);
2679 return 0;
2682 static int accelerator_set_property(void *opaque,
2683 const char *name, const char *value,
2684 Error **errp)
2686 return object_parse_property_opt(opaque, name, value, "accel", errp);
2689 static int do_configure_accelerator(void *opaque, QemuOpts *opts, Error **errp)
2691 bool *p_init_failed = opaque;
2692 const char *acc = qemu_opt_get(opts, "accel");
2693 AccelClass *ac = accel_find(acc);
2694 AccelState *accel;
2695 int ret;
2697 if (!ac) {
2698 *p_init_failed = true;
2699 error_report("invalid accelerator %s", acc);
2700 return 0;
2702 accel = ACCEL(object_new_with_class(OBJECT_CLASS(ac)));
2703 object_apply_compat_props(OBJECT(accel));
2704 qemu_opt_foreach(opts, accelerator_set_property,
2705 accel,
2706 &error_fatal);
2708 ret = accel_init_machine(accel, current_machine);
2709 if (ret < 0) {
2710 *p_init_failed = true;
2711 error_report("failed to initialize %s: %s",
2712 acc, strerror(-ret));
2713 return 0;
2716 return 1;
2719 static void configure_accelerators(const char *progname)
2721 const char *accel;
2722 bool init_failed = false;
2724 qemu_opts_foreach(qemu_find_opts("icount"),
2725 do_configure_icount, NULL, &error_fatal);
2727 accel = qemu_opt_get(qemu_get_machine_opts(), "accel");
2728 if (QTAILQ_EMPTY(&qemu_accel_opts.head)) {
2729 char **accel_list, **tmp;
2731 if (accel == NULL) {
2732 /* Select the default accelerator */
2733 bool have_tcg = accel_find("tcg");
2734 bool have_kvm = accel_find("kvm");
2736 if (have_tcg && have_kvm) {
2737 if (g_str_has_suffix(progname, "kvm")) {
2738 /* If the program name ends with "kvm", we prefer KVM */
2739 accel = "kvm:tcg";
2740 } else {
2741 accel = "tcg:kvm";
2743 } else if (have_kvm) {
2744 accel = "kvm";
2745 } else if (have_tcg) {
2746 accel = "tcg";
2747 } else {
2748 error_report("No accelerator selected and"
2749 " no default accelerator available");
2750 exit(1);
2753 accel_list = g_strsplit(accel, ":", 0);
2755 for (tmp = accel_list; *tmp; tmp++) {
2757 * Filter invalid accelerators here, to prevent obscenities
2758 * such as "-machine accel=tcg,,thread=single".
2760 if (accel_find(*tmp)) {
2761 qemu_opts_parse_noisily(qemu_find_opts("accel"), *tmp, true);
2762 } else {
2763 init_failed = true;
2764 error_report("invalid accelerator %s", *tmp);
2767 g_strfreev(accel_list);
2768 } else {
2769 if (accel != NULL) {
2770 error_report("The -accel and \"-machine accel=\" options are incompatible");
2771 exit(1);
2775 if (!qemu_opts_foreach(qemu_find_opts("accel"),
2776 do_configure_accelerator, &init_failed, &error_fatal)) {
2777 if (!init_failed) {
2778 error_report("no accelerator found");
2780 exit(1);
2783 if (init_failed) {
2784 AccelClass *ac = ACCEL_GET_CLASS(current_accel());
2785 error_report("falling back to %s", ac->name);
2788 if (use_icount && !(tcg_enabled() || qtest_enabled())) {
2789 error_report("-icount is not allowed with hardware virtualization");
2790 exit(1);
2794 static void create_default_memdev(MachineState *ms, const char *path)
2796 Object *obj;
2797 MachineClass *mc = MACHINE_GET_CLASS(ms);
2799 obj = object_new(path ? TYPE_MEMORY_BACKEND_FILE : TYPE_MEMORY_BACKEND_RAM);
2800 if (path) {
2801 object_property_set_str(obj, path, "mem-path", &error_fatal);
2803 object_property_set_int(obj, ms->ram_size, "size", &error_fatal);
2804 object_property_add_child(object_get_objects_root(), mc->default_ram_id,
2805 obj);
2806 /* Ensure backend's memory region name is equal to mc->default_ram_id */
2807 object_property_set_bool(obj, false, "x-use-canonical-path-for-ramblock-id",
2808 &error_fatal);
2809 user_creatable_complete(USER_CREATABLE(obj), &error_fatal);
2810 object_unref(obj);
2811 object_property_set_str(OBJECT(ms), mc->default_ram_id, "memory-backend",
2812 &error_fatal);
2815 void qemu_init(int argc, char **argv, char **envp)
2817 int i;
2818 int snapshot, linux_boot;
2819 const char *initrd_filename;
2820 const char *kernel_filename, *kernel_cmdline;
2821 const char *boot_order = NULL;
2822 const char *boot_once = NULL;
2823 DisplayState *ds;
2824 QemuOpts *opts, *machine_opts;
2825 QemuOpts *icount_opts = NULL, *accel_opts = NULL;
2826 QemuOptsList *olist;
2827 int optind;
2828 const char *optarg;
2829 const char *loadvm = NULL;
2830 MachineClass *machine_class;
2831 const char *cpu_option;
2832 const char *vga_model = NULL;
2833 const char *qtest_chrdev = NULL;
2834 const char *qtest_log = NULL;
2835 const char *incoming = NULL;
2836 bool userconfig = true;
2837 bool nographic = false;
2838 int display_remote = 0;
2839 const char *log_mask = NULL;
2840 const char *log_file = NULL;
2841 char *trace_file = NULL;
2842 ram_addr_t maxram_size;
2843 uint64_t ram_slots = 0;
2844 FILE *vmstate_dump_file = NULL;
2845 Error *main_loop_err = NULL;
2846 Error *err = NULL;
2847 bool list_data_dirs = false;
2848 char *dir, **dirs;
2849 const char *mem_path = NULL;
2850 bool have_custom_ram_size;
2851 BlockdevOptionsQueue bdo_queue = QSIMPLEQ_HEAD_INITIALIZER(bdo_queue);
2852 QemuPluginList plugin_list = QTAILQ_HEAD_INITIALIZER(plugin_list);
2853 int mem_prealloc = 0; /* force preallocation of physical target memory */
2855 os_set_line_buffering();
2857 error_init(argv[0]);
2858 module_call_init(MODULE_INIT_TRACE);
2860 qemu_init_cpu_list();
2861 qemu_init_cpu_loop();
2863 qemu_mutex_lock_iothread();
2865 atexit(qemu_run_exit_notifiers);
2866 qemu_init_exec_dir(argv[0]);
2868 module_call_init(MODULE_INIT_QOM);
2869 module_call_init(MODULE_INIT_MIGRATION);
2871 qemu_add_opts(&qemu_drive_opts);
2872 qemu_add_drive_opts(&qemu_legacy_drive_opts);
2873 qemu_add_drive_opts(&qemu_common_drive_opts);
2874 qemu_add_drive_opts(&qemu_drive_opts);
2875 qemu_add_drive_opts(&bdrv_runtime_opts);
2876 qemu_add_opts(&qemu_chardev_opts);
2877 qemu_add_opts(&qemu_device_opts);
2878 qemu_add_opts(&qemu_netdev_opts);
2879 qemu_add_opts(&qemu_nic_opts);
2880 qemu_add_opts(&qemu_net_opts);
2881 qemu_add_opts(&qemu_rtc_opts);
2882 qemu_add_opts(&qemu_global_opts);
2883 qemu_add_opts(&qemu_mon_opts);
2884 qemu_add_opts(&qemu_trace_opts);
2885 qemu_plugin_add_opts();
2886 qemu_add_opts(&qemu_option_rom_opts);
2887 qemu_add_opts(&qemu_machine_opts);
2888 qemu_add_opts(&qemu_accel_opts);
2889 qemu_add_opts(&qemu_mem_opts);
2890 qemu_add_opts(&qemu_smp_opts);
2891 qemu_add_opts(&qemu_boot_opts);
2892 qemu_add_opts(&qemu_add_fd_opts);
2893 qemu_add_opts(&qemu_object_opts);
2894 qemu_add_opts(&qemu_tpmdev_opts);
2895 qemu_add_opts(&qemu_realtime_opts);
2896 qemu_add_opts(&qemu_overcommit_opts);
2897 qemu_add_opts(&qemu_msg_opts);
2898 qemu_add_opts(&qemu_name_opts);
2899 qemu_add_opts(&qemu_numa_opts);
2900 qemu_add_opts(&qemu_icount_opts);
2901 qemu_add_opts(&qemu_semihosting_config_opts);
2902 qemu_add_opts(&qemu_fw_cfg_opts);
2903 module_call_init(MODULE_INIT_OPTS);
2905 runstate_init();
2906 precopy_infrastructure_init();
2907 postcopy_infrastructure_init();
2908 monitor_init_globals();
2910 if (qcrypto_init(&err) < 0) {
2911 error_reportf_err(err, "cannot initialize crypto: ");
2912 exit(1);
2915 QTAILQ_INIT(&vm_change_state_head);
2916 os_setup_early_signal_handling();
2918 cpu_option = NULL;
2919 snapshot = 0;
2921 nb_nics = 0;
2923 bdrv_init_with_whitelist();
2925 autostart = 1;
2927 /* first pass of option parsing */
2928 optind = 1;
2929 while (optind < argc) {
2930 if (argv[optind][0] != '-') {
2931 /* disk image */
2932 optind++;
2933 } else {
2934 const QEMUOption *popt;
2936 popt = lookup_opt(argc, argv, &optarg, &optind);
2937 switch (popt->index) {
2938 case QEMU_OPTION_nouserconfig:
2939 userconfig = false;
2940 break;
2945 if (userconfig) {
2946 if (qemu_read_default_config_file() < 0) {
2947 exit(1);
2951 /* second pass of option parsing */
2952 optind = 1;
2953 for(;;) {
2954 if (optind >= argc)
2955 break;
2956 if (argv[optind][0] != '-') {
2957 loc_set_cmdline(argv, optind, 1);
2958 drive_add(IF_DEFAULT, 0, argv[optind++], HD_OPTS);
2959 } else {
2960 const QEMUOption *popt;
2962 popt = lookup_opt(argc, argv, &optarg, &optind);
2963 if (!(popt->arch_mask & arch_type)) {
2964 error_report("Option not supported for this target");
2965 exit(1);
2967 switch(popt->index) {
2968 case QEMU_OPTION_cpu:
2969 /* hw initialization will check this */
2970 cpu_option = optarg;
2971 break;
2972 case QEMU_OPTION_hda:
2973 case QEMU_OPTION_hdb:
2974 case QEMU_OPTION_hdc:
2975 case QEMU_OPTION_hdd:
2976 drive_add(IF_DEFAULT, popt->index - QEMU_OPTION_hda, optarg,
2977 HD_OPTS);
2978 break;
2979 case QEMU_OPTION_blockdev:
2981 Visitor *v;
2982 BlockdevOptionsQueueEntry *bdo;
2984 v = qobject_input_visitor_new_str(optarg, "driver",
2985 &error_fatal);
2987 bdo = g_new(BlockdevOptionsQueueEntry, 1);
2988 visit_type_BlockdevOptions(v, NULL, &bdo->bdo,
2989 &error_fatal);
2990 visit_free(v);
2991 loc_save(&bdo->loc);
2992 QSIMPLEQ_INSERT_TAIL(&bdo_queue, bdo, entry);
2993 break;
2995 case QEMU_OPTION_drive:
2996 if (drive_def(optarg) == NULL) {
2997 exit(1);
2999 break;
3000 case QEMU_OPTION_set:
3001 if (qemu_set_option(optarg) != 0)
3002 exit(1);
3003 break;
3004 case QEMU_OPTION_global:
3005 if (qemu_global_option(optarg) != 0)
3006 exit(1);
3007 break;
3008 case QEMU_OPTION_mtdblock:
3009 drive_add(IF_MTD, -1, optarg, MTD_OPTS);
3010 break;
3011 case QEMU_OPTION_sd:
3012 drive_add(IF_SD, -1, optarg, SD_OPTS);
3013 break;
3014 case QEMU_OPTION_pflash:
3015 drive_add(IF_PFLASH, -1, optarg, PFLASH_OPTS);
3016 break;
3017 case QEMU_OPTION_snapshot:
3019 Error *blocker = NULL;
3020 snapshot = 1;
3021 error_setg(&blocker, QERR_REPLAY_NOT_SUPPORTED,
3022 "-snapshot");
3023 replay_add_blocker(blocker);
3025 break;
3026 case QEMU_OPTION_numa:
3027 opts = qemu_opts_parse_noisily(qemu_find_opts("numa"),
3028 optarg, true);
3029 if (!opts) {
3030 exit(1);
3032 break;
3033 case QEMU_OPTION_display:
3034 parse_display(optarg);
3035 break;
3036 case QEMU_OPTION_nographic:
3037 olist = qemu_find_opts("machine");
3038 qemu_opts_parse_noisily(olist, "graphics=off", false);
3039 nographic = true;
3040 dpy.type = DISPLAY_TYPE_NONE;
3041 break;
3042 case QEMU_OPTION_curses:
3043 #ifdef CONFIG_CURSES
3044 dpy.type = DISPLAY_TYPE_CURSES;
3045 #else
3046 error_report("curses or iconv support is disabled");
3047 exit(1);
3048 #endif
3049 break;
3050 case QEMU_OPTION_portrait:
3051 graphic_rotate = 90;
3052 break;
3053 case QEMU_OPTION_rotate:
3054 graphic_rotate = strtol(optarg, (char **) &optarg, 10);
3055 if (graphic_rotate != 0 && graphic_rotate != 90 &&
3056 graphic_rotate != 180 && graphic_rotate != 270) {
3057 error_report("only 90, 180, 270 deg rotation is available");
3058 exit(1);
3060 break;
3061 case QEMU_OPTION_kernel:
3062 qemu_opts_set(qemu_find_opts("machine"), NULL, "kernel", optarg,
3063 &error_abort);
3064 break;
3065 case QEMU_OPTION_initrd:
3066 qemu_opts_set(qemu_find_opts("machine"), NULL, "initrd", optarg,
3067 &error_abort);
3068 break;
3069 case QEMU_OPTION_append:
3070 qemu_opts_set(qemu_find_opts("machine"), NULL, "append", optarg,
3071 &error_abort);
3072 break;
3073 case QEMU_OPTION_dtb:
3074 qemu_opts_set(qemu_find_opts("machine"), NULL, "dtb", optarg,
3075 &error_abort);
3076 break;
3077 case QEMU_OPTION_cdrom:
3078 drive_add(IF_DEFAULT, 2, optarg, CDROM_OPTS);
3079 break;
3080 case QEMU_OPTION_boot:
3081 opts = qemu_opts_parse_noisily(qemu_find_opts("boot-opts"),
3082 optarg, true);
3083 if (!opts) {
3084 exit(1);
3086 break;
3087 case QEMU_OPTION_fda:
3088 case QEMU_OPTION_fdb:
3089 drive_add(IF_FLOPPY, popt->index - QEMU_OPTION_fda,
3090 optarg, FD_OPTS);
3091 break;
3092 case QEMU_OPTION_no_fd_bootchk:
3093 fd_bootchk = 0;
3094 break;
3095 case QEMU_OPTION_netdev:
3096 default_net = 0;
3097 if (net_client_parse(qemu_find_opts("netdev"), optarg) == -1) {
3098 exit(1);
3100 break;
3101 case QEMU_OPTION_nic:
3102 default_net = 0;
3103 if (net_client_parse(qemu_find_opts("nic"), optarg) == -1) {
3104 exit(1);
3106 break;
3107 case QEMU_OPTION_net:
3108 default_net = 0;
3109 if (net_client_parse(qemu_find_opts("net"), optarg) == -1) {
3110 exit(1);
3112 break;
3113 #ifdef CONFIG_LIBISCSI
3114 case QEMU_OPTION_iscsi:
3115 opts = qemu_opts_parse_noisily(qemu_find_opts("iscsi"),
3116 optarg, false);
3117 if (!opts) {
3118 exit(1);
3120 break;
3121 #endif
3122 case QEMU_OPTION_audio_help:
3123 audio_legacy_help();
3124 exit (0);
3125 break;
3126 case QEMU_OPTION_audiodev:
3127 audio_parse_option(optarg);
3128 break;
3129 case QEMU_OPTION_soundhw:
3130 select_soundhw (optarg);
3131 break;
3132 case QEMU_OPTION_h:
3133 help(0);
3134 break;
3135 case QEMU_OPTION_version:
3136 version();
3137 exit(0);
3138 break;
3139 case QEMU_OPTION_m:
3140 opts = qemu_opts_parse_noisily(qemu_find_opts("memory"),
3141 optarg, true);
3142 if (!opts) {
3143 exit(EXIT_FAILURE);
3145 break;
3146 #ifdef CONFIG_TPM
3147 case QEMU_OPTION_tpmdev:
3148 if (tpm_config_parse(qemu_find_opts("tpmdev"), optarg) < 0) {
3149 exit(1);
3151 break;
3152 #endif
3153 case QEMU_OPTION_mempath:
3154 mem_path = optarg;
3155 break;
3156 case QEMU_OPTION_mem_prealloc:
3157 mem_prealloc = 1;
3158 break;
3159 case QEMU_OPTION_d:
3160 log_mask = optarg;
3161 break;
3162 case QEMU_OPTION_D:
3163 log_file = optarg;
3164 break;
3165 case QEMU_OPTION_DFILTER:
3166 qemu_set_dfilter_ranges(optarg, &error_fatal);
3167 break;
3168 case QEMU_OPTION_seed:
3169 qemu_guest_random_seed_main(optarg, &error_fatal);
3170 break;
3171 case QEMU_OPTION_s:
3172 add_device_config(DEV_GDB, "tcp::" DEFAULT_GDBSTUB_PORT);
3173 break;
3174 case QEMU_OPTION_gdb:
3175 add_device_config(DEV_GDB, optarg);
3176 break;
3177 case QEMU_OPTION_L:
3178 if (is_help_option(optarg)) {
3179 list_data_dirs = true;
3180 } else {
3181 qemu_add_data_dir(optarg);
3183 break;
3184 case QEMU_OPTION_bios:
3185 qemu_opts_set(qemu_find_opts("machine"), NULL, "firmware", optarg,
3186 &error_abort);
3187 break;
3188 case QEMU_OPTION_singlestep:
3189 singlestep = 1;
3190 break;
3191 case QEMU_OPTION_S:
3192 autostart = 0;
3193 break;
3194 case QEMU_OPTION_k:
3195 keyboard_layout = optarg;
3196 break;
3197 case QEMU_OPTION_vga:
3198 vga_model = optarg;
3199 default_vga = 0;
3200 break;
3201 case QEMU_OPTION_g:
3203 const char *p;
3204 int w, h, depth;
3205 p = optarg;
3206 w = strtol(p, (char **)&p, 10);
3207 if (w <= 0) {
3208 graphic_error:
3209 error_report("invalid resolution or depth");
3210 exit(1);
3212 if (*p != 'x')
3213 goto graphic_error;
3214 p++;
3215 h = strtol(p, (char **)&p, 10);
3216 if (h <= 0)
3217 goto graphic_error;
3218 if (*p == 'x') {
3219 p++;
3220 depth = strtol(p, (char **)&p, 10);
3221 if (depth != 1 && depth != 2 && depth != 4 &&
3222 depth != 8 && depth != 15 && depth != 16 &&
3223 depth != 24 && depth != 32)
3224 goto graphic_error;
3225 } else if (*p == '\0') {
3226 depth = graphic_depth;
3227 } else {
3228 goto graphic_error;
3231 graphic_width = w;
3232 graphic_height = h;
3233 graphic_depth = depth;
3235 break;
3236 case QEMU_OPTION_echr:
3238 char *r;
3239 term_escape_char = strtol(optarg, &r, 0);
3240 if (r == optarg)
3241 printf("Bad argument to echr\n");
3242 break;
3244 case QEMU_OPTION_monitor:
3245 default_monitor = 0;
3246 if (strncmp(optarg, "none", 4)) {
3247 monitor_parse(optarg, "readline", false);
3249 break;
3250 case QEMU_OPTION_qmp:
3251 monitor_parse(optarg, "control", false);
3252 default_monitor = 0;
3253 break;
3254 case QEMU_OPTION_qmp_pretty:
3255 monitor_parse(optarg, "control", true);
3256 default_monitor = 0;
3257 break;
3258 case QEMU_OPTION_mon:
3259 opts = qemu_opts_parse_noisily(qemu_find_opts("mon"), optarg,
3260 true);
3261 if (!opts) {
3262 exit(1);
3264 default_monitor = 0;
3265 break;
3266 case QEMU_OPTION_chardev:
3267 opts = qemu_opts_parse_noisily(qemu_find_opts("chardev"),
3268 optarg, true);
3269 if (!opts) {
3270 exit(1);
3272 break;
3273 case QEMU_OPTION_fsdev:
3274 olist = qemu_find_opts("fsdev");
3275 if (!olist) {
3276 error_report("fsdev support is disabled");
3277 exit(1);
3279 opts = qemu_opts_parse_noisily(olist, optarg, true);
3280 if (!opts) {
3281 exit(1);
3283 break;
3284 case QEMU_OPTION_virtfs: {
3285 QemuOpts *fsdev;
3286 QemuOpts *device;
3287 const char *writeout, *sock_fd, *socket, *path, *security_model,
3288 *multidevs;
3290 olist = qemu_find_opts("virtfs");
3291 if (!olist) {
3292 error_report("virtfs support is disabled");
3293 exit(1);
3295 opts = qemu_opts_parse_noisily(olist, optarg, true);
3296 if (!opts) {
3297 exit(1);
3300 if (qemu_opt_get(opts, "fsdriver") == NULL ||
3301 qemu_opt_get(opts, "mount_tag") == NULL) {
3302 error_report("Usage: -virtfs fsdriver,mount_tag=tag");
3303 exit(1);
3305 fsdev = qemu_opts_create(qemu_find_opts("fsdev"),
3306 qemu_opts_id(opts) ?:
3307 qemu_opt_get(opts, "mount_tag"),
3308 1, NULL);
3309 if (!fsdev) {
3310 error_report("duplicate or invalid fsdev id: %s",
3311 qemu_opt_get(opts, "mount_tag"));
3312 exit(1);
3315 writeout = qemu_opt_get(opts, "writeout");
3316 if (writeout) {
3317 #ifdef CONFIG_SYNC_FILE_RANGE
3318 qemu_opt_set(fsdev, "writeout", writeout, &error_abort);
3319 #else
3320 error_report("writeout=immediate not supported "
3321 "on this platform");
3322 exit(1);
3323 #endif
3325 qemu_opt_set(fsdev, "fsdriver",
3326 qemu_opt_get(opts, "fsdriver"), &error_abort);
3327 path = qemu_opt_get(opts, "path");
3328 if (path) {
3329 qemu_opt_set(fsdev, "path", path, &error_abort);
3331 security_model = qemu_opt_get(opts, "security_model");
3332 if (security_model) {
3333 qemu_opt_set(fsdev, "security_model", security_model,
3334 &error_abort);
3336 socket = qemu_opt_get(opts, "socket");
3337 if (socket) {
3338 qemu_opt_set(fsdev, "socket", socket, &error_abort);
3340 sock_fd = qemu_opt_get(opts, "sock_fd");
3341 if (sock_fd) {
3342 qemu_opt_set(fsdev, "sock_fd", sock_fd, &error_abort);
3345 qemu_opt_set_bool(fsdev, "readonly",
3346 qemu_opt_get_bool(opts, "readonly", 0),
3347 &error_abort);
3348 multidevs = qemu_opt_get(opts, "multidevs");
3349 if (multidevs) {
3350 qemu_opt_set(fsdev, "multidevs", multidevs, &error_abort);
3352 device = qemu_opts_create(qemu_find_opts("device"), NULL, 0,
3353 &error_abort);
3354 qemu_opt_set(device, "driver", "virtio-9p-pci", &error_abort);
3355 qemu_opt_set(device, "fsdev",
3356 qemu_opts_id(fsdev), &error_abort);
3357 qemu_opt_set(device, "mount_tag",
3358 qemu_opt_get(opts, "mount_tag"), &error_abort);
3359 break;
3361 case QEMU_OPTION_serial:
3362 add_device_config(DEV_SERIAL, optarg);
3363 default_serial = 0;
3364 if (strncmp(optarg, "mon:", 4) == 0) {
3365 default_monitor = 0;
3367 break;
3368 case QEMU_OPTION_watchdog:
3369 if (watchdog) {
3370 error_report("only one watchdog option may be given");
3371 exit(1);
3373 watchdog = optarg;
3374 break;
3375 case QEMU_OPTION_watchdog_action:
3376 if (select_watchdog_action(optarg) == -1) {
3377 error_report("unknown -watchdog-action parameter");
3378 exit(1);
3380 break;
3381 case QEMU_OPTION_parallel:
3382 add_device_config(DEV_PARALLEL, optarg);
3383 default_parallel = 0;
3384 if (strncmp(optarg, "mon:", 4) == 0) {
3385 default_monitor = 0;
3387 break;
3388 case QEMU_OPTION_debugcon:
3389 add_device_config(DEV_DEBUGCON, optarg);
3390 break;
3391 case QEMU_OPTION_loadvm:
3392 loadvm = optarg;
3393 break;
3394 case QEMU_OPTION_full_screen:
3395 dpy.has_full_screen = true;
3396 dpy.full_screen = true;
3397 break;
3398 case QEMU_OPTION_alt_grab:
3399 alt_grab = 1;
3400 break;
3401 case QEMU_OPTION_ctrl_grab:
3402 ctrl_grab = 1;
3403 break;
3404 case QEMU_OPTION_no_quit:
3405 dpy.has_window_close = true;
3406 dpy.window_close = false;
3407 break;
3408 case QEMU_OPTION_sdl:
3409 #ifdef CONFIG_SDL
3410 dpy.type = DISPLAY_TYPE_SDL;
3411 break;
3412 #else
3413 error_report("SDL support is disabled");
3414 exit(1);
3415 #endif
3416 case QEMU_OPTION_pidfile:
3417 pid_file = optarg;
3418 break;
3419 case QEMU_OPTION_win2k_hack:
3420 win2k_install_hack = 1;
3421 break;
3422 case QEMU_OPTION_acpitable:
3423 opts = qemu_opts_parse_noisily(qemu_find_opts("acpi"),
3424 optarg, true);
3425 if (!opts) {
3426 exit(1);
3428 acpi_table_add(opts, &error_fatal);
3429 break;
3430 case QEMU_OPTION_smbios:
3431 opts = qemu_opts_parse_noisily(qemu_find_opts("smbios"),
3432 optarg, false);
3433 if (!opts) {
3434 exit(1);
3436 smbios_entry_add(opts, &error_fatal);
3437 break;
3438 case QEMU_OPTION_fwcfg:
3439 opts = qemu_opts_parse_noisily(qemu_find_opts("fw_cfg"),
3440 optarg, true);
3441 if (opts == NULL) {
3442 exit(1);
3444 break;
3445 case QEMU_OPTION_preconfig:
3446 preconfig_exit_requested = false;
3447 break;
3448 case QEMU_OPTION_enable_kvm:
3449 olist = qemu_find_opts("machine");
3450 qemu_opts_parse_noisily(olist, "accel=kvm", false);
3451 break;
3452 case QEMU_OPTION_M:
3453 case QEMU_OPTION_machine:
3454 olist = qemu_find_opts("machine");
3455 opts = qemu_opts_parse_noisily(olist, optarg, true);
3456 if (!opts) {
3457 exit(1);
3459 break;
3460 case QEMU_OPTION_no_kvm:
3461 olist = qemu_find_opts("machine");
3462 qemu_opts_parse_noisily(olist, "accel=tcg", false);
3463 break;
3464 case QEMU_OPTION_accel:
3465 accel_opts = qemu_opts_parse_noisily(qemu_find_opts("accel"),
3466 optarg, true);
3467 optarg = qemu_opt_get(accel_opts, "accel");
3468 if (!optarg || is_help_option(optarg)) {
3469 printf("Accelerators supported in QEMU binary:\n");
3470 GSList *el, *accel_list = object_class_get_list(TYPE_ACCEL,
3471 false);
3472 for (el = accel_list; el; el = el->next) {
3473 gchar *typename = g_strdup(object_class_get_name(
3474 OBJECT_CLASS(el->data)));
3475 /* omit qtest which is used for tests only */
3476 if (g_strcmp0(typename, ACCEL_CLASS_NAME("qtest")) &&
3477 g_str_has_suffix(typename, ACCEL_CLASS_SUFFIX)) {
3478 gchar **optname = g_strsplit(typename,
3479 ACCEL_CLASS_SUFFIX, 0);
3480 printf("%s\n", optname[0]);
3481 g_strfreev(optname);
3483 g_free(typename);
3485 g_slist_free(accel_list);
3486 exit(0);
3488 if (optarg && strchr(optarg, ':')) {
3489 error_report("Don't use ':' with -accel, "
3490 "use -M accel=... for now instead");
3491 exit(1);
3493 break;
3494 case QEMU_OPTION_usb:
3495 olist = qemu_find_opts("machine");
3496 qemu_opts_parse_noisily(olist, "usb=on", false);
3497 break;
3498 case QEMU_OPTION_usbdevice:
3499 error_report("'-usbdevice' is deprecated, please use "
3500 "'-device usb-...' instead");
3501 olist = qemu_find_opts("machine");
3502 qemu_opts_parse_noisily(olist, "usb=on", false);
3503 add_device_config(DEV_USB, optarg);
3504 break;
3505 case QEMU_OPTION_device:
3506 if (!qemu_opts_parse_noisily(qemu_find_opts("device"),
3507 optarg, true)) {
3508 exit(1);
3510 break;
3511 case QEMU_OPTION_smp:
3512 if (!qemu_opts_parse_noisily(qemu_find_opts("smp-opts"),
3513 optarg, true)) {
3514 exit(1);
3516 break;
3517 case QEMU_OPTION_vnc:
3518 vnc_parse(optarg, &error_fatal);
3519 break;
3520 case QEMU_OPTION_no_acpi:
3521 olist = qemu_find_opts("machine");
3522 qemu_opts_parse_noisily(olist, "acpi=off", false);
3523 break;
3524 case QEMU_OPTION_no_hpet:
3525 no_hpet = 1;
3526 break;
3527 case QEMU_OPTION_no_reboot:
3528 no_reboot = 1;
3529 break;
3530 case QEMU_OPTION_no_shutdown:
3531 no_shutdown = 1;
3532 break;
3533 case QEMU_OPTION_show_cursor:
3534 warn_report("The -show-cursor option is deprecated. Please "
3535 "add show-cursor=on to your -display options.");
3536 warn_report("When using the default display you can use "
3537 "-display default,show-cursor=on");
3538 dpy.has_show_cursor = true;
3539 dpy.show_cursor = true;
3540 break;
3541 case QEMU_OPTION_uuid:
3542 if (qemu_uuid_parse(optarg, &qemu_uuid) < 0) {
3543 error_report("failed to parse UUID string: wrong format");
3544 exit(1);
3546 qemu_uuid_set = true;
3547 break;
3548 case QEMU_OPTION_option_rom:
3549 if (nb_option_roms >= MAX_OPTION_ROMS) {
3550 error_report("too many option ROMs");
3551 exit(1);
3553 opts = qemu_opts_parse_noisily(qemu_find_opts("option-rom"),
3554 optarg, true);
3555 if (!opts) {
3556 exit(1);
3558 option_rom[nb_option_roms].name = qemu_opt_get(opts, "romfile");
3559 option_rom[nb_option_roms].bootindex =
3560 qemu_opt_get_number(opts, "bootindex", -1);
3561 if (!option_rom[nb_option_roms].name) {
3562 error_report("Option ROM file is not specified");
3563 exit(1);
3565 nb_option_roms++;
3566 break;
3567 case QEMU_OPTION_semihosting:
3568 qemu_semihosting_enable();
3569 break;
3570 case QEMU_OPTION_semihosting_config:
3571 if (qemu_semihosting_config_options(optarg) != 0) {
3572 exit(1);
3574 break;
3575 case QEMU_OPTION_name:
3576 opts = qemu_opts_parse_noisily(qemu_find_opts("name"),
3577 optarg, true);
3578 if (!opts) {
3579 exit(1);
3581 break;
3582 case QEMU_OPTION_prom_env:
3583 if (nb_prom_envs >= MAX_PROM_ENVS) {
3584 error_report("too many prom variables");
3585 exit(1);
3587 prom_envs[nb_prom_envs] = optarg;
3588 nb_prom_envs++;
3589 break;
3590 case QEMU_OPTION_old_param:
3591 old_param = 1;
3592 break;
3593 case QEMU_OPTION_rtc:
3594 opts = qemu_opts_parse_noisily(qemu_find_opts("rtc"), optarg,
3595 false);
3596 if (!opts) {
3597 exit(1);
3599 break;
3600 case QEMU_OPTION_tb_size:
3601 #ifndef CONFIG_TCG
3602 error_report("TCG is disabled");
3603 exit(1);
3604 #endif
3605 warn_report("The -tb-size option is deprecated, use -accel tcg,tb-size instead");
3606 object_register_sugar_prop(ACCEL_CLASS_NAME("tcg"), "tb-size", optarg);
3607 break;
3608 case QEMU_OPTION_icount:
3609 icount_opts = qemu_opts_parse_noisily(qemu_find_opts("icount"),
3610 optarg, true);
3611 if (!icount_opts) {
3612 exit(1);
3614 break;
3615 case QEMU_OPTION_incoming:
3616 if (!incoming) {
3617 runstate_set(RUN_STATE_INMIGRATE);
3619 incoming = optarg;
3620 break;
3621 case QEMU_OPTION_only_migratable:
3622 only_migratable = 1;
3623 break;
3624 case QEMU_OPTION_nodefaults:
3625 has_defaults = 0;
3626 break;
3627 case QEMU_OPTION_xen_domid:
3628 if (!(xen_available())) {
3629 error_report("Option not supported for this target");
3630 exit(1);
3632 xen_domid = atoi(optarg);
3633 break;
3634 case QEMU_OPTION_xen_attach:
3635 if (!(xen_available())) {
3636 error_report("Option not supported for this target");
3637 exit(1);
3639 xen_mode = XEN_ATTACH;
3640 break;
3641 case QEMU_OPTION_xen_domid_restrict:
3642 if (!(xen_available())) {
3643 error_report("Option not supported for this target");
3644 exit(1);
3646 xen_domid_restrict = true;
3647 break;
3648 case QEMU_OPTION_trace:
3649 g_free(trace_file);
3650 trace_file = trace_opt_parse(optarg);
3651 break;
3652 case QEMU_OPTION_plugin:
3653 qemu_plugin_opt_parse(optarg, &plugin_list);
3654 break;
3655 case QEMU_OPTION_readconfig:
3657 int ret = qemu_read_config_file(optarg);
3658 if (ret < 0) {
3659 error_report("read config %s: %s", optarg,
3660 strerror(-ret));
3661 exit(1);
3663 break;
3665 case QEMU_OPTION_spice:
3666 olist = qemu_find_opts("spice");
3667 if (!olist) {
3668 error_report("spice support is disabled");
3669 exit(1);
3671 opts = qemu_opts_parse_noisily(olist, optarg, false);
3672 if (!opts) {
3673 exit(1);
3675 display_remote++;
3676 break;
3677 case QEMU_OPTION_writeconfig:
3679 FILE *fp;
3680 if (strcmp(optarg, "-") == 0) {
3681 fp = stdout;
3682 } else {
3683 fp = fopen(optarg, "w");
3684 if (fp == NULL) {
3685 error_report("open %s: %s", optarg,
3686 strerror(errno));
3687 exit(1);
3690 qemu_config_write(fp);
3691 if (fp != stdout) {
3692 fclose(fp);
3694 break;
3696 case QEMU_OPTION_qtest:
3697 qtest_chrdev = optarg;
3698 break;
3699 case QEMU_OPTION_qtest_log:
3700 qtest_log = optarg;
3701 break;
3702 case QEMU_OPTION_sandbox:
3703 olist = qemu_find_opts("sandbox");
3704 if (!olist) {
3705 #ifndef CONFIG_SECCOMP
3706 error_report("-sandbox support is not enabled "
3707 "in this QEMU binary");
3708 #endif
3709 exit(1);
3712 opts = qemu_opts_parse_noisily(olist, optarg, true);
3713 if (!opts) {
3714 exit(1);
3716 break;
3717 case QEMU_OPTION_add_fd:
3718 #ifndef _WIN32
3719 opts = qemu_opts_parse_noisily(qemu_find_opts("add-fd"),
3720 optarg, false);
3721 if (!opts) {
3722 exit(1);
3724 #else
3725 error_report("File descriptor passing is disabled on this "
3726 "platform");
3727 exit(1);
3728 #endif
3729 break;
3730 case QEMU_OPTION_object:
3731 opts = qemu_opts_parse_noisily(qemu_find_opts("object"),
3732 optarg, true);
3733 if (!opts) {
3734 exit(1);
3736 break;
3737 case QEMU_OPTION_realtime:
3738 warn_report("'-realtime mlock=...' is deprecated, please use "
3739 "'-overcommit mem-lock=...' instead");
3740 opts = qemu_opts_parse_noisily(qemu_find_opts("realtime"),
3741 optarg, false);
3742 if (!opts) {
3743 exit(1);
3745 /* Don't override the -overcommit option if set */
3746 enable_mlock = enable_mlock ||
3747 qemu_opt_get_bool(opts, "mlock", true);
3748 break;
3749 case QEMU_OPTION_overcommit:
3750 opts = qemu_opts_parse_noisily(qemu_find_opts("overcommit"),
3751 optarg, false);
3752 if (!opts) {
3753 exit(1);
3755 /* Don't override the -realtime option if set */
3756 enable_mlock = enable_mlock ||
3757 qemu_opt_get_bool(opts, "mem-lock", false);
3758 enable_cpu_pm = qemu_opt_get_bool(opts, "cpu-pm", false);
3759 break;
3760 case QEMU_OPTION_msg:
3761 opts = qemu_opts_parse_noisily(qemu_find_opts("msg"), optarg,
3762 false);
3763 if (!opts) {
3764 exit(1);
3766 configure_msg(opts);
3767 break;
3768 case QEMU_OPTION_dump_vmstate:
3769 if (vmstate_dump_file) {
3770 error_report("only one '-dump-vmstate' "
3771 "option may be given");
3772 exit(1);
3774 vmstate_dump_file = fopen(optarg, "w");
3775 if (vmstate_dump_file == NULL) {
3776 error_report("open %s: %s", optarg, strerror(errno));
3777 exit(1);
3779 break;
3780 case QEMU_OPTION_enable_sync_profile:
3781 qsp_enable();
3782 break;
3783 case QEMU_OPTION_nouserconfig:
3784 /* Nothing to be parsed here. Especially, do not error out below. */
3785 break;
3786 default:
3787 if (os_parse_cmd_args(popt->index, optarg)) {
3788 error_report("Option not supported in this build");
3789 exit(1);
3795 * Clear error location left behind by the loop.
3796 * Best done right after the loop. Do not insert code here!
3798 loc_set_none();
3801 * Check for -cpu help and -device help before we call select_machine(),
3802 * which will return an error if the architecture has no default machine
3803 * type and the user did not specify one, so that the user doesn't need
3804 * to say '-cpu help -machine something'.
3806 if (cpu_option && is_help_option(cpu_option)) {
3807 list_cpus(cpu_option);
3808 exit(0);
3811 if (qemu_opts_foreach(qemu_find_opts("device"),
3812 device_help_func, NULL, NULL)) {
3813 exit(0);
3816 user_register_global_props();
3818 replay_configure(icount_opts);
3820 if (incoming && !preconfig_exit_requested) {
3821 error_report("'preconfig' and 'incoming' options are "
3822 "mutually exclusive");
3823 exit(EXIT_FAILURE);
3826 configure_rtc(qemu_find_opts_singleton("rtc"));
3828 machine_class = select_machine();
3829 object_set_machine_compat_props(machine_class->compat_props);
3831 have_custom_ram_size = set_memory_options(&ram_slots, &maxram_size,
3832 machine_class);
3834 os_daemonize();
3837 * If QTest is enabled, keep the rcu_atfork enabled, since system processes
3838 * may be forked testing purposes (e.g. fork-server based fuzzing) The fork
3839 * should happen before a signle cpu instruction is executed, to prevent
3840 * deadlocks. See commit 73c6e40, rcu: "completely disable pthread_atfork
3841 * callbacks as soon as possible"
3843 if (!qtest_enabled()) {
3844 rcu_disable_atfork();
3847 if (pid_file && !qemu_write_pidfile(pid_file, &err)) {
3848 error_reportf_err(err, "cannot create PID file: ");
3849 exit(1);
3852 qemu_unlink_pidfile_notifier.notify = qemu_unlink_pidfile;
3853 qemu_add_exit_notifier(&qemu_unlink_pidfile_notifier);
3855 if (qemu_init_main_loop(&main_loop_err)) {
3856 error_report_err(main_loop_err);
3857 exit(1);
3860 #ifdef CONFIG_SECCOMP
3861 olist = qemu_find_opts_err("sandbox", NULL);
3862 if (olist) {
3863 qemu_opts_foreach(olist, parse_sandbox, NULL, &error_fatal);
3865 #endif
3867 qemu_opts_foreach(qemu_find_opts("name"),
3868 parse_name, NULL, &error_fatal);
3870 #ifndef _WIN32
3871 qemu_opts_foreach(qemu_find_opts("add-fd"),
3872 parse_add_fd, NULL, &error_fatal);
3874 qemu_opts_foreach(qemu_find_opts("add-fd"),
3875 cleanup_add_fd, NULL, &error_fatal);
3876 #endif
3878 current_machine = MACHINE(object_new_with_class(OBJECT_CLASS(machine_class)));
3879 if (machine_help_func(qemu_get_machine_opts(), current_machine)) {
3880 exit(0);
3882 object_property_add_child(object_get_root(), "machine",
3883 OBJECT(current_machine));
3884 object_property_add_child(container_get(OBJECT(current_machine),
3885 "/unattached"),
3886 "sysbus", OBJECT(sysbus_get_default()));
3888 if (machine_class->minimum_page_bits) {
3889 if (!set_preferred_target_page_bits(machine_class->minimum_page_bits)) {
3890 /* This would be a board error: specifying a minimum smaller than
3891 * a target's compile-time fixed setting.
3893 g_assert_not_reached();
3897 cpu_exec_init_all();
3899 if (machine_class->hw_version) {
3900 qemu_set_hw_version(machine_class->hw_version);
3903 if (!trace_init_backends()) {
3904 exit(1);
3906 trace_init_file(trace_file);
3908 /* Open the logfile at this point and set the log mask if necessary.
3910 qemu_set_log_filename(log_file, &error_fatal);
3911 if (log_mask) {
3912 int mask;
3913 mask = qemu_str_to_log_mask(log_mask);
3914 if (!mask) {
3915 qemu_print_log_usage(stdout);
3916 exit(1);
3918 qemu_set_log(mask);
3919 } else {
3920 qemu_set_log(0);
3923 /* add configured firmware directories */
3924 dirs = g_strsplit(CONFIG_QEMU_FIRMWAREPATH, G_SEARCHPATH_SEPARATOR_S, 0);
3925 for (i = 0; dirs[i] != NULL; i++) {
3926 qemu_add_data_dir(dirs[i]);
3928 g_strfreev(dirs);
3930 /* try to find datadir relative to the executable path */
3931 dir = os_find_datadir();
3932 qemu_add_data_dir(dir);
3933 g_free(dir);
3935 /* add the datadir specified when building */
3936 qemu_add_data_dir(CONFIG_QEMU_DATADIR);
3938 /* -L help lists the data directories and exits. */
3939 if (list_data_dirs) {
3940 for (i = 0; i < data_dir_idx; i++) {
3941 printf("%s\n", data_dir[i]);
3943 exit(0);
3946 /* machine_class: default to UP */
3947 machine_class->max_cpus = machine_class->max_cpus ?: 1;
3948 machine_class->min_cpus = machine_class->min_cpus ?: 1;
3949 machine_class->default_cpus = machine_class->default_cpus ?: 1;
3951 /* default to machine_class->default_cpus */
3952 current_machine->smp.cpus = machine_class->default_cpus;
3953 current_machine->smp.max_cpus = machine_class->default_cpus;
3954 current_machine->smp.cores = 1;
3955 current_machine->smp.threads = 1;
3956 current_machine->smp.sockets = 1;
3958 machine_class->smp_parse(current_machine,
3959 qemu_opts_find(qemu_find_opts("smp-opts"), NULL));
3961 /* sanity-check smp_cpus and max_cpus against machine_class */
3962 if (current_machine->smp.cpus < machine_class->min_cpus) {
3963 error_report("Invalid SMP CPUs %d. The min CPUs "
3964 "supported by machine '%s' is %d",
3965 current_machine->smp.cpus,
3966 machine_class->name, machine_class->min_cpus);
3967 exit(1);
3969 if (current_machine->smp.max_cpus > machine_class->max_cpus) {
3970 error_report("Invalid SMP CPUs %d. The max CPUs "
3971 "supported by machine '%s' is %d",
3972 current_machine->smp.max_cpus,
3973 machine_class->name, machine_class->max_cpus);
3974 exit(1);
3977 if (mem_prealloc) {
3978 char *val;
3980 val = g_strdup_printf("%d", current_machine->smp.cpus);
3981 object_register_sugar_prop("memory-backend", "prealloc-threads", val);
3982 g_free(val);
3983 object_register_sugar_prop("memory-backend", "prealloc", "on");
3987 * Get the default machine options from the machine if it is not already
3988 * specified either by the configuration file or by the command line.
3990 if (machine_class->default_machine_opts) {
3991 qemu_opts_set_defaults(qemu_find_opts("machine"),
3992 machine_class->default_machine_opts, 0);
3995 /* process plugin before CPUs are created, but once -smp has been parsed */
3996 if (qemu_plugin_load_list(&plugin_list)) {
3997 exit(1);
4000 qemu_opts_foreach(qemu_find_opts("device"),
4001 default_driver_check, NULL, NULL);
4002 qemu_opts_foreach(qemu_find_opts("global"),
4003 default_driver_check, NULL, NULL);
4005 if (!vga_model && !default_vga) {
4006 vga_interface_type = VGA_DEVICE;
4008 if (!has_defaults || machine_class->no_serial) {
4009 default_serial = 0;
4011 if (!has_defaults || machine_class->no_parallel) {
4012 default_parallel = 0;
4014 if (!has_defaults || machine_class->no_floppy) {
4015 default_floppy = 0;
4017 if (!has_defaults || machine_class->no_cdrom) {
4018 default_cdrom = 0;
4020 if (!has_defaults || machine_class->no_sdcard) {
4021 default_sdcard = 0;
4023 if (!has_defaults) {
4024 default_monitor = 0;
4025 default_net = 0;
4026 default_vga = 0;
4029 if (is_daemonized()) {
4030 if (!preconfig_exit_requested) {
4031 error_report("'preconfig' and 'daemonize' options are "
4032 "mutually exclusive");
4033 exit(EXIT_FAILURE);
4036 /* According to documentation and historically, -nographic redirects
4037 * serial port, parallel port and monitor to stdio, which does not work
4038 * with -daemonize. We can redirect these to null instead, but since
4039 * -nographic is legacy, let's just error out.
4040 * We disallow -nographic only if all other ports are not redirected
4041 * explicitly, to not break existing legacy setups which uses
4042 * -nographic _and_ redirects all ports explicitly - this is valid
4043 * usage, -nographic is just a no-op in this case.
4045 if (nographic
4046 && (default_parallel || default_serial || default_monitor)) {
4047 error_report("-nographic cannot be used with -daemonize");
4048 exit(1);
4050 #ifdef CONFIG_CURSES
4051 if (dpy.type == DISPLAY_TYPE_CURSES) {
4052 error_report("curses display cannot be used with -daemonize");
4053 exit(1);
4055 #endif
4058 if (nographic) {
4059 if (default_parallel)
4060 add_device_config(DEV_PARALLEL, "null");
4061 if (default_serial && default_monitor) {
4062 add_device_config(DEV_SERIAL, "mon:stdio");
4063 } else {
4064 if (default_serial)
4065 add_device_config(DEV_SERIAL, "stdio");
4066 if (default_monitor)
4067 monitor_parse("stdio", "readline", false);
4069 } else {
4070 if (default_serial)
4071 add_device_config(DEV_SERIAL, "vc:80Cx24C");
4072 if (default_parallel)
4073 add_device_config(DEV_PARALLEL, "vc:80Cx24C");
4074 if (default_monitor)
4075 monitor_parse("vc:80Cx24C", "readline", false);
4078 #if defined(CONFIG_VNC)
4079 if (!QTAILQ_EMPTY(&(qemu_find_opts("vnc")->head))) {
4080 display_remote++;
4082 #endif
4083 if (dpy.type == DISPLAY_TYPE_DEFAULT && !display_remote) {
4084 if (!qemu_display_find_default(&dpy)) {
4085 dpy.type = DISPLAY_TYPE_NONE;
4086 #if defined(CONFIG_VNC)
4087 vnc_parse("localhost:0,to=99,id=default", &error_abort);
4088 #endif
4091 if (dpy.type == DISPLAY_TYPE_DEFAULT) {
4092 dpy.type = DISPLAY_TYPE_NONE;
4095 if ((alt_grab || ctrl_grab) && dpy.type != DISPLAY_TYPE_SDL) {
4096 error_report("-alt-grab and -ctrl-grab are only valid "
4097 "for SDL, ignoring option");
4099 if (dpy.has_window_close &&
4100 (dpy.type != DISPLAY_TYPE_GTK && dpy.type != DISPLAY_TYPE_SDL)) {
4101 error_report("-no-quit is only valid for GTK and SDL, "
4102 "ignoring option");
4105 qemu_display_early_init(&dpy);
4106 qemu_console_early_init();
4108 if (dpy.has_gl && dpy.gl != DISPLAYGL_MODE_OFF && display_opengl == 0) {
4109 #if defined(CONFIG_OPENGL)
4110 error_report("OpenGL is not supported by the display");
4111 #else
4112 error_report("OpenGL support is disabled");
4113 #endif
4114 exit(1);
4117 page_size_init();
4118 socket_init();
4120 qemu_opts_foreach(qemu_find_opts("object"),
4121 user_creatable_add_opts_foreach,
4122 object_create_initial, &error_fatal);
4124 qemu_opts_foreach(qemu_find_opts("chardev"),
4125 chardev_init_func, NULL, &error_fatal);
4126 /* now chardevs have been created we may have semihosting to connect */
4127 qemu_semihosting_connect_chardevs();
4129 #ifdef CONFIG_VIRTFS
4130 qemu_opts_foreach(qemu_find_opts("fsdev"),
4131 fsdev_init_func, NULL, &error_fatal);
4132 #endif
4135 * Note: we need to create block backends before
4136 * machine_set_property(), so machine properties can refer to
4137 * them.
4139 configure_blockdev(&bdo_queue, machine_class, snapshot);
4141 machine_opts = qemu_get_machine_opts();
4142 qemu_opt_foreach(machine_opts, machine_set_property, current_machine,
4143 &error_fatal);
4144 current_machine->ram_size = ram_size;
4145 current_machine->maxram_size = maxram_size;
4146 current_machine->ram_slots = ram_slots;
4149 * Note: uses machine properties such as kernel-irqchip, must run
4150 * after machine_set_property().
4152 configure_accelerators(argv[0]);
4155 * Beware, QOM objects created before this point miss global and
4156 * compat properties.
4158 * Global properties get set up by qdev_prop_register_global(),
4159 * called from user_register_global_props(), and certain option
4160 * desugaring. Also in CPU feature desugaring (buried in
4161 * parse_cpu_option()), which happens below this point, but may
4162 * only target the CPU type, which can only be created after
4163 * parse_cpu_option() returned the type.
4165 * Machine compat properties: object_set_machine_compat_props().
4166 * Accelerator compat props: object_set_accelerator_compat_props(),
4167 * called from configure_accelerator().
4170 if (!qtest_enabled() && machine_class->deprecation_reason) {
4171 error_report("Machine type '%s' is deprecated: %s",
4172 machine_class->name, machine_class->deprecation_reason);
4176 * Note: creates a QOM object, must run only after global and
4177 * compat properties have been set up.
4179 migration_object_init();
4181 if (qtest_chrdev) {
4182 qtest_server_init(qtest_chrdev, qtest_log, &error_fatal);
4185 machine_opts = qemu_get_machine_opts();
4186 kernel_filename = qemu_opt_get(machine_opts, "kernel");
4187 initrd_filename = qemu_opt_get(machine_opts, "initrd");
4188 kernel_cmdline = qemu_opt_get(machine_opts, "append");
4189 bios_name = qemu_opt_get(machine_opts, "firmware");
4191 opts = qemu_opts_find(qemu_find_opts("boot-opts"), NULL);
4192 if (opts) {
4193 boot_order = qemu_opt_get(opts, "order");
4194 if (boot_order) {
4195 validate_bootdevices(boot_order, &error_fatal);
4198 boot_once = qemu_opt_get(opts, "once");
4199 if (boot_once) {
4200 validate_bootdevices(boot_once, &error_fatal);
4203 boot_menu = qemu_opt_get_bool(opts, "menu", boot_menu);
4204 boot_strict = qemu_opt_get_bool(opts, "strict", false);
4207 if (!boot_order) {
4208 boot_order = machine_class->default_boot_order;
4211 if (!kernel_cmdline) {
4212 kernel_cmdline = "";
4213 current_machine->kernel_cmdline = (char *)kernel_cmdline;
4216 linux_boot = (kernel_filename != NULL);
4218 if (!linux_boot && *kernel_cmdline != '\0') {
4219 error_report("-append only allowed with -kernel option");
4220 exit(1);
4223 if (!linux_boot && initrd_filename != NULL) {
4224 error_report("-initrd only allowed with -kernel option");
4225 exit(1);
4228 if (semihosting_enabled() && !semihosting_get_argc() && kernel_filename) {
4229 /* fall back to the -kernel/-append */
4230 semihosting_arg_fallback(kernel_filename, kernel_cmdline);
4233 /* spice needs the timers to be initialized by this point */
4234 qemu_spice_init();
4236 cpu_ticks_init();
4238 if (default_net) {
4239 QemuOptsList *net = qemu_find_opts("net");
4240 qemu_opts_set(net, NULL, "type", "nic", &error_abort);
4241 #ifdef CONFIG_SLIRP
4242 qemu_opts_set(net, NULL, "type", "user", &error_abort);
4243 #endif
4246 if (net_init_clients(&err) < 0) {
4247 error_report_err(err);
4248 exit(1);
4251 qemu_opts_foreach(qemu_find_opts("object"),
4252 user_creatable_add_opts_foreach,
4253 object_create_delayed, &error_fatal);
4255 tpm_init();
4257 blk_mig_init();
4258 ram_mig_init();
4259 dirty_bitmap_mig_init();
4261 qemu_opts_foreach(qemu_find_opts("mon"),
4262 mon_init_func, NULL, &error_fatal);
4264 /* connect semihosting console input if requested */
4265 qemu_semihosting_console_init();
4267 if (foreach_device_config(DEV_SERIAL, serial_parse) < 0)
4268 exit(1);
4269 if (foreach_device_config(DEV_PARALLEL, parallel_parse) < 0)
4270 exit(1);
4271 if (foreach_device_config(DEV_DEBUGCON, debugcon_parse) < 0)
4272 exit(1);
4274 /* If no default VGA is requested, the default is "none". */
4275 if (default_vga) {
4276 vga_model = get_default_vga_model(machine_class);
4278 if (vga_model) {
4279 select_vgahw(machine_class, vga_model);
4282 if (watchdog) {
4283 i = select_watchdog(watchdog);
4284 if (i > 0)
4285 exit (i == 1 ? 1 : 0);
4288 /* This checkpoint is required by replay to separate prior clock
4289 reading from the other reads, because timer polling functions query
4290 clock values from the log. */
4291 replay_checkpoint(CHECKPOINT_INIT);
4292 qdev_machine_init();
4294 current_machine->boot_order = boot_order;
4296 /* parse features once if machine provides default cpu_type */
4297 current_machine->cpu_type = machine_class->default_cpu_type;
4298 if (cpu_option) {
4299 current_machine->cpu_type = parse_cpu_option(cpu_option);
4302 if (current_machine->ram_memdev_id) {
4303 Object *backend;
4304 ram_addr_t backend_size;
4306 backend = object_resolve_path_type(current_machine->ram_memdev_id,
4307 TYPE_MEMORY_BACKEND, NULL);
4308 if (!backend) {
4309 error_report("Memory backend '%s' not found",
4310 current_machine->ram_memdev_id);
4311 exit(EXIT_FAILURE);
4313 backend_size = object_property_get_uint(backend, "size", &error_abort);
4314 if (have_custom_ram_size && backend_size != ram_size) {
4315 error_report("Size specified by -m option must match size of "
4316 "explicitly specified 'memory-backend' property");
4317 exit(EXIT_FAILURE);
4319 if (mem_path) {
4320 error_report("'-mem-path' can't be used together with"
4321 "'-machine memory-backend'");
4322 exit(EXIT_FAILURE);
4324 ram_size = backend_size;
4327 if (!xen_enabled()) {
4328 /* On 32-bit hosts, QEMU is limited by virtual address space */
4329 if (ram_size > (2047 << 20) && HOST_LONG_BITS == 32) {
4330 error_report("at most 2047 MB RAM can be simulated");
4331 exit(1);
4335 parse_numa_opts(current_machine);
4337 /* do monitor/qmp handling at preconfig state if requested */
4338 qemu_main_loop();
4340 if (machine_class->default_ram_id && current_machine->ram_size &&
4341 numa_uses_legacy_mem() && !current_machine->ram_memdev_id) {
4342 create_default_memdev(current_machine, mem_path);
4345 audio_init_audiodevs();
4347 /* from here on runstate is RUN_STATE_PRELAUNCH */
4348 machine_run_board_init(current_machine);
4350 realtime_init();
4352 soundhw_init();
4354 if (hax_enabled()) {
4355 hax_sync_vcpus();
4358 qemu_opts_foreach(qemu_find_opts("fw_cfg"),
4359 parse_fw_cfg, fw_cfg_find(), &error_fatal);
4361 /* init USB devices */
4362 if (machine_usb(current_machine)) {
4363 if (foreach_device_config(DEV_USB, usb_parse) < 0)
4364 exit(1);
4367 /* init generic devices */
4368 rom_set_order_override(FW_CFG_ORDER_OVERRIDE_DEVICE);
4369 qemu_opts_foreach(qemu_find_opts("device"),
4370 device_init_func, NULL, &error_fatal);
4372 cpu_synchronize_all_post_init();
4374 rom_reset_order_override();
4376 /* Did we create any drives that we failed to create a device for? */
4377 drive_check_orphaned();
4379 /* Don't warn about the default network setup that you get if
4380 * no command line -net or -netdev options are specified. There
4381 * are two cases that we would otherwise complain about:
4382 * (1) board doesn't support a NIC but the implicit "-net nic"
4383 * requested one
4384 * (2) CONFIG_SLIRP not set, in which case the implicit "-net nic"
4385 * sets up a nic that isn't connected to anything.
4387 if (!default_net && (!qtest_enabled() || has_defaults)) {
4388 net_check_clients();
4391 if (boot_once) {
4392 qemu_boot_set(boot_once, &error_fatal);
4393 qemu_register_reset(restore_boot_order, g_strdup(boot_order));
4396 /* init local displays */
4397 ds = init_displaystate();
4398 qemu_display_init(ds, &dpy);
4400 /* must be after terminal init, SDL library changes signal handlers */
4401 os_setup_signal_handling();
4403 /* init remote displays */
4404 #ifdef CONFIG_VNC
4405 qemu_opts_foreach(qemu_find_opts("vnc"),
4406 vnc_init_func, NULL, &error_fatal);
4407 #endif
4409 if (using_spice) {
4410 qemu_spice_display_init();
4413 if (foreach_device_config(DEV_GDB, gdbserver_start) < 0) {
4414 exit(1);
4417 qdev_machine_creation_done();
4419 /* TODO: once all bus devices are qdevified, this should be done
4420 * when bus is created by qdev.c */
4422 * TODO: If we had a main 'reset container' that the whole system
4423 * lived in, we could reset that using the multi-phase reset
4424 * APIs. For the moment, we just reset the sysbus, which will cause
4425 * all devices hanging off it (and all their child buses, recursively)
4426 * to be reset. Note that this will *not* reset any Device objects
4427 * which are not attached to some part of the qbus tree!
4429 qemu_register_reset(resettable_cold_reset_fn, sysbus_get_default());
4430 qemu_run_machine_init_done_notifiers();
4432 if (rom_check_and_register_reset() != 0) {
4433 error_report("rom check and register reset failed");
4434 exit(1);
4437 replay_start();
4439 /* This checkpoint is required by replay to separate prior clock
4440 reading from the other reads, because timer polling functions query
4441 clock values from the log. */
4442 replay_checkpoint(CHECKPOINT_RESET);
4443 qemu_system_reset(SHUTDOWN_CAUSE_NONE);
4444 register_global_state();
4445 if (loadvm) {
4446 Error *local_err = NULL;
4447 if (load_snapshot(loadvm, &local_err) < 0) {
4448 error_report_err(local_err);
4449 autostart = 0;
4450 exit(1);
4453 if (replay_mode != REPLAY_MODE_NONE) {
4454 replay_vmstate_init();
4457 qdev_prop_check_globals();
4458 if (vmstate_dump_file) {
4459 /* dump and exit */
4460 dump_vmstate_json_to_file(vmstate_dump_file);
4461 exit(0);
4464 if (incoming) {
4465 Error *local_err = NULL;
4466 qemu_start_incoming_migration(incoming, &local_err);
4467 if (local_err) {
4468 error_reportf_err(local_err, "-incoming %s: ", incoming);
4469 exit(1);
4471 } else if (autostart) {
4472 vm_start();
4475 accel_setup_post(current_machine);
4476 os_setup_post();
4478 return;
4481 void qemu_cleanup(void)
4483 gdbserver_cleanup();
4486 * cleaning up the migration object cancels any existing migration
4487 * try to do this early so that it also stops using devices.
4489 migration_shutdown();
4492 * We must cancel all block jobs while the block layer is drained,
4493 * or cancelling will be affected by throttling and thus may block
4494 * for an extended period of time.
4495 * vm_shutdown() will bdrv_drain_all(), so we may as well include
4496 * it in the drained section.
4497 * We do not need to end this section, because we do not want any
4498 * requests happening from here on anyway.
4500 bdrv_drain_all_begin();
4502 /* No more vcpu or device emulation activity beyond this point */
4503 vm_shutdown();
4504 replay_finish();
4506 job_cancel_sync_all();
4507 bdrv_close_all();
4509 res_free();
4511 /* vhost-user must be cleaned up before chardevs. */
4512 tpm_cleanup();
4513 net_cleanup();
4514 audio_cleanup();
4515 monitor_cleanup();
4516 qemu_chr_cleanup();
4517 user_creatable_cleanup();
4518 /* TODO: unref root container, check all devices are ok */