qapi: Reject section heading in the middle of a doc comment
[qemu/kevin.git] / system / runstate.c
blobd6ab860ecaa7f1f24df968f723c1ad5ab936f1ae
1 /*
2 * QEMU main system emulation loop
4 * Copyright (c) 2003-2020 QEMU contributors
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/osdep.h"
26 #include "audio/audio.h"
27 #include "block/block.h"
28 #include "block/export.h"
29 #include "chardev/char.h"
30 #include "crypto/cipher.h"
31 #include "crypto/init.h"
32 #include "exec/cpu-common.h"
33 #include "gdbstub/syscalls.h"
34 #include "hw/boards.h"
35 #include "migration/misc.h"
36 #include "migration/postcopy-ram.h"
37 #include "monitor/monitor.h"
38 #include "net/net.h"
39 #include "net/vhost_net.h"
40 #include "qapi/error.h"
41 #include "qapi/qapi-commands-run-state.h"
42 #include "qapi/qapi-events-run-state.h"
43 #include "qemu/accel.h"
44 #include "qemu/error-report.h"
45 #include "qemu/job.h"
46 #include "qemu/log.h"
47 #include "qemu/module.h"
48 #include "qemu/plugin.h"
49 #include "qemu/sockets.h"
50 #include "qemu/timer.h"
51 #include "qemu/thread.h"
52 #include "qom/object.h"
53 #include "qom/object_interfaces.h"
54 #include "sysemu/cpus.h"
55 #include "sysemu/qtest.h"
56 #include "sysemu/replay.h"
57 #include "sysemu/reset.h"
58 #include "sysemu/runstate.h"
59 #include "sysemu/runstate-action.h"
60 #include "sysemu/sysemu.h"
61 #include "sysemu/tpm.h"
62 #include "trace.h"
64 static NotifierList exit_notifiers =
65 NOTIFIER_LIST_INITIALIZER(exit_notifiers);
67 static RunState current_run_state = RUN_STATE_PRELAUNCH;
69 /* We use RUN_STATE__MAX but any invalid value will do */
70 static RunState vmstop_requested = RUN_STATE__MAX;
71 static QemuMutex vmstop_lock;
73 typedef struct {
74 RunState from;
75 RunState to;
76 } RunStateTransition;
78 static const RunStateTransition runstate_transitions_def[] = {
79 { RUN_STATE_PRELAUNCH, RUN_STATE_INMIGRATE },
80 { RUN_STATE_PRELAUNCH, RUN_STATE_SUSPENDED },
82 { RUN_STATE_DEBUG, RUN_STATE_RUNNING },
83 { RUN_STATE_DEBUG, RUN_STATE_FINISH_MIGRATE },
84 { RUN_STATE_DEBUG, RUN_STATE_PRELAUNCH },
86 { RUN_STATE_INMIGRATE, RUN_STATE_INTERNAL_ERROR },
87 { RUN_STATE_INMIGRATE, RUN_STATE_IO_ERROR },
88 { RUN_STATE_INMIGRATE, RUN_STATE_PAUSED },
89 { RUN_STATE_INMIGRATE, RUN_STATE_RUNNING },
90 { RUN_STATE_INMIGRATE, RUN_STATE_SHUTDOWN },
91 { RUN_STATE_INMIGRATE, RUN_STATE_SUSPENDED },
92 { RUN_STATE_INMIGRATE, RUN_STATE_WATCHDOG },
93 { RUN_STATE_INMIGRATE, RUN_STATE_GUEST_PANICKED },
94 { RUN_STATE_INMIGRATE, RUN_STATE_FINISH_MIGRATE },
95 { RUN_STATE_INMIGRATE, RUN_STATE_PRELAUNCH },
96 { RUN_STATE_INMIGRATE, RUN_STATE_POSTMIGRATE },
97 { RUN_STATE_INMIGRATE, RUN_STATE_COLO },
99 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PAUSED },
100 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_FINISH_MIGRATE },
101 { RUN_STATE_INTERNAL_ERROR, RUN_STATE_PRELAUNCH },
103 { RUN_STATE_IO_ERROR, RUN_STATE_RUNNING },
104 { RUN_STATE_IO_ERROR, RUN_STATE_FINISH_MIGRATE },
105 { RUN_STATE_IO_ERROR, RUN_STATE_PRELAUNCH },
107 { RUN_STATE_PAUSED, RUN_STATE_RUNNING },
108 { RUN_STATE_PAUSED, RUN_STATE_FINISH_MIGRATE },
109 { RUN_STATE_PAUSED, RUN_STATE_POSTMIGRATE },
110 { RUN_STATE_PAUSED, RUN_STATE_PRELAUNCH },
111 { RUN_STATE_PAUSED, RUN_STATE_COLO},
112 { RUN_STATE_PAUSED, RUN_STATE_SUSPENDED},
114 { RUN_STATE_POSTMIGRATE, RUN_STATE_RUNNING },
115 { RUN_STATE_POSTMIGRATE, RUN_STATE_FINISH_MIGRATE },
116 { RUN_STATE_POSTMIGRATE, RUN_STATE_PRELAUNCH },
118 { RUN_STATE_PRELAUNCH, RUN_STATE_RUNNING },
119 { RUN_STATE_PRELAUNCH, RUN_STATE_FINISH_MIGRATE },
120 { RUN_STATE_PRELAUNCH, RUN_STATE_INMIGRATE },
122 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_RUNNING },
123 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PAUSED },
124 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_POSTMIGRATE },
125 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_PRELAUNCH },
126 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_COLO },
127 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_INTERNAL_ERROR },
128 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_IO_ERROR },
129 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_SHUTDOWN },
130 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_SUSPENDED },
131 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_WATCHDOG },
132 { RUN_STATE_FINISH_MIGRATE, RUN_STATE_GUEST_PANICKED },
134 { RUN_STATE_RESTORE_VM, RUN_STATE_RUNNING },
135 { RUN_STATE_RESTORE_VM, RUN_STATE_PRELAUNCH },
136 { RUN_STATE_RESTORE_VM, RUN_STATE_SUSPENDED },
138 { RUN_STATE_COLO, RUN_STATE_RUNNING },
139 { RUN_STATE_COLO, RUN_STATE_PRELAUNCH },
140 { RUN_STATE_COLO, RUN_STATE_SHUTDOWN},
142 { RUN_STATE_RUNNING, RUN_STATE_DEBUG },
143 { RUN_STATE_RUNNING, RUN_STATE_INTERNAL_ERROR },
144 { RUN_STATE_RUNNING, RUN_STATE_IO_ERROR },
145 { RUN_STATE_RUNNING, RUN_STATE_PAUSED },
146 { RUN_STATE_RUNNING, RUN_STATE_FINISH_MIGRATE },
147 { RUN_STATE_RUNNING, RUN_STATE_RESTORE_VM },
148 { RUN_STATE_RUNNING, RUN_STATE_SAVE_VM },
149 { RUN_STATE_RUNNING, RUN_STATE_SHUTDOWN },
150 { RUN_STATE_RUNNING, RUN_STATE_WATCHDOG },
151 { RUN_STATE_RUNNING, RUN_STATE_GUEST_PANICKED },
152 { RUN_STATE_RUNNING, RUN_STATE_COLO},
154 { RUN_STATE_SAVE_VM, RUN_STATE_RUNNING },
155 { RUN_STATE_SAVE_VM, RUN_STATE_SUSPENDED },
157 { RUN_STATE_SHUTDOWN, RUN_STATE_PAUSED },
158 { RUN_STATE_SHUTDOWN, RUN_STATE_FINISH_MIGRATE },
159 { RUN_STATE_SHUTDOWN, RUN_STATE_PRELAUNCH },
160 { RUN_STATE_SHUTDOWN, RUN_STATE_COLO },
162 { RUN_STATE_DEBUG, RUN_STATE_SUSPENDED },
163 { RUN_STATE_RUNNING, RUN_STATE_SUSPENDED },
164 { RUN_STATE_SUSPENDED, RUN_STATE_RUNNING },
165 { RUN_STATE_SUSPENDED, RUN_STATE_FINISH_MIGRATE },
166 { RUN_STATE_SUSPENDED, RUN_STATE_PRELAUNCH },
167 { RUN_STATE_SUSPENDED, RUN_STATE_COLO},
168 { RUN_STATE_SUSPENDED, RUN_STATE_PAUSED},
169 { RUN_STATE_SUSPENDED, RUN_STATE_SAVE_VM },
170 { RUN_STATE_SUSPENDED, RUN_STATE_RESTORE_VM },
171 { RUN_STATE_SUSPENDED, RUN_STATE_SHUTDOWN },
173 { RUN_STATE_WATCHDOG, RUN_STATE_RUNNING },
174 { RUN_STATE_WATCHDOG, RUN_STATE_FINISH_MIGRATE },
175 { RUN_STATE_WATCHDOG, RUN_STATE_PRELAUNCH },
176 { RUN_STATE_WATCHDOG, RUN_STATE_COLO},
178 { RUN_STATE_GUEST_PANICKED, RUN_STATE_RUNNING },
179 { RUN_STATE_GUEST_PANICKED, RUN_STATE_FINISH_MIGRATE },
180 { RUN_STATE_GUEST_PANICKED, RUN_STATE_PRELAUNCH },
182 { RUN_STATE__MAX, RUN_STATE__MAX },
185 static bool runstate_valid_transitions[RUN_STATE__MAX][RUN_STATE__MAX];
187 bool runstate_check(RunState state)
189 return current_run_state == state;
192 static void runstate_init(void)
194 const RunStateTransition *p;
196 memset(&runstate_valid_transitions, 0, sizeof(runstate_valid_transitions));
197 for (p = &runstate_transitions_def[0]; p->from != RUN_STATE__MAX; p++) {
198 runstate_valid_transitions[p->from][p->to] = true;
201 qemu_mutex_init(&vmstop_lock);
204 /* This function will abort() on invalid state transitions */
205 void runstate_set(RunState new_state)
207 assert(new_state < RUN_STATE__MAX);
209 trace_runstate_set(current_run_state, RunState_str(current_run_state),
210 new_state, RunState_str(new_state));
212 if (current_run_state == new_state) {
213 return;
216 if (!runstate_valid_transitions[current_run_state][new_state]) {
217 error_report("invalid runstate transition: '%s' -> '%s'",
218 RunState_str(current_run_state),
219 RunState_str(new_state));
220 abort();
223 current_run_state = new_state;
226 RunState runstate_get(void)
228 return current_run_state;
231 bool runstate_is_running(void)
233 return runstate_check(RUN_STATE_RUNNING);
236 bool runstate_needs_reset(void)
238 return runstate_check(RUN_STATE_INTERNAL_ERROR) ||
239 runstate_check(RUN_STATE_SHUTDOWN);
242 StatusInfo *qmp_query_status(Error **errp)
244 StatusInfo *info = g_malloc0(sizeof(*info));
246 info->running = runstate_is_running();
247 info->status = current_run_state;
249 return info;
252 bool qemu_vmstop_requested(RunState *r)
254 qemu_mutex_lock(&vmstop_lock);
255 *r = vmstop_requested;
256 vmstop_requested = RUN_STATE__MAX;
257 qemu_mutex_unlock(&vmstop_lock);
258 return *r < RUN_STATE__MAX;
261 void qemu_system_vmstop_request_prepare(void)
263 qemu_mutex_lock(&vmstop_lock);
266 void qemu_system_vmstop_request(RunState state)
268 vmstop_requested = state;
269 qemu_mutex_unlock(&vmstop_lock);
270 qemu_notify_event();
272 struct VMChangeStateEntry {
273 VMChangeStateHandler *cb;
274 VMChangeStateHandler *prepare_cb;
275 void *opaque;
276 QTAILQ_ENTRY(VMChangeStateEntry) entries;
277 int priority;
280 static QTAILQ_HEAD(, VMChangeStateEntry) vm_change_state_head =
281 QTAILQ_HEAD_INITIALIZER(vm_change_state_head);
284 * qemu_add_vm_change_state_handler_prio:
285 * @cb: the callback to invoke
286 * @opaque: user data passed to the callback
287 * @priority: low priorities execute first when the vm runs and the reverse is
288 * true when the vm stops
290 * Register a callback function that is invoked when the vm starts or stops
291 * running.
293 * Returns: an entry to be freed using qemu_del_vm_change_state_handler()
295 VMChangeStateEntry *qemu_add_vm_change_state_handler_prio(
296 VMChangeStateHandler *cb, void *opaque, int priority)
298 return qemu_add_vm_change_state_handler_prio_full(cb, NULL, opaque,
299 priority);
303 * qemu_add_vm_change_state_handler_prio_full:
304 * @cb: the main callback to invoke
305 * @prepare_cb: a callback to invoke before the main callback
306 * @opaque: user data passed to the callbacks
307 * @priority: low priorities execute first when the vm runs and the reverse is
308 * true when the vm stops
310 * Register a main callback function and an optional prepare callback function
311 * that are invoked when the vm starts or stops running. The main callback and
312 * the prepare callback are called in two separate phases: First all prepare
313 * callbacks are called and only then all main callbacks are called. As its
314 * name suggests, the prepare callback can be used to do some preparatory work
315 * before invoking the main callback.
317 * Returns: an entry to be freed using qemu_del_vm_change_state_handler()
319 VMChangeStateEntry *
320 qemu_add_vm_change_state_handler_prio_full(VMChangeStateHandler *cb,
321 VMChangeStateHandler *prepare_cb,
322 void *opaque, int priority)
324 VMChangeStateEntry *e;
325 VMChangeStateEntry *other;
327 e = g_malloc0(sizeof(*e));
328 e->cb = cb;
329 e->prepare_cb = prepare_cb;
330 e->opaque = opaque;
331 e->priority = priority;
333 /* Keep list sorted in ascending priority order */
334 QTAILQ_FOREACH(other, &vm_change_state_head, entries) {
335 if (priority < other->priority) {
336 QTAILQ_INSERT_BEFORE(other, e, entries);
337 return e;
341 QTAILQ_INSERT_TAIL(&vm_change_state_head, e, entries);
342 return e;
345 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb,
346 void *opaque)
348 return qemu_add_vm_change_state_handler_prio(cb, opaque, 0);
351 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e)
353 QTAILQ_REMOVE(&vm_change_state_head, e, entries);
354 g_free(e);
357 void vm_state_notify(bool running, RunState state)
359 VMChangeStateEntry *e, *next;
361 trace_vm_state_notify(running, state, RunState_str(state));
363 if (running) {
364 QTAILQ_FOREACH_SAFE(e, &vm_change_state_head, entries, next) {
365 if (e->prepare_cb) {
366 e->prepare_cb(e->opaque, running, state);
370 QTAILQ_FOREACH_SAFE(e, &vm_change_state_head, entries, next) {
371 e->cb(e->opaque, running, state);
373 } else {
374 QTAILQ_FOREACH_REVERSE_SAFE(e, &vm_change_state_head, entries, next) {
375 if (e->prepare_cb) {
376 e->prepare_cb(e->opaque, running, state);
380 QTAILQ_FOREACH_REVERSE_SAFE(e, &vm_change_state_head, entries, next) {
381 e->cb(e->opaque, running, state);
386 static ShutdownCause reset_requested;
387 static ShutdownCause shutdown_requested;
388 static int shutdown_exit_code = EXIT_SUCCESS;
389 static int shutdown_signal;
390 static pid_t shutdown_pid;
391 static int powerdown_requested;
392 static int debug_requested;
393 static int suspend_requested;
394 static WakeupReason wakeup_reason;
395 static NotifierList powerdown_notifiers =
396 NOTIFIER_LIST_INITIALIZER(powerdown_notifiers);
397 static NotifierList suspend_notifiers =
398 NOTIFIER_LIST_INITIALIZER(suspend_notifiers);
399 static NotifierList wakeup_notifiers =
400 NOTIFIER_LIST_INITIALIZER(wakeup_notifiers);
401 static NotifierList shutdown_notifiers =
402 NOTIFIER_LIST_INITIALIZER(shutdown_notifiers);
403 static uint32_t wakeup_reason_mask = ~(1 << QEMU_WAKEUP_REASON_NONE);
405 ShutdownCause qemu_shutdown_requested_get(void)
407 return shutdown_requested;
410 ShutdownCause qemu_reset_requested_get(void)
412 return reset_requested;
415 static int qemu_shutdown_requested(void)
417 return qatomic_xchg(&shutdown_requested, SHUTDOWN_CAUSE_NONE);
420 static void qemu_kill_report(void)
422 if (!qtest_driver() && shutdown_signal) {
423 if (shutdown_pid == 0) {
424 /* This happens for eg ^C at the terminal, so it's worth
425 * avoiding printing an odd message in that case.
427 error_report("terminating on signal %d", shutdown_signal);
428 } else {
429 char *shutdown_cmd = qemu_get_pid_name(shutdown_pid);
431 error_report("terminating on signal %d from pid " FMT_pid " (%s)",
432 shutdown_signal, shutdown_pid,
433 shutdown_cmd ? shutdown_cmd : "<unknown process>");
434 g_free(shutdown_cmd);
436 shutdown_signal = 0;
440 static ShutdownCause qemu_reset_requested(void)
442 ShutdownCause r = reset_requested;
444 if (r && replay_checkpoint(CHECKPOINT_RESET_REQUESTED)) {
445 reset_requested = SHUTDOWN_CAUSE_NONE;
446 return r;
448 return SHUTDOWN_CAUSE_NONE;
451 static int qemu_suspend_requested(void)
453 int r = suspend_requested;
454 if (r && replay_checkpoint(CHECKPOINT_SUSPEND_REQUESTED)) {
455 suspend_requested = 0;
456 return r;
458 return false;
461 static WakeupReason qemu_wakeup_requested(void)
463 return wakeup_reason;
466 static int qemu_powerdown_requested(void)
468 int r = powerdown_requested;
469 powerdown_requested = 0;
470 return r;
473 static int qemu_debug_requested(void)
475 int r = debug_requested;
476 debug_requested = 0;
477 return r;
481 * Reset the VM. Issue an event unless @reason is SHUTDOWN_CAUSE_NONE.
483 void qemu_system_reset(ShutdownCause reason)
485 MachineClass *mc;
487 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
489 cpu_synchronize_all_states();
491 if (mc && mc->reset) {
492 mc->reset(current_machine, reason);
493 } else {
494 qemu_devices_reset(reason);
496 switch (reason) {
497 case SHUTDOWN_CAUSE_NONE:
498 case SHUTDOWN_CAUSE_SUBSYSTEM_RESET:
499 case SHUTDOWN_CAUSE_SNAPSHOT_LOAD:
500 break;
501 default:
502 qapi_event_send_reset(shutdown_caused_by_guest(reason), reason);
504 cpu_synchronize_all_post_reset();
505 vm_set_suspended(false);
509 * Wake the VM after suspend.
511 static void qemu_system_wakeup(void)
513 MachineClass *mc;
515 mc = current_machine ? MACHINE_GET_CLASS(current_machine) : NULL;
517 if (mc && mc->wakeup) {
518 mc->wakeup(current_machine);
522 void qemu_system_guest_panicked(GuestPanicInformation *info)
524 qemu_log_mask(LOG_GUEST_ERROR, "Guest crashed");
526 if (current_cpu) {
527 current_cpu->crash_occurred = true;
530 * TODO: Currently the available panic actions are: none, pause, and
531 * shutdown, but in principle debug and reset could be supported as well.
532 * Investigate any potential use cases for the unimplemented actions.
534 if (panic_action == PANIC_ACTION_PAUSE
535 || (panic_action == PANIC_ACTION_SHUTDOWN && shutdown_action == SHUTDOWN_ACTION_PAUSE)) {
536 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_PAUSE, info);
537 vm_stop(RUN_STATE_GUEST_PANICKED);
538 } else if (panic_action == PANIC_ACTION_SHUTDOWN ||
539 panic_action == PANIC_ACTION_EXIT_FAILURE) {
540 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_POWEROFF, info);
541 vm_stop(RUN_STATE_GUEST_PANICKED);
542 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_PANIC);
543 } else {
544 qapi_event_send_guest_panicked(GUEST_PANIC_ACTION_RUN, info);
547 if (info) {
548 if (info->type == GUEST_PANIC_INFORMATION_TYPE_HYPER_V) {
549 qemu_log_mask(LOG_GUEST_ERROR, "\nHV crash parameters: (%#"PRIx64
550 " %#"PRIx64" %#"PRIx64" %#"PRIx64" %#"PRIx64")\n",
551 info->u.hyper_v.arg1,
552 info->u.hyper_v.arg2,
553 info->u.hyper_v.arg3,
554 info->u.hyper_v.arg4,
555 info->u.hyper_v.arg5);
556 } else if (info->type == GUEST_PANIC_INFORMATION_TYPE_S390) {
557 qemu_log_mask(LOG_GUEST_ERROR, " on cpu %d: %s\n"
558 "PSW: 0x%016" PRIx64 " 0x%016" PRIx64"\n",
559 info->u.s390.core,
560 S390CrashReason_str(info->u.s390.reason),
561 info->u.s390.psw_mask,
562 info->u.s390.psw_addr);
564 qapi_free_GuestPanicInformation(info);
568 void qemu_system_guest_crashloaded(GuestPanicInformation *info)
570 qemu_log_mask(LOG_GUEST_ERROR, "Guest crash loaded");
571 qapi_event_send_guest_crashloaded(GUEST_PANIC_ACTION_RUN, info);
572 qapi_free_GuestPanicInformation(info);
575 void qemu_system_reset_request(ShutdownCause reason)
577 if (reboot_action == REBOOT_ACTION_SHUTDOWN &&
578 reason != SHUTDOWN_CAUSE_SUBSYSTEM_RESET) {
579 shutdown_requested = reason;
580 } else if (!cpus_are_resettable()) {
581 error_report("cpus are not resettable, terminating");
582 shutdown_requested = reason;
583 } else {
584 reset_requested = reason;
586 cpu_stop_current();
587 qemu_notify_event();
590 static void qemu_system_suspend(void)
592 pause_all_vcpus();
593 notifier_list_notify(&suspend_notifiers, NULL);
594 runstate_set(RUN_STATE_SUSPENDED);
595 qapi_event_send_suspend();
598 void qemu_system_suspend_request(void)
600 if (runstate_check(RUN_STATE_SUSPENDED)) {
601 return;
603 suspend_requested = 1;
604 cpu_stop_current();
605 qemu_notify_event();
608 void qemu_register_suspend_notifier(Notifier *notifier)
610 notifier_list_add(&suspend_notifiers, notifier);
613 void qemu_system_wakeup_request(WakeupReason reason, Error **errp)
615 trace_system_wakeup_request(reason);
617 if (!runstate_check(RUN_STATE_SUSPENDED)) {
618 error_setg(errp,
619 "Unable to wake up: guest is not in suspended state");
620 return;
622 if (!(wakeup_reason_mask & (1 << reason))) {
623 return;
625 runstate_set(RUN_STATE_RUNNING);
626 wakeup_reason = reason;
627 qemu_notify_event();
630 void qemu_system_wakeup_enable(WakeupReason reason, bool enabled)
632 if (enabled) {
633 wakeup_reason_mask |= (1 << reason);
634 } else {
635 wakeup_reason_mask &= ~(1 << reason);
639 void qemu_register_wakeup_notifier(Notifier *notifier)
641 notifier_list_add(&wakeup_notifiers, notifier);
644 static bool wakeup_suspend_enabled;
646 void qemu_register_wakeup_support(void)
648 wakeup_suspend_enabled = true;
651 bool qemu_wakeup_suspend_enabled(void)
653 return wakeup_suspend_enabled;
656 void qemu_system_killed(int signal, pid_t pid)
658 shutdown_signal = signal;
659 shutdown_pid = pid;
660 shutdown_action = SHUTDOWN_ACTION_POWEROFF;
662 /* Cannot call qemu_system_shutdown_request directly because
663 * we are in a signal handler.
665 shutdown_requested = SHUTDOWN_CAUSE_HOST_SIGNAL;
666 qemu_notify_event();
669 void qemu_system_shutdown_request_with_code(ShutdownCause reason,
670 int exit_code)
672 shutdown_exit_code = exit_code;
673 qemu_system_shutdown_request(reason);
676 void qemu_system_shutdown_request(ShutdownCause reason)
678 trace_qemu_system_shutdown_request(reason);
679 replay_shutdown_request(reason);
680 shutdown_requested = reason;
681 qemu_notify_event();
684 static void qemu_system_powerdown(void)
686 qapi_event_send_powerdown();
687 notifier_list_notify(&powerdown_notifiers, NULL);
690 static void qemu_system_shutdown(ShutdownCause cause)
692 qapi_event_send_shutdown(shutdown_caused_by_guest(cause), cause);
693 notifier_list_notify(&shutdown_notifiers, &cause);
696 void qemu_system_powerdown_request(void)
698 trace_qemu_system_powerdown_request();
699 powerdown_requested = 1;
700 qemu_notify_event();
703 void qemu_register_powerdown_notifier(Notifier *notifier)
705 notifier_list_add(&powerdown_notifiers, notifier);
708 void qemu_register_shutdown_notifier(Notifier *notifier)
710 notifier_list_add(&shutdown_notifiers, notifier);
713 void qemu_system_debug_request(void)
715 debug_requested = 1;
716 qemu_notify_event();
719 static bool main_loop_should_exit(int *status)
721 RunState r;
722 ShutdownCause request;
724 if (qemu_debug_requested()) {
725 vm_stop(RUN_STATE_DEBUG);
727 if (qemu_suspend_requested()) {
728 qemu_system_suspend();
730 request = qemu_shutdown_requested();
731 if (request) {
732 qemu_kill_report();
733 qemu_system_shutdown(request);
734 if (shutdown_action == SHUTDOWN_ACTION_PAUSE) {
735 vm_stop(RUN_STATE_SHUTDOWN);
736 } else {
737 if (shutdown_exit_code != EXIT_SUCCESS) {
738 *status = shutdown_exit_code;
739 } else if (request == SHUTDOWN_CAUSE_GUEST_PANIC &&
740 panic_action == PANIC_ACTION_EXIT_FAILURE) {
741 *status = EXIT_FAILURE;
743 return true;
746 request = qemu_reset_requested();
747 if (request) {
748 pause_all_vcpus();
749 qemu_system_reset(request);
750 resume_all_vcpus();
752 * runstate can change in pause_all_vcpus()
753 * as iothread mutex is unlocked
755 if (!runstate_check(RUN_STATE_RUNNING) &&
756 !runstate_check(RUN_STATE_INMIGRATE) &&
757 !runstate_check(RUN_STATE_FINISH_MIGRATE)) {
758 runstate_set(RUN_STATE_PRELAUNCH);
761 if (qemu_wakeup_requested()) {
762 pause_all_vcpus();
763 qemu_system_wakeup();
764 notifier_list_notify(&wakeup_notifiers, &wakeup_reason);
765 wakeup_reason = QEMU_WAKEUP_REASON_NONE;
766 resume_all_vcpus();
767 qapi_event_send_wakeup();
769 if (qemu_powerdown_requested()) {
770 qemu_system_powerdown();
772 if (qemu_vmstop_requested(&r)) {
773 vm_stop(r);
775 return false;
778 int qemu_main_loop(void)
780 int status = EXIT_SUCCESS;
782 while (!main_loop_should_exit(&status)) {
783 main_loop_wait(false);
786 return status;
789 void qemu_add_exit_notifier(Notifier *notify)
791 notifier_list_add(&exit_notifiers, notify);
794 void qemu_remove_exit_notifier(Notifier *notify)
796 notifier_remove(notify);
799 static void qemu_run_exit_notifiers(void)
801 notifier_list_notify(&exit_notifiers, NULL);
804 void qemu_init_subsystems(void)
806 Error *err = NULL;
808 os_set_line_buffering();
810 module_call_init(MODULE_INIT_TRACE);
812 qemu_init_cpu_list();
813 qemu_init_cpu_loop();
814 bql_lock();
816 atexit(qemu_run_exit_notifiers);
818 module_call_init(MODULE_INIT_QOM);
819 module_call_init(MODULE_INIT_MIGRATION);
821 runstate_init();
822 precopy_infrastructure_init();
823 postcopy_infrastructure_init();
824 monitor_init_globals();
826 if (qcrypto_init(&err) < 0) {
827 error_reportf_err(err, "cannot initialize crypto: ");
828 exit(1);
831 os_setup_early_signal_handling();
833 bdrv_init_with_whitelist();
834 socket_init();
838 void qemu_cleanup(int status)
840 gdb_exit(status);
843 * cleaning up the migration object cancels any existing migration
844 * try to do this early so that it also stops using devices.
846 migration_shutdown();
849 * Close the exports before draining the block layer. The export
850 * drivers may have coroutines yielding on it, so we need to clean
851 * them up before the drain, as otherwise they may be get stuck in
852 * blk_wait_while_drained().
854 blk_exp_close_all();
857 /* No more vcpu or device emulation activity beyond this point */
858 vm_shutdown();
859 replay_finish();
862 * We must cancel all block jobs while the block layer is drained,
863 * or cancelling will be affected by throttling and thus may block
864 * for an extended period of time.
865 * Begin the drained section after vm_shutdown() to avoid requests being
866 * stuck in the BlockBackend's request queue.
867 * We do not need to end this section, because we do not want any
868 * requests happening from here on anyway.
870 bdrv_drain_all_begin();
871 job_cancel_sync_all();
872 bdrv_close_all();
874 /* vhost-user must be cleaned up before chardevs. */
875 tpm_cleanup();
876 net_cleanup();
877 audio_cleanup();
878 monitor_cleanup();
879 qemu_chr_cleanup();
880 user_creatable_cleanup();
881 /* TODO: unref root container, check all devices are ok */