1 #ifndef SYSEMU_H 2 #define SYSEMU_H 3 /* Misc. things related to the system emulator. */ 4 5 #include "qapi/qapi-types-run-state.h" 6 #include "qemu/queue.h" 7 #include "qemu/timer.h" 8 #include "qemu/notify.h" 9 #include "qemu/main-loop.h" 10 #include "qemu/bitmap.h" 11 #include "qemu/uuid.h" 12 #include "qom/object.h" 13 14 /* vl.c */ 15 16 extern const char *bios_name; 17 extern const char *qemu_name; 18 extern QemuUUID qemu_uuid; 19 extern bool qemu_uuid_set; 20 21 bool runstate_check(RunState state); 22 void runstate_set(RunState new_state); 23 int runstate_is_running(void); 24 bool runstate_needs_reset(void); 25 bool runstate_store(char *str, size_t size); 26 typedef struct vm_change_state_entry VMChangeStateEntry; 27 typedef void VMChangeStateHandler(void *opaque, int running, RunState state); 28 29 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb, 30 void *opaque); 31 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e); 32 void vm_state_notify(int running, RunState state); 33 34 /* Enumeration of various causes for shutdown. */ 35 typedef enum ShutdownCause { 36 SHUTDOWN_CAUSE_NONE, /* No shutdown request pending */ 37 SHUTDOWN_CAUSE_HOST_ERROR, /* An error prevents further use of guest */ 38 SHUTDOWN_CAUSE_HOST_QMP, /* Reaction to a QMP command, like 'quit' */ 39 SHUTDOWN_CAUSE_HOST_SIGNAL, /* Reaction to a signal, such as SIGINT */ 40 SHUTDOWN_CAUSE_HOST_UI, /* Reaction to UI event, like window close */ 41 SHUTDOWN_CAUSE_GUEST_SHUTDOWN,/* Guest shutdown/suspend request, via 42 ACPI or other hardware-specific means */ 43 SHUTDOWN_CAUSE_GUEST_RESET, /* Guest reset request, and command line 44 turns that into a shutdown */ 45 SHUTDOWN_CAUSE_GUEST_PANIC, /* Guest panicked, and command line turns 46 that into a shutdown */ 47 SHUTDOWN_CAUSE__MAX, 48 } ShutdownCause; 49 50 static inline bool shutdown_caused_by_guest(ShutdownCause cause) 51 { 52 return cause >= SHUTDOWN_CAUSE_GUEST_SHUTDOWN; 53 } 54 55 void vm_start(void); 56 int vm_prepare_start(void); 57 int vm_stop(RunState state); 58 int vm_stop_force_state(RunState state); 59 int vm_shutdown(void); 60 61 typedef enum WakeupReason { 62 /* Always keep QEMU_WAKEUP_REASON_NONE = 0 */ 63 QEMU_WAKEUP_REASON_NONE = 0, 64 QEMU_WAKEUP_REASON_RTC, 65 QEMU_WAKEUP_REASON_PMTIMER, 66 QEMU_WAKEUP_REASON_OTHER, 67 } WakeupReason; 68 69 void qemu_system_reset_request(ShutdownCause reason); 70 void qemu_system_suspend_request(void); 71 void qemu_register_suspend_notifier(Notifier *notifier); 72 void qemu_system_wakeup_request(WakeupReason reason); 73 void qemu_system_wakeup_enable(WakeupReason reason, bool enabled); 74 void qemu_register_wakeup_notifier(Notifier *notifier); 75 void qemu_system_shutdown_request(ShutdownCause reason); 76 void qemu_system_powerdown_request(void); 77 void qemu_register_powerdown_notifier(Notifier *notifier); 78 void qemu_system_debug_request(void); 79 void qemu_system_vmstop_request(RunState reason); 80 void qemu_system_vmstop_request_prepare(void); 81 bool qemu_vmstop_requested(RunState *r); 82 ShutdownCause qemu_shutdown_requested_get(void); 83 ShutdownCause qemu_reset_requested_get(void); 84 void qemu_system_killed(int signal, pid_t pid); 85 void qemu_system_reset(ShutdownCause reason); 86 void qemu_system_guest_panicked(GuestPanicInformation *info); 87 88 void qemu_add_exit_notifier(Notifier *notify); 89 void qemu_remove_exit_notifier(Notifier *notify); 90 91 extern bool machine_init_done; 92 93 void qemu_add_machine_init_done_notifier(Notifier *notify); 94 void qemu_remove_machine_init_done_notifier(Notifier *notify); 95 96 void qemu_announce_self(void); 97 98 extern int autostart; 99 100 typedef enum { 101 VGA_NONE, VGA_STD, VGA_CIRRUS, VGA_VMWARE, VGA_XENFB, VGA_QXL, 102 VGA_TCX, VGA_CG3, VGA_DEVICE, VGA_VIRTIO, 103 VGA_TYPE_MAX, 104 } VGAInterfaceType; 105 106 extern int vga_interface_type; 107 #define xenfb_enabled (vga_interface_type == VGA_XENFB) 108 109 extern int graphic_width; 110 extern int graphic_height; 111 extern int graphic_depth; 112 extern int display_opengl; 113 extern const char *keyboard_layout; 114 extern int win2k_install_hack; 115 extern int alt_grab; 116 extern int ctrl_grab; 117 extern int no_frame; 118 extern int smp_cpus; 119 extern unsigned int max_cpus; 120 extern int cursor_hide; 121 extern int graphic_rotate; 122 extern int no_quit; 123 extern int no_shutdown; 124 extern int old_param; 125 extern int boot_menu; 126 extern bool boot_strict; 127 extern uint8_t *boot_splash_filedata; 128 extern size_t boot_splash_filedata_size; 129 extern bool enable_mlock; 130 extern uint8_t qemu_extra_params_fw[2]; 131 extern QEMUClockType rtc_clock; 132 extern const char *mem_path; 133 extern int mem_prealloc; 134 135 #define MAX_NODES 128 136 #define NUMA_NODE_UNASSIGNED MAX_NODES 137 #define NUMA_DISTANCE_MIN 10 138 #define NUMA_DISTANCE_DEFAULT 20 139 #define NUMA_DISTANCE_MAX 254 140 #define NUMA_DISTANCE_UNREACHABLE 255 141 142 #define MAX_OPTION_ROMS 16 143 typedef struct QEMUOptionRom { 144 const char *name; 145 int32_t bootindex; 146 } QEMUOptionRom; 147 extern QEMUOptionRom option_rom[MAX_OPTION_ROMS]; 148 extern int nb_option_roms; 149 150 #define MAX_PROM_ENVS 128 151 extern const char *prom_envs[MAX_PROM_ENVS]; 152 extern unsigned int nb_prom_envs; 153 154 /* generic hotplug */ 155 void hmp_drive_add(Monitor *mon, const QDict *qdict); 156 157 /* pcie aer error injection */ 158 void hmp_pcie_aer_inject_error(Monitor *mon, const QDict *qdict); 159 160 /* serial ports */ 161 162 /* Return the Chardev for serial port i, or NULL if none */ 163 Chardev *serial_hd(int i); 164 /* return the number of serial ports defined by the user. serial_hd(i) 165 * will always return NULL for any i which is greater than or equal to this. 166 */ 167 int serial_max_hds(void); 168 169 /* parallel ports */ 170 171 #define MAX_PARALLEL_PORTS 3 172 173 extern Chardev *parallel_hds[MAX_PARALLEL_PORTS]; 174 175 void hmp_info_usb(Monitor *mon, const QDict *qdict); 176 177 void add_boot_device_path(int32_t bootindex, DeviceState *dev, 178 const char *suffix); 179 char *get_boot_devices_list(size_t *size, bool ignore_suffixes); 180 181 DeviceState *get_boot_device(uint32_t position); 182 void check_boot_index(int32_t bootindex, Error **errp); 183 void del_boot_device_path(DeviceState *dev, const char *suffix); 184 void device_add_bootindex_property(Object *obj, int32_t *bootindex, 185 const char *name, const char *suffix, 186 DeviceState *dev, Error **errp); 187 void restore_boot_order(void *opaque); 188 void validate_bootdevices(const char *devices, Error **errp); 189 190 /* handler to set the boot_device order for a specific type of MachineClass */ 191 typedef void QEMUBootSetHandler(void *opaque, const char *boot_order, 192 Error **errp); 193 void qemu_register_boot_set(QEMUBootSetHandler *func, void *opaque); 194 void qemu_boot_set(const char *boot_order, Error **errp); 195 196 QemuOpts *qemu_get_machine_opts(void); 197 198 bool defaults_enabled(void); 199 200 extern QemuOptsList qemu_legacy_drive_opts; 201 extern QemuOptsList qemu_common_drive_opts; 202 extern QemuOptsList qemu_drive_opts; 203 extern QemuOptsList bdrv_runtime_opts; 204 extern QemuOptsList qemu_chardev_opts; 205 extern QemuOptsList qemu_device_opts; 206 extern QemuOptsList qemu_netdev_opts; 207 extern QemuOptsList qemu_nic_opts; 208 extern QemuOptsList qemu_net_opts; 209 extern QemuOptsList qemu_global_opts; 210 extern QemuOptsList qemu_mon_opts; 211 212 #endif 213