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
31 #include "config-host.h"
34 #include "sysemu/seccomp.h"
37 #if defined(CONFIG_VDE)
38 #include <libvdeplug.h>
42 #if defined(__APPLE__) || defined(main)
44 int qemu_main(int argc
, char **argv
, char **envp
);
45 int main(int argc
, char **argv
)
47 return qemu_main(argc
, argv
, NULL
);
50 #define main qemu_main
52 #endif /* CONFIG_SDL */
56 #define main qemu_main
57 #endif /* CONFIG_COCOA */
61 #include "qemu/sockets.h"
63 #include "hw/boards.h"
65 #include "hw/pcmcia.h"
66 #include "hw/i386/pc.h"
67 #include "hw/isa/isa.h"
69 #include "sysemu/watchdog.h"
70 #include "hw/i386/smbios.h"
71 #include "hw/xen/xen.h"
73 #include "hw/loader.h"
74 #include "monitor/qdev.h"
75 #include "sysemu/bt.h"
77 #include "net/slirp.h"
78 #include "monitor/monitor.h"
79 #include "ui/console.h"
80 #include "sysemu/sysemu.h"
81 #include "exec/gdbstub.h"
82 #include "qemu/timer.h"
83 #include "sysemu/char.h"
84 #include "qemu/bitmap.h"
85 #include "sysemu/blockdev.h"
86 #include "hw/block/block.h"
87 #include "migration/block.h"
88 #include "sysemu/tpm.h"
89 #include "sysemu/dma.h"
90 #include "audio/audio.h"
91 #include "migration/migration.h"
92 #include "sysemu/kvm.h"
93 #include "qapi/qmp/qjson.h"
94 #include "qemu/option.h"
95 #include "qemu/config-file.h"
96 #include "qemu-options.h"
97 #include "qmp-commands.h"
98 #include "qemu/main-loop.h"
100 #include "fsdev/qemu-fsdev.h"
102 #include "sysemu/qtest.h"
104 #include "disas/disas.h"
107 #include "slirp/libslirp.h"
110 #include "trace/control.h"
111 #include "qemu/queue.h"
112 #include "sysemu/cpus.h"
113 #include "sysemu/arch_init.h"
114 #include "qemu/osdep.h"
116 #include "ui/qemu-spice.h"
117 #include "qapi/string-input-visitor.h"
118 #include "qapi/opts-visitor.h"
119 #include "qom/object_interfaces.h"
120 #include "qapi-event.h"
122 #define DEFAULT_RAM_SIZE 128
124 #define MAX_VIRTIO_CONSOLES 1
125 #define MAX_SCLP_CONSOLES 1
127 static const char *data_dir
[16];
128 static int data_dir_idx
;
129 const char *bios_name
= NULL
;
130 enum vga_retrace_method vga_retrace_method
= VGA_RETRACE_DUMB
;
131 DisplayType display_type
= DT_DEFAULT
;
132 static int display_remote
;
133 const char* keyboard_layout
= NULL
;
135 const char *mem_path
= NULL
;
136 int mem_prealloc
= 0; /* force preallocation of physical target memory */
138 NICInfo nd_table
[MAX_NICS
];
140 static int rtc_utc
= 1;
141 static int rtc_date_offset
= -1; /* -1 means no change */
142 QEMUClockType rtc_clock
;
143 int vga_interface_type
= VGA_NONE
;
144 static int full_screen
= 0;
145 static int no_frame
= 0;
148 static bool grab_on_hover
;
150 CharDriverState
*serial_hds
[MAX_SERIAL_PORTS
];
151 CharDriverState
*parallel_hds
[MAX_PARALLEL_PORTS
];
152 CharDriverState
*virtcon_hds
[MAX_VIRTIO_CONSOLES
];
153 CharDriverState
*sclp_hds
[MAX_SCLP_CONSOLES
];
154 int win2k_install_hack
= 0;
161 const char *vnc_display
;
163 int acpi_enabled
= 1;
166 static int no_reboot
;
169 int graphic_rotate
= 0;
170 const char *watchdog
;
171 QEMUOptionRom option_rom
[MAX_OPTION_ROMS
];
173 int semihosting_enabled
= 0;
175 const char *qemu_name
;
178 unsigned int nb_prom_envs
= 0;
179 const char *prom_envs
[MAX_PROM_ENVS
];
181 static bool boot_strict
;
182 uint8_t *boot_splash_filedata
;
183 size_t boot_splash_filedata_size
;
184 uint8_t qemu_extra_params_fw
[2];
186 typedef struct FWBootEntry FWBootEntry
;
189 QTAILQ_ENTRY(FWBootEntry
) link
;
195 static QTAILQ_HEAD(, FWBootEntry
) fw_boot_order
=
196 QTAILQ_HEAD_INITIALIZER(fw_boot_order
);
200 NodeInfo numa_info
[MAX_NODES
];
202 uint8_t qemu_uuid
[16];
205 static QEMUBootSetHandler
*boot_set_handler
;
206 static void *boot_set_opaque
;
208 static NotifierList exit_notifiers
=
209 NOTIFIER_LIST_INITIALIZER(exit_notifiers
);
211 static NotifierList machine_init_done_notifiers
=
212 NOTIFIER_LIST_INITIALIZER(machine_init_done_notifiers
);
214 static bool tcg_allowed
= true;
217 enum xen_mode xen_mode
= XEN_EMULATE
;
218 static int tcg_tb_size
;
220 static int has_defaults
= 1;
221 static int default_serial
= 1;
222 static int default_parallel
= 1;
223 static int default_virtcon
= 1;
224 static int default_sclp
= 1;
225 static int default_monitor
= 1;
226 static int default_floppy
= 1;
227 static int default_cdrom
= 1;
228 static int default_sdcard
= 1;
229 static int default_vga
= 1;
235 { .driver
= "isa-serial", .flag
= &default_serial
},
236 { .driver
= "isa-parallel", .flag
= &default_parallel
},
237 { .driver
= "isa-fdc", .flag
= &default_floppy
},
238 { .driver
= "ide-cd", .flag
= &default_cdrom
},
239 { .driver
= "ide-hd", .flag
= &default_cdrom
},
240 { .driver
= "ide-drive", .flag
= &default_cdrom
},
241 { .driver
= "scsi-cd", .flag
= &default_cdrom
},
242 { .driver
= "virtio-serial-pci", .flag
= &default_virtcon
},
243 { .driver
= "virtio-serial-s390", .flag
= &default_virtcon
},
244 { .driver
= "virtio-serial", .flag
= &default_virtcon
},
245 { .driver
= "VGA", .flag
= &default_vga
},
246 { .driver
= "isa-vga", .flag
= &default_vga
},
247 { .driver
= "cirrus-vga", .flag
= &default_vga
},
248 { .driver
= "isa-cirrus-vga", .flag
= &default_vga
},
249 { .driver
= "vmware-svga", .flag
= &default_vga
},
250 { .driver
= "qxl-vga", .flag
= &default_vga
},
253 static QemuOptsList qemu_rtc_opts
= {
255 .head
= QTAILQ_HEAD_INITIALIZER(qemu_rtc_opts
.head
),
259 .type
= QEMU_OPT_STRING
,
262 .type
= QEMU_OPT_STRING
,
265 .type
= QEMU_OPT_STRING
,
267 { /* end of list */ }
271 static QemuOptsList qemu_sandbox_opts
= {
273 .implied_opt_name
= "enable",
274 .head
= QTAILQ_HEAD_INITIALIZER(qemu_sandbox_opts
.head
),
278 .type
= QEMU_OPT_BOOL
,
280 { /* end of list */ }
284 static QemuOptsList qemu_trace_opts
= {
286 .implied_opt_name
= "trace",
287 .head
= QTAILQ_HEAD_INITIALIZER(qemu_trace_opts
.head
),
291 .type
= QEMU_OPT_STRING
,
294 .type
= QEMU_OPT_STRING
,
296 { /* end of list */ }
300 static QemuOptsList qemu_option_rom_opts
= {
301 .name
= "option-rom",
302 .implied_opt_name
= "romfile",
303 .head
= QTAILQ_HEAD_INITIALIZER(qemu_option_rom_opts
.head
),
307 .type
= QEMU_OPT_NUMBER
,
310 .type
= QEMU_OPT_STRING
,
312 { /* end of list */ }
316 static QemuOptsList qemu_machine_opts
= {
318 .implied_opt_name
= "type",
320 .head
= QTAILQ_HEAD_INITIALIZER(qemu_machine_opts
.head
),
324 .type
= QEMU_OPT_STRING
,
325 .help
= "emulated machine"
328 .type
= QEMU_OPT_STRING
,
329 .help
= "accelerator list",
331 .name
= "kernel_irqchip",
332 .type
= QEMU_OPT_BOOL
,
333 .help
= "use KVM in-kernel irqchip",
335 .name
= "kvm_shadow_mem",
336 .type
= QEMU_OPT_SIZE
,
337 .help
= "KVM shadow MMU size",
340 .type
= QEMU_OPT_STRING
,
341 .help
= "Linux kernel image file",
344 .type
= QEMU_OPT_STRING
,
345 .help
= "Linux initial ramdisk file",
348 .type
= QEMU_OPT_STRING
,
349 .help
= "Linux kernel command line",
352 .type
= QEMU_OPT_STRING
,
353 .help
= "Linux kernel device tree file",
356 .type
= QEMU_OPT_STRING
,
357 .help
= "Dump current dtb to a file and quit",
359 .name
= "phandle_start",
360 .type
= QEMU_OPT_NUMBER
,
361 .help
= "The first phandle ID we may generate dynamically",
363 .name
= "dt_compatible",
364 .type
= QEMU_OPT_STRING
,
365 .help
= "Overrides the \"compatible\" property of the dt root node",
367 .name
= "dump-guest-core",
368 .type
= QEMU_OPT_BOOL
,
369 .help
= "Include guest memory in a core dump",
372 .type
= QEMU_OPT_BOOL
,
373 .help
= "enable/disable memory merge support",
376 .type
= QEMU_OPT_BOOL
,
377 .help
= "Set on/off to enable/disable usb",
380 .type
= QEMU_OPT_STRING
,
381 .help
= "firmware image",
384 .type
= QEMU_OPT_STRING
,
385 .help
= "Specifies the KVM virtualization mode (HV, PR)",
387 .name
= PC_MACHINE_MAX_RAM_BELOW_4G
,
388 .type
= QEMU_OPT_SIZE
,
389 .help
= "maximum ram below the 4G boundary (32bit boundary)",
391 { /* End of list */ }
395 static QemuOptsList qemu_boot_opts
= {
397 .implied_opt_name
= "order",
399 .head
= QTAILQ_HEAD_INITIALIZER(qemu_boot_opts
.head
),
403 .type
= QEMU_OPT_STRING
,
406 .type
= QEMU_OPT_STRING
,
409 .type
= QEMU_OPT_BOOL
,
412 .type
= QEMU_OPT_STRING
,
414 .name
= "splash-time",
415 .type
= QEMU_OPT_STRING
,
417 .name
= "reboot-timeout",
418 .type
= QEMU_OPT_STRING
,
421 .type
= QEMU_OPT_BOOL
,
427 static QemuOptsList qemu_add_fd_opts
= {
429 .head
= QTAILQ_HEAD_INITIALIZER(qemu_add_fd_opts
.head
),
433 .type
= QEMU_OPT_NUMBER
,
434 .help
= "file descriptor of which a duplicate is added to fd set",
437 .type
= QEMU_OPT_NUMBER
,
438 .help
= "ID of the fd set to add fd to",
441 .type
= QEMU_OPT_STRING
,
442 .help
= "free-form string used to describe fd",
444 { /* end of list */ }
448 static QemuOptsList qemu_object_opts
= {
450 .implied_opt_name
= "qom-type",
451 .head
= QTAILQ_HEAD_INITIALIZER(qemu_object_opts
.head
),
457 static QemuOptsList qemu_tpmdev_opts
= {
459 .implied_opt_name
= "type",
460 .head
= QTAILQ_HEAD_INITIALIZER(qemu_tpmdev_opts
.head
),
462 /* options are defined in the TPM backends */
463 { /* end of list */ }
467 static QemuOptsList qemu_realtime_opts
= {
469 .head
= QTAILQ_HEAD_INITIALIZER(qemu_realtime_opts
.head
),
473 .type
= QEMU_OPT_BOOL
,
475 { /* end of list */ }
479 static QemuOptsList qemu_msg_opts
= {
481 .head
= QTAILQ_HEAD_INITIALIZER(qemu_msg_opts
.head
),
485 .type
= QEMU_OPT_BOOL
,
487 { /* end of list */ }
491 static QemuOptsList qemu_name_opts
= {
493 .implied_opt_name
= "guest",
495 .head
= QTAILQ_HEAD_INITIALIZER(qemu_name_opts
.head
),
499 .type
= QEMU_OPT_STRING
,
500 .help
= "Sets the name of the guest.\n"
501 "This name will be displayed in the SDL window caption.\n"
502 "The name will also be used for the VNC server",
505 .type
= QEMU_OPT_STRING
,
506 .help
= "Sets the name of the QEMU process, as shown in top etc",
508 .name
= "debug-threads",
509 .type
= QEMU_OPT_BOOL
,
510 .help
= "When enabled, name the individual threads; defaults off.\n"
511 "NOTE: The thread names are for debugging and not a\n"
514 { /* End of list */ }
518 static QemuOptsList qemu_mem_opts
= {
520 .implied_opt_name
= "size",
521 .head
= QTAILQ_HEAD_INITIALIZER(qemu_mem_opts
.head
),
526 .type
= QEMU_OPT_SIZE
,
530 .type
= QEMU_OPT_NUMBER
,
534 .type
= QEMU_OPT_SIZE
,
536 { /* end of list */ }
540 static QemuOptsList qemu_icount_opts
= {
542 .implied_opt_name
= "shift",
544 .head
= QTAILQ_HEAD_INITIALIZER(qemu_icount_opts
.head
),
548 .type
= QEMU_OPT_STRING
,
550 { /* end of list */ }
555 * Get machine options
557 * Returns: machine options (never null).
559 QemuOpts
*qemu_get_machine_opts(void)
561 return qemu_find_opts_singleton("machine");
564 const char *qemu_get_vm_name(void)
569 static void res_free(void)
571 if (boot_splash_filedata
!= NULL
) {
572 g_free(boot_splash_filedata
);
573 boot_splash_filedata
= NULL
;
577 static int default_driver_check(QemuOpts
*opts
, void *opaque
)
579 const char *driver
= qemu_opt_get(opts
, "driver");
584 for (i
= 0; i
< ARRAY_SIZE(default_list
); i
++) {
585 if (strcmp(default_list
[i
].driver
, driver
) != 0)
587 *(default_list
[i
].flag
) = 0;
592 /***********************************************************/
595 static RunState current_run_state
= RUN_STATE_PRELAUNCH
;
597 /* We use RUN_STATE_MAX but any invalid value will do */
598 static RunState vmstop_requested
= RUN_STATE_MAX
;
599 static QemuMutex vmstop_lock
;
604 } RunStateTransition
;
606 static const RunStateTransition runstate_transitions_def
[] = {
608 { RUN_STATE_DEBUG
, RUN_STATE_RUNNING
},
609 { RUN_STATE_DEBUG
, RUN_STATE_FINISH_MIGRATE
},
611 { RUN_STATE_INMIGRATE
, RUN_STATE_RUNNING
},
612 { RUN_STATE_INMIGRATE
, RUN_STATE_PAUSED
},
614 { RUN_STATE_INTERNAL_ERROR
, RUN_STATE_PAUSED
},
615 { RUN_STATE_INTERNAL_ERROR
, RUN_STATE_FINISH_MIGRATE
},
617 { RUN_STATE_IO_ERROR
, RUN_STATE_RUNNING
},
618 { RUN_STATE_IO_ERROR
, RUN_STATE_FINISH_MIGRATE
},
620 { RUN_STATE_PAUSED
, RUN_STATE_RUNNING
},
621 { RUN_STATE_PAUSED
, RUN_STATE_FINISH_MIGRATE
},
623 { RUN_STATE_POSTMIGRATE
, RUN_STATE_RUNNING
},
624 { RUN_STATE_POSTMIGRATE
, RUN_STATE_FINISH_MIGRATE
},
626 { RUN_STATE_PRELAUNCH
, RUN_STATE_RUNNING
},
627 { RUN_STATE_PRELAUNCH
, RUN_STATE_FINISH_MIGRATE
},
628 { RUN_STATE_PRELAUNCH
, RUN_STATE_INMIGRATE
},
630 { RUN_STATE_FINISH_MIGRATE
, RUN_STATE_RUNNING
},
631 { RUN_STATE_FINISH_MIGRATE
, RUN_STATE_POSTMIGRATE
},
633 { RUN_STATE_RESTORE_VM
, RUN_STATE_RUNNING
},
635 { RUN_STATE_RUNNING
, RUN_STATE_DEBUG
},
636 { RUN_STATE_RUNNING
, RUN_STATE_INTERNAL_ERROR
},
637 { RUN_STATE_RUNNING
, RUN_STATE_IO_ERROR
},
638 { RUN_STATE_RUNNING
, RUN_STATE_PAUSED
},
639 { RUN_STATE_RUNNING
, RUN_STATE_FINISH_MIGRATE
},
640 { RUN_STATE_RUNNING
, RUN_STATE_RESTORE_VM
},
641 { RUN_STATE_RUNNING
, RUN_STATE_SAVE_VM
},
642 { RUN_STATE_RUNNING
, RUN_STATE_SHUTDOWN
},
643 { RUN_STATE_RUNNING
, RUN_STATE_WATCHDOG
},
644 { RUN_STATE_RUNNING
, RUN_STATE_GUEST_PANICKED
},
646 { RUN_STATE_SAVE_VM
, RUN_STATE_RUNNING
},
648 { RUN_STATE_SHUTDOWN
, RUN_STATE_PAUSED
},
649 { RUN_STATE_SHUTDOWN
, RUN_STATE_FINISH_MIGRATE
},
651 { RUN_STATE_DEBUG
, RUN_STATE_SUSPENDED
},
652 { RUN_STATE_RUNNING
, RUN_STATE_SUSPENDED
},
653 { RUN_STATE_SUSPENDED
, RUN_STATE_RUNNING
},
654 { RUN_STATE_SUSPENDED
, RUN_STATE_FINISH_MIGRATE
},
656 { RUN_STATE_WATCHDOG
, RUN_STATE_RUNNING
},
657 { RUN_STATE_WATCHDOG
, RUN_STATE_FINISH_MIGRATE
},
659 { RUN_STATE_GUEST_PANICKED
, RUN_STATE_RUNNING
},
660 { RUN_STATE_GUEST_PANICKED
, RUN_STATE_FINISH_MIGRATE
},
662 { RUN_STATE_MAX
, RUN_STATE_MAX
},
665 static bool runstate_valid_transitions
[RUN_STATE_MAX
][RUN_STATE_MAX
];
667 bool runstate_check(RunState state
)
669 return current_run_state
== state
;
672 static void runstate_init(void)
674 const RunStateTransition
*p
;
676 memset(&runstate_valid_transitions
, 0, sizeof(runstate_valid_transitions
));
677 for (p
= &runstate_transitions_def
[0]; p
->from
!= RUN_STATE_MAX
; p
++) {
678 runstate_valid_transitions
[p
->from
][p
->to
] = true;
681 qemu_mutex_init(&vmstop_lock
);
684 /* This function will abort() on invalid state transitions */
685 void runstate_set(RunState new_state
)
687 assert(new_state
< RUN_STATE_MAX
);
689 if (!runstate_valid_transitions
[current_run_state
][new_state
]) {
690 fprintf(stderr
, "ERROR: invalid runstate transition: '%s' -> '%s'\n",
691 RunState_lookup
[current_run_state
],
692 RunState_lookup
[new_state
]);
695 trace_runstate_set(new_state
);
696 current_run_state
= new_state
;
699 int runstate_is_running(void)
701 return runstate_check(RUN_STATE_RUNNING
);
704 bool runstate_needs_reset(void)
706 return runstate_check(RUN_STATE_INTERNAL_ERROR
) ||
707 runstate_check(RUN_STATE_SHUTDOWN
);
710 StatusInfo
*qmp_query_status(Error
**errp
)
712 StatusInfo
*info
= g_malloc0(sizeof(*info
));
714 info
->running
= runstate_is_running();
715 info
->singlestep
= singlestep
;
716 info
->status
= current_run_state
;
721 static bool qemu_vmstop_requested(RunState
*r
)
723 qemu_mutex_lock(&vmstop_lock
);
724 *r
= vmstop_requested
;
725 vmstop_requested
= RUN_STATE_MAX
;
726 qemu_mutex_unlock(&vmstop_lock
);
727 return *r
< RUN_STATE_MAX
;
730 void qemu_system_vmstop_request_prepare(void)
732 qemu_mutex_lock(&vmstop_lock
);
735 void qemu_system_vmstop_request(RunState state
)
737 vmstop_requested
= state
;
738 qemu_mutex_unlock(&vmstop_lock
);
746 qemu_vmstop_requested(&requested
);
747 if (runstate_is_running() && requested
== RUN_STATE_MAX
) {
751 /* Ensure that a STOP/RESUME pair of events is emitted if a
752 * vmstop request was pending. The BLOCK_IO_ERROR event, for
753 * example, according to documentation is always followed by
756 if (runstate_is_running()) {
757 qapi_event_send_stop(&error_abort
);
760 runstate_set(RUN_STATE_RUNNING
);
761 vm_state_notify(1, RUN_STATE_RUNNING
);
765 qapi_event_send_resume(&error_abort
);
769 /***********************************************************/
770 /* real time host monotonic timer */
772 /***********************************************************/
773 /* host time/date access */
774 void qemu_get_timedate(struct tm
*tm
, int offset
)
780 if (rtc_date_offset
== -1) {
784 localtime_r(&ti
, tm
);
786 ti
-= rtc_date_offset
;
791 int qemu_timedate_diff(struct tm
*tm
)
795 if (rtc_date_offset
== -1)
797 seconds
= mktimegm(tm
);
800 tmp
.tm_isdst
= -1; /* use timezone to figure it out */
801 seconds
= mktime(&tmp
);
804 seconds
= mktimegm(tm
) + rtc_date_offset
;
806 return seconds
- time(NULL
);
809 static void configure_rtc_date_offset(const char *startdate
, int legacy
)
811 time_t rtc_start_date
;
814 if (!strcmp(startdate
, "now") && legacy
) {
815 rtc_date_offset
= -1;
817 if (sscanf(startdate
, "%d-%d-%dT%d:%d:%d",
825 } else if (sscanf(startdate
, "%d-%d-%d",
837 rtc_start_date
= mktimegm(&tm
);
838 if (rtc_start_date
== -1) {
840 fprintf(stderr
, "Invalid date format. Valid formats are:\n"
841 "'2006-06-17T16:01:21' or '2006-06-17'\n");
844 rtc_date_offset
= time(NULL
) - rtc_start_date
;
848 static void configure_rtc(QemuOpts
*opts
)
852 value
= qemu_opt_get(opts
, "base");
854 if (!strcmp(value
, "utc")) {
856 } else if (!strcmp(value
, "localtime")) {
859 configure_rtc_date_offset(value
, 0);
862 value
= qemu_opt_get(opts
, "clock");
864 if (!strcmp(value
, "host")) {
865 rtc_clock
= QEMU_CLOCK_HOST
;
866 } else if (!strcmp(value
, "rt")) {
867 rtc_clock
= QEMU_CLOCK_REALTIME
;
868 } else if (!strcmp(value
, "vm")) {
869 rtc_clock
= QEMU_CLOCK_VIRTUAL
;
871 fprintf(stderr
, "qemu: invalid option value '%s'\n", value
);
875 value
= qemu_opt_get(opts
, "driftfix");
877 if (!strcmp(value
, "slew")) {
878 static GlobalProperty slew_lost_ticks
[] = {
880 .driver
= "mc146818rtc",
881 .property
= "lost_tick_policy",
884 { /* end of list */ }
887 qdev_prop_register_global_list(slew_lost_ticks
);
888 } else if (!strcmp(value
, "none")) {
889 /* discard is default */
891 fprintf(stderr
, "qemu: invalid option value '%s'\n", value
);
897 /***********************************************************/
898 /* Bluetooth support */
901 static struct HCIInfo
*hci_table
[MAX_NICS
];
903 struct HCIInfo
*qemu_next_hci(void)
905 if (cur_hci
== nb_hcis
)
908 return hci_table
[cur_hci
++];
911 static int bt_hci_parse(const char *str
)
916 if (nb_hcis
>= MAX_NICS
) {
917 fprintf(stderr
, "qemu: Too many bluetooth HCIs (max %i).\n", MAX_NICS
);
930 bdaddr
.b
[5] = 0x56 + nb_hcis
;
931 hci
->bdaddr_set(hci
, bdaddr
.b
);
933 hci_table
[nb_hcis
++] = hci
;
938 static void bt_vhci_add(int vlan_id
)
940 struct bt_scatternet_s
*vlan
= qemu_find_bt_vlan(vlan_id
);
943 fprintf(stderr
, "qemu: warning: adding a VHCI to "
944 "an empty scatternet %i\n", vlan_id
);
946 bt_vhci_init(bt_new_hci(vlan
));
949 static struct bt_device_s
*bt_device_add(const char *opt
)
951 struct bt_scatternet_s
*vlan
;
953 char *endp
= strstr(opt
, ",vlan=");
954 int len
= (endp
? endp
- opt
: strlen(opt
)) + 1;
957 pstrcpy(devname
, MIN(sizeof(devname
), len
), opt
);
960 vlan_id
= strtol(endp
+ 6, &endp
, 0);
962 fprintf(stderr
, "qemu: unrecognised bluetooth vlan Id\n");
967 vlan
= qemu_find_bt_vlan(vlan_id
);
970 fprintf(stderr
, "qemu: warning: adding a slave device to "
971 "an empty scatternet %i\n", vlan_id
);
973 if (!strcmp(devname
, "keyboard"))
974 return bt_keyboard_init(vlan
);
976 fprintf(stderr
, "qemu: unsupported bluetooth device `%s'\n", devname
);
980 static int bt_parse(const char *opt
)
982 const char *endp
, *p
;
985 if (strstart(opt
, "hci", &endp
)) {
986 if (!*endp
|| *endp
== ',') {
988 if (!strstart(endp
, ",vlan=", 0))
991 return bt_hci_parse(opt
);
993 } else if (strstart(opt
, "vhci", &endp
)) {
994 if (!*endp
|| *endp
== ',') {
996 if (strstart(endp
, ",vlan=", &p
)) {
997 vlan
= strtol(p
, (char **) &endp
, 0);
999 fprintf(stderr
, "qemu: bad scatternet '%s'\n", p
);
1003 fprintf(stderr
, "qemu: bad parameter '%s'\n", endp
+ 1);
1012 } else if (strstart(opt
, "device:", &endp
))
1013 return !bt_device_add(endp
);
1015 fprintf(stderr
, "qemu: bad bluetooth parameter '%s'\n", opt
);
1019 static int parse_sandbox(QemuOpts
*opts
, void *opaque
)
1021 /* FIXME: change this to true for 1.3 */
1022 if (qemu_opt_get_bool(opts
, "enable", false)) {
1023 #ifdef CONFIG_SECCOMP
1024 if (seccomp_start() < 0) {
1025 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1026 "failed to install seccomp syscall filter in the kernel");
1030 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1031 "sandboxing request but seccomp is not compiled into this build");
1039 static int parse_name(QemuOpts
*opts
, void *opaque
)
1041 const char *proc_name
;
1043 if (qemu_opt_get(opts
, "debug-threads")) {
1044 qemu_thread_naming(qemu_opt_get_bool(opts
, "debug-threads", false));
1046 qemu_name
= qemu_opt_get(opts
, "guest");
1048 proc_name
= qemu_opt_get(opts
, "process");
1050 os_set_proc_name(proc_name
);
1056 bool usb_enabled(bool default_usb
)
1058 return qemu_opt_get_bool(qemu_get_machine_opts(), "usb",
1059 has_defaults
&& default_usb
);
1063 static int parse_add_fd(QemuOpts
*opts
, void *opaque
)
1065 int fd
, dupfd
, flags
;
1067 const char *fd_opaque
= NULL
;
1069 fd
= qemu_opt_get_number(opts
, "fd", -1);
1070 fdset_id
= qemu_opt_get_number(opts
, "set", -1);
1071 fd_opaque
= qemu_opt_get(opts
, "opaque");
1074 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1075 "fd option is required and must be non-negative");
1079 if (fd
<= STDERR_FILENO
) {
1080 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1081 "fd cannot be a standard I/O stream");
1086 * All fds inherited across exec() necessarily have FD_CLOEXEC
1087 * clear, while qemu sets FD_CLOEXEC on all other fds used internally.
1089 flags
= fcntl(fd
, F_GETFD
);
1090 if (flags
== -1 || (flags
& FD_CLOEXEC
)) {
1091 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1092 "fd is not valid or already in use");
1097 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1098 "set option is required and must be non-negative");
1102 #ifdef F_DUPFD_CLOEXEC
1103 dupfd
= fcntl(fd
, F_DUPFD_CLOEXEC
, 0);
1107 qemu_set_cloexec(dupfd
);
1111 qerror_report(ERROR_CLASS_GENERIC_ERROR
,
1112 "Error duplicating fd: %s", strerror(errno
));
1116 /* add the duplicate fd, and optionally the opaque string, to the fd set */
1117 monitor_fdset_add_fd(dupfd
, true, fdset_id
, fd_opaque
? true : false,
1123 static int cleanup_add_fd(QemuOpts
*opts
, void *opaque
)
1127 fd
= qemu_opt_get_number(opts
, "fd", -1);
1134 /***********************************************************/
1135 /* QEMU Block devices */
1137 #define HD_OPTS "media=disk"
1138 #define CDROM_OPTS "media=cdrom"
1140 #define PFLASH_OPTS ""
1144 static int drive_init_func(QemuOpts
*opts
, void *opaque
)
1146 BlockInterfaceType
*block_default_type
= opaque
;
1148 return drive_new(opts
, *block_default_type
) == NULL
;
1151 static int drive_enable_snapshot(QemuOpts
*opts
, void *opaque
)
1153 if (NULL
== qemu_opt_get(opts
, "snapshot")) {
1154 qemu_opt_set(opts
, "snapshot", "on");
1159 static void default_drive(int enable
, int snapshot
, BlockInterfaceType type
,
1160 int index
, const char *optstr
)
1164 if (!enable
|| drive_get_by_index(type
, index
)) {
1168 opts
= drive_add(type
, index
, NULL
, optstr
);
1170 drive_enable_snapshot(opts
, NULL
);
1172 if (!drive_new(opts
, type
)) {
1177 void qemu_register_boot_set(QEMUBootSetHandler
*func
, void *opaque
)
1179 boot_set_handler
= func
;
1180 boot_set_opaque
= opaque
;
1183 int qemu_boot_set(const char *boot_order
)
1185 if (!boot_set_handler
) {
1188 return boot_set_handler(boot_set_opaque
, boot_order
);
1191 static void validate_bootdevices(const char *devices
)
1193 /* We just do some generic consistency checks */
1197 for (p
= devices
; *p
!= '\0'; p
++) {
1198 /* Allowed boot devices are:
1199 * a-b: floppy disk drives
1200 * c-f: IDE disk drives
1201 * g-m: machine implementation dependent drives
1202 * n-p: network devices
1203 * It's up to each machine implementation to check if the given boot
1204 * devices match the actual hardware implementation and firmware
1207 if (*p
< 'a' || *p
> 'p') {
1208 fprintf(stderr
, "Invalid boot device '%c'\n", *p
);
1211 if (bitmap
& (1 << (*p
- 'a'))) {
1212 fprintf(stderr
, "Boot device '%c' was given twice\n", *p
);
1215 bitmap
|= 1 << (*p
- 'a');
1219 static void restore_boot_order(void *opaque
)
1221 char *normal_boot_order
= opaque
;
1222 static int first
= 1;
1224 /* Restore boot order and remove ourselves after the first boot */
1230 qemu_boot_set(normal_boot_order
);
1232 qemu_unregister_reset(restore_boot_order
, normal_boot_order
);
1233 g_free(normal_boot_order
);
1236 void add_boot_device_path(int32_t bootindex
, DeviceState
*dev
,
1239 FWBootEntry
*node
, *i
;
1241 if (bootindex
< 0) {
1245 assert(dev
!= NULL
|| suffix
!= NULL
);
1247 node
= g_malloc0(sizeof(FWBootEntry
));
1248 node
->bootindex
= bootindex
;
1249 node
->suffix
= g_strdup(suffix
);
1252 QTAILQ_FOREACH(i
, &fw_boot_order
, link
) {
1253 if (i
->bootindex
== bootindex
) {
1254 fprintf(stderr
, "Two devices with same boot index %d\n", bootindex
);
1256 } else if (i
->bootindex
< bootindex
) {
1259 QTAILQ_INSERT_BEFORE(i
, node
, link
);
1262 QTAILQ_INSERT_TAIL(&fw_boot_order
, node
, link
);
1265 DeviceState
*get_boot_device(uint32_t position
)
1267 uint32_t counter
= 0;
1268 FWBootEntry
*i
= NULL
;
1269 DeviceState
*res
= NULL
;
1271 if (!QTAILQ_EMPTY(&fw_boot_order
)) {
1272 QTAILQ_FOREACH(i
, &fw_boot_order
, link
) {
1273 if (counter
== position
) {
1284 * This function returns null terminated string that consist of new line
1285 * separated device paths.
1287 * memory pointed by "size" is assigned total length of the array in bytes
1290 char *get_boot_devices_list(size_t *size
, bool ignore_suffixes
)
1296 QTAILQ_FOREACH(i
, &fw_boot_order
, link
) {
1297 char *devpath
= NULL
, *bootpath
;
1301 devpath
= qdev_get_fw_dev_path(i
->dev
);
1305 if (i
->suffix
&& !ignore_suffixes
&& devpath
) {
1306 size_t bootpathlen
= strlen(devpath
) + strlen(i
->suffix
) + 1;
1308 bootpath
= g_malloc(bootpathlen
);
1309 snprintf(bootpath
, bootpathlen
, "%s%s", devpath
, i
->suffix
);
1311 } else if (devpath
) {
1313 } else if (!ignore_suffixes
) {
1315 bootpath
= g_strdup(i
->suffix
);
1317 bootpath
= g_strdup("");
1321 list
[total
-1] = '\n';
1323 len
= strlen(bootpath
) + 1;
1324 list
= g_realloc(list
, total
+ len
);
1325 memcpy(&list
[total
], bootpath
, len
);
1332 if (boot_strict
&& *size
> 0) {
1333 list
[total
-1] = '\n';
1334 list
= g_realloc(list
, total
+ 5);
1335 memcpy(&list
[total
], "HALT", 5);
1341 static QemuOptsList qemu_smp_opts
= {
1343 .implied_opt_name
= "cpus",
1344 .merge_lists
= true,
1345 .head
= QTAILQ_HEAD_INITIALIZER(qemu_smp_opts
.head
),
1349 .type
= QEMU_OPT_NUMBER
,
1352 .type
= QEMU_OPT_NUMBER
,
1355 .type
= QEMU_OPT_NUMBER
,
1358 .type
= QEMU_OPT_NUMBER
,
1361 .type
= QEMU_OPT_NUMBER
,
1363 { /*End of list */ }
1367 static void smp_parse(QemuOpts
*opts
)
1371 unsigned cpus
= qemu_opt_get_number(opts
, "cpus", 0);
1372 unsigned sockets
= qemu_opt_get_number(opts
, "sockets", 0);
1373 unsigned cores
= qemu_opt_get_number(opts
, "cores", 0);
1374 unsigned threads
= qemu_opt_get_number(opts
, "threads", 0);
1376 /* compute missing values, prefer sockets over cores over threads */
1377 if (cpus
== 0 || sockets
== 0) {
1378 sockets
= sockets
> 0 ? sockets
: 1;
1379 cores
= cores
> 0 ? cores
: 1;
1380 threads
= threads
> 0 ? threads
: 1;
1382 cpus
= cores
* threads
* sockets
;
1386 threads
= threads
> 0 ? threads
: 1;
1387 cores
= cpus
/ (sockets
* threads
);
1389 threads
= cpus
/ (cores
* sockets
);
1393 max_cpus
= qemu_opt_get_number(opts
, "maxcpus", 0);
1396 smp_cores
= cores
> 0 ? cores
: 1;
1397 smp_threads
= threads
> 0 ? threads
: 1;
1401 if (max_cpus
== 0) {
1402 max_cpus
= smp_cpus
;
1405 if (max_cpus
> MAX_CPUMASK_BITS
) {
1406 fprintf(stderr
, "Unsupported number of maxcpus\n");
1409 if (max_cpus
< smp_cpus
) {
1410 fprintf(stderr
, "maxcpus must be equal to or greater than smp\n");
1416 static void configure_realtime(QemuOpts
*opts
)
1420 enable_mlock
= qemu_opt_get_bool(opts
, "mlock", true);
1423 if (os_mlock() < 0) {
1424 fprintf(stderr
, "qemu: locking memory failed\n");
1431 static void configure_msg(QemuOpts
*opts
)
1433 enable_timestamp_msg
= qemu_opt_get_bool(opts
, "timestamp", true);
1436 /***********************************************************/
1439 static int usb_device_add(const char *devname
)
1441 USBDevice
*dev
= NULL
;
1442 #ifndef CONFIG_LINUX
1446 if (!usb_enabled(false)) {
1450 /* drivers with .usbdevice_name entry in USBDeviceInfo */
1451 dev
= usbdevice_create(devname
);
1455 /* the other ones */
1456 #ifndef CONFIG_LINUX
1457 /* only the linux version is qdev-ified, usb-bsd still needs this */
1458 if (strstart(devname
, "host:", &p
)) {
1459 dev
= usb_host_device_open(usb_bus_find(-1), p
);
1469 static int usb_device_del(const char *devname
)
1474 if (strstart(devname
, "host:", &p
)) {
1478 if (!usb_enabled(false)) {
1482 p
= strchr(devname
, '.');
1485 bus_num
= strtoul(devname
, NULL
, 0);
1486 addr
= strtoul(p
+ 1, NULL
, 0);
1488 return usb_device_delete_addr(bus_num
, addr
);
1491 static int usb_parse(const char *cmdline
)
1494 r
= usb_device_add(cmdline
);
1496 fprintf(stderr
, "qemu: could not add USB device '%s'\n", cmdline
);
1501 void do_usb_add(Monitor
*mon
, const QDict
*qdict
)
1503 const char *devname
= qdict_get_str(qdict
, "devname");
1504 if (usb_device_add(devname
) < 0) {
1505 error_report("could not add USB device '%s'", devname
);
1509 void do_usb_del(Monitor
*mon
, const QDict
*qdict
)
1511 const char *devname
= qdict_get_str(qdict
, "devname");
1512 if (usb_device_del(devname
) < 0) {
1513 error_report("could not delete USB device '%s'", devname
);
1517 /***********************************************************/
1518 /* PCMCIA/Cardbus */
1520 static struct pcmcia_socket_entry_s
{
1521 PCMCIASocket
*socket
;
1522 struct pcmcia_socket_entry_s
*next
;
1523 } *pcmcia_sockets
= 0;
1525 void pcmcia_socket_register(PCMCIASocket
*socket
)
1527 struct pcmcia_socket_entry_s
*entry
;
1529 entry
= g_malloc(sizeof(struct pcmcia_socket_entry_s
));
1530 entry
->socket
= socket
;
1531 entry
->next
= pcmcia_sockets
;
1532 pcmcia_sockets
= entry
;
1535 void pcmcia_socket_unregister(PCMCIASocket
*socket
)
1537 struct pcmcia_socket_entry_s
*entry
, **ptr
;
1539 ptr
= &pcmcia_sockets
;
1540 for (entry
= *ptr
; entry
; ptr
= &entry
->next
, entry
= *ptr
)
1541 if (entry
->socket
== socket
) {
1547 void pcmcia_info(Monitor
*mon
, const QDict
*qdict
)
1549 struct pcmcia_socket_entry_s
*iter
;
1551 if (!pcmcia_sockets
)
1552 monitor_printf(mon
, "No PCMCIA sockets\n");
1554 for (iter
= pcmcia_sockets
; iter
; iter
= iter
->next
)
1555 monitor_printf(mon
, "%s: %s\n", iter
->socket
->slot_string
,
1556 iter
->socket
->attached
? iter
->socket
->card_string
:
1560 /***********************************************************/
1561 /* machine registration */
1563 MachineState
*current_machine
;
1565 static void machine_class_init(ObjectClass
*oc
, void *data
)
1567 MachineClass
*mc
= MACHINE_CLASS(oc
);
1568 QEMUMachine
*qm
= data
;
1570 mc
->name
= qm
->name
;
1571 mc
->alias
= qm
->alias
;
1572 mc
->desc
= qm
->desc
;
1573 mc
->init
= qm
->init
;
1574 mc
->reset
= qm
->reset
;
1575 mc
->hot_add_cpu
= qm
->hot_add_cpu
;
1576 mc
->kvm_type
= qm
->kvm_type
;
1577 mc
->block_default_type
= qm
->block_default_type
;
1578 mc
->max_cpus
= qm
->max_cpus
;
1579 mc
->no_serial
= qm
->no_serial
;
1580 mc
->no_parallel
= qm
->no_parallel
;
1581 mc
->use_virtcon
= qm
->use_virtcon
;
1582 mc
->use_sclp
= qm
->use_sclp
;
1583 mc
->no_floppy
= qm
->no_floppy
;
1584 mc
->no_cdrom
= qm
->no_cdrom
;
1585 mc
->no_sdcard
= qm
->no_sdcard
;
1586 mc
->is_default
= qm
->is_default
;
1587 mc
->default_machine_opts
= qm
->default_machine_opts
;
1588 mc
->default_boot_order
= qm
->default_boot_order
;
1589 mc
->compat_props
= qm
->compat_props
;
1590 mc
->hw_version
= qm
->hw_version
;
1593 int qemu_register_machine(QEMUMachine
*m
)
1595 char *name
= g_strconcat(m
->name
, TYPE_MACHINE_SUFFIX
, NULL
);
1598 .parent
= TYPE_MACHINE
,
1599 .class_init
= machine_class_init
,
1600 .class_data
= (void *)m
,
1609 static MachineClass
*find_machine(const char *name
)
1611 GSList
*el
, *machines
= object_class_get_list(TYPE_MACHINE
, false);
1612 MachineClass
*mc
= NULL
;
1614 for (el
= machines
; el
; el
= el
->next
) {
1615 MachineClass
*temp
= el
->data
;
1617 if (!strcmp(temp
->name
, name
)) {
1622 !strcmp(temp
->alias
, name
)) {
1628 g_slist_free(machines
);
1632 MachineClass
*find_default_machine(void)
1634 GSList
*el
, *machines
= object_class_get_list(TYPE_MACHINE
, false);
1635 MachineClass
*mc
= NULL
;
1637 for (el
= machines
; el
; el
= el
->next
) {
1638 MachineClass
*temp
= el
->data
;
1640 if (temp
->is_default
) {
1646 g_slist_free(machines
);
1650 MachineInfoList
*qmp_query_machines(Error
**errp
)
1652 GSList
*el
, *machines
= object_class_get_list(TYPE_MACHINE
, false);
1653 MachineInfoList
*mach_list
= NULL
;
1655 for (el
= machines
; el
; el
= el
->next
) {
1656 MachineClass
*mc
= el
->data
;
1657 MachineInfoList
*entry
;
1660 info
= g_malloc0(sizeof(*info
));
1661 if (mc
->is_default
) {
1662 info
->has_is_default
= true;
1663 info
->is_default
= true;
1667 info
->has_alias
= true;
1668 info
->alias
= g_strdup(mc
->alias
);
1671 info
->name
= g_strdup(mc
->name
);
1672 info
->cpu_max
= !mc
->max_cpus
? 1 : mc
->max_cpus
;
1674 entry
= g_malloc0(sizeof(*entry
));
1675 entry
->value
= info
;
1676 entry
->next
= mach_list
;
1680 g_slist_free(machines
);
1684 /***********************************************************/
1685 /* main execution loop */
1687 struct vm_change_state_entry
{
1688 VMChangeStateHandler
*cb
;
1690 QLIST_ENTRY (vm_change_state_entry
) entries
;
1693 static QLIST_HEAD(vm_change_state_head
, vm_change_state_entry
) vm_change_state_head
;
1695 VMChangeStateEntry
*qemu_add_vm_change_state_handler(VMChangeStateHandler
*cb
,
1698 VMChangeStateEntry
*e
;
1700 e
= g_malloc0(sizeof (*e
));
1704 QLIST_INSERT_HEAD(&vm_change_state_head
, e
, entries
);
1708 void qemu_del_vm_change_state_handler(VMChangeStateEntry
*e
)
1710 QLIST_REMOVE (e
, entries
);
1714 void vm_state_notify(int running
, RunState state
)
1716 VMChangeStateEntry
*e
;
1718 trace_vm_state_notify(running
, state
);
1720 for (e
= vm_change_state_head
.lh_first
; e
; e
= e
->entries
.le_next
) {
1721 e
->cb(e
->opaque
, running
, state
);
1725 /* reset/shutdown handler */
1727 typedef struct QEMUResetEntry
{
1728 QTAILQ_ENTRY(QEMUResetEntry
) entry
;
1729 QEMUResetHandler
*func
;
1733 static QTAILQ_HEAD(reset_handlers
, QEMUResetEntry
) reset_handlers
=
1734 QTAILQ_HEAD_INITIALIZER(reset_handlers
);
1735 static int reset_requested
;
1736 static int shutdown_requested
, shutdown_signal
= -1;
1737 static pid_t shutdown_pid
;
1738 static int powerdown_requested
;
1739 static int debug_requested
;
1740 static int suspend_requested
;
1741 static WakeupReason wakeup_reason
;
1742 static NotifierList powerdown_notifiers
=
1743 NOTIFIER_LIST_INITIALIZER(powerdown_notifiers
);
1744 static NotifierList suspend_notifiers
=
1745 NOTIFIER_LIST_INITIALIZER(suspend_notifiers
);
1746 static NotifierList wakeup_notifiers
=
1747 NOTIFIER_LIST_INITIALIZER(wakeup_notifiers
);
1748 static uint32_t wakeup_reason_mask
= ~(1 << QEMU_WAKEUP_REASON_NONE
);
1750 int qemu_shutdown_requested_get(void)
1752 return shutdown_requested
;
1755 int qemu_reset_requested_get(void)
1757 return reset_requested
;
1760 static int qemu_shutdown_requested(void)
1762 int r
= shutdown_requested
;
1763 shutdown_requested
= 0;
1767 static void qemu_kill_report(void)
1769 if (!qtest_driver() && shutdown_signal
!= -1) {
1770 fprintf(stderr
, "qemu: terminating on signal %d", shutdown_signal
);
1771 if (shutdown_pid
== 0) {
1772 /* This happens for eg ^C at the terminal, so it's worth
1773 * avoiding printing an odd message in that case.
1775 fputc('\n', stderr
);
1777 fprintf(stderr
, " from pid " FMT_pid
"\n", shutdown_pid
);
1779 shutdown_signal
= -1;
1783 static int qemu_reset_requested(void)
1785 int r
= reset_requested
;
1786 reset_requested
= 0;
1790 static int qemu_suspend_requested(void)
1792 int r
= suspend_requested
;
1793 suspend_requested
= 0;
1797 static WakeupReason
qemu_wakeup_requested(void)
1799 return wakeup_reason
;
1802 static int qemu_powerdown_requested(void)
1804 int r
= powerdown_requested
;
1805 powerdown_requested
= 0;
1809 static int qemu_debug_requested(void)
1811 int r
= debug_requested
;
1812 debug_requested
= 0;
1816 void qemu_register_reset(QEMUResetHandler
*func
, void *opaque
)
1818 QEMUResetEntry
*re
= g_malloc0(sizeof(QEMUResetEntry
));
1821 re
->opaque
= opaque
;
1822 QTAILQ_INSERT_TAIL(&reset_handlers
, re
, entry
);
1825 void qemu_unregister_reset(QEMUResetHandler
*func
, void *opaque
)
1829 QTAILQ_FOREACH(re
, &reset_handlers
, entry
) {
1830 if (re
->func
== func
&& re
->opaque
== opaque
) {
1831 QTAILQ_REMOVE(&reset_handlers
, re
, entry
);
1838 void qemu_devices_reset(void)
1840 QEMUResetEntry
*re
, *nre
;
1842 /* reset all devices */
1843 QTAILQ_FOREACH_SAFE(re
, &reset_handlers
, entry
, nre
) {
1844 re
->func(re
->opaque
);
1848 void qemu_system_reset(bool report
)
1852 mc
= current_machine
? MACHINE_GET_CLASS(current_machine
) : NULL
;
1854 if (mc
&& mc
->reset
) {
1857 qemu_devices_reset();
1860 qapi_event_send_reset(&error_abort
);
1862 cpu_synchronize_all_post_reset();
1865 void qemu_system_reset_request(void)
1868 shutdown_requested
= 1;
1870 reset_requested
= 1;
1873 qemu_notify_event();
1876 static void qemu_system_suspend(void)
1879 notifier_list_notify(&suspend_notifiers
, NULL
);
1880 runstate_set(RUN_STATE_SUSPENDED
);
1881 qapi_event_send_suspend(&error_abort
);
1884 void qemu_system_suspend_request(void)
1886 if (runstate_check(RUN_STATE_SUSPENDED
)) {
1889 suspend_requested
= 1;
1891 qemu_notify_event();
1894 void qemu_register_suspend_notifier(Notifier
*notifier
)
1896 notifier_list_add(&suspend_notifiers
, notifier
);
1899 void qemu_system_wakeup_request(WakeupReason reason
)
1901 trace_system_wakeup_request(reason
);
1903 if (!runstate_check(RUN_STATE_SUSPENDED
)) {
1906 if (!(wakeup_reason_mask
& (1 << reason
))) {
1909 runstate_set(RUN_STATE_RUNNING
);
1910 wakeup_reason
= reason
;
1911 qemu_notify_event();
1914 void qemu_system_wakeup_enable(WakeupReason reason
, bool enabled
)
1917 wakeup_reason_mask
|= (1 << reason
);
1919 wakeup_reason_mask
&= ~(1 << reason
);
1923 void qemu_register_wakeup_notifier(Notifier
*notifier
)
1925 notifier_list_add(&wakeup_notifiers
, notifier
);
1928 void qemu_system_killed(int signal
, pid_t pid
)
1930 shutdown_signal
= signal
;
1933 qemu_system_shutdown_request();
1936 void qemu_system_shutdown_request(void)
1938 trace_qemu_system_shutdown_request();
1939 shutdown_requested
= 1;
1940 qemu_notify_event();
1943 static void qemu_system_powerdown(void)
1945 qapi_event_send_powerdown(&error_abort
);
1946 notifier_list_notify(&powerdown_notifiers
, NULL
);
1949 void qemu_system_powerdown_request(void)
1951 trace_qemu_system_powerdown_request();
1952 powerdown_requested
= 1;
1953 qemu_notify_event();
1956 void qemu_register_powerdown_notifier(Notifier
*notifier
)
1958 notifier_list_add(&powerdown_notifiers
, notifier
);
1961 void qemu_system_debug_request(void)
1963 debug_requested
= 1;
1964 qemu_notify_event();
1967 static bool main_loop_should_exit(void)
1970 if (qemu_debug_requested()) {
1971 vm_stop(RUN_STATE_DEBUG
);
1973 if (qemu_suspend_requested()) {
1974 qemu_system_suspend();
1976 if (qemu_shutdown_requested()) {
1978 qapi_event_send_shutdown(&error_abort
);
1980 vm_stop(RUN_STATE_SHUTDOWN
);
1985 if (qemu_reset_requested()) {
1987 cpu_synchronize_all_states();
1988 qemu_system_reset(VMRESET_REPORT
);
1990 if (runstate_needs_reset()) {
1991 runstate_set(RUN_STATE_PAUSED
);
1994 if (qemu_wakeup_requested()) {
1996 cpu_synchronize_all_states();
1997 qemu_system_reset(VMRESET_SILENT
);
1998 notifier_list_notify(&wakeup_notifiers
, &wakeup_reason
);
1999 wakeup_reason
= QEMU_WAKEUP_REASON_NONE
;
2001 qapi_event_send_wakeup(&error_abort
);
2003 if (qemu_powerdown_requested()) {
2004 qemu_system_powerdown();
2006 if (qemu_vmstop_requested(&r
)) {
2012 static void main_loop(void)
2016 #ifdef CONFIG_PROFILER
2020 nonblocking
= !kvm_enabled() && !xen_enabled() && last_io
> 0;
2021 #ifdef CONFIG_PROFILER
2022 ti
= profile_getclock();
2024 last_io
= main_loop_wait(nonblocking
);
2025 #ifdef CONFIG_PROFILER
2026 dev_time
+= profile_getclock() - ti
;
2028 } while (!main_loop_should_exit());
2031 static void version(void)
2033 printf("QEMU emulator version " QEMU_VERSION QEMU_PKGVERSION
", Copyright (c) 2003-2008 Fabrice Bellard\n");
2036 static void help(int exitcode
)
2039 printf("usage: %s [options] [disk_image]\n\n"
2040 "'disk_image' is a raw hard disk image for IDE hard disk 0\n\n",
2041 error_get_progname());
2043 #define QEMU_OPTIONS_GENERATE_HELP
2044 #include "qemu-options-wrapper.h"
2046 printf("\nDuring emulation, the following keys are useful:\n"
2047 "ctrl-alt-f toggle full screen\n"
2048 "ctrl-alt-n switch to virtual console 'n'\n"
2049 "ctrl-alt toggle mouse and keyboard grab\n"
2051 "When using -nographic, press 'ctrl-a h' to get some help.\n");
2056 #define HAS_ARG 0x0001
2058 typedef struct QEMUOption
{
2065 static const QEMUOption qemu_options
[] = {
2066 { "h", 0, QEMU_OPTION_h
, QEMU_ARCH_ALL
},
2067 #define QEMU_OPTIONS_GENERATE_OPTIONS
2068 #include "qemu-options-wrapper.h"
2072 static bool vga_available(void)
2074 return object_class_by_name("VGA") || object_class_by_name("isa-vga");
2077 static bool cirrus_vga_available(void)
2079 return object_class_by_name("cirrus-vga")
2080 || object_class_by_name("isa-cirrus-vga");
2083 static bool vmware_vga_available(void)
2085 return object_class_by_name("vmware-svga");
2088 static bool qxl_vga_available(void)
2090 return object_class_by_name("qxl-vga");
2093 static bool tcx_vga_available(void)
2095 return object_class_by_name("SUNW,tcx");
2098 static bool cg3_vga_available(void)
2100 return object_class_by_name("cgthree");
2103 static void select_vgahw (const char *p
)
2107 assert(vga_interface_type
== VGA_NONE
);
2108 if (strstart(p
, "std", &opts
)) {
2109 if (vga_available()) {
2110 vga_interface_type
= VGA_STD
;
2112 fprintf(stderr
, "Error: standard VGA not available\n");
2115 } else if (strstart(p
, "cirrus", &opts
)) {
2116 if (cirrus_vga_available()) {
2117 vga_interface_type
= VGA_CIRRUS
;
2119 fprintf(stderr
, "Error: Cirrus VGA not available\n");
2122 } else if (strstart(p
, "vmware", &opts
)) {
2123 if (vmware_vga_available()) {
2124 vga_interface_type
= VGA_VMWARE
;
2126 fprintf(stderr
, "Error: VMWare SVGA not available\n");
2129 } else if (strstart(p
, "xenfb", &opts
)) {
2130 vga_interface_type
= VGA_XENFB
;
2131 } else if (strstart(p
, "qxl", &opts
)) {
2132 if (qxl_vga_available()) {
2133 vga_interface_type
= VGA_QXL
;
2135 fprintf(stderr
, "Error: QXL VGA not available\n");
2138 } else if (strstart(p
, "tcx", &opts
)) {
2139 if (tcx_vga_available()) {
2140 vga_interface_type
= VGA_TCX
;
2142 fprintf(stderr
, "Error: TCX framebuffer not available\n");
2145 } else if (strstart(p
, "cg3", &opts
)) {
2146 if (cg3_vga_available()) {
2147 vga_interface_type
= VGA_CG3
;
2149 fprintf(stderr
, "Error: CG3 framebuffer not available\n");
2152 } else if (!strstart(p
, "none", &opts
)) {
2154 fprintf(stderr
, "Unknown vga type: %s\n", p
);
2158 const char *nextopt
;
2160 if (strstart(opts
, ",retrace=", &nextopt
)) {
2162 if (strstart(opts
, "dumb", &nextopt
))
2163 vga_retrace_method
= VGA_RETRACE_DUMB
;
2164 else if (strstart(opts
, "precise", &nextopt
))
2165 vga_retrace_method
= VGA_RETRACE_PRECISE
;
2166 else goto invalid_vga
;
2167 } else goto invalid_vga
;
2172 static DisplayType
select_display(const char *p
)
2175 DisplayType display
= DT_DEFAULT
;
2177 if (strstart(p
, "sdl", &opts
)) {
2181 const char *nextopt
;
2183 if (strstart(opts
, ",frame=", &nextopt
)) {
2185 if (strstart(opts
, "on", &nextopt
)) {
2187 } else if (strstart(opts
, "off", &nextopt
)) {
2190 goto invalid_sdl_args
;
2192 } else if (strstart(opts
, ",alt_grab=", &nextopt
)) {
2194 if (strstart(opts
, "on", &nextopt
)) {
2196 } else if (strstart(opts
, "off", &nextopt
)) {
2199 goto invalid_sdl_args
;
2201 } else if (strstart(opts
, ",ctrl_grab=", &nextopt
)) {
2203 if (strstart(opts
, "on", &nextopt
)) {
2205 } else if (strstart(opts
, "off", &nextopt
)) {
2208 goto invalid_sdl_args
;
2210 } else if (strstart(opts
, ",window_close=", &nextopt
)) {
2212 if (strstart(opts
, "on", &nextopt
)) {
2214 } else if (strstart(opts
, "off", &nextopt
)) {
2217 goto invalid_sdl_args
;
2221 fprintf(stderr
, "Invalid SDL option string: %s\n", p
);
2227 fprintf(stderr
, "SDL support is disabled\n");
2230 } else if (strstart(p
, "vnc", &opts
)) {
2235 const char *nextopt
;
2237 if (strstart(opts
, "=", &nextopt
)) {
2238 vnc_display
= nextopt
;
2242 fprintf(stderr
, "VNC requires a display argument vnc=<display>\n");
2246 fprintf(stderr
, "VNC support is disabled\n");
2249 } else if (strstart(p
, "curses", &opts
)) {
2250 #ifdef CONFIG_CURSES
2251 display
= DT_CURSES
;
2253 fprintf(stderr
, "Curses support is disabled\n");
2256 } else if (strstart(p
, "gtk", &opts
)) {
2260 const char *nextopt
;
2262 if (strstart(opts
, ",grab_on_hover=", &nextopt
)) {
2264 if (strstart(opts
, "on", &nextopt
)) {
2265 grab_on_hover
= true;
2266 } else if (strstart(opts
, "off", &nextopt
)) {
2267 grab_on_hover
= false;
2269 goto invalid_gtk_args
;
2273 fprintf(stderr
, "Invalid GTK option string: %s\n", p
);
2279 fprintf(stderr
, "GTK support is disabled\n");
2282 } else if (strstart(p
, "none", &opts
)) {
2285 fprintf(stderr
, "Unknown display type: %s\n", p
);
2292 static int balloon_parse(const char *arg
)
2296 if (strcmp(arg
, "none") == 0) {
2300 if (!strncmp(arg
, "virtio", 6)) {
2301 if (arg
[6] == ',') {
2302 /* have params -> parse them */
2303 opts
= qemu_opts_parse(qemu_find_opts("device"), arg
+7, 0);
2307 /* create empty opts */
2308 opts
= qemu_opts_create(qemu_find_opts("device"), NULL
, 0,
2311 qemu_opt_set(opts
, "driver", "virtio-balloon");
2318 char *qemu_find_file(int type
, const char *name
)
2324 /* Try the name as a straight path first */
2325 if (access(name
, R_OK
) == 0) {
2326 trace_load_file(name
, name
);
2327 return g_strdup(name
);
2331 case QEMU_FILE_TYPE_BIOS
:
2334 case QEMU_FILE_TYPE_KEYMAP
:
2335 subdir
= "keymaps/";
2341 for (i
= 0; i
< data_dir_idx
; i
++) {
2342 buf
= g_strdup_printf("%s/%s%s", data_dir
[i
], subdir
, name
);
2343 if (access(buf
, R_OK
) == 0) {
2344 trace_load_file(name
, buf
);
2352 static int device_help_func(QemuOpts
*opts
, void *opaque
)
2354 return qdev_device_help(opts
);
2357 static int device_init_func(QemuOpts
*opts
, void *opaque
)
2361 dev
= qdev_device_add(opts
);
2364 object_unref(OBJECT(dev
));
2368 static int chardev_init_func(QemuOpts
*opts
, void *opaque
)
2370 Error
*local_err
= NULL
;
2372 qemu_chr_new_from_opts(opts
, NULL
, &local_err
);
2374 error_report("%s", error_get_pretty(local_err
));
2375 error_free(local_err
);
2381 #ifdef CONFIG_VIRTFS
2382 static int fsdev_init_func(QemuOpts
*opts
, void *opaque
)
2385 ret
= qemu_fsdev_add(opts
);
2391 static int mon_init_func(QemuOpts
*opts
, void *opaque
)
2393 CharDriverState
*chr
;
2394 const char *chardev
;
2398 mode
= qemu_opt_get(opts
, "mode");
2402 if (strcmp(mode
, "readline") == 0) {
2403 flags
= MONITOR_USE_READLINE
;
2404 } else if (strcmp(mode
, "control") == 0) {
2405 flags
= MONITOR_USE_CONTROL
;
2407 fprintf(stderr
, "unknown monitor mode \"%s\"\n", mode
);
2411 if (qemu_opt_get_bool(opts
, "pretty", 0))
2412 flags
|= MONITOR_USE_PRETTY
;
2414 if (qemu_opt_get_bool(opts
, "default", 0))
2415 flags
|= MONITOR_IS_DEFAULT
;
2417 chardev
= qemu_opt_get(opts
, "chardev");
2418 chr
= qemu_chr_find(chardev
);
2420 fprintf(stderr
, "chardev \"%s\" not found\n", chardev
);
2424 qemu_chr_fe_claim_no_fail(chr
);
2425 monitor_init(chr
, flags
);
2429 static void monitor_parse(const char *optarg
, const char *mode
)
2431 static int monitor_device_index
= 0;
2437 if (strstart(optarg
, "chardev:", &p
)) {
2438 snprintf(label
, sizeof(label
), "%s", p
);
2440 snprintf(label
, sizeof(label
), "compat_monitor%d",
2441 monitor_device_index
);
2442 if (monitor_device_index
== 0) {
2445 opts
= qemu_chr_parse_compat(label
, optarg
);
2447 fprintf(stderr
, "parse error: %s\n", optarg
);
2452 opts
= qemu_opts_create(qemu_find_opts("mon"), label
, 1, NULL
);
2454 fprintf(stderr
, "duplicate chardev: %s\n", label
);
2457 qemu_opt_set(opts
, "mode", mode
);
2458 qemu_opt_set(opts
, "chardev", label
);
2460 qemu_opt_set(opts
, "default", "on");
2461 monitor_device_index
++;
2464 struct device_config
{
2466 DEV_USB
, /* -usbdevice */
2468 DEV_SERIAL
, /* -serial */
2469 DEV_PARALLEL
, /* -parallel */
2470 DEV_VIRTCON
, /* -virtioconsole */
2471 DEV_DEBUGCON
, /* -debugcon */
2472 DEV_GDB
, /* -gdb, -s */
2473 DEV_SCLP
, /* s390 sclp */
2475 const char *cmdline
;
2477 QTAILQ_ENTRY(device_config
) next
;
2480 static QTAILQ_HEAD(, device_config
) device_configs
=
2481 QTAILQ_HEAD_INITIALIZER(device_configs
);
2483 static void add_device_config(int type
, const char *cmdline
)
2485 struct device_config
*conf
;
2487 conf
= g_malloc0(sizeof(*conf
));
2489 conf
->cmdline
= cmdline
;
2490 loc_save(&conf
->loc
);
2491 QTAILQ_INSERT_TAIL(&device_configs
, conf
, next
);
2494 static int foreach_device_config(int type
, int (*func
)(const char *cmdline
))
2496 struct device_config
*conf
;
2499 QTAILQ_FOREACH(conf
, &device_configs
, next
) {
2500 if (conf
->type
!= type
)
2502 loc_push_restore(&conf
->loc
);
2503 rc
= func(conf
->cmdline
);
2504 loc_pop(&conf
->loc
);
2511 static int serial_parse(const char *devname
)
2513 static int index
= 0;
2516 if (strcmp(devname
, "none") == 0)
2518 if (index
== MAX_SERIAL_PORTS
) {
2519 fprintf(stderr
, "qemu: too many serial ports\n");
2522 snprintf(label
, sizeof(label
), "serial%d", index
);
2523 serial_hds
[index
] = qemu_chr_new(label
, devname
, NULL
);
2524 if (!serial_hds
[index
]) {
2525 fprintf(stderr
, "qemu: could not connect serial device"
2526 " to character backend '%s'\n", devname
);
2533 static int parallel_parse(const char *devname
)
2535 static int index
= 0;
2538 if (strcmp(devname
, "none") == 0)
2540 if (index
== MAX_PARALLEL_PORTS
) {
2541 fprintf(stderr
, "qemu: too many parallel ports\n");
2544 snprintf(label
, sizeof(label
), "parallel%d", index
);
2545 parallel_hds
[index
] = qemu_chr_new(label
, devname
, NULL
);
2546 if (!parallel_hds
[index
]) {
2547 fprintf(stderr
, "qemu: could not connect parallel device"
2548 " to character backend '%s'\n", devname
);
2555 static int virtcon_parse(const char *devname
)
2557 QemuOptsList
*device
= qemu_find_opts("device");
2558 static int index
= 0;
2560 QemuOpts
*bus_opts
, *dev_opts
;
2562 if (strcmp(devname
, "none") == 0)
2564 if (index
== MAX_VIRTIO_CONSOLES
) {
2565 fprintf(stderr
, "qemu: too many virtio consoles\n");
2569 bus_opts
= qemu_opts_create(device
, NULL
, 0, &error_abort
);
2570 if (arch_type
== QEMU_ARCH_S390X
) {
2571 qemu_opt_set(bus_opts
, "driver", "virtio-serial-s390");
2573 qemu_opt_set(bus_opts
, "driver", "virtio-serial-pci");
2576 dev_opts
= qemu_opts_create(device
, NULL
, 0, &error_abort
);
2577 qemu_opt_set(dev_opts
, "driver", "virtconsole");
2579 snprintf(label
, sizeof(label
), "virtcon%d", index
);
2580 virtcon_hds
[index
] = qemu_chr_new(label
, devname
, NULL
);
2581 if (!virtcon_hds
[index
]) {
2582 fprintf(stderr
, "qemu: could not connect virtio console"
2583 " to character backend '%s'\n", devname
);
2586 qemu_opt_set(dev_opts
, "chardev", label
);
2592 static int sclp_parse(const char *devname
)
2594 QemuOptsList
*device
= qemu_find_opts("device");
2595 static int index
= 0;
2599 if (strcmp(devname
, "none") == 0) {
2602 if (index
== MAX_SCLP_CONSOLES
) {
2603 fprintf(stderr
, "qemu: too many sclp consoles\n");
2607 assert(arch_type
== QEMU_ARCH_S390X
);
2609 dev_opts
= qemu_opts_create(device
, NULL
, 0, NULL
);
2610 qemu_opt_set(dev_opts
, "driver", "sclpconsole");
2612 snprintf(label
, sizeof(label
), "sclpcon%d", index
);
2613 sclp_hds
[index
] = qemu_chr_new(label
, devname
, NULL
);
2614 if (!sclp_hds
[index
]) {
2615 fprintf(stderr
, "qemu: could not connect sclp console"
2616 " to character backend '%s'\n", devname
);
2619 qemu_opt_set(dev_opts
, "chardev", label
);
2625 static int debugcon_parse(const char *devname
)
2629 if (!qemu_chr_new("debugcon", devname
, NULL
)) {
2632 opts
= qemu_opts_create(qemu_find_opts("device"), "debugcon", 1, NULL
);
2634 fprintf(stderr
, "qemu: already have a debugcon device\n");
2637 qemu_opt_set(opts
, "driver", "isa-debugcon");
2638 qemu_opt_set(opts
, "chardev", "debugcon");
2642 static MachineClass
*machine_parse(const char *name
)
2644 MachineClass
*mc
= NULL
;
2645 GSList
*el
, *machines
= object_class_get_list(TYPE_MACHINE
, false);
2648 mc
= find_machine(name
);
2653 if (name
&& !is_help_option(name
)) {
2654 error_report("Unsupported machine type");
2655 error_printf("Use -machine help to list supported machines!\n");
2657 printf("Supported machines are:\n");
2658 for (el
= machines
; el
; el
= el
->next
) {
2659 MachineClass
*mc
= el
->data
;
2661 printf("%-20s %s (alias of %s)\n", mc
->alias
, mc
->desc
, mc
->name
);
2663 printf("%-20s %s%s\n", mc
->name
, mc
->desc
,
2664 mc
->is_default
? " (default)" : "");
2668 g_slist_free(machines
);
2669 exit(!name
|| !is_help_option(name
));
2672 static int tcg_init(MachineClass
*mc
)
2674 tcg_exec_init(tcg_tb_size
* 1024 * 1024);
2679 const char *opt_name
;
2681 int (*available
)(void);
2682 int (*init
)(MachineClass
*mc
);
2685 { "tcg", "tcg", tcg_available
, tcg_init
, &tcg_allowed
},
2686 { "xen", "Xen", xen_available
, xen_init
, &xen_allowed
},
2687 { "kvm", "KVM", kvm_available
, kvm_init
, &kvm_allowed
},
2688 { "qtest", "QTest", qtest_available
, qtest_init_accel
, &qtest_allowed
},
2691 static int configure_accelerator(MachineClass
*mc
)
2696 bool accel_initialised
= false;
2697 bool init_failed
= false;
2699 p
= qemu_opt_get(qemu_get_machine_opts(), "accel");
2701 /* Use the default "accelerator", tcg */
2705 while (!accel_initialised
&& *p
!= '\0') {
2709 p
= get_opt_name(buf
, sizeof (buf
), p
, ':');
2710 for (i
= 0; i
< ARRAY_SIZE(accel_list
); i
++) {
2711 if (strcmp(accel_list
[i
].opt_name
, buf
) == 0) {
2712 if (!accel_list
[i
].available()) {
2713 printf("%s not supported for this target\n",
2714 accel_list
[i
].name
);
2717 *(accel_list
[i
].allowed
) = true;
2718 ret
= accel_list
[i
].init(mc
);
2721 fprintf(stderr
, "failed to initialize %s: %s\n",
2724 *(accel_list
[i
].allowed
) = false;
2726 accel_initialised
= true;
2731 if (i
== ARRAY_SIZE(accel_list
)) {
2732 fprintf(stderr
, "\"%s\" accelerator does not exist.\n", buf
);
2736 if (!accel_initialised
) {
2738 fprintf(stderr
, "No accelerator found!\n");
2744 fprintf(stderr
, "Back to %s accelerator.\n", accel_list
[i
].name
);
2747 return !accel_initialised
;
2750 void qemu_add_exit_notifier(Notifier
*notify
)
2752 notifier_list_add(&exit_notifiers
, notify
);
2755 void qemu_remove_exit_notifier(Notifier
*notify
)
2757 notifier_remove(notify
);
2760 static void qemu_run_exit_notifiers(void)
2762 notifier_list_notify(&exit_notifiers
, NULL
);
2765 void qemu_add_machine_init_done_notifier(Notifier
*notify
)
2767 notifier_list_add(&machine_init_done_notifiers
, notify
);
2770 static void qemu_run_machine_init_done_notifiers(void)
2772 notifier_list_notify(&machine_init_done_notifiers
, NULL
);
2775 static const QEMUOption
*lookup_opt(int argc
, char **argv
,
2776 const char **poptarg
, int *poptind
)
2778 const QEMUOption
*popt
;
2779 int optind
= *poptind
;
2780 char *r
= argv
[optind
];
2783 loc_set_cmdline(argv
, optind
, 1);
2785 /* Treat --foo the same as -foo. */
2788 popt
= qemu_options
;
2791 error_report("invalid option");
2794 if (!strcmp(popt
->name
, r
+ 1))
2798 if (popt
->flags
& HAS_ARG
) {
2799 if (optind
>= argc
) {
2800 error_report("requires an argument");
2803 optarg
= argv
[optind
++];
2804 loc_set_cmdline(argv
, optind
- 2, 2);
2815 static gpointer
malloc_and_trace(gsize n_bytes
)
2817 void *ptr
= malloc(n_bytes
);
2818 trace_g_malloc(n_bytes
, ptr
);
2822 static gpointer
realloc_and_trace(gpointer mem
, gsize n_bytes
)
2824 void *ptr
= realloc(mem
, n_bytes
);
2825 trace_g_realloc(mem
, n_bytes
, ptr
);
2829 static void free_and_trace(gpointer mem
)
2835 static int object_set_property(const char *name
, const char *value
, void *opaque
)
2837 Object
*obj
= OBJECT(opaque
);
2838 StringInputVisitor
*siv
;
2839 Error
*local_err
= NULL
;
2842 if (strcmp(name
, "qom-type") == 0 || strcmp(name
, "id") == 0 ||
2843 strcmp(name
, "type") == 0) {
2847 qom_name
= g_strdup(name
);
2855 siv
= string_input_visitor_new(value
);
2856 object_property_set(obj
, string_input_get_visitor(siv
), qom_name
, &local_err
);
2857 string_input_visitor_cleanup(siv
);
2861 qerror_report_err(local_err
);
2862 error_free(local_err
);
2869 static int object_create(QemuOpts
*opts
, void *opaque
)
2878 ov
= opts_visitor_new(opts
);
2879 pdict
= qemu_opts_to_qdict(opts
, NULL
);
2881 visit_start_struct(opts_get_visitor(ov
), &dummy
, NULL
, NULL
, 0, &err
);
2886 qdict_del(pdict
, "qom-type");
2887 visit_type_str(opts_get_visitor(ov
), &type
, "qom-type", &err
);
2892 qdict_del(pdict
, "id");
2893 visit_type_str(opts_get_visitor(ov
), &id
, "id", &err
);
2898 object_add(type
, id
, pdict
, opts_get_visitor(ov
), &err
);
2902 visit_end_struct(opts_get_visitor(ov
), &err
);
2904 qmp_object_del(id
, NULL
);
2908 opts_visitor_cleanup(ov
);
2915 qerror_report_err(err
);
2921 int main(int argc
, char **argv
, char **envp
)
2924 int snapshot
, linux_boot
;
2925 const char *initrd_filename
;
2926 const char *kernel_filename
, *kernel_cmdline
;
2927 const char *boot_order
;
2929 int cyls
, heads
, secs
, translation
;
2930 QemuOpts
*hda_opts
= NULL
, *opts
, *machine_opts
, *icount_opts
= NULL
;
2931 QemuOptsList
*olist
;
2934 const char *loadvm
= NULL
;
2935 MachineClass
*machine_class
;
2936 const char *cpu_model
;
2937 const char *vga_model
= NULL
;
2938 const char *qtest_chrdev
= NULL
;
2939 const char *qtest_log
= NULL
;
2940 const char *pid_file
= NULL
;
2941 const char *incoming
= NULL
;
2943 int show_vnc_port
= 0;
2945 bool defconfig
= true;
2946 bool userconfig
= true;
2947 const char *log_mask
= NULL
;
2948 const char *log_file
= NULL
;
2949 GMemVTable mem_trace
= {
2950 .malloc
= malloc_and_trace
,
2951 .realloc
= realloc_and_trace
,
2952 .free
= free_and_trace
,
2954 const char *trace_events
= NULL
;
2955 const char *trace_file
= NULL
;
2956 const ram_addr_t default_ram_size
= (ram_addr_t
)DEFAULT_RAM_SIZE
*
2958 ram_addr_t maxram_size
= default_ram_size
;
2959 uint64_t ram_slots
= 0;
2960 FILE *vmstate_dump_file
= NULL
;
2962 atexit(qemu_run_exit_notifiers
);
2963 error_set_progname(argv
[0]);
2964 qemu_init_exec_dir(argv
[0]);
2966 g_mem_set_vtable(&mem_trace
);
2968 module_call_init(MODULE_INIT_QOM
);
2970 qemu_add_opts(&qemu_drive_opts
);
2971 qemu_add_drive_opts(&qemu_legacy_drive_opts
);
2972 qemu_add_drive_opts(&qemu_common_drive_opts
);
2973 qemu_add_drive_opts(&qemu_drive_opts
);
2974 qemu_add_opts(&qemu_chardev_opts
);
2975 qemu_add_opts(&qemu_device_opts
);
2976 qemu_add_opts(&qemu_netdev_opts
);
2977 qemu_add_opts(&qemu_net_opts
);
2978 qemu_add_opts(&qemu_rtc_opts
);
2979 qemu_add_opts(&qemu_global_opts
);
2980 qemu_add_opts(&qemu_mon_opts
);
2981 qemu_add_opts(&qemu_trace_opts
);
2982 qemu_add_opts(&qemu_option_rom_opts
);
2983 qemu_add_opts(&qemu_machine_opts
);
2984 qemu_add_opts(&qemu_mem_opts
);
2985 qemu_add_opts(&qemu_smp_opts
);
2986 qemu_add_opts(&qemu_boot_opts
);
2987 qemu_add_opts(&qemu_sandbox_opts
);
2988 qemu_add_opts(&qemu_add_fd_opts
);
2989 qemu_add_opts(&qemu_object_opts
);
2990 qemu_add_opts(&qemu_tpmdev_opts
);
2991 qemu_add_opts(&qemu_realtime_opts
);
2992 qemu_add_opts(&qemu_msg_opts
);
2993 qemu_add_opts(&qemu_name_opts
);
2994 qemu_add_opts(&qemu_numa_opts
);
2995 qemu_add_opts(&qemu_icount_opts
);
2999 rtc_clock
= QEMU_CLOCK_HOST
;
3001 QLIST_INIT (&vm_change_state_head
);
3002 os_setup_early_signal_handling();
3004 module_call_init(MODULE_INIT_MACHINE
);
3005 machine_class
= find_default_machine();
3007 ram_size
= default_ram_size
;
3009 cyls
= heads
= secs
= 0;
3010 translation
= BIOS_ATA_TRANSLATION_AUTO
;
3012 for (i
= 0; i
< MAX_NODES
; i
++) {
3013 numa_info
[i
].node_mem
= 0;
3014 numa_info
[i
].present
= false;
3015 bitmap_zero(numa_info
[i
].node_cpu
, MAX_CPUMASK_BITS
);
3019 max_numa_nodeid
= 0;
3022 bdrv_init_with_whitelist();
3026 /* first pass of option parsing */
3028 while (optind
< argc
) {
3029 if (argv
[optind
][0] != '-') {
3033 const QEMUOption
*popt
;
3035 popt
= lookup_opt(argc
, argv
, &optarg
, &optind
);
3036 switch (popt
->index
) {
3037 case QEMU_OPTION_nodefconfig
:
3040 case QEMU_OPTION_nouserconfig
:
3049 ret
= qemu_read_default_config_files(userconfig
);
3055 /* second pass of option parsing */
3060 if (argv
[optind
][0] != '-') {
3061 hda_opts
= drive_add(IF_DEFAULT
, 0, argv
[optind
++], HD_OPTS
);
3063 const QEMUOption
*popt
;
3065 popt
= lookup_opt(argc
, argv
, &optarg
, &optind
);
3066 if (!(popt
->arch_mask
& arch_type
)) {
3067 printf("Option %s not supported for this target\n", popt
->name
);
3070 switch(popt
->index
) {
3072 machine_class
= machine_parse(optarg
);
3074 case QEMU_OPTION_no_kvm_irqchip
: {
3075 olist
= qemu_find_opts("machine");
3076 qemu_opts_parse(olist
, "kernel_irqchip=off", 0);
3079 case QEMU_OPTION_cpu
:
3080 /* hw initialization will check this */
3083 case QEMU_OPTION_hda
:
3087 snprintf(buf
, sizeof(buf
), "%s", HD_OPTS
);
3089 snprintf(buf
, sizeof(buf
),
3090 "%s,cyls=%d,heads=%d,secs=%d%s",
3091 HD_OPTS
, cyls
, heads
, secs
,
3092 translation
== BIOS_ATA_TRANSLATION_LBA
?
3094 translation
== BIOS_ATA_TRANSLATION_NONE
?
3095 ",trans=none" : "");
3096 drive_add(IF_DEFAULT
, 0, optarg
, buf
);
3099 case QEMU_OPTION_hdb
:
3100 case QEMU_OPTION_hdc
:
3101 case QEMU_OPTION_hdd
:
3102 drive_add(IF_DEFAULT
, popt
->index
- QEMU_OPTION_hda
, optarg
,
3105 case QEMU_OPTION_drive
:
3106 if (drive_def(optarg
) == NULL
) {
3110 case QEMU_OPTION_set
:
3111 if (qemu_set_option(optarg
) != 0)
3114 case QEMU_OPTION_global
:
3115 if (qemu_global_option(optarg
) != 0)
3118 case QEMU_OPTION_mtdblock
:
3119 drive_add(IF_MTD
, -1, optarg
, MTD_OPTS
);
3121 case QEMU_OPTION_sd
:
3122 drive_add(IF_SD
, -1, optarg
, SD_OPTS
);
3124 case QEMU_OPTION_pflash
:
3125 drive_add(IF_PFLASH
, -1, optarg
, PFLASH_OPTS
);
3127 case QEMU_OPTION_snapshot
:
3130 case QEMU_OPTION_hdachs
:
3134 cyls
= strtol(p
, (char **)&p
, 0);
3135 if (cyls
< 1 || cyls
> 16383)
3140 heads
= strtol(p
, (char **)&p
, 0);
3141 if (heads
< 1 || heads
> 16)
3146 secs
= strtol(p
, (char **)&p
, 0);
3147 if (secs
< 1 || secs
> 63)
3151 if (!strcmp(p
, "large")) {
3152 translation
= BIOS_ATA_TRANSLATION_LARGE
;
3153 } else if (!strcmp(p
, "rechs")) {
3154 translation
= BIOS_ATA_TRANSLATION_RECHS
;
3155 } else if (!strcmp(p
, "none")) {
3156 translation
= BIOS_ATA_TRANSLATION_NONE
;
3157 } else if (!strcmp(p
, "lba")) {
3158 translation
= BIOS_ATA_TRANSLATION_LBA
;
3159 } else if (!strcmp(p
, "auto")) {
3160 translation
= BIOS_ATA_TRANSLATION_AUTO
;
3164 } else if (*p
!= '\0') {
3166 fprintf(stderr
, "qemu: invalid physical CHS format\n");
3169 if (hda_opts
!= NULL
) {
3171 snprintf(num
, sizeof(num
), "%d", cyls
);
3172 qemu_opt_set(hda_opts
, "cyls", num
);
3173 snprintf(num
, sizeof(num
), "%d", heads
);
3174 qemu_opt_set(hda_opts
, "heads", num
);
3175 snprintf(num
, sizeof(num
), "%d", secs
);
3176 qemu_opt_set(hda_opts
, "secs", num
);
3177 if (translation
== BIOS_ATA_TRANSLATION_LARGE
) {
3178 qemu_opt_set(hda_opts
, "trans", "large");
3179 } else if (translation
== BIOS_ATA_TRANSLATION_RECHS
) {
3180 qemu_opt_set(hda_opts
, "trans", "rechs");
3181 } else if (translation
== BIOS_ATA_TRANSLATION_LBA
) {
3182 qemu_opt_set(hda_opts
, "trans", "lba");
3183 } else if (translation
== BIOS_ATA_TRANSLATION_NONE
) {
3184 qemu_opt_set(hda_opts
, "trans", "none");
3189 case QEMU_OPTION_numa
:
3190 opts
= qemu_opts_parse(qemu_find_opts("numa"), optarg
, 1);
3195 case QEMU_OPTION_display
:
3196 display_type
= select_display(optarg
);
3198 case QEMU_OPTION_nographic
:
3199 display_type
= DT_NOGRAPHIC
;
3201 case QEMU_OPTION_curses
:
3202 #ifdef CONFIG_CURSES
3203 display_type
= DT_CURSES
;
3205 fprintf(stderr
, "Curses support is disabled\n");
3209 case QEMU_OPTION_portrait
:
3210 graphic_rotate
= 90;
3212 case QEMU_OPTION_rotate
:
3213 graphic_rotate
= strtol(optarg
, (char **) &optarg
, 10);
3214 if (graphic_rotate
!= 0 && graphic_rotate
!= 90 &&
3215 graphic_rotate
!= 180 && graphic_rotate
!= 270) {
3217 "qemu: only 90, 180, 270 deg rotation is available\n");
3221 case QEMU_OPTION_kernel
:
3222 qemu_opts_set(qemu_find_opts("machine"), 0, "kernel", optarg
);
3224 case QEMU_OPTION_initrd
:
3225 qemu_opts_set(qemu_find_opts("machine"), 0, "initrd", optarg
);
3227 case QEMU_OPTION_append
:
3228 qemu_opts_set(qemu_find_opts("machine"), 0, "append", optarg
);
3230 case QEMU_OPTION_dtb
:
3231 qemu_opts_set(qemu_find_opts("machine"), 0, "dtb", optarg
);
3233 case QEMU_OPTION_cdrom
:
3234 drive_add(IF_DEFAULT
, 2, optarg
, CDROM_OPTS
);
3236 case QEMU_OPTION_boot
:
3237 opts
= qemu_opts_parse(qemu_find_opts("boot-opts"), optarg
, 1);
3242 case QEMU_OPTION_fda
:
3243 case QEMU_OPTION_fdb
:
3244 drive_add(IF_FLOPPY
, popt
->index
- QEMU_OPTION_fda
,
3247 case QEMU_OPTION_no_fd_bootchk
:
3250 case QEMU_OPTION_netdev
:
3251 if (net_client_parse(qemu_find_opts("netdev"), optarg
) == -1) {
3255 case QEMU_OPTION_net
:
3256 if (net_client_parse(qemu_find_opts("net"), optarg
) == -1) {
3260 #ifdef CONFIG_LIBISCSI
3261 case QEMU_OPTION_iscsi
:
3262 opts
= qemu_opts_parse(qemu_find_opts("iscsi"), optarg
, 0);
3269 case QEMU_OPTION_tftp
:
3270 legacy_tftp_prefix
= optarg
;
3272 case QEMU_OPTION_bootp
:
3273 legacy_bootp_filename
= optarg
;
3275 case QEMU_OPTION_redir
:
3276 if (net_slirp_redir(optarg
) < 0)
3280 case QEMU_OPTION_bt
:
3281 add_device_config(DEV_BT
, optarg
);
3283 case QEMU_OPTION_audio_help
:
3287 case QEMU_OPTION_soundhw
:
3288 select_soundhw (optarg
);
3293 case QEMU_OPTION_version
:
3297 case QEMU_OPTION_m
: {
3299 const char *mem_str
;
3300 const char *maxmem_str
, *slots_str
;
3302 opts
= qemu_opts_parse(qemu_find_opts("memory"),
3308 mem_str
= qemu_opt_get(opts
, "size");
3310 error_report("invalid -m option, missing 'size' option");
3314 error_report("missing 'size' option value");
3318 sz
= qemu_opt_get_size(opts
, "size", ram_size
);
3320 /* Fix up legacy suffix-less format */
3321 if (g_ascii_isdigit(mem_str
[strlen(mem_str
) - 1])) {
3322 uint64_t overflow_check
= sz
;
3325 if ((sz
>> 20) != overflow_check
) {
3326 error_report("too large 'size' option value");
3331 /* backward compatibility behaviour for case "-m 0" */
3333 sz
= default_ram_size
;
3336 sz
= QEMU_ALIGN_UP(sz
, 8192);
3338 if (ram_size
!= sz
) {
3339 error_report("ram size too large");
3342 maxram_size
= ram_size
;
3344 maxmem_str
= qemu_opt_get(opts
, "maxmem");
3345 slots_str
= qemu_opt_get(opts
, "slots");
3346 if (maxmem_str
&& slots_str
) {
3349 sz
= qemu_opt_get_size(opts
, "maxmem", 0);
3350 if (sz
< ram_size
) {
3351 fprintf(stderr
, "qemu: invalid -m option value: maxmem "
3352 "(%" PRIu64
") <= initial memory ("
3353 RAM_ADDR_FMT
")\n", sz
, ram_size
);
3357 slots
= qemu_opt_get_number(opts
, "slots", 0);
3358 if ((sz
> ram_size
) && !slots
) {
3359 fprintf(stderr
, "qemu: invalid -m option value: maxmem "
3360 "(%" PRIu64
") more than initial memory ("
3361 RAM_ADDR_FMT
") but no hotplug slots where "
3362 "specified\n", sz
, ram_size
);
3366 if ((sz
<= ram_size
) && slots
) {
3367 fprintf(stderr
, "qemu: invalid -m option value: %"
3368 PRIu64
" hotplug slots where specified but "
3369 "maxmem (%" PRIu64
") <= initial memory ("
3370 RAM_ADDR_FMT
")\n", slots
, sz
, ram_size
);
3375 } else if ((!maxmem_str
&& slots_str
) ||
3376 (maxmem_str
&& !slots_str
)) {
3377 fprintf(stderr
, "qemu: invalid -m option value: missing "
3378 "'%s' option\n", slots_str
? "maxmem" : "slots");
3384 case QEMU_OPTION_tpmdev
:
3385 if (tpm_config_parse(qemu_find_opts("tpmdev"), optarg
) < 0) {
3390 case QEMU_OPTION_mempath
:
3393 case QEMU_OPTION_mem_prealloc
:
3403 add_device_config(DEV_GDB
, "tcp::" DEFAULT_GDBSTUB_PORT
);
3405 case QEMU_OPTION_gdb
:
3406 add_device_config(DEV_GDB
, optarg
);
3409 if (data_dir_idx
< ARRAY_SIZE(data_dir
)) {
3410 data_dir
[data_dir_idx
++] = optarg
;
3413 case QEMU_OPTION_bios
:
3414 qemu_opts_set(qemu_find_opts("machine"), 0, "firmware", optarg
);
3416 case QEMU_OPTION_singlestep
:
3423 keyboard_layout
= optarg
;
3425 case QEMU_OPTION_localtime
:
3428 case QEMU_OPTION_vga
:
3437 w
= strtol(p
, (char **)&p
, 10);
3440 fprintf(stderr
, "qemu: invalid resolution or depth\n");
3446 h
= strtol(p
, (char **)&p
, 10);
3451 depth
= strtol(p
, (char **)&p
, 10);
3452 if (depth
!= 8 && depth
!= 15 && depth
!= 16 &&
3453 depth
!= 24 && depth
!= 32)
3455 } else if (*p
== '\0') {
3456 depth
= graphic_depth
;
3463 graphic_depth
= depth
;
3466 case QEMU_OPTION_echr
:
3469 term_escape_char
= strtol(optarg
, &r
, 0);
3471 printf("Bad argument to echr\n");
3474 case QEMU_OPTION_monitor
:
3475 default_monitor
= 0;
3476 if (strncmp(optarg
, "none", 4)) {
3477 monitor_parse(optarg
, "readline");
3480 case QEMU_OPTION_qmp
:
3481 monitor_parse(optarg
, "control");
3482 default_monitor
= 0;
3484 case QEMU_OPTION_mon
:
3485 opts
= qemu_opts_parse(qemu_find_opts("mon"), optarg
, 1);
3489 default_monitor
= 0;
3491 case QEMU_OPTION_chardev
:
3492 opts
= qemu_opts_parse(qemu_find_opts("chardev"), optarg
, 1);
3497 case QEMU_OPTION_fsdev
:
3498 olist
= qemu_find_opts("fsdev");
3500 fprintf(stderr
, "fsdev is not supported by this qemu build.\n");
3503 opts
= qemu_opts_parse(olist
, optarg
, 1);
3508 case QEMU_OPTION_virtfs
: {
3511 const char *writeout
, *sock_fd
, *socket
;
3513 olist
= qemu_find_opts("virtfs");
3515 fprintf(stderr
, "virtfs is not supported by this qemu build.\n");
3518 opts
= qemu_opts_parse(olist
, optarg
, 1);
3523 if (qemu_opt_get(opts
, "fsdriver") == NULL
||
3524 qemu_opt_get(opts
, "mount_tag") == NULL
) {
3525 fprintf(stderr
, "Usage: -virtfs fsdriver,mount_tag=tag.\n");
3528 fsdev
= qemu_opts_create(qemu_find_opts("fsdev"),
3529 qemu_opt_get(opts
, "mount_tag"),
3532 fprintf(stderr
, "duplicate fsdev id: %s\n",
3533 qemu_opt_get(opts
, "mount_tag"));
3537 writeout
= qemu_opt_get(opts
, "writeout");
3539 #ifdef CONFIG_SYNC_FILE_RANGE
3540 qemu_opt_set(fsdev
, "writeout", writeout
);
3542 fprintf(stderr
, "writeout=immediate not supported on "
3547 qemu_opt_set(fsdev
, "fsdriver", qemu_opt_get(opts
, "fsdriver"));
3548 qemu_opt_set(fsdev
, "path", qemu_opt_get(opts
, "path"));
3549 qemu_opt_set(fsdev
, "security_model",
3550 qemu_opt_get(opts
, "security_model"));
3551 socket
= qemu_opt_get(opts
, "socket");
3553 qemu_opt_set(fsdev
, "socket", socket
);
3555 sock_fd
= qemu_opt_get(opts
, "sock_fd");
3557 qemu_opt_set(fsdev
, "sock_fd", sock_fd
);
3560 qemu_opt_set_bool(fsdev
, "readonly",
3561 qemu_opt_get_bool(opts
, "readonly", 0));
3562 device
= qemu_opts_create(qemu_find_opts("device"), NULL
, 0,
3564 qemu_opt_set(device
, "driver", "virtio-9p-pci");
3565 qemu_opt_set(device
, "fsdev",
3566 qemu_opt_get(opts
, "mount_tag"));
3567 qemu_opt_set(device
, "mount_tag",
3568 qemu_opt_get(opts
, "mount_tag"));
3571 case QEMU_OPTION_virtfs_synth
: {
3575 fsdev
= qemu_opts_create(qemu_find_opts("fsdev"), "v_synth",
3578 fprintf(stderr
, "duplicate option: %s\n", "virtfs_synth");
3581 qemu_opt_set(fsdev
, "fsdriver", "synth");
3583 device
= qemu_opts_create(qemu_find_opts("device"), NULL
, 0,
3585 qemu_opt_set(device
, "driver", "virtio-9p-pci");
3586 qemu_opt_set(device
, "fsdev", "v_synth");
3587 qemu_opt_set(device
, "mount_tag", "v_synth");
3590 case QEMU_OPTION_serial
:
3591 add_device_config(DEV_SERIAL
, optarg
);
3593 if (strncmp(optarg
, "mon:", 4) == 0) {
3594 default_monitor
= 0;
3597 case QEMU_OPTION_watchdog
:
3600 "qemu: only one watchdog option may be given\n");
3605 case QEMU_OPTION_watchdog_action
:
3606 if (select_watchdog_action(optarg
) == -1) {
3607 fprintf(stderr
, "Unknown -watchdog-action parameter\n");
3611 case QEMU_OPTION_virtiocon
:
3612 add_device_config(DEV_VIRTCON
, optarg
);
3613 default_virtcon
= 0;
3614 if (strncmp(optarg
, "mon:", 4) == 0) {
3615 default_monitor
= 0;
3618 case QEMU_OPTION_parallel
:
3619 add_device_config(DEV_PARALLEL
, optarg
);
3620 default_parallel
= 0;
3621 if (strncmp(optarg
, "mon:", 4) == 0) {
3622 default_monitor
= 0;
3625 case QEMU_OPTION_debugcon
:
3626 add_device_config(DEV_DEBUGCON
, optarg
);
3628 case QEMU_OPTION_loadvm
:
3631 case QEMU_OPTION_full_screen
:
3634 case QEMU_OPTION_no_frame
:
3637 case QEMU_OPTION_alt_grab
:
3640 case QEMU_OPTION_ctrl_grab
:
3643 case QEMU_OPTION_no_quit
:
3646 case QEMU_OPTION_sdl
:
3648 display_type
= DT_SDL
;
3651 fprintf(stderr
, "SDL support is disabled\n");
3654 case QEMU_OPTION_pidfile
:
3657 case QEMU_OPTION_win2k_hack
:
3658 win2k_install_hack
= 1;
3660 case QEMU_OPTION_rtc_td_hack
: {
3661 static GlobalProperty slew_lost_ticks
[] = {
3663 .driver
= "mc146818rtc",
3664 .property
= "lost_tick_policy",
3667 { /* end of list */ }
3670 qdev_prop_register_global_list(slew_lost_ticks
);
3673 case QEMU_OPTION_acpitable
:
3674 opts
= qemu_opts_parse(qemu_find_opts("acpi"), optarg
, 1);
3678 do_acpitable_option(opts
);
3680 case QEMU_OPTION_smbios
:
3681 opts
= qemu_opts_parse(qemu_find_opts("smbios"), optarg
, 0);
3685 do_smbios_option(opts
);
3687 case QEMU_OPTION_enable_kvm
:
3688 olist
= qemu_find_opts("machine");
3689 qemu_opts_parse(olist
, "accel=kvm", 0);
3691 case QEMU_OPTION_machine
:
3692 olist
= qemu_find_opts("machine");
3693 opts
= qemu_opts_parse(olist
, optarg
, 1);
3697 optarg
= qemu_opt_get(opts
, "type");
3699 machine_class
= machine_parse(optarg
);
3702 case QEMU_OPTION_no_kvm
:
3703 olist
= qemu_find_opts("machine");
3704 qemu_opts_parse(olist
, "accel=tcg", 0);
3706 case QEMU_OPTION_no_kvm_pit
: {
3707 fprintf(stderr
, "Warning: KVM PIT can no longer be disabled "
3711 case QEMU_OPTION_no_kvm_pit_reinjection
: {
3712 static GlobalProperty kvm_pit_lost_tick_policy
[] = {
3714 .driver
= "kvm-pit",
3715 .property
= "lost_tick_policy",
3718 { /* end of list */ }
3721 fprintf(stderr
, "Warning: option deprecated, use "
3722 "lost_tick_policy property of kvm-pit instead.\n");
3723 qdev_prop_register_global_list(kvm_pit_lost_tick_policy
);
3726 case QEMU_OPTION_usb
:
3727 olist
= qemu_find_opts("machine");
3728 qemu_opts_parse(olist
, "usb=on", 0);
3730 case QEMU_OPTION_usbdevice
:
3731 olist
= qemu_find_opts("machine");
3732 qemu_opts_parse(olist
, "usb=on", 0);
3733 add_device_config(DEV_USB
, optarg
);
3735 case QEMU_OPTION_device
:
3736 if (!qemu_opts_parse(qemu_find_opts("device"), optarg
, 1)) {
3740 case QEMU_OPTION_smp
:
3741 if (!qemu_opts_parse(qemu_find_opts("smp-opts"), optarg
, 1)) {
3745 case QEMU_OPTION_vnc
:
3748 vnc_display
= optarg
;
3750 fprintf(stderr
, "VNC support is disabled\n");
3754 case QEMU_OPTION_no_acpi
:
3757 case QEMU_OPTION_no_hpet
:
3760 case QEMU_OPTION_balloon
:
3761 if (balloon_parse(optarg
) < 0) {
3762 fprintf(stderr
, "Unknown -balloon argument %s\n", optarg
);
3766 case QEMU_OPTION_no_reboot
:
3769 case QEMU_OPTION_no_shutdown
:
3772 case QEMU_OPTION_show_cursor
:
3775 case QEMU_OPTION_uuid
:
3776 if(qemu_uuid_parse(optarg
, qemu_uuid
) < 0) {
3777 fprintf(stderr
, "Fail to parse UUID string."
3778 " Wrong format.\n");
3781 qemu_uuid_set
= true;
3783 case QEMU_OPTION_option_rom
:
3784 if (nb_option_roms
>= MAX_OPTION_ROMS
) {
3785 fprintf(stderr
, "Too many option ROMs\n");
3788 opts
= qemu_opts_parse(qemu_find_opts("option-rom"), optarg
, 1);
3792 option_rom
[nb_option_roms
].name
= qemu_opt_get(opts
, "romfile");
3793 option_rom
[nb_option_roms
].bootindex
=
3794 qemu_opt_get_number(opts
, "bootindex", -1);
3795 if (!option_rom
[nb_option_roms
].name
) {
3796 fprintf(stderr
, "Option ROM file is not specified\n");
3801 case QEMU_OPTION_semihosting
:
3802 semihosting_enabled
= 1;
3804 case QEMU_OPTION_tdf
:
3805 fprintf(stderr
, "Warning: user space PIT time drift fix "
3806 "is no longer supported.\n");
3808 case QEMU_OPTION_name
:
3809 opts
= qemu_opts_parse(qemu_find_opts("name"), optarg
, 1);
3814 case QEMU_OPTION_prom_env
:
3815 if (nb_prom_envs
>= MAX_PROM_ENVS
) {
3816 fprintf(stderr
, "Too many prom variables\n");
3819 prom_envs
[nb_prom_envs
] = optarg
;
3822 case QEMU_OPTION_old_param
:
3825 case QEMU_OPTION_clock
:
3826 /* Clock options no longer exist. Keep this option for
3827 * backward compatibility.
3830 case QEMU_OPTION_startdate
:
3831 configure_rtc_date_offset(optarg
, 1);
3833 case QEMU_OPTION_rtc
:
3834 opts
= qemu_opts_parse(qemu_find_opts("rtc"), optarg
, 0);
3838 configure_rtc(opts
);
3840 case QEMU_OPTION_tb_size
:
3841 tcg_tb_size
= strtol(optarg
, NULL
, 0);
3842 if (tcg_tb_size
< 0) {
3846 case QEMU_OPTION_icount
:
3847 icount_opts
= qemu_opts_parse(qemu_find_opts("icount"),
3853 case QEMU_OPTION_incoming
:
3855 runstate_set(RUN_STATE_INMIGRATE
);
3857 case QEMU_OPTION_nodefaults
:
3860 case QEMU_OPTION_xen_domid
:
3861 if (!(xen_available())) {
3862 printf("Option %s not supported for this target\n", popt
->name
);
3865 xen_domid
= atoi(optarg
);
3867 case QEMU_OPTION_xen_create
:
3868 if (!(xen_available())) {
3869 printf("Option %s not supported for this target\n", popt
->name
);
3872 xen_mode
= XEN_CREATE
;
3874 case QEMU_OPTION_xen_attach
:
3875 if (!(xen_available())) {
3876 printf("Option %s not supported for this target\n", popt
->name
);
3879 xen_mode
= XEN_ATTACH
;
3881 case QEMU_OPTION_trace
:
3883 opts
= qemu_opts_parse(qemu_find_opts("trace"), optarg
, 0);
3887 trace_events
= qemu_opt_get(opts
, "events");
3888 trace_file
= qemu_opt_get(opts
, "file");
3891 case QEMU_OPTION_readconfig
:
3893 int ret
= qemu_read_config_file(optarg
);
3895 fprintf(stderr
, "read config %s: %s\n", optarg
,
3901 case QEMU_OPTION_spice
:
3902 olist
= qemu_find_opts("spice");
3904 fprintf(stderr
, "spice is not supported by this qemu build.\n");
3907 opts
= qemu_opts_parse(olist
, optarg
, 0);
3913 case QEMU_OPTION_writeconfig
:
3916 if (strcmp(optarg
, "-") == 0) {
3919 fp
= fopen(optarg
, "w");
3921 fprintf(stderr
, "open %s: %s\n", optarg
, strerror(errno
));
3925 qemu_config_write(fp
);
3931 case QEMU_OPTION_qtest
:
3932 qtest_chrdev
= optarg
;
3934 case QEMU_OPTION_qtest_log
:
3937 case QEMU_OPTION_sandbox
:
3938 opts
= qemu_opts_parse(qemu_find_opts("sandbox"), optarg
, 1);
3943 case QEMU_OPTION_add_fd
:
3945 opts
= qemu_opts_parse(qemu_find_opts("add-fd"), optarg
, 0);
3950 error_report("File descriptor passing is disabled on this "
3955 case QEMU_OPTION_object
:
3956 opts
= qemu_opts_parse(qemu_find_opts("object"), optarg
, 1);
3961 case QEMU_OPTION_realtime
:
3962 opts
= qemu_opts_parse(qemu_find_opts("realtime"), optarg
, 0);
3966 configure_realtime(opts
);
3968 case QEMU_OPTION_msg
:
3969 opts
= qemu_opts_parse(qemu_find_opts("msg"), optarg
, 0);
3973 configure_msg(opts
);
3975 case QEMU_OPTION_dump_vmstate
:
3976 vmstate_dump_file
= fopen(optarg
, "w");
3977 if (vmstate_dump_file
== NULL
) {
3978 fprintf(stderr
, "open %s: %s\n", optarg
, strerror(errno
));
3983 os_parse_cmd_args(popt
->index
, optarg
);
3991 if (qemu_init_main_loop()) {
3992 fprintf(stderr
, "qemu_init_main_loop failed\n");
3996 if (qemu_opts_foreach(qemu_find_opts("sandbox"), parse_sandbox
, NULL
, 0)) {
4000 if (qemu_opts_foreach(qemu_find_opts("name"), parse_name
, NULL
, 1)) {
4005 if (qemu_opts_foreach(qemu_find_opts("add-fd"), parse_add_fd
, NULL
, 1)) {
4009 if (qemu_opts_foreach(qemu_find_opts("add-fd"), cleanup_add_fd
, NULL
, 1)) {
4014 if (machine_class
== NULL
) {
4015 fprintf(stderr
, "No machine specified, and there is no default.\n"
4016 "Use -machine help to list supported machines!\n");
4020 current_machine
= MACHINE(object_new(object_class_get_name(
4021 OBJECT_CLASS(machine_class
))));
4022 object_property_add_child(object_get_root(), "machine",
4023 OBJECT(current_machine
), &error_abort
);
4024 cpu_exec_init_all();
4026 if (machine_class
->hw_version
) {
4027 qemu_set_version(machine_class
->hw_version
);
4030 if (qemu_opts_foreach(qemu_find_opts("object"),
4031 object_create
, NULL
, 0) != 0) {
4035 /* Init CPU def lists, based on config
4036 * - Must be called after all the qemu_read_config_file() calls
4037 * - Must be called before list_cpus()
4038 * - Must be called before machine->init()
4042 if (cpu_model
&& is_help_option(cpu_model
)) {
4043 list_cpus(stdout
, &fprintf
, cpu_model
);
4047 /* Open the logfile at this point, if necessary. We can't open the logfile
4048 * when encountering either of the logging options (-d or -D) because the
4049 * other one may be encountered later on the command line, changing the
4050 * location or level of logging.
4055 qemu_set_log_filename(log_file
);
4058 mask
= qemu_str_to_log_mask(log_mask
);
4060 qemu_print_log_usage(stdout
);
4066 if (!is_daemonized()) {
4067 if (!trace_init_backends(trace_events
, trace_file
)) {
4072 /* If no data_dir is specified then try to find it relative to the
4074 if (data_dir_idx
< ARRAY_SIZE(data_dir
)) {
4075 data_dir
[data_dir_idx
] = os_find_datadir();
4076 if (data_dir
[data_dir_idx
] != NULL
) {
4080 /* If all else fails use the install path specified when building. */
4081 if (data_dir_idx
< ARRAY_SIZE(data_dir
)) {
4082 data_dir
[data_dir_idx
++] = CONFIG_QEMU_DATADIR
;
4085 smp_parse(qemu_opts_find(qemu_find_opts("smp-opts"), NULL
));
4087 machine_class
->max_cpus
= machine_class
->max_cpus
?: 1; /* Default to UP */
4088 if (smp_cpus
> machine_class
->max_cpus
) {
4089 fprintf(stderr
, "Number of SMP cpus requested (%d), exceeds max cpus "
4090 "supported by machine `%s' (%d)\n", smp_cpus
,
4091 machine_class
->name
, machine_class
->max_cpus
);
4096 * Get the default machine options from the machine if it is not already
4097 * specified either by the configuration file or by the command line.
4099 if (machine_class
->default_machine_opts
) {
4100 qemu_opts_set_defaults(qemu_find_opts("machine"),
4101 machine_class
->default_machine_opts
, 0);
4104 qemu_opts_foreach(qemu_find_opts("device"), default_driver_check
, NULL
, 0);
4105 qemu_opts_foreach(qemu_find_opts("global"), default_driver_check
, NULL
, 0);
4107 if (!vga_model
&& !default_vga
) {
4108 vga_interface_type
= VGA_DEVICE
;
4110 if (!has_defaults
|| machine_class
->no_serial
) {
4113 if (!has_defaults
|| machine_class
->no_parallel
) {
4114 default_parallel
= 0;
4116 if (!has_defaults
|| !machine_class
->use_virtcon
) {
4117 default_virtcon
= 0;
4119 if (!has_defaults
|| !machine_class
->use_sclp
) {
4122 if (!has_defaults
|| machine_class
->no_floppy
) {
4125 if (!has_defaults
|| machine_class
->no_cdrom
) {
4128 if (!has_defaults
|| machine_class
->no_sdcard
) {
4131 if (!has_defaults
) {
4132 default_monitor
= 0;
4137 if (is_daemonized()) {
4138 /* According to documentation and historically, -nographic redirects
4139 * serial port, parallel port and monitor to stdio, which does not work
4140 * with -daemonize. We can redirect these to null instead, but since
4141 * -nographic is legacy, let's just error out.
4142 * We disallow -nographic only if all other ports are not redirected
4143 * explicitly, to not break existing legacy setups which uses
4144 * -nographic _and_ redirects all ports explicitly - this is valid
4145 * usage, -nographic is just a no-op in this case.
4147 if (display_type
== DT_NOGRAPHIC
4148 && (default_parallel
|| default_serial
4149 || default_monitor
|| default_virtcon
)) {
4150 fprintf(stderr
, "-nographic can not be used with -daemonize\n");
4153 #ifdef CONFIG_CURSES
4154 if (display_type
== DT_CURSES
) {
4155 fprintf(stderr
, "curses display can not be used with -daemonize\n");
4161 if (display_type
== DT_NOGRAPHIC
) {
4162 if (default_parallel
)
4163 add_device_config(DEV_PARALLEL
, "null");
4164 if (default_serial
&& default_monitor
) {
4165 add_device_config(DEV_SERIAL
, "mon:stdio");
4166 } else if (default_virtcon
&& default_monitor
) {
4167 add_device_config(DEV_VIRTCON
, "mon:stdio");
4168 } else if (default_sclp
&& default_monitor
) {
4169 add_device_config(DEV_SCLP
, "mon:stdio");
4172 add_device_config(DEV_SERIAL
, "stdio");
4173 if (default_virtcon
)
4174 add_device_config(DEV_VIRTCON
, "stdio");
4176 add_device_config(DEV_SCLP
, "stdio");
4178 if (default_monitor
)
4179 monitor_parse("stdio", "readline");
4183 add_device_config(DEV_SERIAL
, "vc:80Cx24C");
4184 if (default_parallel
)
4185 add_device_config(DEV_PARALLEL
, "vc:80Cx24C");
4186 if (default_monitor
)
4187 monitor_parse("vc:80Cx24C", "readline");
4188 if (default_virtcon
)
4189 add_device_config(DEV_VIRTCON
, "vc:80Cx24C");
4191 add_device_config(DEV_SCLP
, "vc:80Cx24C");
4195 if (display_type
== DT_DEFAULT
&& !display_remote
) {
4196 #if defined(CONFIG_GTK)
4197 display_type
= DT_GTK
;
4198 #elif defined(CONFIG_SDL) || defined(CONFIG_COCOA)
4199 display_type
= DT_SDL
;
4200 #elif defined(CONFIG_VNC)
4201 vnc_display
= "localhost:0,to=99";
4204 display_type
= DT_NONE
;
4208 if ((no_frame
|| alt_grab
|| ctrl_grab
) && display_type
!= DT_SDL
) {
4209 fprintf(stderr
, "-no-frame, -alt-grab and -ctrl-grab are only valid "
4210 "for SDL, ignoring option\n");
4212 if (no_quit
&& (display_type
!= DT_GTK
&& display_type
!= DT_SDL
)) {
4213 fprintf(stderr
, "-no-quit is only valid for GTK and SDL, "
4214 "ignoring option\n");
4217 #if defined(CONFIG_GTK)
4218 if (display_type
== DT_GTK
) {
4219 early_gtk_display_init();
4225 if (qemu_opts_foreach(qemu_find_opts("chardev"), chardev_init_func
, NULL
, 1) != 0)
4227 #ifdef CONFIG_VIRTFS
4228 if (qemu_opts_foreach(qemu_find_opts("fsdev"), fsdev_init_func
, NULL
, 1) != 0) {
4233 if (pid_file
&& qemu_create_pidfile(pid_file
) != 0) {
4238 /* store value for the future use */
4239 qemu_opt_set_number(qemu_find_opts_singleton("memory"), "size", ram_size
);
4241 if (qemu_opts_foreach(qemu_find_opts("device"), device_help_func
, NULL
, 0)
4246 machine_opts
= qemu_get_machine_opts();
4247 if (qemu_opt_foreach(machine_opts
, object_set_property
, current_machine
,
4249 object_unref(OBJECT(current_machine
));
4253 configure_accelerator(machine_class
);
4256 Error
*local_err
= NULL
;
4257 qtest_init(qtest_chrdev
, qtest_log
, &local_err
);
4259 error_report("%s", error_get_pretty(local_err
));
4260 error_free(local_err
);
4265 machine_opts
= qemu_get_machine_opts();
4266 kernel_filename
= qemu_opt_get(machine_opts
, "kernel");
4267 initrd_filename
= qemu_opt_get(machine_opts
, "initrd");
4268 kernel_cmdline
= qemu_opt_get(machine_opts
, "append");
4269 bios_name
= qemu_opt_get(machine_opts
, "firmware");
4271 boot_order
= machine_class
->default_boot_order
;
4272 opts
= qemu_opts_find(qemu_find_opts("boot-opts"), NULL
);
4274 char *normal_boot_order
;
4275 const char *order
, *once
;
4277 order
= qemu_opt_get(opts
, "order");
4279 validate_bootdevices(order
);
4283 once
= qemu_opt_get(opts
, "once");
4285 validate_bootdevices(once
);
4286 normal_boot_order
= g_strdup(boot_order
);
4288 qemu_register_reset(restore_boot_order
, normal_boot_order
);
4291 boot_menu
= qemu_opt_get_bool(opts
, "menu", boot_menu
);
4292 boot_strict
= qemu_opt_get_bool(opts
, "strict", false);
4295 if (!kernel_cmdline
) {
4296 kernel_cmdline
= "";
4297 current_machine
->kernel_cmdline
= (char *)kernel_cmdline
;
4300 linux_boot
= (kernel_filename
!= NULL
);
4302 if (!linux_boot
&& *kernel_cmdline
!= '\0') {
4303 fprintf(stderr
, "-append only allowed with -kernel option\n");
4307 if (!linux_boot
&& initrd_filename
!= NULL
) {
4308 fprintf(stderr
, "-initrd only allowed with -kernel option\n");
4312 if (!linux_boot
&& qemu_opt_get(machine_opts
, "dtb")) {
4313 fprintf(stderr
, "-dtb only allowed with -kernel option\n");
4317 os_set_line_buffering();
4319 qemu_init_cpu_loop();
4320 qemu_mutex_lock_iothread();
4323 /* spice needs the timers to be initialized by this point */
4328 if (kvm_enabled() || xen_enabled()) {
4329 fprintf(stderr
, "-icount is not allowed with kvm or xen\n");
4332 configure_icount(icount_opts
, &error_abort
);
4333 qemu_opts_del(icount_opts
);
4336 /* clean up network at qemu process termination */
4337 atexit(&net_cleanup
);
4339 if (net_init_clients() < 0) {
4344 if (tpm_init() < 0) {
4349 /* init the bluetooth world */
4350 if (foreach_device_config(DEV_BT
, bt_parse
))
4353 if (!xen_enabled()) {
4354 /* On 32-bit hosts, QEMU is limited by virtual address space */
4355 if (ram_size
> (2047 << 20) && HOST_LONG_BITS
== 32) {
4356 fprintf(stderr
, "qemu: at most 2047 MB RAM can be simulated\n");
4364 /* open the virtual block devices */
4366 qemu_opts_foreach(qemu_find_opts("drive"), drive_enable_snapshot
, NULL
, 0);
4367 if (qemu_opts_foreach(qemu_find_opts("drive"), drive_init_func
,
4368 &machine_class
->block_default_type
, 1) != 0) {
4372 default_drive(default_cdrom
, snapshot
, machine_class
->block_default_type
, 2,
4374 default_drive(default_floppy
, snapshot
, IF_FLOPPY
, 0, FD_OPTS
);
4375 default_drive(default_sdcard
, snapshot
, IF_SD
, 0, SD_OPTS
);
4377 if (qemu_opts_foreach(qemu_find_opts("numa"), numa_init_func
,
4384 if (qemu_opts_foreach(qemu_find_opts("mon"), mon_init_func
, NULL
, 1) != 0) {
4388 if (foreach_device_config(DEV_SERIAL
, serial_parse
) < 0)
4390 if (foreach_device_config(DEV_PARALLEL
, parallel_parse
) < 0)
4392 if (foreach_device_config(DEV_VIRTCON
, virtcon_parse
) < 0)
4394 if (foreach_device_config(DEV_SCLP
, sclp_parse
) < 0) {
4397 if (foreach_device_config(DEV_DEBUGCON
, debugcon_parse
) < 0)
4400 /* If no default VGA is requested, the default is "none". */
4402 if (cirrus_vga_available()) {
4403 vga_model
= "cirrus";
4404 } else if (vga_available()) {
4409 select_vgahw(vga_model
);
4413 i
= select_watchdog(watchdog
);
4415 exit (i
== 1 ? 1 : 0);
4418 if (machine_class
->compat_props
) {
4419 qdev_prop_register_global_list(machine_class
->compat_props
);
4423 qdev_machine_init();
4425 current_machine
->ram_size
= ram_size
;
4426 current_machine
->maxram_size
= maxram_size
;
4427 current_machine
->ram_slots
= ram_slots
;
4428 current_machine
->boot_order
= boot_order
;
4429 current_machine
->cpu_model
= cpu_model
;
4431 machine_class
->init(current_machine
);
4435 cpu_synchronize_all_post_init();
4439 /* init USB devices */
4440 if (usb_enabled(false)) {
4441 if (foreach_device_config(DEV_USB
, usb_parse
) < 0)
4445 /* init generic devices */
4446 if (qemu_opts_foreach(qemu_find_opts("device"), device_init_func
, NULL
, 1) != 0)
4449 net_check_clients();
4451 ds
= init_displaystate();
4453 /* init local displays */
4454 switch (display_type
) {
4456 (void)ds
; /* avoid warning if no display is configured */
4458 #if defined(CONFIG_CURSES)
4460 curses_display_init(ds
, full_screen
);
4463 #if defined(CONFIG_SDL)
4465 sdl_display_init(ds
, full_screen
, no_frame
);
4467 #elif defined(CONFIG_COCOA)
4469 cocoa_display_init(ds
, full_screen
);
4472 #if defined(CONFIG_GTK)
4474 gtk_display_init(ds
, full_screen
, grab_on_hover
);
4481 /* must be after terminal init, SDL library changes signal handlers */
4482 os_setup_signal_handling();
4485 /* init remote displays */
4487 Error
*local_err
= NULL
;
4488 vnc_display_init(ds
);
4489 vnc_display_open(ds
, vnc_display
, &local_err
);
4490 if (local_err
!= NULL
) {
4491 error_report("Failed to start VNC server on `%s': %s",
4492 vnc_display
, error_get_pretty(local_err
));
4493 error_free(local_err
);
4497 if (show_vnc_port
) {
4498 printf("VNC server running on `%s'\n", vnc_display_local_addr(ds
));
4504 qemu_spice_display_init();
4508 if (foreach_device_config(DEV_GDB
, gdbserver_start
) < 0) {
4512 qdev_machine_creation_done();
4514 if (rom_load_all() != 0) {
4515 fprintf(stderr
, "rom loading failed\n");
4519 /* TODO: once all bus devices are qdevified, this should be done
4520 * when bus is created by qdev.c */
4521 qemu_register_reset(qbus_reset_all_fn
, sysbus_get_default());
4522 qemu_run_machine_init_done_notifiers();
4524 /* Done notifiers can load ROMs */
4527 qemu_system_reset(VMRESET_SILENT
);
4529 if (load_vmstate(loadvm
) < 0) {
4534 qdev_prop_check_global();
4535 if (vmstate_dump_file
) {
4537 dump_vmstate_json_to_file(vmstate_dump_file
);
4542 Error
*local_err
= NULL
;
4543 qemu_start_incoming_migration(incoming
, &local_err
);
4545 error_report("-incoming %s: %s", incoming
,
4546 error_get_pretty(local_err
));
4547 error_free(local_err
);
4550 } else if (autostart
) {
4556 if (is_daemonized()) {
4557 if (!trace_init_backends(trace_events
, trace_file
)) {