+4

.gitignore

··· 38 38 /qapi/qapi-commands-crypto.[ch] 39 39 /qapi/qapi-commands-introspect.[ch] 40 40 /qapi/qapi-commands-migration.[ch] 41 41 + /qapi/qapi-commands-misc.[ch] 41 42 /qapi/qapi-commands-net.[ch] 42 43 /qapi/qapi-commands-rocker.[ch] 43 44 /qapi/qapi-commands-run-state.[ch] ··· 53 54 /qapi/qapi-events-crypto.[ch] 54 55 /qapi/qapi-events-introspect.[ch] 55 56 /qapi/qapi-events-migration.[ch] 57 57 + /qapi/qapi-events-misc.[ch] 56 58 /qapi/qapi-events-net.[ch] 57 59 /qapi/qapi-events-rocker.[ch] 58 60 /qapi/qapi-events-run-state.[ch] ··· 68 70 /qapi/qapi-types-crypto.[ch] 69 71 /qapi/qapi-types-introspect.[ch] 70 72 /qapi/qapi-types-migration.[ch] 73 73 + /qapi/qapi-types-misc.[ch] 71 74 /qapi/qapi-types-net.[ch] 72 75 /qapi/qapi-types-rocker.[ch] 73 76 /qapi/qapi-types-run-state.[ch] ··· 84 87 /qapi/qapi-visit-crypto.[ch] 85 88 /qapi/qapi-visit-introspect.[ch] 86 89 /qapi/qapi-visit-migration.[ch] 90 90 + /qapi/qapi-visit-misc.[ch] 87 91 /qapi/qapi-visit-net.[ch] 88 92 /qapi/qapi-visit-rocker.[ch] 89 93 /qapi/qapi-visit-run-state.[ch]

+9

Makefile

··· 99 99 GENERATED_FILES += qapi/qapi-types-crypto.h qapi/qapi-types-crypto.c 100 100 GENERATED_FILES += qapi/qapi-types-introspect.h qapi/qapi-types-introspect.c 101 101 GENERATED_FILES += qapi/qapi-types-migration.h qapi/qapi-types-migration.c 102 102 + GENERATED_FILES += qapi/qapi-types-misc.h qapi/qapi-types-misc.c 102 103 GENERATED_FILES += qapi/qapi-types-net.h qapi/qapi-types-net.c 103 104 GENERATED_FILES += qapi/qapi-types-rocker.h qapi/qapi-types-rocker.c 104 105 GENERATED_FILES += qapi/qapi-types-run-state.h qapi/qapi-types-run-state.c ··· 116 117 GENERATED_FILES += qapi/qapi-visit-crypto.h qapi/qapi-visit-crypto.c 117 118 GENERATED_FILES += qapi/qapi-visit-introspect.h qapi/qapi-visit-introspect.c 118 119 GENERATED_FILES += qapi/qapi-visit-migration.h qapi/qapi-visit-migration.c 120 120 + GENERATED_FILES += qapi/qapi-visit-misc.h qapi/qapi-visit-misc.c 119 121 GENERATED_FILES += qapi/qapi-visit-net.h qapi/qapi-visit-net.c 120 122 GENERATED_FILES += qapi/qapi-visit-rocker.h qapi/qapi-visit-rocker.c 121 123 GENERATED_FILES += qapi/qapi-visit-run-state.h qapi/qapi-visit-run-state.c ··· 132 134 GENERATED_FILES += qapi/qapi-commands-crypto.h qapi/qapi-commands-crypto.c 133 135 GENERATED_FILES += qapi/qapi-commands-introspect.h qapi/qapi-commands-introspect.c 134 136 GENERATED_FILES += qapi/qapi-commands-migration.h qapi/qapi-commands-migration.c 137 137 + GENERATED_FILES += qapi/qapi-commands-misc.h qapi/qapi-commands-misc.c 135 138 GENERATED_FILES += qapi/qapi-commands-net.h qapi/qapi-commands-net.c 136 139 GENERATED_FILES += qapi/qapi-commands-rocker.h qapi/qapi-commands-rocker.c 137 140 GENERATED_FILES += qapi/qapi-commands-run-state.h qapi/qapi-commands-run-state.c ··· 148 151 GENERATED_FILES += qapi/qapi-events-crypto.h qapi/qapi-events-crypto.c 149 152 GENERATED_FILES += qapi/qapi-events-introspect.h qapi/qapi-events-introspect.c 150 153 GENERATED_FILES += qapi/qapi-events-migration.h qapi/qapi-events-migration.c 154 154 + GENERATED_FILES += qapi/qapi-events-misc.h qapi/qapi-events-misc.c 151 155 GENERATED_FILES += qapi/qapi-events-net.h qapi/qapi-events-net.c 152 156 GENERATED_FILES += qapi/qapi-events-rocker.h qapi/qapi-events-rocker.c 153 157 GENERATED_FILES += qapi/qapi-events-run-state.h qapi/qapi-events-run-state.c ··· 573 577 $(SRC_PATH)/qapi/crypto.json \ 574 578 $(SRC_PATH)/qapi/introspect.json \ 575 579 $(SRC_PATH)/qapi/migration.json \ 580 580 + $(SRC_PATH)/qapi/misc.json \ 576 581 $(SRC_PATH)/qapi/net.json \ 577 582 $(SRC_PATH)/qapi/rocker.json \ 578 583 $(SRC_PATH)/qapi/run-state.json \ ··· 591 596 qapi/qapi-types-crypto.c qapi/qapi-types-crypto.h \ 592 597 qapi/qapi-types-introspect.c qapi/qapi-types-introspect.h \ 593 598 qapi/qapi-types-migration.c qapi/qapi-types-migration.h \ 599 599 + qapi/qapi-types-misc.c qapi/qapi-types-misc.h \ 594 600 qapi/qapi-types-net.c qapi/qapi-types-net.h \ 595 601 qapi/qapi-types-rocker.c qapi/qapi-types-rocker.h \ 596 602 qapi/qapi-types-run-state.c qapi/qapi-types-run-state.h \ ··· 608 614 qapi/qapi-visit-crypto.c qapi/qapi-visit-crypto.h \ 609 615 qapi/qapi-visit-introspect.c qapi/qapi-visit-introspect.h \ 610 616 qapi/qapi-visit-migration.c qapi/qapi-visit-migration.h \ 617 617 + qapi/qapi-visit-misc.c qapi/qapi-visit-misc.h \ 611 618 qapi/qapi-visit-net.c qapi/qapi-visit-net.h \ 612 619 qapi/qapi-visit-rocker.c qapi/qapi-visit-rocker.h \ 613 620 qapi/qapi-visit-run-state.c qapi/qapi-visit-run-state.h \ ··· 624 631 qapi/qapi-commands-crypto.c qapi/qapi-commands-crypto.h \ 625 632 qapi/qapi-commands-introspect.c qapi/qapi-commands-introspect.h \ 626 633 qapi/qapi-commands-migration.c qapi/qapi-commands-migration.h \ 634 634 + qapi/qapi-commands-misc.c qapi/qapi-commands-misc.h \ 627 635 qapi/qapi-commands-net.c qapi/qapi-commands-net.h \ 628 636 qapi/qapi-commands-rocker.c qapi/qapi-commands-rocker.h \ 629 637 qapi/qapi-commands-run-state.c qapi/qapi-commands-run-state.h \ ··· 640 648 qapi/qapi-events-crypto.c qapi/qapi-events-crypto.h \ 641 649 qapi/qapi-events-introspect.c qapi/qapi-events-introspect.h \ 642 650 qapi/qapi-events-migration.c qapi/qapi-events-migration.h \ 651 651 + qapi/qapi-events-misc.c qapi/qapi-events-misc.h \ 643 652 qapi/qapi-events-net.c qapi/qapi-events-net.h \ 644 653 qapi/qapi-events-rocker.c qapi/qapi-events-rocker.h \ 645 654 qapi/qapi-events-run-state.c qapi/qapi-events-run-state.h \

+4

Makefile.objs

··· 11 11 util-obj-y += qapi/qapi-types-crypto.o 12 12 util-obj-y += qapi/qapi-types-introspect.o 13 13 util-obj-y += qapi/qapi-types-migration.o 14 14 + util-obj-y += qapi/qapi-types-misc.o 14 15 util-obj-y += qapi/qapi-types-net.o 15 16 util-obj-y += qapi/qapi-types-rocker.o 16 17 util-obj-y += qapi/qapi-types-run-state.o ··· 28 29 util-obj-y += qapi/qapi-visit-crypto.o 29 30 util-obj-y += qapi/qapi-visit-introspect.o 30 31 util-obj-y += qapi/qapi-visit-migration.o 32 32 + util-obj-y += qapi/qapi-visit-misc.o 31 33 util-obj-y += qapi/qapi-visit-net.o 32 34 util-obj-y += qapi/qapi-visit-rocker.o 33 35 util-obj-y += qapi/qapi-visit-run-state.o ··· 44 46 util-obj-y += qapi/qapi-events-crypto.o 45 47 util-obj-y += qapi/qapi-events-introspect.o 46 48 util-obj-y += qapi/qapi-events-migration.o 49 49 + util-obj-y += qapi/qapi-events-misc.o 47 50 util-obj-y += qapi/qapi-events-net.o 48 51 util-obj-y += qapi/qapi-events-rocker.o 49 52 util-obj-y += qapi/qapi-events-run-state.o ··· 136 139 common-obj-y += qapi/qapi-commands-crypto.o 137 140 common-obj-y += qapi/qapi-commands-introspect.o 138 141 common-obj-y += qapi/qapi-commands-migration.o 142 142 + common-obj-y += qapi/qapi-commands-misc.o 139 143 common-obj-y += qapi/qapi-commands-net.o 140 144 common-obj-y += qapi/qapi-commands-rocker.o 141 145 common-obj-y += qapi/qapi-commands-run-state.o

+1 -1

arch_init.c

··· 28 28 #include "sysemu/arch_init.h" 29 29 #include "hw/pci/pci.h" 30 30 #include "hw/audio/soundhw.h" 31 31 + #include "qapi/qapi-commands-misc.h" 31 32 #include "qemu/config-file.h" 32 33 #include "qemu/error-report.h" 33 33 - #include "qmp-commands.h" 34 34 #include "hw/acpi/acpi.h" 35 35 #include "qemu/help_option.h" 36 36

+1 -1

balloon.c

··· 30 30 #include "sysemu/kvm.h" 31 31 #include "sysemu/balloon.h" 32 32 #include "trace-root.h" 33 33 - #include "qmp-commands.h" 34 33 #include "qapi/error.h" 34 34 + #include "qapi/qapi-commands-misc.h" 35 35 #include "qapi/qmp/qerror.h" 36 36 37 37 static QEMUBalloonEvent *balloon_event_fn;

+1 -1

block/iscsi.c

··· 37 37 #include "qemu/iov.h" 38 38 #include "qemu/option.h" 39 39 #include "qemu/uuid.h" 40 40 - #include "qmp-commands.h" 41 40 #include "qapi/error.h" 41 41 + #include "qapi/qapi-commands-misc.h" 42 42 #include "qapi/qmp/qdict.h" 43 43 #include "qapi/qmp/qstring.h" 44 44 #include "crypto/secret.h"

+1 -1

cpus.c

··· 27 27 #include "cpu.h" 28 28 #include "monitor/monitor.h" 29 29 #include "qapi/error.h" 30 30 + #include "qapi/qapi-commands-misc.h" 30 31 #include "qapi/qapi-events-run-state.h" 31 32 #include "qapi/qmp/qerror.h" 32 33 #include "qemu/error-report.h" ··· 39 40 #include "sysemu/hax.h" 40 41 #include "sysemu/hvf.h" 41 42 #include "sysemu/whpx.h" 42 42 - #include "qmp-commands.h" 43 43 #include "exec/exec-all.h" 44 44 45 45 #include "qemu/thread.h"

+2 -2

dump.c

··· 23 23 #include "sysemu/memory_mapping.h" 24 24 #include "sysemu/cpus.h" 25 25 #include "qapi/error.h" 26 26 + #include "qapi/qapi-commands-misc.h" 27 27 + #include "qapi/qapi-events-misc.h" 26 28 #include "qapi/qmp/qerror.h" 27 27 - #include "qmp-commands.h" 28 28 - #include "qapi-event.h" 29 29 #include "qemu/error-report.h" 30 30 #include "hw/misc/vmcoreinfo.h" 31 31

+9 -1

hmp.c

··· 23 23 #include "qemu/config-file.h" 24 24 #include "qemu/option.h" 25 25 #include "qemu/timer.h" 26 26 - #include "qmp-commands.h" 27 26 #include "qemu/sockets.h" 28 27 #include "monitor/monitor.h" 29 28 #include "monitor/qdev.h" 30 29 #include "qapi/error.h" 31 30 #include "qapi/opts-visitor.h" 32 31 #include "qapi-builtin-visit.h" 32 32 + #include "qapi/qapi-commands-block.h" 33 33 + #include "qapi/qapi-commands-char.h" 34 34 + #include "qapi/qapi-commands-migration.h" 35 35 + #include "qapi/qapi-commands-misc.h" 36 36 + #include "qapi/qapi-commands-net.h" 37 37 + #include "qapi/qapi-commands-rocker.h" 38 38 + #include "qapi/qapi-commands-run-state.h" 39 39 + #include "qapi/qapi-commands-tpm.h" 40 40 + #include "qapi/qapi-commands-ui.h" 33 41 #include "qapi/qmp/qdict.h" 34 42 #include "qapi/qmp/qerror.h" 35 43 #include "qapi/string-input-visitor.h"

+1 -1

hw/acpi/core.c

··· 28 28 #include "qapi/error.h" 29 29 #include "qapi/opts-visitor.h" 30 30 #include "qapi/qapi-events-run-state.h" 31 31 - #include "qapi-visit.h" 31 31 + #include "qapi/qapi-visit-misc.h" 32 32 #include "qemu/error-report.h" 33 33 #include "qemu/option.h" 34 34

+1 -1

hw/acpi/cpu.c

··· 2 2 #include "hw/boards.h" 3 3 #include "hw/acpi/cpu.h" 4 4 #include "qapi/error.h" 5 5 - #include "qapi-event.h" 5 5 + #include "qapi/qapi-events-misc.h" 6 6 #include "trace.h" 7 7 #include "sysemu/numa.h" 8 8

+1 -1

hw/acpi/memory_hotplug.c

··· 5 5 #include "hw/boards.h" 6 6 #include "hw/qdev-core.h" 7 7 #include "trace.h" 8 8 - #include "qapi-event.h" 9 8 #include "qapi/error.h" 9 9 + #include "qapi/qapi-events-misc.h" 10 10 11 11 #define MEMORY_SLOTS_NUMBER "MDNR" 12 12 #define MEMORY_HOTPLUG_IO_REGION "HPMR"

+1 -1

hw/acpi/vmgenid.c

··· 12 12 13 13 #include "qemu/osdep.h" 14 14 #include "qapi/error.h" 15 15 - #include "qmp-commands.h" 15 15 + #include "qapi/qapi-commands-misc.h" 16 16 #include "hw/acpi/acpi.h" 17 17 #include "hw/acpi/aml-build.h" 18 18 #include "hw/acpi/vmgenid.h"

+1 -1

hw/core/qdev.c

··· 29 29 #include "hw/qdev.h" 30 30 #include "sysemu/sysemu.h" 31 31 #include "qapi/error.h" 32 32 + #include "qapi/qapi-events-misc.h" 32 33 #include "qapi/qmp/qerror.h" 33 34 #include "qapi/visitor.h" 34 35 #include "qemu/error-report.h" ··· 36 37 #include "hw/hotplug.h" 37 38 #include "hw/boards.h" 38 39 #include "hw/sysbus.h" 39 39 - #include "qapi-event.h" 40 40 41 41 bool qdev_hotplug = false; 42 42 static bool qdev_hot_added = false;

+1 -1

hw/i386/xen/xen-hvm.c

··· 16 16 #include "hw/i386/apic-msidef.h" 17 17 #include "hw/xen/xen_common.h" 18 18 #include "hw/xen/xen_backend.h" 19 19 - #include "qmp-commands.h" 20 19 #include "qapi/error.h" 20 20 + #include "qapi/qapi-commands-misc.h" 21 21 #include "qemu/error-report.h" 22 22 #include "qemu/range.h" 23 23 #include "sysemu/xen-mapcache.h"

+1 -1

hw/ipmi/ipmi.c

··· 26 26 #include "hw/hw.h" 27 27 #include "hw/ipmi/ipmi.h" 28 28 #include "sysemu/sysemu.h" 29 29 - #include "qmp-commands.h" 30 29 #include "qom/object_interfaces.h" 31 30 #include "qapi/error.h" 31 31 + #include "qapi/qapi-commands-misc.h" 32 32 #include "qapi/visitor.h" 33 33 34 34 static uint32_t ipmi_current_uuid = 1;

+1 -1

hw/pci/pci-stub.c

··· 22 22 #include "sysemu/sysemu.h" 23 23 #include "monitor/monitor.h" 24 24 #include "qapi/error.h" 25 25 + #include "qapi/qapi-commands-misc.h" 25 26 #include "qapi/qmp/qerror.h" 26 27 #include "hw/pci/pci.h" 27 27 - #include "qmp-commands.h" 28 28 #include "hw/pci/msi.h" 29 29 30 30 bool msi_nonbroken;

+1 -1

hw/pci/pci.c

··· 34 34 #include "hw/loader.h" 35 35 #include "qemu/error-report.h" 36 36 #include "qemu/range.h" 37 37 - #include "qmp-commands.h" 38 37 #include "trace.h" 39 38 #include "hw/pci/msi.h" 40 39 #include "hw/pci/msix.h" ··· 42 41 #include "hw/hotplug.h" 43 42 #include "hw/boards.h" 44 43 #include "qapi/error.h" 44 44 + #include "qapi/qapi-commands-misc.h" 45 45 #include "qemu/cutils.h" 46 46 47 47 //#define DEBUG_PCI

+1 -1

hw/ppc/spapr_rtc.c

··· 30 30 #include "qemu/timer.h" 31 31 #include "sysemu/sysemu.h" 32 32 #include "hw/ppc/spapr.h" 33 33 - #include "qapi-event.h" 34 33 #include "qapi/error.h" 34 34 + #include "qapi/qapi-events-misc.h" 35 35 #include "qemu/cutils.h" 36 36 37 37 void spapr_rtc_read(sPAPRRTCState *rtc, struct tm *tm, uint32_t *ns)

+1 -1

hw/s390x/s390-skeys.c

··· 11 11 12 12 #include "qemu/osdep.h" 13 13 #include "hw/boards.h" 14 14 - #include "qmp-commands.h" 15 14 #include "hw/s390x/storage-keys.h" 16 15 #include "qapi/error.h" 16 16 + #include "qapi/qapi-commands-misc.h" 17 17 #include "qapi/qmp/qdict.h" 18 18 #include "qemu/error-report.h" 19 19 #include "sysemu/kvm.h"

+2 -2

hw/timer/mc146818rtc.c

··· 31 31 #include "sysemu/replay.h" 32 32 #include "hw/timer/mc146818rtc.h" 33 33 #include "qapi/error.h" 34 34 + #include "qapi/qapi-commands-misc.h" 35 35 + #include "qapi/qapi-events-misc.h" 34 36 #include "qapi/visitor.h" 35 35 - #include "qapi-event.h" 36 36 - #include "qmp-commands.h" 37 37 38 38 #ifdef TARGET_I386 39 39 #include "hw/i386/apic.h"

+1 -1

hw/virtio/virtio-balloon.c

··· 24 24 #include "sysemu/kvm.h" 25 25 #include "exec/address-spaces.h" 26 26 #include "qapi/error.h" 27 27 + #include "qapi/qapi-events-misc.h" 27 28 #include "qapi/visitor.h" 28 28 - #include "qapi-event.h" 29 29 #include "trace.h" 30 30 #include "qemu/error-report.h" 31 31

+1 -1

hw/watchdog/watchdog.c

··· 24 24 #include "qemu/config-file.h" 25 25 #include "qemu/queue.h" 26 26 #include "qapi/error.h" 27 27 + #include "qapi/qapi-commands-run-state.h" 27 28 #include "qapi/qapi-events-run-state.h" 28 29 #include "sysemu/sysemu.h" 29 30 #include "sysemu/watchdog.h" 30 31 #include "hw/nmi.h" 31 32 #include "qemu/help_option.h" 32 32 - #include "qmp-commands.h" 33 33 34 34 static WatchdogAction watchdog_action = WATCHDOG_ACTION_RESET; 35 35 static QLIST_HEAD(watchdog_list, WatchdogTimerModel) watchdog_list;

+2 -1

include/hw/qdev-properties.h

··· 1 1 #ifndef QEMU_QDEV_PROPERTIES_H 2 2 #define QEMU_QDEV_PROPERTIES_H 3 3 4 4 - #include "qapi-types.h" 4 4 + #include "qapi/qapi-types-block.h" 5 5 + #include "qapi/qapi-types-misc.h" 5 6 #include "hw/qdev-core.h" 6 7 7 8 /*** qdev-properties.c ***/

+1 -1

include/monitor/monitor.h

··· 3 3 4 4 #include "qemu-common.h" 5 5 #include "block/block.h" 6 6 - #include "qapi-types.h" 6 6 + #include "qapi/qapi-types-misc.h" 7 7 #include "qemu/readline.h" 8 8 9 9 extern Monitor *cur_mon;

+1 -1

include/sysemu/arch_init.h

··· 1 1 #ifndef QEMU_ARCH_INIT_H 2 2 #define QEMU_ARCH_INIT_H 3 3 4 4 - #include "qapi-types.h" 4 4 + #include "qapi/qapi-types-misc.h" 5 5 6 6 enum { 7 7 QEMU_ARCH_ALL = -1,

+1 -1

include/sysemu/balloon.h

··· 14 14 #ifndef QEMU_BALLOON_H 15 15 #define QEMU_BALLOON_H 16 16 17 17 - #include "qapi-types.h" 17 17 + #include "qapi/qapi-types-misc.h" 18 18 19 19 typedef void (QEMUBalloonEvent)(void *opaque, ram_addr_t target); 20 20 typedef void (QEMUBalloonStatus)(void *opaque, BalloonInfo *info);

+1 -1

include/sysemu/dump.h

··· 14 14 #ifndef DUMP_H 15 15 #define DUMP_H 16 16 17 17 - #include "qapi-types.h" 17 17 + #include "qapi/qapi-types-misc.h" 18 18 19 19 #define MAKEDUMPFILE_SIGNATURE "makedumpfile" 20 20 #define MAX_SIZE_MDF_HEADER (4096) /* max size of makedumpfile_header */

+1 -1

include/sysemu/hostmem.h

··· 14 14 #define SYSEMU_HOSTMEM_H 15 15 16 16 #include "sysemu/sysemu.h" /* for MAX_NODES */ 17 17 - #include "qapi-types.h" 17 17 + #include "qapi/qapi-types-misc.h" 18 18 #include "qom/object.h" 19 19 #include "exec/memory.h" 20 20 #include "qemu/bitmap.h"

+2 -1

include/sysemu/replay.h

··· 13 13 */ 14 14 15 15 #include "sysemu.h" 16 16 - #include "qapi-types.h" 16 16 + #include "qapi/qapi-types-misc.h" 17 17 + #include "qapi/qapi-types-ui.h" 17 18 18 19 /* replay clock kinds */ 19 20 enum ReplayClockKind {

+1 -1

iothread.c

··· 18 18 #include "block/aio.h" 19 19 #include "block/block.h" 20 20 #include "sysemu/iothread.h" 21 21 - #include "qmp-commands.h" 22 21 #include "qapi/error.h" 22 22 + #include "qapi/qapi-commands-misc.h" 23 23 #include "qemu/error-report.h" 24 24 #include "qemu/rcu.h" 25 25 #include "qemu/main-loop.h"

+2 -1

migration/savevm.c

··· 41 41 #include "savevm.h" 42 42 #include "postcopy-ram.h" 43 43 #include "qapi/error.h" 44 44 + #include "qapi/qapi-commands-migration.h" 45 45 + #include "qapi/qapi-commands-misc.h" 44 46 #include "qapi/qmp/qerror.h" 45 47 #include "qemu/error-report.h" 46 48 #include "sysemu/cpus.h" 47 49 #include "exec/memory.h" 48 50 #include "exec/target_page.h" 49 49 - #include "qmp-commands.h" 50 51 #include "trace.h" 51 52 #include "qemu/iov.h" 52 53 #include "block/snapshot.h"

+2 -2

numa.c

··· 29 29 #include "qemu/bitmap.h" 30 30 #include "qom/cpu.h" 31 31 #include "qemu/error-report.h" 32 32 - #include "qapi-visit.h" 33 32 #include "qapi/error.h" 34 33 #include "qapi/opts-visitor.h" 34 34 + #include "qapi/qapi-commands-misc.h" 35 35 + #include "qapi/qapi-visit-misc.h" 35 36 #include "hw/boards.h" 36 37 #include "sysemu/hostmem.h" 37 37 - #include "qmp-commands.h" 38 38 #include "hw/mem/pc-dimm.h" 39 39 #include "qemu/option.h" 40 40 #include "qemu/config-file.h"

+1 -3199

qapi-schema.json

··· 92 92 { 'include': 'qapi/transaction.json' } 93 93 { 'include': 'qapi/trace.json' } 94 94 { 'include': 'qapi/introspect.json' } 95 95 - 96 96 - ## 97 97 - # = Miscellanea 98 98 - ## 99 99 - 100 100 - ## 101 101 - # @qmp_capabilities: 102 102 - # 103 103 - # Enable QMP capabilities. 104 104 - # 105 105 - # Arguments: None. 106 106 - # 107 107 - # Example: 108 108 - # 109 109 - # -> { "execute": "qmp_capabilities" } 110 110 - # <- { "return": {} } 111 111 - # 112 112 - # Notes: This command is valid exactly when first connecting: it must be 113 113 - # issued before any other command will be accepted, and will fail once the 114 114 - # monitor is accepting other commands. (see qemu docs/interop/qmp-spec.txt) 115 115 - # 116 116 - # Since: 0.13 117 117 - # 118 118 - ## 119 119 - { 'command': 'qmp_capabilities' } 120 120 - 121 121 - ## 122 122 - # @VersionTriple: 123 123 - # 124 124 - # A three-part version number. 125 125 - # 126 126 - # @major: The major version number. 127 127 - # 128 128 - # @minor: The minor version number. 129 129 - # 130 130 - # @micro: The micro version number. 131 131 - # 132 132 - # Since: 2.4 133 133 - ## 134 134 - { 'struct': 'VersionTriple', 135 135 - 'data': {'major': 'int', 'minor': 'int', 'micro': 'int'} } 136 136 - 137 137 - 138 138 - ## 139 139 - # @VersionInfo: 140 140 - # 141 141 - # A description of QEMU's version. 142 142 - # 143 143 - # @qemu: The version of QEMU. By current convention, a micro 144 144 - # version of 50 signifies a development branch. A micro version 145 145 - # greater than or equal to 90 signifies a release candidate for 146 146 - # the next minor version. A micro version of less than 50 147 147 - # signifies a stable release. 148 148 - # 149 149 - # @package: QEMU will always set this field to an empty string. Downstream 150 150 - # versions of QEMU should set this to a non-empty string. The 151 151 - # exact format depends on the downstream however it highly 152 152 - # recommended that a unique name is used. 153 153 - # 154 154 - # Since: 0.14.0 155 155 - ## 156 156 - { 'struct': 'VersionInfo', 157 157 - 'data': {'qemu': 'VersionTriple', 'package': 'str'} } 158 158 - 159 159 - ## 160 160 - # @query-version: 161 161 - # 162 162 - # Returns the current version of QEMU. 163 163 - # 164 164 - # Returns: A @VersionInfo object describing the current version of QEMU. 165 165 - # 166 166 - # Since: 0.14.0 167 167 - # 168 168 - # Example: 169 169 - # 170 170 - # -> { "execute": "query-version" } 171 171 - # <- { 172 172 - # "return":{ 173 173 - # "qemu":{ 174 174 - # "major":0, 175 175 - # "minor":11, 176 176 - # "micro":5 177 177 - # }, 178 178 - # "package":"" 179 179 - # } 180 180 - # } 181 181 - # 182 182 - ## 183 183 - { 'command': 'query-version', 'returns': 'VersionInfo' } 184 184 - 185 185 - ## 186 186 - # @CommandInfo: 187 187 - # 188 188 - # Information about a QMP command 189 189 - # 190 190 - # @name: The command name 191 191 - # 192 192 - # Since: 0.14.0 193 193 - ## 194 194 - { 'struct': 'CommandInfo', 'data': {'name': 'str'} } 195 195 - 196 196 - ## 197 197 - # @query-commands: 198 198 - # 199 199 - # Return a list of supported QMP commands by this server 200 200 - # 201 201 - # Returns: A list of @CommandInfo for all supported commands 202 202 - # 203 203 - # Since: 0.14.0 204 204 - # 205 205 - # Example: 206 206 - # 207 207 - # -> { "execute": "query-commands" } 208 208 - # <- { 209 209 - # "return":[ 210 210 - # { 211 211 - # "name":"query-balloon" 212 212 - # }, 213 213 - # { 214 214 - # "name":"system_powerdown" 215 215 - # } 216 216 - # ] 217 217 - # } 218 218 - # 219 219 - # Note: This example has been shortened as the real response is too long. 220 220 - # 221 221 - ## 222 222 - { 'command': 'query-commands', 'returns': ['CommandInfo'] } 223 223 - 224 224 - ## 225 225 - # @LostTickPolicy: 226 226 - # 227 227 - # Policy for handling lost ticks in timer devices. 228 228 - # 229 229 - # @discard: throw away the missed tick(s) and continue with future injection 230 230 - # normally. Guest time may be delayed, unless the OS has explicit 231 231 - # handling of lost ticks 232 232 - # 233 233 - # @delay: continue to deliver ticks at the normal rate. Guest time will be 234 234 - # delayed due to the late tick 235 235 - # 236 236 - # @merge: merge the missed tick(s) into one tick and inject. Guest time 237 237 - # may be delayed, depending on how the OS reacts to the merging 238 238 - # of ticks 239 239 - # 240 240 - # @slew: deliver ticks at a higher rate to catch up with the missed tick. The 241 241 - # guest time should not be delayed once catchup is complete. 242 242 - # 243 243 - # Since: 2.0 244 244 - ## 245 245 - { 'enum': 'LostTickPolicy', 246 246 - 'data': ['discard', 'delay', 'merge', 'slew' ] } 247 247 - 248 248 - ## 249 249 - # @add_client: 250 250 - # 251 251 - # Allow client connections for VNC, Spice and socket based 252 252 - # character devices to be passed in to QEMU via SCM_RIGHTS. 253 253 - # 254 254 - # @protocol: protocol name. Valid names are "vnc", "spice" or the 255 255 - # name of a character device (eg. from -chardev id=XXXX) 256 256 - # 257 257 - # @fdname: file descriptor name previously passed via 'getfd' command 258 258 - # 259 259 - # @skipauth: whether to skip authentication. Only applies 260 260 - # to "vnc" and "spice" protocols 261 261 - # 262 262 - # @tls: whether to perform TLS. Only applies to the "spice" 263 263 - # protocol 264 264 - # 265 265 - # Returns: nothing on success. 266 266 - # 267 267 - # Since: 0.14.0 268 268 - # 269 269 - # Example: 270 270 - # 271 271 - # -> { "execute": "add_client", "arguments": { "protocol": "vnc", 272 272 - # "fdname": "myclient" } } 273 273 - # <- { "return": {} } 274 274 - # 275 275 - ## 276 276 - { 'command': 'add_client', 277 277 - 'data': { 'protocol': 'str', 'fdname': 'str', '*skipauth': 'bool', 278 278 - '*tls': 'bool' } } 279 279 - 280 280 - ## 281 281 - # @NameInfo: 282 282 - # 283 283 - # Guest name information. 284 284 - # 285 285 - # @name: The name of the guest 286 286 - # 287 287 - # Since: 0.14.0 288 288 - ## 289 289 - { 'struct': 'NameInfo', 'data': {'*name': 'str'} } 290 290 - 291 291 - ## 292 292 - # @query-name: 293 293 - # 294 294 - # Return the name information of a guest. 295 295 - # 296 296 - # Returns: @NameInfo of the guest 297 297 - # 298 298 - # Since: 0.14.0 299 299 - # 300 300 - # Example: 301 301 - # 302 302 - # -> { "execute": "query-name" } 303 303 - # <- { "return": { "name": "qemu-name" } } 304 304 - # 305 305 - ## 306 306 - { 'command': 'query-name', 'returns': 'NameInfo' } 307 307 - 308 308 - ## 309 309 - # @KvmInfo: 310 310 - # 311 311 - # Information about support for KVM acceleration 312 312 - # 313 313 - # @enabled: true if KVM acceleration is active 314 314 - # 315 315 - # @present: true if KVM acceleration is built into this executable 316 316 - # 317 317 - # Since: 0.14.0 318 318 - ## 319 319 - { 'struct': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} } 320 320 - 321 321 - ## 322 322 - # @query-kvm: 323 323 - # 324 324 - # Returns information about KVM acceleration 325 325 - # 326 326 - # Returns: @KvmInfo 327 327 - # 328 328 - # Since: 0.14.0 329 329 - # 330 330 - # Example: 331 331 - # 332 332 - # -> { "execute": "query-kvm" } 333 333 - # <- { "return": { "enabled": true, "present": true } } 334 334 - # 335 335 - ## 336 336 - { 'command': 'query-kvm', 'returns': 'KvmInfo' } 337 337 - 338 338 - ## 339 339 - # @UuidInfo: 340 340 - # 341 341 - # Guest UUID information (Universally Unique Identifier). 342 342 - # 343 343 - # @UUID: the UUID of the guest 344 344 - # 345 345 - # Since: 0.14.0 346 346 - # 347 347 - # Notes: If no UUID was specified for the guest, a null UUID is returned. 348 348 - ## 349 349 - { 'struct': 'UuidInfo', 'data': {'UUID': 'str'} } 350 350 - 351 351 - ## 352 352 - # @query-uuid: 353 353 - # 354 354 - # Query the guest UUID information. 355 355 - # 356 356 - # Returns: The @UuidInfo for the guest 357 357 - # 358 358 - # Since: 0.14.0 359 359 - # 360 360 - # Example: 361 361 - # 362 362 - # -> { "execute": "query-uuid" } 363 363 - # <- { "return": { "UUID": "550e8400-e29b-41d4-a716-446655440000" } } 364 364 - # 365 365 - ## 366 366 - { 'command': 'query-uuid', 'returns': 'UuidInfo' } 367 367 - 368 368 - ## 369 369 - # @EventInfo: 370 370 - # 371 371 - # Information about a QMP event 372 372 - # 373 373 - # @name: The event name 374 374 - # 375 375 - # Since: 1.2.0 376 376 - ## 377 377 - { 'struct': 'EventInfo', 'data': {'name': 'str'} } 378 378 - 379 379 - ## 380 380 - # @query-events: 381 381 - # 382 382 - # Return a list of supported QMP events by this server 383 383 - # 384 384 - # Returns: A list of @EventInfo for all supported events 385 385 - # 386 386 - # Since: 1.2.0 387 387 - # 388 388 - # Example: 389 389 - # 390 390 - # -> { "execute": "query-events" } 391 391 - # <- { 392 392 - # "return": [ 393 393 - # { 394 394 - # "name":"SHUTDOWN" 395 395 - # }, 396 396 - # { 397 397 - # "name":"RESET" 398 398 - # } 399 399 - # ] 400 400 - # } 401 401 - # 402 402 - # Note: This example has been shortened as the real response is too long. 403 403 - # 404 404 - ## 405 405 - { 'command': 'query-events', 'returns': ['EventInfo'] } 406 406 - 407 407 - ## 408 408 - # @CpuInfoArch: 409 409 - # 410 410 - # An enumeration of cpu types that enable additional information during 411 411 - # @query-cpus and @query-cpus-fast. 412 412 - # 413 413 - # @s390: since 2.12 414 414 - # 415 415 - # Since: 2.6 416 416 - ## 417 417 - { 'enum': 'CpuInfoArch', 418 418 - 'data': ['x86', 'sparc', 'ppc', 'mips', 'tricore', 's390', 'other' ] } 419 419 - 420 420 - ## 421 421 - # @CpuInfo: 422 422 - # 423 423 - # Information about a virtual CPU 424 424 - # 425 425 - # @CPU: the index of the virtual CPU 426 426 - # 427 427 - # @current: this only exists for backwards compatibility and should be ignored 428 428 - # 429 429 - # @halted: true if the virtual CPU is in the halt state. Halt usually refers 430 430 - # to a processor specific low power mode. 431 431 - # 432 432 - # @qom_path: path to the CPU object in the QOM tree (since 2.4) 433 433 - # 434 434 - # @thread_id: ID of the underlying host thread 435 435 - # 436 436 - # @props: properties describing to which node/socket/core/thread 437 437 - # virtual CPU belongs to, provided if supported by board (since 2.10) 438 438 - # 439 439 - # @arch: architecture of the cpu, which determines which additional fields 440 440 - # will be listed (since 2.6) 441 441 - # 442 442 - # Since: 0.14.0 443 443 - # 444 444 - # Notes: @halted is a transient state that changes frequently. By the time the 445 445 - # data is sent to the client, the guest may no longer be halted. 446 446 - ## 447 447 - { 'union': 'CpuInfo', 448 448 - 'base': {'CPU': 'int', 'current': 'bool', 'halted': 'bool', 449 449 - 'qom_path': 'str', 'thread_id': 'int', 450 450 - '*props': 'CpuInstanceProperties', 'arch': 'CpuInfoArch' }, 451 451 - 'discriminator': 'arch', 452 452 - 'data': { 'x86': 'CpuInfoX86', 453 453 - 'sparc': 'CpuInfoSPARC', 454 454 - 'ppc': 'CpuInfoPPC', 455 455 - 'mips': 'CpuInfoMIPS', 456 456 - 'tricore': 'CpuInfoTricore', 457 457 - 's390': 'CpuInfoS390', 458 458 - 'other': 'CpuInfoOther' } } 459 459 - 460 460 - ## 461 461 - # @CpuInfoX86: 462 462 - # 463 463 - # Additional information about a virtual i386 or x86_64 CPU 464 464 - # 465 465 - # @pc: the 64-bit instruction pointer 466 466 - # 467 467 - # Since: 2.6 468 468 - ## 469 469 - { 'struct': 'CpuInfoX86', 'data': { 'pc': 'int' } } 470 470 - 471 471 - ## 472 472 - # @CpuInfoSPARC: 473 473 - # 474 474 - # Additional information about a virtual SPARC CPU 475 475 - # 476 476 - # @pc: the PC component of the instruction pointer 477 477 - # 478 478 - # @npc: the NPC component of the instruction pointer 479 479 - # 480 480 - # Since: 2.6 481 481 - ## 482 482 - { 'struct': 'CpuInfoSPARC', 'data': { 'pc': 'int', 'npc': 'int' } } 483 483 - 484 484 - ## 485 485 - # @CpuInfoPPC: 486 486 - # 487 487 - # Additional information about a virtual PPC CPU 488 488 - # 489 489 - # @nip: the instruction pointer 490 490 - # 491 491 - # Since: 2.6 492 492 - ## 493 493 - { 'struct': 'CpuInfoPPC', 'data': { 'nip': 'int' } } 494 494 - 495 495 - ## 496 496 - # @CpuInfoMIPS: 497 497 - # 498 498 - # Additional information about a virtual MIPS CPU 499 499 - # 500 500 - # @PC: the instruction pointer 501 501 - # 502 502 - # Since: 2.6 503 503 - ## 504 504 - { 'struct': 'CpuInfoMIPS', 'data': { 'PC': 'int' } } 505 505 - 506 506 - ## 507 507 - # @CpuInfoTricore: 508 508 - # 509 509 - # Additional information about a virtual Tricore CPU 510 510 - # 511 511 - # @PC: the instruction pointer 512 512 - # 513 513 - # Since: 2.6 514 514 - ## 515 515 - { 'struct': 'CpuInfoTricore', 'data': { 'PC': 'int' } } 516 516 - 517 517 - ## 518 518 - # @CpuInfoOther: 519 519 - # 520 520 - # No additional information is available about the virtual CPU 521 521 - # 522 522 - # Since: 2.6 523 523 - # 524 524 - ## 525 525 - { 'struct': 'CpuInfoOther', 'data': { } } 526 526 - 527 527 - ## 528 528 - # @CpuS390State: 529 529 - # 530 530 - # An enumeration of cpu states that can be assumed by a virtual 531 531 - # S390 CPU 532 532 - # 533 533 - # Since: 2.12 534 534 - ## 535 535 - { 'enum': 'CpuS390State', 536 536 - 'prefix': 'S390_CPU_STATE', 537 537 - 'data': [ 'uninitialized', 'stopped', 'check-stop', 'operating', 'load' ] } 538 538 - 539 539 - ## 540 540 - # @CpuInfoS390: 541 541 - # 542 542 - # Additional information about a virtual S390 CPU 543 543 - # 544 544 - # @cpu-state: the virtual CPU's state 545 545 - # 546 546 - # Since: 2.12 547 547 - ## 548 548 - { 'struct': 'CpuInfoS390', 'data': { 'cpu-state': 'CpuS390State' } } 549 549 - 550 550 - ## 551 551 - # @query-cpus: 552 552 - # 553 553 - # Returns a list of information about each virtual CPU. 554 554 - # 555 555 - # This command causes vCPU threads to exit to userspace, which causes 556 556 - # a small interruption to guest CPU execution. This will have a negative 557 557 - # impact on realtime guests and other latency sensitive guest workloads. 558 558 - # It is recommended to use @query-cpus-fast instead of this command to 559 559 - # avoid the vCPU interruption. 560 560 - # 561 561 - # Returns: a list of @CpuInfo for each virtual CPU 562 562 - # 563 563 - # Since: 0.14.0 564 564 - # 565 565 - # Example: 566 566 - # 567 567 - # -> { "execute": "query-cpus" } 568 568 - # <- { "return": [ 569 569 - # { 570 570 - # "CPU":0, 571 571 - # "current":true, 572 572 - # "halted":false, 573 573 - # "qom_path":"/machine/unattached/device[0]", 574 574 - # "arch":"x86", 575 575 - # "pc":3227107138, 576 576 - # "thread_id":3134 577 577 - # }, 578 578 - # { 579 579 - # "CPU":1, 580 580 - # "current":false, 581 581 - # "halted":true, 582 582 - # "qom_path":"/machine/unattached/device[2]", 583 583 - # "arch":"x86", 584 584 - # "pc":7108165, 585 585 - # "thread_id":3135 586 586 - # } 587 587 - # ] 588 588 - # } 589 589 - # 590 590 - # Notes: This interface is deprecated (since 2.12.0), and it is strongly 591 591 - # recommended that you avoid using it. Use @query-cpus-fast to 592 592 - # obtain information about virtual CPUs. 593 593 - # 594 594 - ## 595 595 - { 'command': 'query-cpus', 'returns': ['CpuInfo'] } 596 596 - 597 597 - ## 598 598 - # @CpuInfoFast: 599 599 - # 600 600 - # Information about a virtual CPU 601 601 - # 602 602 - # @cpu-index: index of the virtual CPU 603 603 - # 604 604 - # @qom-path: path to the CPU object in the QOM tree 605 605 - # 606 606 - # @thread-id: ID of the underlying host thread 607 607 - # 608 608 - # @props: properties describing to which node/socket/core/thread 609 609 - # virtual CPU belongs to, provided if supported by board 610 610 - # 611 611 - # @arch: architecture of the cpu, which determines which additional fields 612 612 - # will be listed 613 613 - # 614 614 - # Since: 2.12 615 615 - # 616 616 - ## 617 617 - { 'union': 'CpuInfoFast', 618 618 - 'base': {'cpu-index': 'int', 'qom-path': 'str', 619 619 - 'thread-id': 'int', '*props': 'CpuInstanceProperties', 620 620 - 'arch': 'CpuInfoArch' }, 621 621 - 'discriminator': 'arch', 622 622 - 'data': { 'x86': 'CpuInfoOther', 623 623 - 'sparc': 'CpuInfoOther', 624 624 - 'ppc': 'CpuInfoOther', 625 625 - 'mips': 'CpuInfoOther', 626 626 - 'tricore': 'CpuInfoOther', 627 627 - 's390': 'CpuInfoS390', 628 628 - 'other': 'CpuInfoOther' } } 629 629 - 630 630 - ## 631 631 - # @query-cpus-fast: 632 632 - # 633 633 - # Returns information about all virtual CPUs. This command does not 634 634 - # incur a performance penalty and should be used in production 635 635 - # instead of query-cpus. 636 636 - # 637 637 - # Returns: list of @CpuInfoFast 638 638 - # 639 639 - # Since: 2.12 640 640 - # 641 641 - # Example: 642 642 - # 643 643 - # -> { "execute": "query-cpus-fast" } 644 644 - # <- { "return": [ 645 645 - # { 646 646 - # "thread-id": 25627, 647 647 - # "props": { 648 648 - # "core-id": 0, 649 649 - # "thread-id": 0, 650 650 - # "socket-id": 0 651 651 - # }, 652 652 - # "qom-path": "/machine/unattached/device[0]", 653 653 - # "arch":"x86", 654 654 - # "cpu-index": 0 655 655 - # }, 656 656 - # { 657 657 - # "thread-id": 25628, 658 658 - # "props": { 659 659 - # "core-id": 0, 660 660 - # "thread-id": 0, 661 661 - # "socket-id": 1 662 662 - # }, 663 663 - # "qom-path": "/machine/unattached/device[2]", 664 664 - # "arch":"x86", 665 665 - # "cpu-index": 1 666 666 - # } 667 667 - # ] 668 668 - # } 669 669 - ## 670 670 - { 'command': 'query-cpus-fast', 'returns': [ 'CpuInfoFast' ] } 671 671 - 672 672 - ## 673 673 - # @IOThreadInfo: 674 674 - # 675 675 - # Information about an iothread 676 676 - # 677 677 - # @id: the identifier of the iothread 678 678 - # 679 679 - # @thread-id: ID of the underlying host thread 680 680 - # 681 681 - # @poll-max-ns: maximum polling time in ns, 0 means polling is disabled 682 682 - # (since 2.9) 683 683 - # 684 684 - # @poll-grow: how many ns will be added to polling time, 0 means that it's not 685 685 - # configured (since 2.9) 686 686 - # 687 687 - # @poll-shrink: how many ns will be removed from polling time, 0 means that 688 688 - # it's not configured (since 2.9) 689 689 - # 690 690 - # Since: 2.0 691 691 - ## 692 692 - { 'struct': 'IOThreadInfo', 693 693 - 'data': {'id': 'str', 694 694 - 'thread-id': 'int', 695 695 - 'poll-max-ns': 'int', 696 696 - 'poll-grow': 'int', 697 697 - 'poll-shrink': 'int' } } 698 698 - 699 699 - ## 700 700 - # @query-iothreads: 701 701 - # 702 702 - # Returns a list of information about each iothread. 703 703 - # 704 704 - # Note: this list excludes the QEMU main loop thread, which is not declared 705 705 - # using the -object iothread command-line option. It is always the main thread 706 706 - # of the process. 707 707 - # 708 708 - # Returns: a list of @IOThreadInfo for each iothread 709 709 - # 710 710 - # Since: 2.0 711 711 - # 712 712 - # Example: 713 713 - # 714 714 - # -> { "execute": "query-iothreads" } 715 715 - # <- { "return": [ 716 716 - # { 717 717 - # "id":"iothread0", 718 718 - # "thread-id":3134 719 719 - # }, 720 720 - # { 721 721 - # "id":"iothread1", 722 722 - # "thread-id":3135 723 723 - # } 724 724 - # ] 725 725 - # } 726 726 - # 727 727 - ## 728 728 - { 'command': 'query-iothreads', 'returns': ['IOThreadInfo'] } 729 729 - 730 730 - ## 731 731 - # @BalloonInfo: 732 732 - # 733 733 - # Information about the guest balloon device. 734 734 - # 735 735 - # @actual: the number of bytes the balloon currently contains 736 736 - # 737 737 - # Since: 0.14.0 738 738 - # 739 739 - ## 740 740 - { 'struct': 'BalloonInfo', 'data': {'actual': 'int' } } 741 741 - 742 742 - ## 743 743 - # @query-balloon: 744 744 - # 745 745 - # Return information about the balloon device. 746 746 - # 747 747 - # Returns: @BalloonInfo on success 748 748 - # 749 749 - # If the balloon driver is enabled but not functional because the KVM 750 750 - # kernel module cannot support it, KvmMissingCap 751 751 - # 752 752 - # If no balloon device is present, DeviceNotActive 753 753 - # 754 754 - # Since: 0.14.0 755 755 - # 756 756 - # Example: 757 757 - # 758 758 - # -> { "execute": "query-balloon" } 759 759 - # <- { "return": { 760 760 - # "actual": 1073741824, 761 761 - # } 762 762 - # } 763 763 - # 764 764 - ## 765 765 - { 'command': 'query-balloon', 'returns': 'BalloonInfo' } 766 766 - 767 767 - ## 768 768 - # @BALLOON_CHANGE: 769 769 - # 770 770 - # Emitted when the guest changes the actual BALLOON level. This value is 771 771 - # equivalent to the @actual field return by the 'query-balloon' command 772 772 - # 773 773 - # @actual: actual level of the guest memory balloon in bytes 774 774 - # 775 775 - # Note: this event is rate-limited. 776 776 - # 777 777 - # Since: 1.2 778 778 - # 779 779 - # Example: 780 780 - # 781 781 - # <- { "event": "BALLOON_CHANGE", 782 782 - # "data": { "actual": 944766976 }, 783 783 - # "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } 784 784 - # 785 785 - ## 786 786 - { 'event': 'BALLOON_CHANGE', 787 787 - 'data': { 'actual': 'int' } } 788 788 - 789 789 - ## 790 790 - # @PciMemoryRange: 791 791 - # 792 792 - # A PCI device memory region 793 793 - # 794 794 - # @base: the starting address (guest physical) 795 795 - # 796 796 - # @limit: the ending address (guest physical) 797 797 - # 798 798 - # Since: 0.14.0 799 799 - ## 800 800 - { 'struct': 'PciMemoryRange', 'data': {'base': 'int', 'limit': 'int'} } 801 801 - 802 802 - ## 803 803 - # @PciMemoryRegion: 804 804 - # 805 805 - # Information about a PCI device I/O region. 806 806 - # 807 807 - # @bar: the index of the Base Address Register for this region 808 808 - # 809 809 - # @type: 'io' if the region is a PIO region 810 810 - # 'memory' if the region is a MMIO region 811 811 - # 812 812 - # @size: memory size 813 813 - # 814 814 - # @prefetch: if @type is 'memory', true if the memory is prefetchable 815 815 - # 816 816 - # @mem_type_64: if @type is 'memory', true if the BAR is 64-bit 817 817 - # 818 818 - # Since: 0.14.0 819 819 - ## 820 820 - { 'struct': 'PciMemoryRegion', 821 821 - 'data': {'bar': 'int', 'type': 'str', 'address': 'int', 'size': 'int', 822 822 - '*prefetch': 'bool', '*mem_type_64': 'bool' } } 823 823 - 824 824 - ## 825 825 - # @PciBusInfo: 826 826 - # 827 827 - # Information about a bus of a PCI Bridge device 828 828 - # 829 829 - # @number: primary bus interface number. This should be the number of the 830 830 - # bus the device resides on. 831 831 - # 832 832 - # @secondary: secondary bus interface number. This is the number of the 833 833 - # main bus for the bridge 834 834 - # 835 835 - # @subordinate: This is the highest number bus that resides below the 836 836 - # bridge. 837 837 - # 838 838 - # @io_range: The PIO range for all devices on this bridge 839 839 - # 840 840 - # @memory_range: The MMIO range for all devices on this bridge 841 841 - # 842 842 - # @prefetchable_range: The range of prefetchable MMIO for all devices on 843 843 - # this bridge 844 844 - # 845 845 - # Since: 2.4 846 846 - ## 847 847 - { 'struct': 'PciBusInfo', 848 848 - 'data': {'number': 'int', 'secondary': 'int', 'subordinate': 'int', 849 849 - 'io_range': 'PciMemoryRange', 850 850 - 'memory_range': 'PciMemoryRange', 851 851 - 'prefetchable_range': 'PciMemoryRange' } } 852 852 - 853 853 - ## 854 854 - # @PciBridgeInfo: 855 855 - # 856 856 - # Information about a PCI Bridge device 857 857 - # 858 858 - # @bus: information about the bus the device resides on 859 859 - # 860 860 - # @devices: a list of @PciDeviceInfo for each device on this bridge 861 861 - # 862 862 - # Since: 0.14.0 863 863 - ## 864 864 - { 'struct': 'PciBridgeInfo', 865 865 - 'data': {'bus': 'PciBusInfo', '*devices': ['PciDeviceInfo']} } 866 866 - 867 867 - ## 868 868 - # @PciDeviceClass: 869 869 - # 870 870 - # Information about the Class of a PCI device 871 871 - # 872 872 - # @desc: a string description of the device's class 873 873 - # 874 874 - # @class: the class code of the device 875 875 - # 876 876 - # Since: 2.4 877 877 - ## 878 878 - { 'struct': 'PciDeviceClass', 879 879 - 'data': {'*desc': 'str', 'class': 'int'} } 880 880 - 881 881 - ## 882 882 - # @PciDeviceId: 883 883 - # 884 884 - # Information about the Id of a PCI device 885 885 - # 886 886 - # @device: the PCI device id 887 887 - # 888 888 - # @vendor: the PCI vendor id 889 889 - # 890 890 - # Since: 2.4 891 891 - ## 892 892 - { 'struct': 'PciDeviceId', 893 893 - 'data': {'device': 'int', 'vendor': 'int'} } 894 894 - 895 895 - ## 896 896 - # @PciDeviceInfo: 897 897 - # 898 898 - # Information about a PCI device 899 899 - # 900 900 - # @bus: the bus number of the device 901 901 - # 902 902 - # @slot: the slot the device is located in 903 903 - # 904 904 - # @function: the function of the slot used by the device 905 905 - # 906 906 - # @class_info: the class of the device 907 907 - # 908 908 - # @id: the PCI device id 909 909 - # 910 910 - # @irq: if an IRQ is assigned to the device, the IRQ number 911 911 - # 912 912 - # @qdev_id: the device name of the PCI device 913 913 - # 914 914 - # @pci_bridge: if the device is a PCI bridge, the bridge information 915 915 - # 916 916 - # @regions: a list of the PCI I/O regions associated with the device 917 917 - # 918 918 - # Notes: the contents of @class_info.desc are not stable and should only be 919 919 - # treated as informational. 920 920 - # 921 921 - # Since: 0.14.0 922 922 - ## 923 923 - { 'struct': 'PciDeviceInfo', 924 924 - 'data': {'bus': 'int', 'slot': 'int', 'function': 'int', 925 925 - 'class_info': 'PciDeviceClass', 'id': 'PciDeviceId', 926 926 - '*irq': 'int', 'qdev_id': 'str', '*pci_bridge': 'PciBridgeInfo', 927 927 - 'regions': ['PciMemoryRegion']} } 928 928 - 929 929 - ## 930 930 - # @PciInfo: 931 931 - # 932 932 - # Information about a PCI bus 933 933 - # 934 934 - # @bus: the bus index 935 935 - # 936 936 - # @devices: a list of devices on this bus 937 937 - # 938 938 - # Since: 0.14.0 939 939 - ## 940 940 - { 'struct': 'PciInfo', 'data': {'bus': 'int', 'devices': ['PciDeviceInfo']} } 941 941 - 942 942 - ## 943 943 - # @query-pci: 944 944 - # 945 945 - # Return information about the PCI bus topology of the guest. 946 946 - # 947 947 - # Returns: a list of @PciInfo for each PCI bus. Each bus is 948 948 - # represented by a json-object, which has a key with a json-array of 949 949 - # all PCI devices attached to it. Each device is represented by a 950 950 - # json-object. 951 951 - # 952 952 - # Since: 0.14.0 953 953 - # 954 954 - # Example: 955 955 - # 956 956 - # -> { "execute": "query-pci" } 957 957 - # <- { "return": [ 958 958 - # { 959 959 - # "bus": 0, 960 960 - # "devices": [ 961 961 - # { 962 962 - # "bus": 0, 963 963 - # "qdev_id": "", 964 964 - # "slot": 0, 965 965 - # "class_info": { 966 966 - # "class": 1536, 967 967 - # "desc": "Host bridge" 968 968 - # }, 969 969 - # "id": { 970 970 - # "device": 32902, 971 971 - # "vendor": 4663 972 972 - # }, 973 973 - # "function": 0, 974 974 - # "regions": [ 975 975 - # ] 976 976 - # }, 977 977 - # { 978 978 - # "bus": 0, 979 979 - # "qdev_id": "", 980 980 - # "slot": 1, 981 981 - # "class_info": { 982 982 - # "class": 1537, 983 983 - # "desc": "ISA bridge" 984 984 - # }, 985 985 - # "id": { 986 986 - # "device": 32902, 987 987 - # "vendor": 28672 988 988 - # }, 989 989 - # "function": 0, 990 990 - # "regions": [ 991 991 - # ] 992 992 - # }, 993 993 - # { 994 994 - # "bus": 0, 995 995 - # "qdev_id": "", 996 996 - # "slot": 1, 997 997 - # "class_info": { 998 998 - # "class": 257, 999 999 - # "desc": "IDE controller" 1000 1000 - # }, 1001 1001 - # "id": { 1002 1002 - # "device": 32902, 1003 1003 - # "vendor": 28688 1004 1004 - # }, 1005 1005 - # "function": 1, 1006 1006 - # "regions": [ 1007 1007 - # { 1008 1008 - # "bar": 4, 1009 1009 - # "size": 16, 1010 1010 - # "address": 49152, 1011 1011 - # "type": "io" 1012 1012 - # } 1013 1013 - # ] 1014 1014 - # }, 1015 1015 - # { 1016 1016 - # "bus": 0, 1017 1017 - # "qdev_id": "", 1018 1018 - # "slot": 2, 1019 1019 - # "class_info": { 1020 1020 - # "class": 768, 1021 1021 - # "desc": "VGA controller" 1022 1022 - # }, 1023 1023 - # "id": { 1024 1024 - # "device": 4115, 1025 1025 - # "vendor": 184 1026 1026 - # }, 1027 1027 - # "function": 0, 1028 1028 - # "regions": [ 1029 1029 - # { 1030 1030 - # "prefetch": true, 1031 1031 - # "mem_type_64": false, 1032 1032 - # "bar": 0, 1033 1033 - # "size": 33554432, 1034 1034 - # "address": 4026531840, 1035 1035 - # "type": "memory" 1036 1036 - # }, 1037 1037 - # { 1038 1038 - # "prefetch": false, 1039 1039 - # "mem_type_64": false, 1040 1040 - # "bar": 1, 1041 1041 - # "size": 4096, 1042 1042 - # "address": 4060086272, 1043 1043 - # "type": "memory" 1044 1044 - # }, 1045 1045 - # { 1046 1046 - # "prefetch": false, 1047 1047 - # "mem_type_64": false, 1048 1048 - # "bar": 6, 1049 1049 - # "size": 65536, 1050 1050 - # "address": -1, 1051 1051 - # "type": "memory" 1052 1052 - # } 1053 1053 - # ] 1054 1054 - # }, 1055 1055 - # { 1056 1056 - # "bus": 0, 1057 1057 - # "qdev_id": "", 1058 1058 - # "irq": 11, 1059 1059 - # "slot": 4, 1060 1060 - # "class_info": { 1061 1061 - # "class": 1280, 1062 1062 - # "desc": "RAM controller" 1063 1063 - # }, 1064 1064 - # "id": { 1065 1065 - # "device": 6900, 1066 1066 - # "vendor": 4098 1067 1067 - # }, 1068 1068 - # "function": 0, 1069 1069 - # "regions": [ 1070 1070 - # { 1071 1071 - # "bar": 0, 1072 1072 - # "size": 32, 1073 1073 - # "address": 49280, 1074 1074 - # "type": "io" 1075 1075 - # } 1076 1076 - # ] 1077 1077 - # } 1078 1078 - # ] 1079 1079 - # } 1080 1080 - # ] 1081 1081 - # } 1082 1082 - # 1083 1083 - # Note: This example has been shortened as the real response is too long. 1084 1084 - # 1085 1085 - ## 1086 1086 - { 'command': 'query-pci', 'returns': ['PciInfo'] } 1087 1087 - 1088 1088 - ## 1089 1089 - # @quit: 1090 1090 - # 1091 1091 - # This command will cause the QEMU process to exit gracefully. While every 1092 1092 - # attempt is made to send the QMP response before terminating, this is not 1093 1093 - # guaranteed. When using this interface, a premature EOF would not be 1094 1094 - # unexpected. 1095 1095 - # 1096 1096 - # Since: 0.14.0 1097 1097 - # 1098 1098 - # Example: 1099 1099 - # 1100 1100 - # -> { "execute": "quit" } 1101 1101 - # <- { "return": {} } 1102 1102 - ## 1103 1103 - { 'command': 'quit' } 1104 1104 - 1105 1105 - ## 1106 1106 - # @stop: 1107 1107 - # 1108 1108 - # Stop all guest VCPU execution. 1109 1109 - # 1110 1110 - # Since: 0.14.0 1111 1111 - # 1112 1112 - # Notes: This function will succeed even if the guest is already in the stopped 1113 1113 - # state. In "inmigrate" state, it will ensure that the guest 1114 1114 - # remains paused once migration finishes, as if the -S option was 1115 1115 - # passed on the command line. 1116 1116 - # 1117 1117 - # Example: 1118 1118 - # 1119 1119 - # -> { "execute": "stop" } 1120 1120 - # <- { "return": {} } 1121 1121 - # 1122 1122 - ## 1123 1123 - { 'command': 'stop' } 1124 1124 - 1125 1125 - ## 1126 1126 - # @system_reset: 1127 1127 - # 1128 1128 - # Performs a hard reset of a guest. 1129 1129 - # 1130 1130 - # Since: 0.14.0 1131 1131 - # 1132 1132 - # Example: 1133 1133 - # 1134 1134 - # -> { "execute": "system_reset" } 1135 1135 - # <- { "return": {} } 1136 1136 - # 1137 1137 - ## 1138 1138 - { 'command': 'system_reset' } 1139 1139 - 1140 1140 - ## 1141 1141 - # @system_powerdown: 1142 1142 - # 1143 1143 - # Requests that a guest perform a powerdown operation. 1144 1144 - # 1145 1145 - # Since: 0.14.0 1146 1146 - # 1147 1147 - # Notes: A guest may or may not respond to this command. This command 1148 1148 - # returning does not indicate that a guest has accepted the request or 1149 1149 - # that it has shut down. Many guests will respond to this command by 1150 1150 - # prompting the user in some way. 1151 1151 - # Example: 1152 1152 - # 1153 1153 - # -> { "execute": "system_powerdown" } 1154 1154 - # <- { "return": {} } 1155 1155 - # 1156 1156 - ## 1157 1157 - { 'command': 'system_powerdown' } 1158 1158 - 1159 1159 - ## 1160 1160 - # @cpu-add: 1161 1161 - # 1162 1162 - # Adds CPU with specified ID 1163 1163 - # 1164 1164 - # @id: ID of CPU to be created, valid values [0..max_cpus) 1165 1165 - # 1166 1166 - # Returns: Nothing on success 1167 1167 - # 1168 1168 - # Since: 1.5 1169 1169 - # 1170 1170 - # Example: 1171 1171 - # 1172 1172 - # -> { "execute": "cpu-add", "arguments": { "id": 2 } } 1173 1173 - # <- { "return": {} } 1174 1174 - # 1175 1175 - ## 1176 1176 - { 'command': 'cpu-add', 'data': {'id': 'int'} } 1177 1177 - 1178 1178 - ## 1179 1179 - # @memsave: 1180 1180 - # 1181 1181 - # Save a portion of guest memory to a file. 1182 1182 - # 1183 1183 - # @val: the virtual address of the guest to start from 1184 1184 - # 1185 1185 - # @size: the size of memory region to save 1186 1186 - # 1187 1187 - # @filename: the file to save the memory to as binary data 1188 1188 - # 1189 1189 - # @cpu-index: the index of the virtual CPU to use for translating the 1190 1190 - # virtual address (defaults to CPU 0) 1191 1191 - # 1192 1192 - # Returns: Nothing on success 1193 1193 - # 1194 1194 - # Since: 0.14.0 1195 1195 - # 1196 1196 - # Notes: Errors were not reliably returned until 1.1 1197 1197 - # 1198 1198 - # Example: 1199 1199 - # 1200 1200 - # -> { "execute": "memsave", 1201 1201 - # "arguments": { "val": 10, 1202 1202 - # "size": 100, 1203 1203 - # "filename": "/tmp/virtual-mem-dump" } } 1204 1204 - # <- { "return": {} } 1205 1205 - # 1206 1206 - ## 1207 1207 - { 'command': 'memsave', 1208 1208 - 'data': {'val': 'int', 'size': 'int', 'filename': 'str', '*cpu-index': 'int'} } 1209 1209 - 1210 1210 - ## 1211 1211 - # @pmemsave: 1212 1212 - # 1213 1213 - # Save a portion of guest physical memory to a file. 1214 1214 - # 1215 1215 - # @val: the physical address of the guest to start from 1216 1216 - # 1217 1217 - # @size: the size of memory region to save 1218 1218 - # 1219 1219 - # @filename: the file to save the memory to as binary data 1220 1220 - # 1221 1221 - # Returns: Nothing on success 1222 1222 - # 1223 1223 - # Since: 0.14.0 1224 1224 - # 1225 1225 - # Notes: Errors were not reliably returned until 1.1 1226 1226 - # 1227 1227 - # Example: 1228 1228 - # 1229 1229 - # -> { "execute": "pmemsave", 1230 1230 - # "arguments": { "val": 10, 1231 1231 - # "size": 100, 1232 1232 - # "filename": "/tmp/physical-mem-dump" } } 1233 1233 - # <- { "return": {} } 1234 1234 - # 1235 1235 - ## 1236 1236 - { 'command': 'pmemsave', 1237 1237 - 'data': {'val': 'int', 'size': 'int', 'filename': 'str'} } 1238 1238 - 1239 1239 - ## 1240 1240 - # @cont: 1241 1241 - # 1242 1242 - # Resume guest VCPU execution. 1243 1243 - # 1244 1244 - # Since: 0.14.0 1245 1245 - # 1246 1246 - # Returns: If successful, nothing 1247 1247 - # 1248 1248 - # Notes: This command will succeed if the guest is currently running. It 1249 1249 - # will also succeed if the guest is in the "inmigrate" state; in 1250 1250 - # this case, the effect of the command is to make sure the guest 1251 1251 - # starts once migration finishes, removing the effect of the -S 1252 1252 - # command line option if it was passed. 1253 1253 - # 1254 1254 - # Example: 1255 1255 - # 1256 1256 - # -> { "execute": "cont" } 1257 1257 - # <- { "return": {} } 1258 1258 - # 1259 1259 - ## 1260 1260 - { 'command': 'cont' } 1261 1261 - 1262 1262 - ## 1263 1263 - # @system_wakeup: 1264 1264 - # 1265 1265 - # Wakeup guest from suspend. Does nothing in case the guest isn't suspended. 1266 1266 - # 1267 1267 - # Since: 1.1 1268 1268 - # 1269 1269 - # Returns: nothing. 1270 1270 - # 1271 1271 - # Example: 1272 1272 - # 1273 1273 - # -> { "execute": "system_wakeup" } 1274 1274 - # <- { "return": {} } 1275 1275 - # 1276 1276 - ## 1277 1277 - { 'command': 'system_wakeup' } 1278 1278 - 1279 1279 - ## 1280 1280 - # @inject-nmi: 1281 1281 - # 1282 1282 - # Injects a Non-Maskable Interrupt into the default CPU (x86/s390) or all CPUs (ppc64). 1283 1283 - # The command fails when the guest doesn't support injecting. 1284 1284 - # 1285 1285 - # Returns: If successful, nothing 1286 1286 - # 1287 1287 - # Since: 0.14.0 1288 1288 - # 1289 1289 - # Note: prior to 2.1, this command was only supported for x86 and s390 VMs 1290 1290 - # 1291 1291 - # Example: 1292 1292 - # 1293 1293 - # -> { "execute": "inject-nmi" } 1294 1294 - # <- { "return": {} } 1295 1295 - # 1296 1296 - ## 1297 1297 - { 'command': 'inject-nmi' } 1298 1298 - 1299 1299 - ## 1300 1300 - # @balloon: 1301 1301 - # 1302 1302 - # Request the balloon driver to change its balloon size. 1303 1303 - # 1304 1304 - # @value: the target size of the balloon in bytes 1305 1305 - # 1306 1306 - # Returns: Nothing on success 1307 1307 - # If the balloon driver is enabled but not functional because the KVM 1308 1308 - # kernel module cannot support it, KvmMissingCap 1309 1309 - # If no balloon device is present, DeviceNotActive 1310 1310 - # 1311 1311 - # Notes: This command just issues a request to the guest. When it returns, 1312 1312 - # the balloon size may not have changed. A guest can change the balloon 1313 1313 - # size independent of this command. 1314 1314 - # 1315 1315 - # Since: 0.14.0 1316 1316 - # 1317 1317 - # Example: 1318 1318 - # 1319 1319 - # -> { "execute": "balloon", "arguments": { "value": 536870912 } } 1320 1320 - # <- { "return": {} } 1321 1321 - # 1322 1322 - ## 1323 1323 - { 'command': 'balloon', 'data': {'value': 'int'} } 1324 1324 - 1325 1325 - ## 1326 1326 - # @human-monitor-command: 1327 1327 - # 1328 1328 - # Execute a command on the human monitor and return the output. 1329 1329 - # 1330 1330 - # @command-line: the command to execute in the human monitor 1331 1331 - # 1332 1332 - # @cpu-index: The CPU to use for commands that require an implicit CPU 1333 1333 - # 1334 1334 - # Returns: the output of the command as a string 1335 1335 - # 1336 1336 - # Since: 0.14.0 1337 1337 - # 1338 1338 - # Notes: This command only exists as a stop-gap. Its use is highly 1339 1339 - # discouraged. The semantics of this command are not 1340 1340 - # guaranteed: this means that command names, arguments and 1341 1341 - # responses can change or be removed at ANY time. Applications 1342 1342 - # that rely on long term stability guarantees should NOT 1343 1343 - # use this command. 1344 1344 - # 1345 1345 - # Known limitations: 1346 1346 - # 1347 1347 - # * This command is stateless, this means that commands that depend 1348 1348 - # on state information (such as getfd) might not work 1349 1349 - # 1350 1350 - # * Commands that prompt the user for data don't currently work 1351 1351 - # 1352 1352 - # Example: 1353 1353 - # 1354 1354 - # -> { "execute": "human-monitor-command", 1355 1355 - # "arguments": { "command-line": "info kvm" } } 1356 1356 - # <- { "return": "kvm support: enabled\r\n" } 1357 1357 - # 1358 1358 - ## 1359 1359 - { 'command': 'human-monitor-command', 1360 1360 - 'data': {'command-line': 'str', '*cpu-index': 'int'}, 1361 1361 - 'returns': 'str' } 1362 1362 - 1363 1363 - ## 1364 1364 - # @ObjectPropertyInfo: 1365 1365 - # 1366 1366 - # @name: the name of the property 1367 1367 - # 1368 1368 - # @type: the type of the property. This will typically come in one of four 1369 1369 - # forms: 1370 1370 - # 1371 1371 - # 1) A primitive type such as 'u8', 'u16', 'bool', 'str', or 'double'. 1372 1372 - # These types are mapped to the appropriate JSON type. 1373 1373 - # 1374 1374 - # 2) A child type in the form 'child<subtype>' where subtype is a qdev 1375 1375 - # device type name. Child properties create the composition tree. 1376 1376 - # 1377 1377 - # 3) A link type in the form 'link<subtype>' where subtype is a qdev 1378 1378 - # device type name. Link properties form the device model graph. 1379 1379 - # 1380 1380 - # Since: 1.2 1381 1381 - ## 1382 1382 - { 'struct': 'ObjectPropertyInfo', 1383 1383 - 'data': { 'name': 'str', 'type': 'str' } } 1384 1384 - 1385 1385 - ## 1386 1386 - # @qom-list: 1387 1387 - # 1388 1388 - # This command will list any properties of a object given a path in the object 1389 1389 - # model. 1390 1390 - # 1391 1391 - # @path: the path within the object model. See @qom-get for a description of 1392 1392 - # this parameter. 1393 1393 - # 1394 1394 - # Returns: a list of @ObjectPropertyInfo that describe the properties of the 1395 1395 - # object. 1396 1396 - # 1397 1397 - # Since: 1.2 1398 1398 - ## 1399 1399 - { 'command': 'qom-list', 1400 1400 - 'data': { 'path': 'str' }, 1401 1401 - 'returns': [ 'ObjectPropertyInfo' ] } 1402 1402 - 1403 1403 - ## 1404 1404 - # @qom-get: 1405 1405 - # 1406 1406 - # This command will get a property from a object model path and return the 1407 1407 - # value. 1408 1408 - # 1409 1409 - # @path: The path within the object model. There are two forms of supported 1410 1410 - # paths--absolute and partial paths. 1411 1411 - # 1412 1412 - # Absolute paths are derived from the root object and can follow child<> 1413 1413 - # or link<> properties. Since they can follow link<> properties, they 1414 1414 - # can be arbitrarily long. Absolute paths look like absolute filenames 1415 1415 - # and are prefixed with a leading slash. 1416 1416 - # 1417 1417 - # Partial paths look like relative filenames. They do not begin 1418 1418 - # with a prefix. The matching rules for partial paths are subtle but 1419 1419 - # designed to make specifying objects easy. At each level of the 1420 1420 - # composition tree, the partial path is matched as an absolute path. 1421 1421 - # The first match is not returned. At least two matches are searched 1422 1422 - # for. A successful result is only returned if only one match is 1423 1423 - # found. If more than one match is found, a flag is return to 1424 1424 - # indicate that the match was ambiguous. 1425 1425 - # 1426 1426 - # @property: The property name to read 1427 1427 - # 1428 1428 - # Returns: The property value. The type depends on the property 1429 1429 - # type. child<> and link<> properties are returned as #str 1430 1430 - # pathnames. All integer property types (u8, u16, etc) are 1431 1431 - # returned as #int. 1432 1432 - # 1433 1433 - # Since: 1.2 1434 1434 - ## 1435 1435 - { 'command': 'qom-get', 1436 1436 - 'data': { 'path': 'str', 'property': 'str' }, 1437 1437 - 'returns': 'any' } 1438 1438 - 1439 1439 - ## 1440 1440 - # @qom-set: 1441 1441 - # 1442 1442 - # This command will set a property from a object model path. 1443 1443 - # 1444 1444 - # @path: see @qom-get for a description of this parameter 1445 1445 - # 1446 1446 - # @property: the property name to set 1447 1447 - # 1448 1448 - # @value: a value who's type is appropriate for the property type. See @qom-get 1449 1449 - # for a description of type mapping. 1450 1450 - # 1451 1451 - # Since: 1.2 1452 1452 - ## 1453 1453 - { 'command': 'qom-set', 1454 1454 - 'data': { 'path': 'str', 'property': 'str', 'value': 'any' } } 1455 1455 - 1456 1456 - ## 1457 1457 - # @change: 1458 1458 - # 1459 1459 - # This command is multiple commands multiplexed together. 1460 1460 - # 1461 1461 - # @device: This is normally the name of a block device but it may also be 'vnc'. 1462 1462 - # when it's 'vnc', then sub command depends on @target 1463 1463 - # 1464 1464 - # @target: If @device is a block device, then this is the new filename. 1465 1465 - # If @device is 'vnc', then if the value 'password' selects the vnc 1466 1466 - # change password command. Otherwise, this specifies a new server URI 1467 1467 - # address to listen to for VNC connections. 1468 1468 - # 1469 1469 - # @arg: If @device is a block device, then this is an optional format to open 1470 1470 - # the device with. 1471 1471 - # If @device is 'vnc' and @target is 'password', this is the new VNC 1472 1472 - # password to set. See change-vnc-password for additional notes. 1473 1473 - # 1474 1474 - # Returns: Nothing on success. 1475 1475 - # If @device is not a valid block device, DeviceNotFound 1476 1476 - # 1477 1477 - # Notes: This interface is deprecated, and it is strongly recommended that you 1478 1478 - # avoid using it. For changing block devices, use 1479 1479 - # blockdev-change-medium; for changing VNC parameters, use 1480 1480 - # change-vnc-password. 1481 1481 - # 1482 1482 - # Since: 0.14.0 1483 1483 - # 1484 1484 - # Example: 1485 1485 - # 1486 1486 - # 1. Change a removable medium 1487 1487 - # 1488 1488 - # -> { "execute": "change", 1489 1489 - # "arguments": { "device": "ide1-cd0", 1490 1490 - # "target": "/srv/images/Fedora-12-x86_64-DVD.iso" } } 1491 1491 - # <- { "return": {} } 1492 1492 - # 1493 1493 - # 2. Change VNC password 1494 1494 - # 1495 1495 - # -> { "execute": "change", 1496 1496 - # "arguments": { "device": "vnc", "target": "password", 1497 1497 - # "arg": "foobar1" } } 1498 1498 - # <- { "return": {} } 1499 1499 - # 1500 1500 - ## 1501 1501 - { 'command': 'change', 1502 1502 - 'data': {'device': 'str', 'target': 'str', '*arg': 'str'} } 1503 1503 - 1504 1504 - ## 1505 1505 - # @ObjectTypeInfo: 1506 1506 - # 1507 1507 - # This structure describes a search result from @qom-list-types 1508 1508 - # 1509 1509 - # @name: the type name found in the search 1510 1510 - # 1511 1511 - # @abstract: the type is abstract and can't be directly instantiated. 1512 1512 - # Omitted if false. (since 2.10) 1513 1513 - # 1514 1514 - # @parent: Name of parent type, if any (since 2.10) 1515 1515 - # 1516 1516 - # Since: 1.1 1517 1517 - ## 1518 1518 - { 'struct': 'ObjectTypeInfo', 1519 1519 - 'data': { 'name': 'str', '*abstract': 'bool', '*parent': 'str' } } 1520 1520 - 1521 1521 - ## 1522 1522 - # @qom-list-types: 1523 1523 - # 1524 1524 - # This command will return a list of types given search parameters 1525 1525 - # 1526 1526 - # @implements: if specified, only return types that implement this type name 1527 1527 - # 1528 1528 - # @abstract: if true, include abstract types in the results 1529 1529 - # 1530 1530 - # Returns: a list of @ObjectTypeInfo or an empty list if no results are found 1531 1531 - # 1532 1532 - # Since: 1.1 1533 1533 - ## 1534 1534 - { 'command': 'qom-list-types', 1535 1535 - 'data': { '*implements': 'str', '*abstract': 'bool' }, 1536 1536 - 'returns': [ 'ObjectTypeInfo' ] } 1537 1537 - 1538 1538 - ## 1539 1539 - # @DevicePropertyInfo: 1540 1540 - # 1541 1541 - # Information about device properties. 1542 1542 - # 1543 1543 - # @name: the name of the property 1544 1544 - # @type: the typename of the property 1545 1545 - # @description: if specified, the description of the property. 1546 1546 - # (since 2.2) 1547 1547 - # 1548 1548 - # Since: 1.2 1549 1549 - ## 1550 1550 - { 'struct': 'DevicePropertyInfo', 1551 1551 - 'data': { 'name': 'str', 'type': 'str', '*description': 'str' } } 1552 1552 - 1553 1553 - ## 1554 1554 - # @device-list-properties: 1555 1555 - # 1556 1556 - # List properties associated with a device. 1557 1557 - # 1558 1558 - # @typename: the type name of a device 1559 1559 - # 1560 1560 - # Returns: a list of DevicePropertyInfo describing a devices properties 1561 1561 - # 1562 1562 - # Since: 1.2 1563 1563 - ## 1564 1564 - { 'command': 'device-list-properties', 1565 1565 - 'data': { 'typename': 'str'}, 1566 1566 - 'returns': [ 'DevicePropertyInfo' ] } 1567 1567 - 1568 1568 - ## 1569 1569 - # @xen-set-global-dirty-log: 1570 1570 - # 1571 1571 - # Enable or disable the global dirty log mode. 1572 1572 - # 1573 1573 - # @enable: true to enable, false to disable. 1574 1574 - # 1575 1575 - # Returns: nothing 1576 1576 - # 1577 1577 - # Since: 1.3 1578 1578 - # 1579 1579 - # Example: 1580 1580 - # 1581 1581 - # -> { "execute": "xen-set-global-dirty-log", 1582 1582 - # "arguments": { "enable": true } } 1583 1583 - # <- { "return": {} } 1584 1584 - # 1585 1585 - ## 1586 1586 - { 'command': 'xen-set-global-dirty-log', 'data': { 'enable': 'bool' } } 1587 1587 - 1588 1588 - ## 1589 1589 - # @device_add: 1590 1590 - # 1591 1591 - # @driver: the name of the new device's driver 1592 1592 - # 1593 1593 - # @bus: the device's parent bus (device tree path) 1594 1594 - # 1595 1595 - # @id: the device's ID, must be unique 1596 1596 - # 1597 1597 - # Additional arguments depend on the type. 1598 1598 - # 1599 1599 - # Add a device. 1600 1600 - # 1601 1601 - # Notes: 1602 1602 - # 1. For detailed information about this command, please refer to the 1603 1603 - # 'docs/qdev-device-use.txt' file. 1604 1604 - # 1605 1605 - # 2. It's possible to list device properties by running QEMU with the 1606 1606 - # "-device DEVICE,help" command-line argument, where DEVICE is the 1607 1607 - # device's name 1608 1608 - # 1609 1609 - # Example: 1610 1610 - # 1611 1611 - # -> { "execute": "device_add", 1612 1612 - # "arguments": { "driver": "e1000", "id": "net1", 1613 1613 - # "bus": "pci.0", 1614 1614 - # "mac": "52:54:00:12:34:56" } } 1615 1615 - # <- { "return": {} } 1616 1616 - # 1617 1617 - # TODO: This command effectively bypasses QAPI completely due to its 1618 1618 - # "additional arguments" business. It shouldn't have been added to 1619 1619 - # the schema in this form. It should be qapified properly, or 1620 1620 - # replaced by a properly qapified command. 1621 1621 - # 1622 1622 - # Since: 0.13 1623 1623 - ## 1624 1624 - { 'command': 'device_add', 1625 1625 - 'data': {'driver': 'str', '*bus': 'str', '*id': 'str'}, 1626 1626 - 'gen': false } # so we can get the additional arguments 1627 1627 - 1628 1628 - ## 1629 1629 - # @device_del: 1630 1630 - # 1631 1631 - # Remove a device from a guest 1632 1632 - # 1633 1633 - # @id: the device's ID or QOM path 1634 1634 - # 1635 1635 - # Returns: Nothing on success 1636 1636 - # If @id is not a valid device, DeviceNotFound 1637 1637 - # 1638 1638 - # Notes: When this command completes, the device may not be removed from the 1639 1639 - # guest. Hot removal is an operation that requires guest cooperation. 1640 1640 - # This command merely requests that the guest begin the hot removal 1641 1641 - # process. Completion of the device removal process is signaled with a 1642 1642 - # DEVICE_DELETED event. Guest reset will automatically complete removal 1643 1643 - # for all devices. 1644 1644 - # 1645 1645 - # Since: 0.14.0 1646 1646 - # 1647 1647 - # Example: 1648 1648 - # 1649 1649 - # -> { "execute": "device_del", 1650 1650 - # "arguments": { "id": "net1" } } 1651 1651 - # <- { "return": {} } 1652 1652 - # 1653 1653 - # -> { "execute": "device_del", 1654 1654 - # "arguments": { "id": "/machine/peripheral-anon/device[0]" } } 1655 1655 - # <- { "return": {} } 1656 1656 - # 1657 1657 - ## 1658 1658 - { 'command': 'device_del', 'data': {'id': 'str'} } 1659 1659 - 1660 1660 - ## 1661 1661 - # @DEVICE_DELETED: 1662 1662 - # 1663 1663 - # Emitted whenever the device removal completion is acknowledged by the guest. 1664 1664 - # At this point, it's safe to reuse the specified device ID. Device removal can 1665 1665 - # be initiated by the guest or by HMP/QMP commands. 1666 1666 - # 1667 1667 - # @device: device name 1668 1668 - # 1669 1669 - # @path: device path 1670 1670 - # 1671 1671 - # Since: 1.5 1672 1672 - # 1673 1673 - # Example: 1674 1674 - # 1675 1675 - # <- { "event": "DEVICE_DELETED", 1676 1676 - # "data": { "device": "virtio-net-pci-0", 1677 1677 - # "path": "/machine/peripheral/virtio-net-pci-0" }, 1678 1678 - # "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } 1679 1679 - # 1680 1680 - ## 1681 1681 - { 'event': 'DEVICE_DELETED', 1682 1682 - 'data': { '*device': 'str', 'path': 'str' } } 1683 1683 - 1684 1684 - ## 1685 1685 - # @DumpGuestMemoryFormat: 1686 1686 - # 1687 1687 - # An enumeration of guest-memory-dump's format. 1688 1688 - # 1689 1689 - # @elf: elf format 1690 1690 - # 1691 1691 - # @kdump-zlib: kdump-compressed format with zlib-compressed 1692 1692 - # 1693 1693 - # @kdump-lzo: kdump-compressed format with lzo-compressed 1694 1694 - # 1695 1695 - # @kdump-snappy: kdump-compressed format with snappy-compressed 1696 1696 - # 1697 1697 - # Since: 2.0 1698 1698 - ## 1699 1699 - { 'enum': 'DumpGuestMemoryFormat', 1700 1700 - 'data': [ 'elf', 'kdump-zlib', 'kdump-lzo', 'kdump-snappy' ] } 1701 1701 - 1702 1702 - ## 1703 1703 - # @dump-guest-memory: 1704 1704 - # 1705 1705 - # Dump guest's memory to vmcore. It is a synchronous operation that can take 1706 1706 - # very long depending on the amount of guest memory. 1707 1707 - # 1708 1708 - # @paging: if true, do paging to get guest's memory mapping. This allows 1709 1709 - # using gdb to process the core file. 1710 1710 - # 1711 1711 - # IMPORTANT: this option can make QEMU allocate several gigabytes 1712 1712 - # of RAM. This can happen for a large guest, or a 1713 1713 - # malicious guest pretending to be large. 1714 1714 - # 1715 1715 - # Also, paging=true has the following limitations: 1716 1716 - # 1717 1717 - # 1. The guest may be in a catastrophic state or can have corrupted 1718 1718 - # memory, which cannot be trusted 1719 1719 - # 2. The guest can be in real-mode even if paging is enabled. For 1720 1720 - # example, the guest uses ACPI to sleep, and ACPI sleep state 1721 1721 - # goes in real-mode 1722 1722 - # 3. Currently only supported on i386 and x86_64. 1723 1723 - # 1724 1724 - # @protocol: the filename or file descriptor of the vmcore. The supported 1725 1725 - # protocols are: 1726 1726 - # 1727 1727 - # 1. file: the protocol starts with "file:", and the following 1728 1728 - # string is the file's path. 1729 1729 - # 2. fd: the protocol starts with "fd:", and the following string 1730 1730 - # is the fd's name. 1731 1731 - # 1732 1732 - # @detach: if true, QMP will return immediately rather than 1733 1733 - # waiting for the dump to finish. The user can track progress 1734 1734 - # using "query-dump". (since 2.6). 1735 1735 - # 1736 1736 - # @begin: if specified, the starting physical address. 1737 1737 - # 1738 1738 - # @length: if specified, the memory size, in bytes. If you don't 1739 1739 - # want to dump all guest's memory, please specify the start @begin 1740 1740 - # and @length 1741 1741 - # 1742 1742 - # @format: if specified, the format of guest memory dump. But non-elf 1743 1743 - # format is conflict with paging and filter, ie. @paging, @begin and 1744 1744 - # @length is not allowed to be specified with non-elf @format at the 1745 1745 - # same time (since 2.0) 1746 1746 - # 1747 1747 - # Note: All boolean arguments default to false 1748 1748 - # 1749 1749 - # Returns: nothing on success 1750 1750 - # 1751 1751 - # Since: 1.2 1752 1752 - # 1753 1753 - # Example: 1754 1754 - # 1755 1755 - # -> { "execute": "dump-guest-memory", 1756 1756 - # "arguments": { "protocol": "fd:dump" } } 1757 1757 - # <- { "return": {} } 1758 1758 - # 1759 1759 - ## 1760 1760 - { 'command': 'dump-guest-memory', 1761 1761 - 'data': { 'paging': 'bool', 'protocol': 'str', '*detach': 'bool', 1762 1762 - '*begin': 'int', '*length': 'int', 1763 1763 - '*format': 'DumpGuestMemoryFormat'} } 1764 1764 - 1765 1765 - ## 1766 1766 - # @DumpStatus: 1767 1767 - # 1768 1768 - # Describe the status of a long-running background guest memory dump. 1769 1769 - # 1770 1770 - # @none: no dump-guest-memory has started yet. 1771 1771 - # 1772 1772 - # @active: there is one dump running in background. 1773 1773 - # 1774 1774 - # @completed: the last dump has finished successfully. 1775 1775 - # 1776 1776 - # @failed: the last dump has failed. 1777 1777 - # 1778 1778 - # Since: 2.6 1779 1779 - ## 1780 1780 - { 'enum': 'DumpStatus', 1781 1781 - 'data': [ 'none', 'active', 'completed', 'failed' ] } 1782 1782 - 1783 1783 - ## 1784 1784 - # @DumpQueryResult: 1785 1785 - # 1786 1786 - # The result format for 'query-dump'. 1787 1787 - # 1788 1788 - # @status: enum of @DumpStatus, which shows current dump status 1789 1789 - # 1790 1790 - # @completed: bytes written in latest dump (uncompressed) 1791 1791 - # 1792 1792 - # @total: total bytes to be written in latest dump (uncompressed) 1793 1793 - # 1794 1794 - # Since: 2.6 1795 1795 - ## 1796 1796 - { 'struct': 'DumpQueryResult', 1797 1797 - 'data': { 'status': 'DumpStatus', 1798 1798 - 'completed': 'int', 1799 1799 - 'total': 'int' } } 1800 1800 - 1801 1801 - ## 1802 1802 - # @query-dump: 1803 1803 - # 1804 1804 - # Query latest dump status. 1805 1805 - # 1806 1806 - # Returns: A @DumpStatus object showing the dump status. 1807 1807 - # 1808 1808 - # Since: 2.6 1809 1809 - # 1810 1810 - # Example: 1811 1811 - # 1812 1812 - # -> { "execute": "query-dump" } 1813 1813 - # <- { "return": { "status": "active", "completed": 1024000, 1814 1814 - # "total": 2048000 } } 1815 1815 - # 1816 1816 - ## 1817 1817 - { 'command': 'query-dump', 'returns': 'DumpQueryResult' } 1818 1818 - 1819 1819 - ## 1820 1820 - # @DUMP_COMPLETED: 1821 1821 - # 1822 1822 - # Emitted when background dump has completed 1823 1823 - # 1824 1824 - # @result: DumpQueryResult type described in qapi-schema.json. 1825 1825 - # 1826 1826 - # @error: human-readable error string that provides 1827 1827 - # hint on why dump failed. Only presents on failure. The 1828 1828 - # user should not try to interpret the error string. 1829 1829 - # 1830 1830 - # Since: 2.6 1831 1831 - # 1832 1832 - # Example: 1833 1833 - # 1834 1834 - # { "event": "DUMP_COMPLETED", 1835 1835 - # "data": {"result": {"total": 1090650112, "status": "completed", 1836 1836 - # "completed": 1090650112} } } 1837 1837 - # 1838 1838 - ## 1839 1839 - { 'event': 'DUMP_COMPLETED' , 1840 1840 - 'data': { 'result': 'DumpQueryResult', '*error': 'str' } } 1841 1841 - 1842 1842 - ## 1843 1843 - # @DumpGuestMemoryCapability: 1844 1844 - # 1845 1845 - # A list of the available formats for dump-guest-memory 1846 1846 - # 1847 1847 - # Since: 2.0 1848 1848 - ## 1849 1849 - { 'struct': 'DumpGuestMemoryCapability', 1850 1850 - 'data': { 1851 1851 - 'formats': ['DumpGuestMemoryFormat'] } } 1852 1852 - 1853 1853 - ## 1854 1854 - # @query-dump-guest-memory-capability: 1855 1855 - # 1856 1856 - # Returns the available formats for dump-guest-memory 1857 1857 - # 1858 1858 - # Returns: A @DumpGuestMemoryCapability object listing available formats for 1859 1859 - # dump-guest-memory 1860 1860 - # 1861 1861 - # Since: 2.0 1862 1862 - # 1863 1863 - # Example: 1864 1864 - # 1865 1865 - # -> { "execute": "query-dump-guest-memory-capability" } 1866 1866 - # <- { "return": { "formats": 1867 1867 - # ["elf", "kdump-zlib", "kdump-lzo", "kdump-snappy"] } 1868 1868 - # 1869 1869 - ## 1870 1870 - { 'command': 'query-dump-guest-memory-capability', 1871 1871 - 'returns': 'DumpGuestMemoryCapability' } 1872 1872 - 1873 1873 - ## 1874 1874 - # @dump-skeys: 1875 1875 - # 1876 1876 - # Dump guest's storage keys 1877 1877 - # 1878 1878 - # @filename: the path to the file to dump to 1879 1879 - # 1880 1880 - # This command is only supported on s390 architecture. 1881 1881 - # 1882 1882 - # Since: 2.5 1883 1883 - # 1884 1884 - # Example: 1885 1885 - # 1886 1886 - # -> { "execute": "dump-skeys", 1887 1887 - # "arguments": { "filename": "/tmp/skeys" } } 1888 1888 - # <- { "return": {} } 1889 1889 - # 1890 1890 - ## 1891 1891 - { 'command': 'dump-skeys', 1892 1892 - 'data': { 'filename': 'str' } } 1893 1893 - 1894 1894 - ## 1895 1895 - # @object-add: 1896 1896 - # 1897 1897 - # Create a QOM object. 1898 1898 - # 1899 1899 - # @qom-type: the class name for the object to be created 1900 1900 - # 1901 1901 - # @id: the name of the new object 1902 1902 - # 1903 1903 - # @props: a dictionary of properties to be passed to the backend 1904 1904 - # 1905 1905 - # Returns: Nothing on success 1906 1906 - # Error if @qom-type is not a valid class name 1907 1907 - # 1908 1908 - # Since: 2.0 1909 1909 - # 1910 1910 - # Example: 1911 1911 - # 1912 1912 - # -> { "execute": "object-add", 1913 1913 - # "arguments": { "qom-type": "rng-random", "id": "rng1", 1914 1914 - # "props": { "filename": "/dev/hwrng" } } } 1915 1915 - # <- { "return": {} } 1916 1916 - # 1917 1917 - ## 1918 1918 - { 'command': 'object-add', 1919 1919 - 'data': {'qom-type': 'str', 'id': 'str', '*props': 'any'} } 1920 1920 - 1921 1921 - ## 1922 1922 - # @object-del: 1923 1923 - # 1924 1924 - # Remove a QOM object. 1925 1925 - # 1926 1926 - # @id: the name of the QOM object to remove 1927 1927 - # 1928 1928 - # Returns: Nothing on success 1929 1929 - # Error if @id is not a valid id for a QOM object 1930 1930 - # 1931 1931 - # Since: 2.0 1932 1932 - # 1933 1933 - # Example: 1934 1934 - # 1935 1935 - # -> { "execute": "object-del", "arguments": { "id": "rng1" } } 1936 1936 - # <- { "return": {} } 1937 1937 - # 1938 1938 - ## 1939 1939 - { 'command': 'object-del', 'data': {'id': 'str'} } 1940 1940 - 1941 1941 - ## 1942 1942 - # @getfd: 1943 1943 - # 1944 1944 - # Receive a file descriptor via SCM rights and assign it a name 1945 1945 - # 1946 1946 - # @fdname: file descriptor name 1947 1947 - # 1948 1948 - # Returns: Nothing on success 1949 1949 - # 1950 1950 - # Since: 0.14.0 1951 1951 - # 1952 1952 - # Notes: If @fdname already exists, the file descriptor assigned to 1953 1953 - # it will be closed and replaced by the received file 1954 1954 - # descriptor. 1955 1955 - # 1956 1956 - # The 'closefd' command can be used to explicitly close the 1957 1957 - # file descriptor when it is no longer needed. 1958 1958 - # 1959 1959 - # Example: 1960 1960 - # 1961 1961 - # -> { "execute": "getfd", "arguments": { "fdname": "fd1" } } 1962 1962 - # <- { "return": {} } 1963 1963 - # 1964 1964 - ## 1965 1965 - { 'command': 'getfd', 'data': {'fdname': 'str'} } 1966 1966 - 1967 1967 - ## 1968 1968 - # @closefd: 1969 1969 - # 1970 1970 - # Close a file descriptor previously passed via SCM rights 1971 1971 - # 1972 1972 - # @fdname: file descriptor name 1973 1973 - # 1974 1974 - # Returns: Nothing on success 1975 1975 - # 1976 1976 - # Since: 0.14.0 1977 1977 - # 1978 1978 - # Example: 1979 1979 - # 1980 1980 - # -> { "execute": "closefd", "arguments": { "fdname": "fd1" } } 1981 1981 - # <- { "return": {} } 1982 1982 - # 1983 1983 - ## 1984 1984 - { 'command': 'closefd', 'data': {'fdname': 'str'} } 1985 1985 - 1986 1986 - ## 1987 1987 - # @MachineInfo: 1988 1988 - # 1989 1989 - # Information describing a machine. 1990 1990 - # 1991 1991 - # @name: the name of the machine 1992 1992 - # 1993 1993 - # @alias: an alias for the machine name 1994 1994 - # 1995 1995 - # @is-default: whether the machine is default 1996 1996 - # 1997 1997 - # @cpu-max: maximum number of CPUs supported by the machine type 1998 1998 - # (since 1.5.0) 1999 1999 - # 2000 2000 - # @hotpluggable-cpus: cpu hotplug via -device is supported (since 2.7.0) 2001 2001 - # 2002 2002 - # Since: 1.2.0 2003 2003 - ## 2004 2004 - { 'struct': 'MachineInfo', 2005 2005 - 'data': { 'name': 'str', '*alias': 'str', 2006 2006 - '*is-default': 'bool', 'cpu-max': 'int', 2007 2007 - 'hotpluggable-cpus': 'bool'} } 2008 2008 - 2009 2009 - ## 2010 2010 - # @query-machines: 2011 2011 - # 2012 2012 - # Return a list of supported machines 2013 2013 - # 2014 2014 - # Returns: a list of MachineInfo 2015 2015 - # 2016 2016 - # Since: 1.2.0 2017 2017 - ## 2018 2018 - { 'command': 'query-machines', 'returns': ['MachineInfo'] } 2019 2019 - 2020 2020 - ## 2021 2021 - # @CpuDefinitionInfo: 2022 2022 - # 2023 2023 - # Virtual CPU definition. 2024 2024 - # 2025 2025 - # @name: the name of the CPU definition 2026 2026 - # 2027 2027 - # @migration-safe: whether a CPU definition can be safely used for 2028 2028 - # migration in combination with a QEMU compatibility machine 2029 2029 - # when migrating between different QMU versions and between 2030 2030 - # hosts with different sets of (hardware or software) 2031 2031 - # capabilities. If not provided, information is not available 2032 2032 - # and callers should not assume the CPU definition to be 2033 2033 - # migration-safe. (since 2.8) 2034 2034 - # 2035 2035 - # @static: whether a CPU definition is static and will not change depending on 2036 2036 - # QEMU version, machine type, machine options and accelerator options. 2037 2037 - # A static model is always migration-safe. (since 2.8) 2038 2038 - # 2039 2039 - # @unavailable-features: List of properties that prevent 2040 2040 - # the CPU model from running in the current 2041 2041 - # host. (since 2.8) 2042 2042 - # @typename: Type name that can be used as argument to @device-list-properties, 2043 2043 - # to introspect properties configurable using -cpu or -global. 2044 2044 - # (since 2.9) 2045 2045 - # 2046 2046 - # @unavailable-features is a list of QOM property names that 2047 2047 - # represent CPU model attributes that prevent the CPU from running. 2048 2048 - # If the QOM property is read-only, that means there's no known 2049 2049 - # way to make the CPU model run in the current host. Implementations 2050 2050 - # that choose not to provide specific information return the 2051 2051 - # property name "type". 2052 2052 - # If the property is read-write, it means that it MAY be possible 2053 2053 - # to run the CPU model in the current host if that property is 2054 2054 - # changed. Management software can use it as hints to suggest or 2055 2055 - # choose an alternative for the user, or just to generate meaningful 2056 2056 - # error messages explaining why the CPU model can't be used. 2057 2057 - # If @unavailable-features is an empty list, the CPU model is 2058 2058 - # runnable using the current host and machine-type. 2059 2059 - # If @unavailable-features is not present, runnability 2060 2060 - # information for the CPU is not available. 2061 2061 - # 2062 2062 - # Since: 1.2.0 2063 2063 - ## 2064 2064 - { 'struct': 'CpuDefinitionInfo', 2065 2065 - 'data': { 'name': 'str', '*migration-safe': 'bool', 'static': 'bool', 2066 2066 - '*unavailable-features': [ 'str' ], 'typename': 'str' } } 2067 2067 - 2068 2068 - ## 2069 2069 - # @MemoryInfo: 2070 2070 - # 2071 2071 - # Actual memory information in bytes. 2072 2072 - # 2073 2073 - # @base-memory: size of "base" memory specified with command line 2074 2074 - # option -m. 2075 2075 - # 2076 2076 - # @plugged-memory: size of memory that can be hot-unplugged. This field 2077 2077 - # is omitted if target doesn't support memory hotplug 2078 2078 - # (i.e. CONFIG_MEM_HOTPLUG not defined on build time). 2079 2079 - # 2080 2080 - # Since: 2.11.0 2081 2081 - ## 2082 2082 - { 'struct': 'MemoryInfo', 2083 2083 - 'data' : { 'base-memory': 'size', '*plugged-memory': 'size' } } 2084 2084 - 2085 2085 - ## 2086 2086 - # @query-memory-size-summary: 2087 2087 - # 2088 2088 - # Return the amount of initially allocated and present hotpluggable (if 2089 2089 - # enabled) memory in bytes. 2090 2090 - # 2091 2091 - # Example: 2092 2092 - # 2093 2093 - # -> { "execute": "query-memory-size-summary" } 2094 2094 - # <- { "return": { "base-memory": 4294967296, "plugged-memory": 0 } } 2095 2095 - # 2096 2096 - # Since: 2.11.0 2097 2097 - ## 2098 2098 - { 'command': 'query-memory-size-summary', 'returns': 'MemoryInfo' } 2099 2099 - 2100 2100 - ## 2101 2101 - # @query-cpu-definitions: 2102 2102 - # 2103 2103 - # Return a list of supported virtual CPU definitions 2104 2104 - # 2105 2105 - # Returns: a list of CpuDefInfo 2106 2106 - # 2107 2107 - # Since: 1.2.0 2108 2108 - ## 2109 2109 - { 'command': 'query-cpu-definitions', 'returns': ['CpuDefinitionInfo'] } 2110 2110 - 2111 2111 - ## 2112 2112 - # @CpuModelInfo: 2113 2113 - # 2114 2114 - # Virtual CPU model. 2115 2115 - # 2116 2116 - # A CPU model consists of the name of a CPU definition, to which 2117 2117 - # delta changes are applied (e.g. features added/removed). Most magic values 2118 2118 - # that an architecture might require should be hidden behind the name. 2119 2119 - # However, if required, architectures can expose relevant properties. 2120 2120 - # 2121 2121 - # @name: the name of the CPU definition the model is based on 2122 2122 - # @props: a dictionary of QOM properties to be applied 2123 2123 - # 2124 2124 - # Since: 2.8.0 2125 2125 - ## 2126 2126 - { 'struct': 'CpuModelInfo', 2127 2127 - 'data': { 'name': 'str', 2128 2128 - '*props': 'any' } } 2129 2129 - 2130 2130 - ## 2131 2131 - # @CpuModelExpansionType: 2132 2132 - # 2133 2133 - # An enumeration of CPU model expansion types. 2134 2134 - # 2135 2135 - # @static: Expand to a static CPU model, a combination of a static base 2136 2136 - # model name and property delta changes. As the static base model will 2137 2137 - # never change, the expanded CPU model will be the same, independent of 2138 2138 - # independent of QEMU version, machine type, machine options, and 2139 2139 - # accelerator options. Therefore, the resulting model can be used by 2140 2140 - # tooling without having to specify a compatibility machine - e.g. when 2141 2141 - # displaying the "host" model. static CPU models are migration-safe. 2142 2142 - # 2143 2143 - # @full: Expand all properties. The produced model is not guaranteed to be 2144 2144 - # migration-safe, but allows tooling to get an insight and work with 2145 2145 - # model details. 2146 2146 - # 2147 2147 - # Note: When a non-migration-safe CPU model is expanded in static mode, some 2148 2148 - # features enabled by the CPU model may be omitted, because they can't be 2149 2149 - # implemented by a static CPU model definition (e.g. cache info passthrough and 2150 2150 - # PMU passthrough in x86). If you need an accurate representation of the 2151 2151 - # features enabled by a non-migration-safe CPU model, use @full. If you need a 2152 2152 - # static representation that will keep ABI compatibility even when changing QEMU 2153 2153 - # version or machine-type, use @static (but keep in mind that some features may 2154 2154 - # be omitted). 2155 2155 - # 2156 2156 - # Since: 2.8.0 2157 2157 - ## 2158 2158 - { 'enum': 'CpuModelExpansionType', 2159 2159 - 'data': [ 'static', 'full' ] } 2160 2160 - 2161 2161 - 2162 2162 - ## 2163 2163 - # @CpuModelExpansionInfo: 2164 2164 - # 2165 2165 - # The result of a cpu model expansion. 2166 2166 - # 2167 2167 - # @model: the expanded CpuModelInfo. 2168 2168 - # 2169 2169 - # Since: 2.8.0 2170 2170 - ## 2171 2171 - { 'struct': 'CpuModelExpansionInfo', 2172 2172 - 'data': { 'model': 'CpuModelInfo' } } 2173 2173 - 2174 2174 - 2175 2175 - ## 2176 2176 - # @query-cpu-model-expansion: 2177 2177 - # 2178 2178 - # Expands a given CPU model (or a combination of CPU model + additional options) 2179 2179 - # to different granularities, allowing tooling to get an understanding what a 2180 2180 - # specific CPU model looks like in QEMU under a certain configuration. 2181 2181 - # 2182 2182 - # This interface can be used to query the "host" CPU model. 2183 2183 - # 2184 2184 - # The data returned by this command may be affected by: 2185 2185 - # 2186 2186 - # * QEMU version: CPU models may look different depending on the QEMU version. 2187 2187 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2188 2188 - # * machine-type: CPU model may look different depending on the machine-type. 2189 2189 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2190 2190 - # * machine options (including accelerator): in some architectures, CPU models 2191 2191 - # may look different depending on machine and accelerator options. (Except for 2192 2192 - # CPU models reported as "static" in query-cpu-definitions.) 2193 2193 - # * "-cpu" arguments and global properties: arguments to the -cpu option and 2194 2194 - # global properties may affect expansion of CPU models. Using 2195 2195 - # query-cpu-model-expansion while using these is not advised. 2196 2196 - # 2197 2197 - # Some architectures may not support all expansion types. s390x supports 2198 2198 - # "full" and "static". 2199 2199 - # 2200 2200 - # Returns: a CpuModelExpansionInfo. Returns an error if expanding CPU models is 2201 2201 - # not supported, if the model cannot be expanded, if the model contains 2202 2202 - # an unknown CPU definition name, unknown properties or properties 2203 2203 - # with a wrong type. Also returns an error if an expansion type is 2204 2204 - # not supported. 2205 2205 - # 2206 2206 - # Since: 2.8.0 2207 2207 - ## 2208 2208 - { 'command': 'query-cpu-model-expansion', 2209 2209 - 'data': { 'type': 'CpuModelExpansionType', 2210 2210 - 'model': 'CpuModelInfo' }, 2211 2211 - 'returns': 'CpuModelExpansionInfo' } 2212 2212 - 2213 2213 - ## 2214 2214 - # @CpuModelCompareResult: 2215 2215 - # 2216 2216 - # An enumeration of CPU model comparison results. The result is usually 2217 2217 - # calculated using e.g. CPU features or CPU generations. 2218 2218 - # 2219 2219 - # @incompatible: If model A is incompatible to model B, model A is not 2220 2220 - # guaranteed to run where model B runs and the other way around. 2221 2221 - # 2222 2222 - # @identical: If model A is identical to model B, model A is guaranteed to run 2223 2223 - # where model B runs and the other way around. 2224 2224 - # 2225 2225 - # @superset: If model A is a superset of model B, model B is guaranteed to run 2226 2226 - # where model A runs. There are no guarantees about the other way. 2227 2227 - # 2228 2228 - # @subset: If model A is a subset of model B, model A is guaranteed to run 2229 2229 - # where model B runs. There are no guarantees about the other way. 2230 2230 - # 2231 2231 - # Since: 2.8.0 2232 2232 - ## 2233 2233 - { 'enum': 'CpuModelCompareResult', 2234 2234 - 'data': [ 'incompatible', 'identical', 'superset', 'subset' ] } 2235 2235 - 2236 2236 - ## 2237 2237 - # @CpuModelCompareInfo: 2238 2238 - # 2239 2239 - # The result of a CPU model comparison. 2240 2240 - # 2241 2241 - # @result: The result of the compare operation. 2242 2242 - # @responsible-properties: List of properties that led to the comparison result 2243 2243 - # not being identical. 2244 2244 - # 2245 2245 - # @responsible-properties is a list of QOM property names that led to 2246 2246 - # both CPUs not being detected as identical. For identical models, this 2247 2247 - # list is empty. 2248 2248 - # If a QOM property is read-only, that means there's no known way to make the 2249 2249 - # CPU models identical. If the special property name "type" is included, the 2250 2250 - # models are by definition not identical and cannot be made identical. 2251 2251 - # 2252 2252 - # Since: 2.8.0 2253 2253 - ## 2254 2254 - { 'struct': 'CpuModelCompareInfo', 2255 2255 - 'data': {'result': 'CpuModelCompareResult', 2256 2256 - 'responsible-properties': ['str'] 2257 2257 - } 2258 2258 - } 2259 2259 - 2260 2260 - ## 2261 2261 - # @query-cpu-model-comparison: 2262 2262 - # 2263 2263 - # Compares two CPU models, returning how they compare in a specific 2264 2264 - # configuration. The results indicates how both models compare regarding 2265 2265 - # runnability. This result can be used by tooling to make decisions if a 2266 2266 - # certain CPU model will run in a certain configuration or if a compatible 2267 2267 - # CPU model has to be created by baselining. 2268 2268 - # 2269 2269 - # Usually, a CPU model is compared against the maximum possible CPU model 2270 2270 - # of a certain configuration (e.g. the "host" model for KVM). If that CPU 2271 2271 - # model is identical or a subset, it will run in that configuration. 2272 2272 - # 2273 2273 - # The result returned by this command may be affected by: 2274 2274 - # 2275 2275 - # * QEMU version: CPU models may look different depending on the QEMU version. 2276 2276 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2277 2277 - # * machine-type: CPU model may look different depending on the machine-type. 2278 2278 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2279 2279 - # * machine options (including accelerator): in some architectures, CPU models 2280 2280 - # may look different depending on machine and accelerator options. (Except for 2281 2281 - # CPU models reported as "static" in query-cpu-definitions.) 2282 2282 - # * "-cpu" arguments and global properties: arguments to the -cpu option and 2283 2283 - # global properties may affect expansion of CPU models. Using 2284 2284 - # query-cpu-model-expansion while using these is not advised. 2285 2285 - # 2286 2286 - # Some architectures may not support comparing CPU models. s390x supports 2287 2287 - # comparing CPU models. 2288 2288 - # 2289 2289 - # Returns: a CpuModelBaselineInfo. Returns an error if comparing CPU models is 2290 2290 - # not supported, if a model cannot be used, if a model contains 2291 2291 - # an unknown cpu definition name, unknown properties or properties 2292 2292 - # with wrong types. 2293 2293 - # 2294 2294 - # Since: 2.8.0 2295 2295 - ## 2296 2296 - { 'command': 'query-cpu-model-comparison', 2297 2297 - 'data': { 'modela': 'CpuModelInfo', 'modelb': 'CpuModelInfo' }, 2298 2298 - 'returns': 'CpuModelCompareInfo' } 2299 2299 - 2300 2300 - ## 2301 2301 - # @CpuModelBaselineInfo: 2302 2302 - # 2303 2303 - # The result of a CPU model baseline. 2304 2304 - # 2305 2305 - # @model: the baselined CpuModelInfo. 2306 2306 - # 2307 2307 - # Since: 2.8.0 2308 2308 - ## 2309 2309 - { 'struct': 'CpuModelBaselineInfo', 2310 2310 - 'data': { 'model': 'CpuModelInfo' } } 2311 2311 - 2312 2312 - ## 2313 2313 - # @query-cpu-model-baseline: 2314 2314 - # 2315 2315 - # Baseline two CPU models, creating a compatible third model. The created 2316 2316 - # model will always be a static, migration-safe CPU model (see "static" 2317 2317 - # CPU model expansion for details). 2318 2318 - # 2319 2319 - # This interface can be used by tooling to create a compatible CPU model out 2320 2320 - # two CPU models. The created CPU model will be identical to or a subset of 2321 2321 - # both CPU models when comparing them. Therefore, the created CPU model is 2322 2322 - # guaranteed to run where the given CPU models run. 2323 2323 - # 2324 2324 - # The result returned by this command may be affected by: 2325 2325 - # 2326 2326 - # * QEMU version: CPU models may look different depending on the QEMU version. 2327 2327 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2328 2328 - # * machine-type: CPU model may look different depending on the machine-type. 2329 2329 - # (Except for CPU models reported as "static" in query-cpu-definitions.) 2330 2330 - # * machine options (including accelerator): in some architectures, CPU models 2331 2331 - # may look different depending on machine and accelerator options. (Except for 2332 2332 - # CPU models reported as "static" in query-cpu-definitions.) 2333 2333 - # * "-cpu" arguments and global properties: arguments to the -cpu option and 2334 2334 - # global properties may affect expansion of CPU models. Using 2335 2335 - # query-cpu-model-expansion while using these is not advised. 2336 2336 - # 2337 2337 - # Some architectures may not support baselining CPU models. s390x supports 2338 2338 - # baselining CPU models. 2339 2339 - # 2340 2340 - # Returns: a CpuModelBaselineInfo. Returns an error if baselining CPU models is 2341 2341 - # not supported, if a model cannot be used, if a model contains 2342 2342 - # an unknown cpu definition name, unknown properties or properties 2343 2343 - # with wrong types. 2344 2344 - # 2345 2345 - # Since: 2.8.0 2346 2346 - ## 2347 2347 - { 'command': 'query-cpu-model-baseline', 2348 2348 - 'data': { 'modela': 'CpuModelInfo', 2349 2349 - 'modelb': 'CpuModelInfo' }, 2350 2350 - 'returns': 'CpuModelBaselineInfo' } 2351 2351 - 2352 2352 - ## 2353 2353 - # @AddfdInfo: 2354 2354 - # 2355 2355 - # Information about a file descriptor that was added to an fd set. 2356 2356 - # 2357 2357 - # @fdset-id: The ID of the fd set that @fd was added to. 2358 2358 - # 2359 2359 - # @fd: The file descriptor that was received via SCM rights and 2360 2360 - # added to the fd set. 2361 2361 - # 2362 2362 - # Since: 1.2.0 2363 2363 - ## 2364 2364 - { 'struct': 'AddfdInfo', 'data': {'fdset-id': 'int', 'fd': 'int'} } 2365 2365 - 2366 2366 - ## 2367 2367 - # @add-fd: 2368 2368 - # 2369 2369 - # Add a file descriptor, that was passed via SCM rights, to an fd set. 2370 2370 - # 2371 2371 - # @fdset-id: The ID of the fd set to add the file descriptor to. 2372 2372 - # 2373 2373 - # @opaque: A free-form string that can be used to describe the fd. 2374 2374 - # 2375 2375 - # Returns: @AddfdInfo on success 2376 2376 - # 2377 2377 - # If file descriptor was not received, FdNotSupplied 2378 2378 - # 2379 2379 - # If @fdset-id is a negative value, InvalidParameterValue 2380 2380 - # 2381 2381 - # Notes: The list of fd sets is shared by all monitor connections. 2382 2382 - # 2383 2383 - # If @fdset-id is not specified, a new fd set will be created. 2384 2384 - # 2385 2385 - # Since: 1.2.0 2386 2386 - # 2387 2387 - # Example: 2388 2388 - # 2389 2389 - # -> { "execute": "add-fd", "arguments": { "fdset-id": 1 } } 2390 2390 - # <- { "return": { "fdset-id": 1, "fd": 3 } } 2391 2391 - # 2392 2392 - ## 2393 2393 - { 'command': 'add-fd', 'data': {'*fdset-id': 'int', '*opaque': 'str'}, 2394 2394 - 'returns': 'AddfdInfo' } 2395 2395 - 2396 2396 - ## 2397 2397 - # @remove-fd: 2398 2398 - # 2399 2399 - # Remove a file descriptor from an fd set. 2400 2400 - # 2401 2401 - # @fdset-id: The ID of the fd set that the file descriptor belongs to. 2402 2402 - # 2403 2403 - # @fd: The file descriptor that is to be removed. 2404 2404 - # 2405 2405 - # Returns: Nothing on success 2406 2406 - # If @fdset-id or @fd is not found, FdNotFound 2407 2407 - # 2408 2408 - # Since: 1.2.0 2409 2409 - # 2410 2410 - # Notes: The list of fd sets is shared by all monitor connections. 2411 2411 - # 2412 2412 - # If @fd is not specified, all file descriptors in @fdset-id 2413 2413 - # will be removed. 2414 2414 - # 2415 2415 - # Example: 2416 2416 - # 2417 2417 - # -> { "execute": "remove-fd", "arguments": { "fdset-id": 1, "fd": 3 } } 2418 2418 - # <- { "return": {} } 2419 2419 - # 2420 2420 - ## 2421 2421 - { 'command': 'remove-fd', 'data': {'fdset-id': 'int', '*fd': 'int'} } 2422 2422 - 2423 2423 - ## 2424 2424 - # @FdsetFdInfo: 2425 2425 - # 2426 2426 - # Information about a file descriptor that belongs to an fd set. 2427 2427 - # 2428 2428 - # @fd: The file descriptor value. 2429 2429 - # 2430 2430 - # @opaque: A free-form string that can be used to describe the fd. 2431 2431 - # 2432 2432 - # Since: 1.2.0 2433 2433 - ## 2434 2434 - { 'struct': 'FdsetFdInfo', 2435 2435 - 'data': {'fd': 'int', '*opaque': 'str'} } 2436 2436 - 2437 2437 - ## 2438 2438 - # @FdsetInfo: 2439 2439 - # 2440 2440 - # Information about an fd set. 2441 2441 - # 2442 2442 - # @fdset-id: The ID of the fd set. 2443 2443 - # 2444 2444 - # @fds: A list of file descriptors that belong to this fd set. 2445 2445 - # 2446 2446 - # Since: 1.2.0 2447 2447 - ## 2448 2448 - { 'struct': 'FdsetInfo', 2449 2449 - 'data': {'fdset-id': 'int', 'fds': ['FdsetFdInfo']} } 2450 2450 - 2451 2451 - ## 2452 2452 - # @query-fdsets: 2453 2453 - # 2454 2454 - # Return information describing all fd sets. 2455 2455 - # 2456 2456 - # Returns: A list of @FdsetInfo 2457 2457 - # 2458 2458 - # Since: 1.2.0 2459 2459 - # 2460 2460 - # Note: The list of fd sets is shared by all monitor connections. 2461 2461 - # 2462 2462 - # Example: 2463 2463 - # 2464 2464 - # -> { "execute": "query-fdsets" } 2465 2465 - # <- { "return": [ 2466 2466 - # { 2467 2467 - # "fds": [ 2468 2468 - # { 2469 2469 - # "fd": 30, 2470 2470 - # "opaque": "rdonly:/path/to/file" 2471 2471 - # }, 2472 2472 - # { 2473 2473 - # "fd": 24, 2474 2474 - # "opaque": "rdwr:/path/to/file" 2475 2475 - # } 2476 2476 - # ], 2477 2477 - # "fdset-id": 1 2478 2478 - # }, 2479 2479 - # { 2480 2480 - # "fds": [ 2481 2481 - # { 2482 2482 - # "fd": 28 2483 2483 - # }, 2484 2484 - # { 2485 2485 - # "fd": 29 2486 2486 - # } 2487 2487 - # ], 2488 2488 - # "fdset-id": 0 2489 2489 - # } 2490 2490 - # ] 2491 2491 - # } 2492 2492 - # 2493 2493 - ## 2494 2494 - { 'command': 'query-fdsets', 'returns': ['FdsetInfo'] } 2495 2495 - 2496 2496 - ## 2497 2497 - # @TargetInfo: 2498 2498 - # 2499 2499 - # Information describing the QEMU target. 2500 2500 - # 2501 2501 - # @arch: the target architecture (eg "x86_64", "i386", etc) 2502 2502 - # 2503 2503 - # Since: 1.2.0 2504 2504 - ## 2505 2505 - { 'struct': 'TargetInfo', 2506 2506 - 'data': { 'arch': 'str' } } 2507 2507 - 2508 2508 - ## 2509 2509 - # @query-target: 2510 2510 - # 2511 2511 - # Return information about the target for this QEMU 2512 2512 - # 2513 2513 - # Returns: TargetInfo 2514 2514 - # 2515 2515 - # Since: 1.2.0 2516 2516 - ## 2517 2517 - { 'command': 'query-target', 'returns': 'TargetInfo' } 2518 2518 - 2519 2519 - ## 2520 2520 - # @AcpiTableOptions: 2521 2521 - # 2522 2522 - # Specify an ACPI table on the command line to load. 2523 2523 - # 2524 2524 - # At most one of @file and @data can be specified. The list of files specified 2525 2525 - # by any one of them is loaded and concatenated in order. If both are omitted, 2526 2526 - # @data is implied. 2527 2527 - # 2528 2528 - # Other fields / optargs can be used to override fields of the generic ACPI 2529 2529 - # table header; refer to the ACPI specification 5.0, section 5.2.6 System 2530 2530 - # Description Table Header. If a header field is not overridden, then the 2531 2531 - # corresponding value from the concatenated blob is used (in case of @file), or 2532 2532 - # it is filled in with a hard-coded value (in case of @data). 2533 2533 - # 2534 2534 - # String fields are copied into the matching ACPI member from lowest address 2535 2535 - # upwards, and silently truncated / NUL-padded to length. 2536 2536 - # 2537 2537 - # @sig: table signature / identifier (4 bytes) 2538 2538 - # 2539 2539 - # @rev: table revision number (dependent on signature, 1 byte) 2540 2540 - # 2541 2541 - # @oem_id: OEM identifier (6 bytes) 2542 2542 - # 2543 2543 - # @oem_table_id: OEM table identifier (8 bytes) 2544 2544 - # 2545 2545 - # @oem_rev: OEM-supplied revision number (4 bytes) 2546 2546 - # 2547 2547 - # @asl_compiler_id: identifier of the utility that created the table 2548 2548 - # (4 bytes) 2549 2549 - # 2550 2550 - # @asl_compiler_rev: revision number of the utility that created the 2551 2551 - # table (4 bytes) 2552 2552 - # 2553 2553 - # @file: colon (:) separated list of pathnames to load and 2554 2554 - # concatenate as table data. The resultant binary blob is expected to 2555 2555 - # have an ACPI table header. At least one file is required. This field 2556 2556 - # excludes @data. 2557 2557 - # 2558 2558 - # @data: colon (:) separated list of pathnames to load and 2559 2559 - # concatenate as table data. The resultant binary blob must not have an 2560 2560 - # ACPI table header. At least one file is required. This field excludes 2561 2561 - # @file. 2562 2562 - # 2563 2563 - # Since: 1.5 2564 2564 - ## 2565 2565 - { 'struct': 'AcpiTableOptions', 2566 2566 - 'data': { 2567 2567 - '*sig': 'str', 2568 2568 - '*rev': 'uint8', 2569 2569 - '*oem_id': 'str', 2570 2570 - '*oem_table_id': 'str', 2571 2571 - '*oem_rev': 'uint32', 2572 2572 - '*asl_compiler_id': 'str', 2573 2573 - '*asl_compiler_rev': 'uint32', 2574 2574 - '*file': 'str', 2575 2575 - '*data': 'str' }} 2576 2576 - 2577 2577 - ## 2578 2578 - # @CommandLineParameterType: 2579 2579 - # 2580 2580 - # Possible types for an option parameter. 2581 2581 - # 2582 2582 - # @string: accepts a character string 2583 2583 - # 2584 2584 - # @boolean: accepts "on" or "off" 2585 2585 - # 2586 2586 - # @number: accepts a number 2587 2587 - # 2588 2588 - # @size: accepts a number followed by an optional suffix (K)ilo, 2589 2589 - # (M)ega, (G)iga, (T)era 2590 2590 - # 2591 2591 - # Since: 1.5 2592 2592 - ## 2593 2593 - { 'enum': 'CommandLineParameterType', 2594 2594 - 'data': ['string', 'boolean', 'number', 'size'] } 2595 2595 - 2596 2596 - ## 2597 2597 - # @CommandLineParameterInfo: 2598 2598 - # 2599 2599 - # Details about a single parameter of a command line option. 2600 2600 - # 2601 2601 - # @name: parameter name 2602 2602 - # 2603 2603 - # @type: parameter @CommandLineParameterType 2604 2604 - # 2605 2605 - # @help: human readable text string, not suitable for parsing. 2606 2606 - # 2607 2607 - # @default: default value string (since 2.1) 2608 2608 - # 2609 2609 - # Since: 1.5 2610 2610 - ## 2611 2611 - { 'struct': 'CommandLineParameterInfo', 2612 2612 - 'data': { 'name': 'str', 2613 2613 - 'type': 'CommandLineParameterType', 2614 2614 - '*help': 'str', 2615 2615 - '*default': 'str' } } 2616 2616 - 2617 2617 - ## 2618 2618 - # @CommandLineOptionInfo: 2619 2619 - # 2620 2620 - # Details about a command line option, including its list of parameter details 2621 2621 - # 2622 2622 - # @option: option name 2623 2623 - # 2624 2624 - # @parameters: an array of @CommandLineParameterInfo 2625 2625 - # 2626 2626 - # Since: 1.5 2627 2627 - ## 2628 2628 - { 'struct': 'CommandLineOptionInfo', 2629 2629 - 'data': { 'option': 'str', 'parameters': ['CommandLineParameterInfo'] } } 2630 2630 - 2631 2631 - ## 2632 2632 - # @query-command-line-options: 2633 2633 - # 2634 2634 - # Query command line option schema. 2635 2635 - # 2636 2636 - # @option: option name 2637 2637 - # 2638 2638 - # Returns: list of @CommandLineOptionInfo for all options (or for the given 2639 2639 - # @option). Returns an error if the given @option doesn't exist. 2640 2640 - # 2641 2641 - # Since: 1.5 2642 2642 - # 2643 2643 - # Example: 2644 2644 - # 2645 2645 - # -> { "execute": "query-command-line-options", 2646 2646 - # "arguments": { "option": "option-rom" } } 2647 2647 - # <- { "return": [ 2648 2648 - # { 2649 2649 - # "parameters": [ 2650 2650 - # { 2651 2651 - # "name": "romfile", 2652 2652 - # "type": "string" 2653 2653 - # }, 2654 2654 - # { 2655 2655 - # "name": "bootindex", 2656 2656 - # "type": "number" 2657 2657 - # } 2658 2658 - # ], 2659 2659 - # "option": "option-rom" 2660 2660 - # } 2661 2661 - # ] 2662 2662 - # } 2663 2663 - # 2664 2664 - ## 2665 2665 - {'command': 'query-command-line-options', 'data': { '*option': 'str' }, 2666 2666 - 'returns': ['CommandLineOptionInfo'] } 2667 2667 - 2668 2668 - ## 2669 2669 - # @X86CPURegister32: 2670 2670 - # 2671 2671 - # A X86 32-bit register 2672 2672 - # 2673 2673 - # Since: 1.5 2674 2674 - ## 2675 2675 - { 'enum': 'X86CPURegister32', 2676 2676 - 'data': [ 'EAX', 'EBX', 'ECX', 'EDX', 'ESP', 'EBP', 'ESI', 'EDI' ] } 2677 2677 - 2678 2678 - ## 2679 2679 - # @X86CPUFeatureWordInfo: 2680 2680 - # 2681 2681 - # Information about a X86 CPU feature word 2682 2682 - # 2683 2683 - # @cpuid-input-eax: Input EAX value for CPUID instruction for that feature word 2684 2684 - # 2685 2685 - # @cpuid-input-ecx: Input ECX value for CPUID instruction for that 2686 2686 - # feature word 2687 2687 - # 2688 2688 - # @cpuid-register: Output register containing the feature bits 2689 2689 - # 2690 2690 - # @features: value of output register, containing the feature bits 2691 2691 - # 2692 2692 - # Since: 1.5 2693 2693 - ## 2694 2694 - { 'struct': 'X86CPUFeatureWordInfo', 2695 2695 - 'data': { 'cpuid-input-eax': 'int', 2696 2696 - '*cpuid-input-ecx': 'int', 2697 2697 - 'cpuid-register': 'X86CPURegister32', 2698 2698 - 'features': 'int' } } 2699 2699 - 2700 2700 - ## 2701 2701 - # @DummyForceArrays: 2702 2702 - # 2703 2703 - # Not used by QMP; hack to let us use X86CPUFeatureWordInfoList internally 2704 2704 - # 2705 2705 - # Since: 2.5 2706 2706 - ## 2707 2707 - { 'struct': 'DummyForceArrays', 2708 2708 - 'data': { 'unused': ['X86CPUFeatureWordInfo'] } } 2709 2709 - 2710 2710 - 2711 2711 - ## 2712 2712 - # @NumaOptionsType: 2713 2713 - # 2714 2714 - # @node: NUMA nodes configuration 2715 2715 - # 2716 2716 - # @dist: NUMA distance configuration (since 2.10) 2717 2717 - # 2718 2718 - # @cpu: property based CPU(s) to node mapping (Since: 2.10) 2719 2719 - # 2720 2720 - # Since: 2.1 2721 2721 - ## 2722 2722 - { 'enum': 'NumaOptionsType', 2723 2723 - 'data': [ 'node', 'dist', 'cpu' ] } 2724 2724 - 2725 2725 - ## 2726 2726 - # @NumaOptions: 2727 2727 - # 2728 2728 - # A discriminated record of NUMA options. (for OptsVisitor) 2729 2729 - # 2730 2730 - # Since: 2.1 2731 2731 - ## 2732 2732 - { 'union': 'NumaOptions', 2733 2733 - 'base': { 'type': 'NumaOptionsType' }, 2734 2734 - 'discriminator': 'type', 2735 2735 - 'data': { 2736 2736 - 'node': 'NumaNodeOptions', 2737 2737 - 'dist': 'NumaDistOptions', 2738 2738 - 'cpu': 'NumaCpuOptions' }} 2739 2739 - 2740 2740 - ## 2741 2741 - # @NumaNodeOptions: 2742 2742 - # 2743 2743 - # Create a guest NUMA node. (for OptsVisitor) 2744 2744 - # 2745 2745 - # @nodeid: NUMA node ID (increase by 1 from 0 if omitted) 2746 2746 - # 2747 2747 - # @cpus: VCPUs belonging to this node (assign VCPUS round-robin 2748 2748 - # if omitted) 2749 2749 - # 2750 2750 - # @mem: memory size of this node; mutually exclusive with @memdev. 2751 2751 - # Equally divide total memory among nodes if both @mem and @memdev are 2752 2752 - # omitted. 2753 2753 - # 2754 2754 - # @memdev: memory backend object. If specified for one node, 2755 2755 - # it must be specified for all nodes. 2756 2756 - # 2757 2757 - # Since: 2.1 2758 2758 - ## 2759 2759 - { 'struct': 'NumaNodeOptions', 2760 2760 - 'data': { 2761 2761 - '*nodeid': 'uint16', 2762 2762 - '*cpus': ['uint16'], 2763 2763 - '*mem': 'size', 2764 2764 - '*memdev': 'str' }} 2765 2765 - 2766 2766 - ## 2767 2767 - # @NumaDistOptions: 2768 2768 - # 2769 2769 - # Set the distance between 2 NUMA nodes. 2770 2770 - # 2771 2771 - # @src: source NUMA node. 2772 2772 - # 2773 2773 - # @dst: destination NUMA node. 2774 2774 - # 2775 2775 - # @val: NUMA distance from source node to destination node. 2776 2776 - # When a node is unreachable from another node, set the distance 2777 2777 - # between them to 255. 2778 2778 - # 2779 2779 - # Since: 2.10 2780 2780 - ## 2781 2781 - { 'struct': 'NumaDistOptions', 2782 2782 - 'data': { 2783 2783 - 'src': 'uint16', 2784 2784 - 'dst': 'uint16', 2785 2785 - 'val': 'uint8' }} 2786 2786 - 2787 2787 - ## 2788 2788 - # @NumaCpuOptions: 2789 2789 - # 2790 2790 - # Option "-numa cpu" overrides default cpu to node mapping. 2791 2791 - # It accepts the same set of cpu properties as returned by 2792 2792 - # query-hotpluggable-cpus[].props, where node-id could be used to 2793 2793 - # override default node mapping. 2794 2794 - # 2795 2795 - # Since: 2.10 2796 2796 - ## 2797 2797 - { 'struct': 'NumaCpuOptions', 2798 2798 - 'base': 'CpuInstanceProperties', 2799 2799 - 'data' : {} } 2800 2800 - 2801 2801 - ## 2802 2802 - # @HostMemPolicy: 2803 2803 - # 2804 2804 - # Host memory policy types 2805 2805 - # 2806 2806 - # @default: restore default policy, remove any nondefault policy 2807 2807 - # 2808 2808 - # @preferred: set the preferred host nodes for allocation 2809 2809 - # 2810 2810 - # @bind: a strict policy that restricts memory allocation to the 2811 2811 - # host nodes specified 2812 2812 - # 2813 2813 - # @interleave: memory allocations are interleaved across the set 2814 2814 - # of host nodes specified 2815 2815 - # 2816 2816 - # Since: 2.1 2817 2817 - ## 2818 2818 - { 'enum': 'HostMemPolicy', 2819 2819 - 'data': [ 'default', 'preferred', 'bind', 'interleave' ] } 2820 2820 - 2821 2821 - ## 2822 2822 - # @Memdev: 2823 2823 - # 2824 2824 - # Information about memory backend 2825 2825 - # 2826 2826 - # @id: backend's ID if backend has 'id' property (since 2.9) 2827 2827 - # 2828 2828 - # @size: memory backend size 2829 2829 - # 2830 2830 - # @merge: enables or disables memory merge support 2831 2831 - # 2832 2832 - # @dump: includes memory backend's memory in a core dump or not 2833 2833 - # 2834 2834 - # @prealloc: enables or disables memory preallocation 2835 2835 - # 2836 2836 - # @host-nodes: host nodes for its memory policy 2837 2837 - # 2838 2838 - # @policy: memory policy of memory backend 2839 2839 - # 2840 2840 - # Since: 2.1 2841 2841 - ## 2842 2842 - { 'struct': 'Memdev', 2843 2843 - 'data': { 2844 2844 - '*id': 'str', 2845 2845 - 'size': 'size', 2846 2846 - 'merge': 'bool', 2847 2847 - 'dump': 'bool', 2848 2848 - 'prealloc': 'bool', 2849 2849 - 'host-nodes': ['uint16'], 2850 2850 - 'policy': 'HostMemPolicy' }} 2851 2851 - 2852 2852 - ## 2853 2853 - # @query-memdev: 2854 2854 - # 2855 2855 - # Returns information for all memory backends. 2856 2856 - # 2857 2857 - # Returns: a list of @Memdev. 2858 2858 - # 2859 2859 - # Since: 2.1 2860 2860 - # 2861 2861 - # Example: 2862 2862 - # 2863 2863 - # -> { "execute": "query-memdev" } 2864 2864 - # <- { "return": [ 2865 2865 - # { 2866 2866 - # "id": "mem1", 2867 2867 - # "size": 536870912, 2868 2868 - # "merge": false, 2869 2869 - # "dump": true, 2870 2870 - # "prealloc": false, 2871 2871 - # "host-nodes": [0, 1], 2872 2872 - # "policy": "bind" 2873 2873 - # }, 2874 2874 - # { 2875 2875 - # "size": 536870912, 2876 2876 - # "merge": false, 2877 2877 - # "dump": true, 2878 2878 - # "prealloc": true, 2879 2879 - # "host-nodes": [2, 3], 2880 2880 - # "policy": "preferred" 2881 2881 - # } 2882 2882 - # ] 2883 2883 - # } 2884 2884 - # 2885 2885 - ## 2886 2886 - { 'command': 'query-memdev', 'returns': ['Memdev'] } 2887 2887 - 2888 2888 - ## 2889 2889 - # @PCDIMMDeviceInfo: 2890 2890 - # 2891 2891 - # PCDIMMDevice state information 2892 2892 - # 2893 2893 - # @id: device's ID 2894 2894 - # 2895 2895 - # @addr: physical address, where device is mapped 2896 2896 - # 2897 2897 - # @size: size of memory that the device provides 2898 2898 - # 2899 2899 - # @slot: slot number at which device is plugged in 2900 2900 - # 2901 2901 - # @node: NUMA node number where device is plugged in 2902 2902 - # 2903 2903 - # @memdev: memory backend linked with device 2904 2904 - # 2905 2905 - # @hotplugged: true if device was hotplugged 2906 2906 - # 2907 2907 - # @hotpluggable: true if device if could be added/removed while machine is running 2908 2908 - # 2909 2909 - # Since: 2.1 2910 2910 - ## 2911 2911 - { 'struct': 'PCDIMMDeviceInfo', 2912 2912 - 'data': { '*id': 'str', 2913 2913 - 'addr': 'int', 2914 2914 - 'size': 'int', 2915 2915 - 'slot': 'int', 2916 2916 - 'node': 'int', 2917 2917 - 'memdev': 'str', 2918 2918 - 'hotplugged': 'bool', 2919 2919 - 'hotpluggable': 'bool' 2920 2920 - } 2921 2921 - } 2922 2922 - 2923 2923 - ## 2924 2924 - # @MemoryDeviceInfo: 2925 2925 - # 2926 2926 - # Union containing information about a memory device 2927 2927 - # 2928 2928 - # Since: 2.1 2929 2929 - ## 2930 2930 - { 'union': 'MemoryDeviceInfo', 'data': {'dimm': 'PCDIMMDeviceInfo'} } 2931 2931 - 2932 2932 - ## 2933 2933 - # @query-memory-devices: 2934 2934 - # 2935 2935 - # Lists available memory devices and their state 2936 2936 - # 2937 2937 - # Since: 2.1 2938 2938 - # 2939 2939 - # Example: 2940 2940 - # 2941 2941 - # -> { "execute": "query-memory-devices" } 2942 2942 - # <- { "return": [ { "data": 2943 2943 - # { "addr": 5368709120, 2944 2944 - # "hotpluggable": true, 2945 2945 - # "hotplugged": true, 2946 2946 - # "id": "d1", 2947 2947 - # "memdev": "/objects/memX", 2948 2948 - # "node": 0, 2949 2949 - # "size": 1073741824, 2950 2950 - # "slot": 0}, 2951 2951 - # "type": "dimm" 2952 2952 - # } ] } 2953 2953 - # 2954 2954 - ## 2955 2955 - { 'command': 'query-memory-devices', 'returns': ['MemoryDeviceInfo'] } 2956 2956 - 2957 2957 - ## 2958 2958 - # @MEM_UNPLUG_ERROR: 2959 2959 - # 2960 2960 - # Emitted when memory hot unplug error occurs. 2961 2961 - # 2962 2962 - # @device: device name 2963 2963 - # 2964 2964 - # @msg: Informative message 2965 2965 - # 2966 2966 - # Since: 2.4 2967 2967 - # 2968 2968 - # Example: 2969 2969 - # 2970 2970 - # <- { "event": "MEM_UNPLUG_ERROR" 2971 2971 - # "data": { "device": "dimm1", 2972 2972 - # "msg": "acpi: device unplug for unsupported device" 2973 2973 - # }, 2974 2974 - # "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } 2975 2975 - # 2976 2976 - ## 2977 2977 - { 'event': 'MEM_UNPLUG_ERROR', 2978 2978 - 'data': { 'device': 'str', 'msg': 'str' } } 2979 2979 - 2980 2980 - ## 2981 2981 - # @ACPISlotType: 2982 2982 - # 2983 2983 - # @DIMM: memory slot 2984 2984 - # @CPU: logical CPU slot (since 2.7) 2985 2985 - ## 2986 2986 - { 'enum': 'ACPISlotType', 'data': [ 'DIMM', 'CPU' ] } 2987 2987 - 2988 2988 - ## 2989 2989 - # @ACPIOSTInfo: 2990 2990 - # 2991 2991 - # OSPM Status Indication for a device 2992 2992 - # For description of possible values of @source and @status fields 2993 2993 - # see "_OST (OSPM Status Indication)" chapter of ACPI5.0 spec. 2994 2994 - # 2995 2995 - # @device: device ID associated with slot 2996 2996 - # 2997 2997 - # @slot: slot ID, unique per slot of a given @slot-type 2998 2998 - # 2999 2999 - # @slot-type: type of the slot 3000 3000 - # 3001 3001 - # @source: an integer containing the source event 3002 3002 - # 3003 3003 - # @status: an integer containing the status code 3004 3004 - # 3005 3005 - # Since: 2.1 3006 3006 - ## 3007 3007 - { 'struct': 'ACPIOSTInfo', 3008 3008 - 'data' : { '*device': 'str', 3009 3009 - 'slot': 'str', 3010 3010 - 'slot-type': 'ACPISlotType', 3011 3011 - 'source': 'int', 3012 3012 - 'status': 'int' } } 3013 3013 - 3014 3014 - ## 3015 3015 - # @query-acpi-ospm-status: 3016 3016 - # 3017 3017 - # Return a list of ACPIOSTInfo for devices that support status 3018 3018 - # reporting via ACPI _OST method. 3019 3019 - # 3020 3020 - # Since: 2.1 3021 3021 - # 3022 3022 - # Example: 3023 3023 - # 3024 3024 - # -> { "execute": "query-acpi-ospm-status" } 3025 3025 - # <- { "return": [ { "device": "d1", "slot": "0", "slot-type": "DIMM", "source": 1, "status": 0}, 3026 3026 - # { "slot": "1", "slot-type": "DIMM", "source": 0, "status": 0}, 3027 3027 - # { "slot": "2", "slot-type": "DIMM", "source": 0, "status": 0}, 3028 3028 - # { "slot": "3", "slot-type": "DIMM", "source": 0, "status": 0} 3029 3029 - # ]} 3030 3030 - # 3031 3031 - ## 3032 3032 - { 'command': 'query-acpi-ospm-status', 'returns': ['ACPIOSTInfo'] } 3033 3033 - 3034 3034 - ## 3035 3035 - # @ACPI_DEVICE_OST: 3036 3036 - # 3037 3037 - # Emitted when guest executes ACPI _OST method. 3038 3038 - # 3039 3039 - # @info: ACPIOSTInfo type as described in qapi-schema.json 3040 3040 - # 3041 3041 - # Since: 2.1 3042 3042 - # 3043 3043 - # Example: 3044 3044 - # 3045 3045 - # <- { "event": "ACPI_DEVICE_OST", 3046 3046 - # "data": { "device": "d1", "slot": "0", 3047 3047 - # "slot-type": "DIMM", "source": 1, "status": 0 } } 3048 3048 - # 3049 3049 - ## 3050 3050 - { 'event': 'ACPI_DEVICE_OST', 3051 3051 - 'data': { 'info': 'ACPIOSTInfo' } } 3052 3052 - 3053 3053 - ## 3054 3054 - # @rtc-reset-reinjection: 3055 3055 - # 3056 3056 - # This command will reset the RTC interrupt reinjection backlog. 3057 3057 - # Can be used if another mechanism to synchronize guest time 3058 3058 - # is in effect, for example QEMU guest agent's guest-set-time 3059 3059 - # command. 3060 3060 - # 3061 3061 - # Since: 2.1 3062 3062 - # 3063 3063 - # Example: 3064 3064 - # 3065 3065 - # -> { "execute": "rtc-reset-reinjection" } 3066 3066 - # <- { "return": {} } 3067 3067 - # 3068 3068 - ## 3069 3069 - { 'command': 'rtc-reset-reinjection' } 3070 3070 - 3071 3071 - ## 3072 3072 - # @RTC_CHANGE: 3073 3073 - # 3074 3074 - # Emitted when the guest changes the RTC time. 3075 3075 - # 3076 3076 - # @offset: offset between base RTC clock (as specified by -rtc base), and 3077 3077 - # new RTC clock value 3078 3078 - # 3079 3079 - # Note: This event is rate-limited. 3080 3080 - # 3081 3081 - # Since: 0.13.0 3082 3082 - # 3083 3083 - # Example: 3084 3084 - # 3085 3085 - # <- { "event": "RTC_CHANGE", 3086 3086 - # "data": { "offset": 78 }, 3087 3087 - # "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } 3088 3088 - # 3089 3089 - ## 3090 3090 - { 'event': 'RTC_CHANGE', 3091 3091 - 'data': { 'offset': 'int' } } 3092 3092 - 3093 3093 - ## 3094 3094 - # @ReplayMode: 3095 3095 - # 3096 3096 - # Mode of the replay subsystem. 3097 3097 - # 3098 3098 - # @none: normal execution mode. Replay or record are not enabled. 3099 3099 - # 3100 3100 - # @record: record mode. All non-deterministic data is written into the 3101 3101 - # replay log. 3102 3102 - # 3103 3103 - # @play: replay mode. Non-deterministic data required for system execution 3104 3104 - # is read from the log. 3105 3105 - # 3106 3106 - # Since: 2.5 3107 3107 - ## 3108 3108 - { 'enum': 'ReplayMode', 3109 3109 - 'data': [ 'none', 'record', 'play' ] } 3110 3110 - 3111 3111 - ## 3112 3112 - # @xen-load-devices-state: 3113 3113 - # 3114 3114 - # Load the state of all devices from file. The RAM and the block devices 3115 3115 - # of the VM are not loaded by this command. 3116 3116 - # 3117 3117 - # @filename: the file to load the state of the devices from as binary 3118 3118 - # data. See xen-save-devices-state.txt for a description of the binary 3119 3119 - # format. 3120 3120 - # 3121 3121 - # Since: 2.7 3122 3122 - # 3123 3123 - # Example: 3124 3124 - # 3125 3125 - # -> { "execute": "xen-load-devices-state", 3126 3126 - # "arguments": { "filename": "/tmp/resume" } } 3127 3127 - # <- { "return": {} } 3128 3128 - # 3129 3129 - ## 3130 3130 - { 'command': 'xen-load-devices-state', 'data': {'filename': 'str'} } 3131 3131 - 3132 3132 - ## 3133 3133 - # @GICCapability: 3134 3134 - # 3135 3135 - # The struct describes capability for a specific GIC (Generic 3136 3136 - # Interrupt Controller) version. These bits are not only decided by 3137 3137 - # QEMU/KVM software version, but also decided by the hardware that 3138 3138 - # the program is running upon. 3139 3139 - # 3140 3140 - # @version: version of GIC to be described. Currently, only 2 and 3 3141 3141 - # are supported. 3142 3142 - # 3143 3143 - # @emulated: whether current QEMU/hardware supports emulated GIC 3144 3144 - # device in user space. 3145 3145 - # 3146 3146 - # @kernel: whether current QEMU/hardware supports hardware 3147 3147 - # accelerated GIC device in kernel. 3148 3148 - # 3149 3149 - # Since: 2.6 3150 3150 - ## 3151 3151 - { 'struct': 'GICCapability', 3152 3152 - 'data': { 'version': 'int', 3153 3153 - 'emulated': 'bool', 3154 3154 - 'kernel': 'bool' } } 3155 3155 - 3156 3156 - ## 3157 3157 - # @query-gic-capabilities: 3158 3158 - # 3159 3159 - # This command is ARM-only. It will return a list of GICCapability 3160 3160 - # objects that describe its capability bits. 3161 3161 - # 3162 3162 - # Returns: a list of GICCapability objects. 3163 3163 - # 3164 3164 - # Since: 2.6 3165 3165 - # 3166 3166 - # Example: 3167 3167 - # 3168 3168 - # -> { "execute": "query-gic-capabilities" } 3169 3169 - # <- { "return": [{ "version": 2, "emulated": true, "kernel": false }, 3170 3170 - # { "version": 3, "emulated": false, "kernel": true } ] } 3171 3171 - # 3172 3172 - ## 3173 3173 - { 'command': 'query-gic-capabilities', 'returns': ['GICCapability'] } 3174 3174 - 3175 3175 - ## 3176 3176 - # @CpuInstanceProperties: 3177 3177 - # 3178 3178 - # List of properties to be used for hotplugging a CPU instance, 3179 3179 - # it should be passed by management with device_add command when 3180 3180 - # a CPU is being hotplugged. 3181 3181 - # 3182 3182 - # @node-id: NUMA node ID the CPU belongs to 3183 3183 - # @socket-id: socket number within node/board the CPU belongs to 3184 3184 - # @core-id: core number within socket the CPU belongs to 3185 3185 - # @thread-id: thread number within core the CPU belongs to 3186 3186 - # 3187 3187 - # Note: currently there are 4 properties that could be present 3188 3188 - # but management should be prepared to pass through other 3189 3189 - # properties with device_add command to allow for future 3190 3190 - # interface extension. This also requires the filed names to be kept in 3191 3191 - # sync with the properties passed to -device/device_add. 3192 3192 - # 3193 3193 - # Since: 2.7 3194 3194 - ## 3195 3195 - { 'struct': 'CpuInstanceProperties', 3196 3196 - 'data': { '*node-id': 'int', 3197 3197 - '*socket-id': 'int', 3198 3198 - '*core-id': 'int', 3199 3199 - '*thread-id': 'int' 3200 3200 - } 3201 3201 - } 3202 3202 - 3203 3203 - ## 3204 3204 - # @HotpluggableCPU: 3205 3205 - # 3206 3206 - # @type: CPU object type for usage with device_add command 3207 3207 - # @props: list of properties to be used for hotplugging CPU 3208 3208 - # @vcpus-count: number of logical VCPU threads @HotpluggableCPU provides 3209 3209 - # @qom-path: link to existing CPU object if CPU is present or 3210 3210 - # omitted if CPU is not present. 3211 3211 - # 3212 3212 - # Since: 2.7 3213 3213 - ## 3214 3214 - { 'struct': 'HotpluggableCPU', 3215 3215 - 'data': { 'type': 'str', 3216 3216 - 'vcpus-count': 'int', 3217 3217 - 'props': 'CpuInstanceProperties', 3218 3218 - '*qom-path': 'str' 3219 3219 - } 3220 3220 - } 3221 3221 - 3222 3222 - ## 3223 3223 - # @query-hotpluggable-cpus: 3224 3224 - # 3225 3225 - # Returns: a list of HotpluggableCPU objects. 3226 3226 - # 3227 3227 - # Since: 2.7 3228 3228 - # 3229 3229 - # Example: 3230 3230 - # 3231 3231 - # For pseries machine type started with -smp 2,cores=2,maxcpus=4 -cpu POWER8: 3232 3232 - # 3233 3233 - # -> { "execute": "query-hotpluggable-cpus" } 3234 3234 - # <- {"return": [ 3235 3235 - # { "props": { "core": 8 }, "type": "POWER8-spapr-cpu-core", 3236 3236 - # "vcpus-count": 1 }, 3237 3237 - # { "props": { "core": 0 }, "type": "POWER8-spapr-cpu-core", 3238 3238 - # "vcpus-count": 1, "qom-path": "/machine/unattached/device[0]"} 3239 3239 - # ]}' 3240 3240 - # 3241 3241 - # For pc machine type started with -smp 1,maxcpus=2: 3242 3242 - # 3243 3243 - # -> { "execute": "query-hotpluggable-cpus" } 3244 3244 - # <- {"return": [ 3245 3245 - # { 3246 3246 - # "type": "qemu64-x86_64-cpu", "vcpus-count": 1, 3247 3247 - # "props": {"core-id": 0, "socket-id": 1, "thread-id": 0} 3248 3248 - # }, 3249 3249 - # { 3250 3250 - # "qom-path": "/machine/unattached/device[0]", 3251 3251 - # "type": "qemu64-x86_64-cpu", "vcpus-count": 1, 3252 3252 - # "props": {"core-id": 0, "socket-id": 0, "thread-id": 0} 3253 3253 - # } 3254 3254 - # ]} 3255 3255 - # 3256 3256 - # For s390x-virtio-ccw machine type started with -smp 1,maxcpus=2 -cpu qemu 3257 3257 - # (Since: 2.11): 3258 3258 - # 3259 3259 - # -> { "execute": "query-hotpluggable-cpus" } 3260 3260 - # <- {"return": [ 3261 3261 - # { 3262 3262 - # "type": "qemu-s390x-cpu", "vcpus-count": 1, 3263 3263 - # "props": { "core-id": 1 } 3264 3264 - # }, 3265 3265 - # { 3266 3266 - # "qom-path": "/machine/unattached/device[0]", 3267 3267 - # "type": "qemu-s390x-cpu", "vcpus-count": 1, 3268 3268 - # "props": { "core-id": 0 } 3269 3269 - # } 3270 3270 - # ]} 3271 3271 - # 3272 3272 - ## 3273 3273 - { 'command': 'query-hotpluggable-cpus', 'returns': ['HotpluggableCPU'] } 3274 3274 - 3275 3275 - ## 3276 3276 - # @GuidInfo: 3277 3277 - # 3278 3278 - # GUID information. 3279 3279 - # 3280 3280 - # @guid: the globally unique identifier 3281 3281 - # 3282 3282 - # Since: 2.9 3283 3283 - ## 3284 3284 - { 'struct': 'GuidInfo', 'data': {'guid': 'str'} } 3285 3285 - 3286 3286 - ## 3287 3287 - # @query-vm-generation-id: 3288 3288 - # 3289 3289 - # Show Virtual Machine Generation ID 3290 3290 - # 3291 3291 - # Since: 2.9 3292 3292 - ## 3293 3293 - { 'command': 'query-vm-generation-id', 'returns': 'GuidInfo' } 95 95 + { 'include': 'qapi/misc.json' }

+3201

qapi/misc.json

··· 1 1 + # -*- Mode: Python -*- 2 2 + # 3 3 + 4 4 + ## 5 5 + # = Miscellanea 6 6 + ## 7 7 + 8 8 + ## 9 9 + # @qmp_capabilities: 10 10 + # 11 11 + # Enable QMP capabilities. 12 12 + # 13 13 + # Arguments: None. 14 14 + # 15 15 + # Example: 16 16 + # 17 17 + # -> { "execute": "qmp_capabilities" } 18 18 + # <- { "return": {} } 19 19 + # 20 20 + # Notes: This command is valid exactly when first connecting: it must be 21 21 + # issued before any other command will be accepted, and will fail once the 22 22 + # monitor is accepting other commands. (see qemu docs/interop/qmp-spec.txt) 23 23 + # 24 24 + # Since: 0.13 25 25 + # 26 26 + ## 27 27 + { 'command': 'qmp_capabilities' } 28 28 + 29 29 + ## 30 30 + # @VersionTriple: 31 31 + # 32 32 + # A three-part version number. 33 33 + # 34 34 + # @major: The major version number. 35 35 + # 36 36 + # @minor: The minor version number. 37 37 + # 38 38 + # @micro: The micro version number. 39 39 + # 40 40 + # Since: 2.4 41 41 + ## 42 42 + { 'struct': 'VersionTriple', 43 43 + 'data': {'major': 'int', 'minor': 'int', 'micro': 'int'} } 44 44 + 45 45 + 46 46 + ## 47 47 + # @VersionInfo: 48 48 + # 49 49 + # A description of QEMU's version. 50 50 + # 51 51 + # @qemu: The version of QEMU. By current convention, a micro 52 52 + # version of 50 signifies a development branch. A micro version 53 53 + # greater than or equal to 90 signifies a release candidate for 54 54 + # the next minor version. A micro version of less than 50 55 55 + # signifies a stable release. 56 56 + # 57 57 + # @package: QEMU will always set this field to an empty string. Downstream 58 58 + # versions of QEMU should set this to a non-empty string. The 59 59 + # exact format depends on the downstream however it highly 60 60 + # recommended that a unique name is used. 61 61 + # 62 62 + # Since: 0.14.0 63 63 + ## 64 64 + { 'struct': 'VersionInfo', 65 65 + 'data': {'qemu': 'VersionTriple', 'package': 'str'} } 66 66 + 67 67 + ## 68 68 + # @query-version: 69 69 + # 70 70 + # Returns the current version of QEMU. 71 71 + # 72 72 + # Returns: A @VersionInfo object describing the current version of QEMU. 73 73 + # 74 74 + # Since: 0.14.0 75 75 + # 76 76 + # Example: 77 77 + # 78 78 + # -> { "execute": "query-version" } 79 79 + # <- { 80 80 + # "return":{ 81 81 + # "qemu":{ 82 82 + # "major":0, 83 83 + # "minor":11, 84 84 + # "micro":5 85 85 + # }, 86 86 + # "package":"" 87 87 + # } 88 88 + # } 89 89 + # 90 90 + ## 91 91 + { 'command': 'query-version', 'returns': 'VersionInfo' } 92 92 + 93 93 + ## 94 94 + # @CommandInfo: 95 95 + # 96 96 + # Information about a QMP command 97 97 + # 98 98 + # @name: The command name 99 99 + # 100 100 + # Since: 0.14.0 101 101 + ## 102 102 + { 'struct': 'CommandInfo', 'data': {'name': 'str'} } 103 103 + 104 104 + ## 105 105 + # @query-commands: 106 106 + # 107 107 + # Return a list of supported QMP commands by this server 108 108 + # 109 109 + # Returns: A list of @CommandInfo for all supported commands 110 110 + # 111 111 + # Since: 0.14.0 112 112 + # 113 113 + # Example: 114 114 + # 115 115 + # -> { "execute": "query-commands" } 116 116 + # <- { 117 117 + # "return":[ 118 118 + # { 119 119 + # "name":"query-balloon" 120 120 + # }, 121 121 + # { 122 122 + # "name":"system_powerdown" 123 123 + # } 124 124 + # ] 125 125 + # } 126 126 + # 127 127 + # Note: This example has been shortened as the real response is too long. 128 128 + # 129 129 + ## 130 130 + { 'command': 'query-commands', 'returns': ['CommandInfo'] } 131 131 + 132 132 + ## 133 133 + # @LostTickPolicy: 134 134 + # 135 135 + # Policy for handling lost ticks in timer devices. 136 136 + # 137 137 + # @discard: throw away the missed tick(s) and continue with future injection 138 138 + # normally. Guest time may be delayed, unless the OS has explicit 139 139 + # handling of lost ticks 140 140 + # 141 141 + # @delay: continue to deliver ticks at the normal rate. Guest time will be 142 142 + # delayed due to the late tick 143 143 + # 144 144 + # @merge: merge the missed tick(s) into one tick and inject. Guest time 145 145 + # may be delayed, depending on how the OS reacts to the merging 146 146 + # of ticks 147 147 + # 148 148 + # @slew: deliver ticks at a higher rate to catch up with the missed tick. The 149 149 + # guest time should not be delayed once catchup is complete. 150 150 + # 151 151 + # Since: 2.0 152 152 + ## 153 153 + { 'enum': 'LostTickPolicy', 154 154 + 'data': ['discard', 'delay', 'merge', 'slew' ] } 155 155 + 156 156 + ## 157 157 + # @add_client: 158 158 + # 159 159 + # Allow client connections for VNC, Spice and socket based 160 160 + # character devices to be passed in to QEMU via SCM_RIGHTS. 161 161 + # 162 162 + # @protocol: protocol name. Valid names are "vnc", "spice" or the 163 163 + # name of a character device (eg. from -chardev id=XXXX) 164 164 + # 165 165 + # @fdname: file descriptor name previously passed via 'getfd' command 166 166 + # 167 167 + # @skipauth: whether to skip authentication. Only applies 168 168 + # to "vnc" and "spice" protocols 169 169 + # 170 170 + # @tls: whether to perform TLS. Only applies to the "spice" 171 171 + # protocol 172 172 + # 173 173 + # Returns: nothing on success. 174 174 + # 175 175 + # Since: 0.14.0 176 176 + # 177 177 + # Example: 178 178 + # 179 179 + # -> { "execute": "add_client", "arguments": { "protocol": "vnc", 180 180 + # "fdname": "myclient" } } 181 181 + # <- { "return": {} } 182 182 + # 183 183 + ## 184 184 + { 'command': 'add_client', 185 185 + 'data': { 'protocol': 'str', 'fdname': 'str', '*skipauth': 'bool', 186 186 + '*tls': 'bool' } } 187 187 + 188 188 + ## 189 189 + # @NameInfo: 190 190 + # 191 191 + # Guest name information. 192 192 + # 193 193 + # @name: The name of the guest 194 194 + # 195 195 + # Since: 0.14.0 196 196 + ## 197 197 + { 'struct': 'NameInfo', 'data': {'*name': 'str'} } 198 198 + 199 199 + ## 200 200 + # @query-name: 201 201 + # 202 202 + # Return the name information of a guest. 203 203 + # 204 204 + # Returns: @NameInfo of the guest 205 205 + # 206 206 + # Since: 0.14.0 207 207 + # 208 208 + # Example: 209 209 + # 210 210 + # -> { "execute": "query-name" } 211 211 + # <- { "return": { "name": "qemu-name" } } 212 212 + # 213 213 + ## 214 214 + { 'command': 'query-name', 'returns': 'NameInfo' } 215 215 + 216 216 + ## 217 217 + # @KvmInfo: 218 218 + # 219 219 + # Information about support for KVM acceleration 220 220 + # 221 221 + # @enabled: true if KVM acceleration is active 222 222 + # 223 223 + # @present: true if KVM acceleration is built into this executable 224 224 + # 225 225 + # Since: 0.14.0 226 226 + ## 227 227 + { 'struct': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} } 228 228 + 229 229 + ## 230 230 + # @query-kvm: 231 231 + # 232 232 + # Returns information about KVM acceleration 233 233 + # 234 234 + # Returns: @KvmInfo 235 235 + # 236 236 + # Since: 0.14.0 237 237 + # 238 238 + # Example: 239 239 + # 240 240 + # -> { "execute": "query-kvm" } 241 241 + # <- { "return": { "enabled": true, "present": true } } 242 242 + # 243 243 + ## 244 244 + { 'command': 'query-kvm', 'returns': 'KvmInfo' } 245 245 + 246 246 + ## 247 247 + # @UuidInfo: 248 248 + # 249 249 + # Guest UUID information (Universally Unique Identifier). 250 250 + # 251 251 + # @UUID: the UUID of the guest 252 252 + # 253 253 + # Since: 0.14.0 254 254 + # 255 255 + # Notes: If no UUID was specified for the guest, a null UUID is returned. 256 256 + ## 257 257 + { 'struct': 'UuidInfo', 'data': {'UUID': 'str'} } 258 258 + 259 259 + ## 260 260 + # @query-uuid: 261 261 + # 262 262 + # Query the guest UUID information. 263 263 + # 264 264 + # Returns: The @UuidInfo for the guest 265 265 + # 266 266 + # Since: 0.14.0 267 267 + # 268 268 + # Example: 269 269 + # 270 270 + # -> { "execute": "query-uuid" } 271 271 + # <- { "return": { "UUID": "550e8400-e29b-41d4-a716-446655440000" } } 272 272 + # 273 273 + ## 274 274 + { 'command': 'query-uuid', 'returns': 'UuidInfo' } 275 275 + 276 276 + ## 277 277 + # @EventInfo: 278 278 + # 279 279 + # Information about a QMP event 280 280 + # 281 281 + # @name: The event name 282 282 + # 283 283 + # Since: 1.2.0 284 284 + ## 285 285 + { 'struct': 'EventInfo', 'data': {'name': 'str'} } 286 286 + 287 287 + ## 288 288 + # @query-events: 289 289 + # 290 290 + # Return a list of supported QMP events by this server 291 291 + # 292 292 + # Returns: A list of @EventInfo for all supported events 293 293 + # 294 294 + # Since: 1.2.0 295 295 + # 296 296 + # Example: 297 297 + # 298 298 + # -> { "execute": "query-events" } 299 299 + # <- { 300 300 + # "return": [ 301 301 + # { 302 302 + # "name":"SHUTDOWN" 303 303 + # }, 304 304 + # { 305 305 + # "name":"RESET" 306 306 + # } 307 307 + # ] 308 308 + # } 309 309 + # 310 310 + # Note: This example has been shortened as the real response is too long. 311 311 + # 312 312 + ## 313 313 + { 'command': 'query-events', 'returns': ['EventInfo'] } 314 314 + 315 315 + ## 316 316 + # @CpuInfoArch: 317 317 + # 318 318 + # An enumeration of cpu types that enable additional information during 319 319 + # @query-cpus and @query-cpus-fast. 320 320 + # 321 321 + # @s390: since 2.12 322 322 + # 323 323 + # Since: 2.6 324 324 + ## 325 325 + { 'enum': 'CpuInfoArch', 326 326 + 'data': ['x86', 'sparc', 'ppc', 'mips', 'tricore', 's390', 'other' ] } 327 327 + 328 328 + ## 329 329 + # @CpuInfo: 330 330 + # 331 331 + # Information about a virtual CPU 332 332 + # 333 333 + # @CPU: the index of the virtual CPU 334 334 + # 335 335 + # @current: this only exists for backwards compatibility and should be ignored 336 336 + # 337 337 + # @halted: true if the virtual CPU is in the halt state. Halt usually refers 338 338 + # to a processor specific low power mode. 339 339 + # 340 340 + # @qom_path: path to the CPU object in the QOM tree (since 2.4) 341 341 + # 342 342 + # @thread_id: ID of the underlying host thread 343 343 + # 344 344 + # @props: properties describing to which node/socket/core/thread 345 345 + # virtual CPU belongs to, provided if supported by board (since 2.10) 346 346 + # 347 347 + # @arch: architecture of the cpu, which determines which additional fields 348 348 + # will be listed (since 2.6) 349 349 + # 350 350 + # Since: 0.14.0 351 351 + # 352 352 + # Notes: @halted is a transient state that changes frequently. By the time the 353 353 + # data is sent to the client, the guest may no longer be halted. 354 354 + ## 355 355 + { 'union': 'CpuInfo', 356 356 + 'base': {'CPU': 'int', 'current': 'bool', 'halted': 'bool', 357 357 + 'qom_path': 'str', 'thread_id': 'int', 358 358 + '*props': 'CpuInstanceProperties', 'arch': 'CpuInfoArch' }, 359 359 + 'discriminator': 'arch', 360 360 + 'data': { 'x86': 'CpuInfoX86', 361 361 + 'sparc': 'CpuInfoSPARC', 362 362 + 'ppc': 'CpuInfoPPC', 363 363 + 'mips': 'CpuInfoMIPS', 364 364 + 'tricore': 'CpuInfoTricore', 365 365 + 's390': 'CpuInfoS390', 366 366 + 'other': 'CpuInfoOther' } } 367 367 + 368 368 + ## 369 369 + # @CpuInfoX86: 370 370 + # 371 371 + # Additional information about a virtual i386 or x86_64 CPU 372 372 + # 373 373 + # @pc: the 64-bit instruction pointer 374 374 + # 375 375 + # Since: 2.6 376 376 + ## 377 377 + { 'struct': 'CpuInfoX86', 'data': { 'pc': 'int' } } 378 378 + 379 379 + ## 380 380 + # @CpuInfoSPARC: 381 381 + # 382 382 + # Additional information about a virtual SPARC CPU 383 383 + # 384 384 + # @pc: the PC component of the instruction pointer 385 385 + # 386 386 + # @npc: the NPC component of the instruction pointer 387 387 + # 388 388 + # Since: 2.6 389 389 + ## 390 390 + { 'struct': 'CpuInfoSPARC', 'data': { 'pc': 'int', 'npc': 'int' } } 391 391 + 392 392 + ## 393 393 + # @CpuInfoPPC: 394 394 + # 395 395 + # Additional information about a virtual PPC CPU 396 396 + # 397 397 + # @nip: the instruction pointer 398 398 + # 399 399 + # Since: 2.6 400 400 + ## 401 401 + { 'struct': 'CpuInfoPPC', 'data': { 'nip': 'int' } } 402 402 + 403 403 + ## 404 404 + # @CpuInfoMIPS: 405 405 + # 406 406 + # Additional information about a virtual MIPS CPU 407 407 + # 408 408 + # @PC: the instruction pointer 409 409 + # 410 410 + # Since: 2.6 411 411 + ## 412 412 + { 'struct': 'CpuInfoMIPS', 'data': { 'PC': 'int' } } 413 413 + 414 414 + ## 415 415 + # @CpuInfoTricore: 416 416 + # 417 417 + # Additional information about a virtual Tricore CPU 418 418 + # 419 419 + # @PC: the instruction pointer 420 420 + # 421 421 + # Since: 2.6 422 422 + ## 423 423 + { 'struct': 'CpuInfoTricore', 'data': { 'PC': 'int' } } 424 424 + 425 425 + ## 426 426 + # @CpuInfoOther: 427 427 + # 428 428 + # No additional information is available about the virtual CPU 429 429 + # 430 430 + # Since: 2.6 431 431 + # 432 432 + ## 433 433 + { 'struct': 'CpuInfoOther', 'data': { } } 434 434 + 435 435 + ## 436 436 + # @CpuS390State: 437 437 + # 438 438 + # An enumeration of cpu states that can be assumed by a virtual 439 439 + # S390 CPU 440 440 + # 441 441 + # Since: 2.12 442 442 + ## 443 443 + { 'enum': 'CpuS390State', 444 444 + 'prefix': 'S390_CPU_STATE', 445 445 + 'data': [ 'uninitialized', 'stopped', 'check-stop', 'operating', 'load' ] } 446 446 + 447 447 + ## 448 448 + # @CpuInfoS390: 449 449 + # 450 450 + # Additional information about a virtual S390 CPU 451 451 + # 452 452 + # @cpu-state: the virtual CPU's state 453 453 + # 454 454 + # Since: 2.12 455 455 + ## 456 456 + { 'struct': 'CpuInfoS390', 'data': { 'cpu-state': 'CpuS390State' } } 457 457 + 458 458 + ## 459 459 + # @query-cpus: 460 460 + # 461 461 + # Returns a list of information about each virtual CPU. 462 462 + # 463 463 + # This command causes vCPU threads to exit to userspace, which causes 464 464 + # a small interruption to guest CPU execution. This will have a negative 465 465 + # impact on realtime guests and other latency sensitive guest workloads. 466 466 + # It is recommended to use @query-cpus-fast instead of this command to 467 467 + # avoid the vCPU interruption. 468 468 + # 469 469 + # Returns: a list of @CpuInfo for each virtual CPU 470 470 + # 471 471 + # Since: 0.14.0 472 472 + # 473 473 + # Example: 474 474 + # 475 475 + # -> { "execute": "query-cpus" } 476 476 + # <- { "return": [ 477 477 + # { 478 478 + # "CPU":0, 479 479 + # "current":true, 480 480 + # "halted":false, 481 481 + # "qom_path":"/machine/unattached/device[0]", 482 482 + # "arch":"x86", 483 483 + # "pc":3227107138, 484 484 + # "thread_id":3134 485 485 + # }, 486 486 + # { 487 487 + # "CPU":1, 488 488 + # "current":false, 489 489 + # "halted":true, 490 490 + # "qom_path":"/machine/unattached/device[2]", 491 491 + # "arch":"x86", 492 492 + # "pc":7108165, 493 493 + # "thread_id":3135 494 494 + # } 495 495 + # ] 496 496 + # } 497 497 + # 498 498 + # Notes: This interface is deprecated (since 2.12.0), and it is strongly 499 499 + # recommended that you avoid using it. Use @query-cpus-fast to 500 500 + # obtain information about virtual CPUs. 501 501 + # 502 502 + ## 503 503 + { 'command': 'query-cpus', 'returns': ['CpuInfo'] } 504 504 + 505 505 + ## 506 506 + # @CpuInfoFast: 507 507 + # 508 508 + # Information about a virtual CPU 509 509 + # 510 510 + # @cpu-index: index of the virtual CPU 511 511 + # 512 512 + # @qom-path: path to the CPU object in the QOM tree 513 513 + # 514 514 + # @thread-id: ID of the underlying host thread 515 515 + # 516 516 + # @props: properties describing to which node/socket/core/thread 517 517 + # virtual CPU belongs to, provided if supported by board 518 518 + # 519 519 + # @arch: architecture of the cpu, which determines which additional fields 520 520 + # will be listed 521 521 + # 522 522 + # Since: 2.12 523 523 + # 524 524 + ## 525 525 + { 'union': 'CpuInfoFast', 526 526 + 'base': {'cpu-index': 'int', 'qom-path': 'str', 527 527 + 'thread-id': 'int', '*props': 'CpuInstanceProperties', 528 528 + 'arch': 'CpuInfoArch' }, 529 529 + 'discriminator': 'arch', 530 530 + 'data': { 'x86': 'CpuInfoOther', 531 531 + 'sparc': 'CpuInfoOther', 532 532 + 'ppc': 'CpuInfoOther', 533 533 + 'mips': 'CpuInfoOther', 534 534 + 'tricore': 'CpuInfoOther', 535 535 + 's390': 'CpuInfoS390', 536 536 + 'other': 'CpuInfoOther' } } 537 537 + 538 538 + ## 539 539 + # @query-cpus-fast: 540 540 + # 541 541 + # Returns information about all virtual CPUs. This command does not 542 542 + # incur a performance penalty and should be used in production 543 543 + # instead of query-cpus. 544 544 + # 545 545 + # Returns: list of @CpuInfoFast 546 546 + # 547 547 + # Since: 2.12 548 548 + # 549 549 + # Example: 550 550 + # 551 551 + # -> { "execute": "query-cpus-fast" } 552 552 + # <- { "return": [ 553 553 + # { 554 554 + # "thread-id": 25627, 555 555 + # "props": { 556 556 + # "core-id": 0, 557 557 + # "thread-id": 0, 558 558 + # "socket-id": 0 559 559 + # }, 560 560 + # "qom-path": "/machine/unattached/device[0]", 561 561 + # "arch":"x86", 562 562 + # "cpu-index": 0 563 563 + # }, 564 564 + # { 565 565 + # "thread-id": 25628, 566 566 + # "props": { 567 567 + # "core-id": 0, 568 568 + # "thread-id": 0, 569 569 + # "socket-id": 1 570 570 + # }, 571 571 + # "qom-path": "/machine/unattached/device[2]", 572 572 + # "arch":"x86", 573 573 + # "cpu-index": 1 574 574 + # } 575 575 + # ] 576 576 + # } 577 577 + ## 578 578 + { 'command': 'query-cpus-fast', 'returns': [ 'CpuInfoFast' ] } 579 579 + 580 580 + ## 581 581 + # @IOThreadInfo: 582 582 + # 583 583 + # Information about an iothread 584 584 + # 585 585 + # @id: the identifier of the iothread 586 586 + # 587 587 + # @thread-id: ID of the underlying host thread 588 588 + # 589 589 + # @poll-max-ns: maximum polling time in ns, 0 means polling is disabled 590 590 + # (since 2.9) 591 591 + # 592 592 + # @poll-grow: how many ns will be added to polling time, 0 means that it's not 593 593 + # configured (since 2.9) 594 594 + # 595 595 + # @poll-shrink: how many ns will be removed from polling time, 0 means that 596 596 + # it's not configured (since 2.9) 597 597 + # 598 598 + # Since: 2.0 599 599 + ## 600 600 + { 'struct': 'IOThreadInfo', 601 601 + 'data': {'id': 'str', 602 602 + 'thread-id': 'int', 603 603 + 'poll-max-ns': 'int', 604 604 + 'poll-grow': 'int', 605 605 + 'poll-shrink': 'int' } } 606 606 + 607 607 + ## 608 608 + # @query-iothreads: 609 609 + # 610 610 + # Returns a list of information about each iothread. 611 611 + # 612 612 + # Note: this list excludes the QEMU main loop thread, which is not declared 613 613 + # using the -object iothread command-line option. It is always the main thread 614 614 + # of the process. 615 615 + # 616 616 + # Returns: a list of @IOThreadInfo for each iothread 617 617 + # 618 618 + # Since: 2.0 619 619 + # 620 620 + # Example: 621 621 + # 622 622 + # -> { "execute": "query-iothreads" } 623 623 + # <- { "return": [ 624 624 + # { 625 625 + # "id":"iothread0", 626 626 + # "thread-id":3134 627 627 + # }, 628 628 + # { 629 629 + # "id":"iothread1", 630 630 + # "thread-id":3135 631 631 + # } 632 632 + # ] 633 633 + # } 634 634 + # 635 635 + ## 636 636 + { 'command': 'query-iothreads', 'returns': ['IOThreadInfo'] } 637 637 + 638 638 + ## 639 639 + # @BalloonInfo: 640 640 + # 641 641 + # Information about the guest balloon device. 642 642 + # 643 643 + # @actual: the number of bytes the balloon currently contains 644 644 + # 645 645 + # Since: 0.14.0 646 646 + # 647 647 + ## 648 648 + { 'struct': 'BalloonInfo', 'data': {'actual': 'int' } } 649 649 + 650 650 + ## 651 651 + # @query-balloon: 652 652 + # 653 653 + # Return information about the balloon device. 654 654 + # 655 655 + # Returns: @BalloonInfo on success 656 656 + # 657 657 + # If the balloon driver is enabled but not functional because the KVM 658 658 + # kernel module cannot support it, KvmMissingCap 659 659 + # 660 660 + # If no balloon device is present, DeviceNotActive 661 661 + # 662 662 + # Since: 0.14.0 663 663 + # 664 664 + # Example: 665 665 + # 666 666 + # -> { "execute": "query-balloon" } 667 667 + # <- { "return": { 668 668 + # "actual": 1073741824, 669 669 + # } 670 670 + # } 671 671 + # 672 672 + ## 673 673 + { 'command': 'query-balloon', 'returns': 'BalloonInfo' } 674 674 + 675 675 + ## 676 676 + # @BALLOON_CHANGE: 677 677 + # 678 678 + # Emitted when the guest changes the actual BALLOON level. This value is 679 679 + # equivalent to the @actual field return by the 'query-balloon' command 680 680 + # 681 681 + # @actual: actual level of the guest memory balloon in bytes 682 682 + # 683 683 + # Note: this event is rate-limited. 684 684 + # 685 685 + # Since: 1.2 686 686 + # 687 687 + # Example: 688 688 + # 689 689 + # <- { "event": "BALLOON_CHANGE", 690 690 + # "data": { "actual": 944766976 }, 691 691 + # "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } 692 692 + # 693 693 + ## 694 694 + { 'event': 'BALLOON_CHANGE', 695 695 + 'data': { 'actual': 'int' } } 696 696 + 697 697 + ## 698 698 + # @PciMemoryRange: 699 699 + # 700 700 + # A PCI device memory region 701 701 + # 702 702 + # @base: the starting address (guest physical) 703 703 + # 704 704 + # @limit: the ending address (guest physical) 705 705 + # 706 706 + # Since: 0.14.0 707 707 + ## 708 708 + { 'struct': 'PciMemoryRange', 'data': {'base': 'int', 'limit': 'int'} } 709 709 + 710 710 + ## 711 711 + # @PciMemoryRegion: 712 712 + # 713 713 + # Information about a PCI device I/O region. 714 714 + # 715 715 + # @bar: the index of the Base Address Register for this region 716 716 + # 717 717 + # @type: 'io' if the region is a PIO region 718 718 + # 'memory' if the region is a MMIO region 719 719 + # 720 720 + # @size: memory size 721 721 + # 722 722 + # @prefetch: if @type is 'memory', true if the memory is prefetchable 723 723 + # 724 724 + # @mem_type_64: if @type is 'memory', true if the BAR is 64-bit 725 725 + # 726 726 + # Since: 0.14.0 727 727 + ## 728 728 + { 'struct': 'PciMemoryRegion', 729 729 + 'data': {'bar': 'int', 'type': 'str', 'address': 'int', 'size': 'int', 730 730 + '*prefetch': 'bool', '*mem_type_64': 'bool' } } 731 731 + 732 732 + ## 733 733 + # @PciBusInfo: 734 734 + # 735 735 + # Information about a bus of a PCI Bridge device 736 736 + # 737 737 + # @number: primary bus interface number. This should be the number of the 738 738 + # bus the device resides on. 739 739 + # 740 740 + # @secondary: secondary bus interface number. This is the number of the 741 741 + # main bus for the bridge 742 742 + # 743 743 + # @subordinate: This is the highest number bus that resides below the 744 744 + # bridge. 745 745 + # 746 746 + # @io_range: The PIO range for all devices on this bridge 747 747 + # 748 748 + # @memory_range: The MMIO range for all devices on this bridge 749 749 + # 750 750 + # @prefetchable_range: The range of prefetchable MMIO for all devices on 751 751 + # this bridge 752 752 + # 753 753 + # Since: 2.4 754 754 + ## 755 755 + { 'struct': 'PciBusInfo', 756 756 + 'data': {'number': 'int', 'secondary': 'int', 'subordinate': 'int', 757 757 + 'io_range': 'PciMemoryRange', 758 758 + 'memory_range': 'PciMemoryRange', 759 759 + 'prefetchable_range': 'PciMemoryRange' } } 760 760 + 761 761 + ## 762 762 + # @PciBridgeInfo: 763 763 + # 764 764 + # Information about a PCI Bridge device 765 765 + # 766 766 + # @bus: information about the bus the device resides on 767 767 + # 768 768 + # @devices: a list of @PciDeviceInfo for each device on this bridge 769 769 + # 770 770 + # Since: 0.14.0 771 771 + ## 772 772 + { 'struct': 'PciBridgeInfo', 773 773 + 'data': {'bus': 'PciBusInfo', '*devices': ['PciDeviceInfo']} } 774 774 + 775 775 + ## 776 776 + # @PciDeviceClass: 777 777 + # 778 778 + # Information about the Class of a PCI device 779 779 + # 780 780 + # @desc: a string description of the device's class 781 781 + # 782 782 + # @class: the class code of the device 783 783 + # 784 784 + # Since: 2.4 785 785 + ## 786 786 + { 'struct': 'PciDeviceClass', 787 787 + 'data': {'*desc': 'str', 'class': 'int'} } 788 788 + 789 789 + ## 790 790 + # @PciDeviceId: 791 791 + # 792 792 + # Information about the Id of a PCI device 793 793 + # 794 794 + # @device: the PCI device id 795 795 + # 796 796 + # @vendor: the PCI vendor id 797 797 + # 798 798 + # Since: 2.4 799 799 + ## 800 800 + { 'struct': 'PciDeviceId', 801 801 + 'data': {'device': 'int', 'vendor': 'int'} } 802 802 + 803 803 + ## 804 804 + # @PciDeviceInfo: 805 805 + # 806 806 + # Information about a PCI device 807 807 + # 808 808 + # @bus: the bus number of the device 809 809 + # 810 810 + # @slot: the slot the device is located in 811 811 + # 812 812 + # @function: the function of the slot used by the device 813 813 + # 814 814 + # @class_info: the class of the device 815 815 + # 816 816 + # @id: the PCI device id 817 817 + # 818 818 + # @irq: if an IRQ is assigned to the device, the IRQ number 819 819 + # 820 820 + # @qdev_id: the device name of the PCI device 821 821 + # 822 822 + # @pci_bridge: if the device is a PCI bridge, the bridge information 823 823 + # 824 824 + # @regions: a list of the PCI I/O regions associated with the device 825 825 + # 826 826 + # Notes: the contents of @class_info.desc are not stable and should only be 827 827 + # treated as informational. 828 828 + # 829 829 + # Since: 0.14.0 830 830 + ## 831 831 + { 'struct': 'PciDeviceInfo', 832 832 + 'data': {'bus': 'int', 'slot': 'int', 'function': 'int', 833 833 + 'class_info': 'PciDeviceClass', 'id': 'PciDeviceId', 834 834 + '*irq': 'int', 'qdev_id': 'str', '*pci_bridge': 'PciBridgeInfo', 835 835 + 'regions': ['PciMemoryRegion']} } 836 836 + 837 837 + ## 838 838 + # @PciInfo: 839 839 + # 840 840 + # Information about a PCI bus 841 841 + # 842 842 + # @bus: the bus index 843 843 + # 844 844 + # @devices: a list of devices on this bus 845 845 + # 846 846 + # Since: 0.14.0 847 847 + ## 848 848 + { 'struct': 'PciInfo', 'data': {'bus': 'int', 'devices': ['PciDeviceInfo']} } 849 849 + 850 850 + ## 851 851 + # @query-pci: 852 852 + # 853 853 + # Return information about the PCI bus topology of the guest. 854 854 + # 855 855 + # Returns: a list of @PciInfo for each PCI bus. Each bus is 856 856 + # represented by a json-object, which has a key with a json-array of 857 857 + # all PCI devices attached to it. Each device is represented by a 858 858 + # json-object. 859 859 + # 860 860 + # Since: 0.14.0 861 861 + # 862 862 + # Example: 863 863 + # 864 864 + # -> { "execute": "query-pci" } 865 865 + # <- { "return": [ 866 866 + # { 867 867 + # "bus": 0, 868 868 + # "devices": [ 869 869 + # { 870 870 + # "bus": 0, 871 871 + # "qdev_id": "", 872 872 + # "slot": 0, 873 873 + # "class_info": { 874 874 + # "class": 1536, 875 875 + # "desc": "Host bridge" 876 876 + # }, 877 877 + # "id": { 878 878 + # "device": 32902, 879 879 + # "vendor": 4663 880 880 + # }, 881 881 + # "function": 0, 882 882 + # "regions": [ 883 883 + # ] 884 884 + # }, 885 885 + # { 886 886 + # "bus": 0, 887 887 + # "qdev_id": "", 888 888 + # "slot": 1, 889 889 + # "class_info": { 890 890 + # "class": 1537, 891 891 + # "desc": "ISA bridge" 892 892 + # }, 893 893 + # "id": { 894 894 + # "device": 32902, 895 895 + # "vendor": 28672 896 896 + # }, 897 897 + # "function": 0, 898 898 + # "regions": [ 899 899 + # ] 900 900 + # }, 901 901 + # { 902 902 + # "bus": 0, 903 903 + # "qdev_id": "", 904 904 + # "slot": 1, 905 905 + # "class_info": { 906 906 + # "class": 257, 907 907 + # "desc": "IDE controller" 908 908 + # }, 909 909 + # "id": { 910 910 + # "device": 32902, 911 911 + # "vendor": 28688 912 912 + # }, 913 913 + # "function": 1, 914 914 + # "regions": [ 915 915 + # { 916 916 + # "bar": 4, 917 917 + # "size": 16, 918 918 + # "address": 49152, 919 919 + # "type": "io" 920 920 + # } 921 921 + # ] 922 922 + # }, 923 923 + # { 924 924 + # "bus": 0, 925 925 + # "qdev_id": "", 926 926 + # "slot": 2, 927 927 + # "class_info": { 928 928 + # "class": 768, 929 929 + # "desc": "VGA controller" 930 930 + # }, 931 931 + # "id": { 932 932 + # "device": 4115, 933 933 + # "vendor": 184 934 934 + # }, 935 935 + # "function": 0, 936 936 + # "regions": [ 937 937 + # { 938 938 + # "prefetch": true, 939 939 + # "mem_type_64": false, 940 940 + # "bar": 0, 941 941 + # "size": 33554432, 942 942 + # "address": 4026531840, 943 943 + # "type": "memory" 944 944 + # }, 945 945 + # { 946 946 + # "prefetch": false, 947 947 + # "mem_type_64": false, 948 948 + # "bar": 1, 949 949 + # "size": 4096, 950 950 + # "address": 4060086272, 951 951 + # "type": "memory" 952 952 + # }, 953 953 + # { 954 954 + # "prefetch": false, 955 955 + # "mem_type_64": false, 956 956 + # "bar": 6, 957 957 + # "size": 65536, 958 958 + # "address": -1, 959 959 + # "type": "memory" 960 960 + # } 961 961 + # ] 962 962 + # }, 963 963 + # { 964 964 + # "bus": 0, 965 965 + # "qdev_id": "", 966 966 + # "irq": 11, 967 967 + # "slot": 4, 968 968 + # "class_info": { 969 969 + # "class": 1280, 970 970 + # "desc": "RAM controller" 971 971 + # }, 972 972 + # "id": { 973 973 + # "device": 6900, 974 974 + # "vendor": 4098 975 975 + # }, 976 976 + # "function": 0, 977 977 + # "regions": [ 978 978 + # { 979 979 + # "bar": 0, 980 980 + # "size": 32, 981 981 + # "address": 49280, 982 982 + # "type": "io" 983 983 + # } 984 984 + # ] 985 985 + # } 986 986 + # ] 987 987 + # } 988 988 + # ] 989 989 + # } 990 990 + # 991 991 + # Note: This example has been shortened as the real response is too long. 992 992 + # 993 993 + ## 994 994 + { 'command': 'query-pci', 'returns': ['PciInfo'] } 995 995 + 996 996 + ## 997 997 + # @quit: 998 998 + # 999 999 + # This command will cause the QEMU process to exit gracefully. While every 1000 1000 + # attempt is made to send the QMP response before terminating, this is not 1001 1001 + # guaranteed. When using this interface, a premature EOF would not be 1002 1002 + # unexpected. 1003 1003 + # 1004 1004 + # Since: 0.14.0 1005 1005 + # 1006 1006 + # Example: 1007 1007 + # 1008 1008 + # -> { "execute": "quit" } 1009 1009 + # <- { "return": {} } 1010 1010 + ## 1011 1011 + { 'command': 'quit' } 1012 1012 + 1013 1013 + ## 1014 1014 + # @stop: 1015 1015 + # 1016 1016 + # Stop all guest VCPU execution. 1017 1017 + # 1018 1018 + # Since: 0.14.0 1019 1019 + # 1020 1020 + # Notes: This function will succeed even if the guest is already in the stopped 1021 1021 + # state. In "inmigrate" state, it will ensure that the guest 1022 1022 + # remains paused once migration finishes, as if the -S option was 1023 1023 + # passed on the command line. 1024 1024 + # 1025 1025 + # Example: 1026 1026 + # 1027 1027 + # -> { "execute": "stop" } 1028 1028 + # <- { "return": {} } 1029 1029 + # 1030 1030 + ## 1031 1031 + { 'command': 'stop' } 1032 1032 + 1033 1033 + ## 1034 1034 + # @system_reset: 1035 1035 + # 1036 1036 + # Performs a hard reset of a guest. 1037 1037 + # 1038 1038 + # Since: 0.14.0 1039 1039 + # 1040 1040 + # Example: 1041 1041 + # 1042 1042 + # -> { "execute": "system_reset" } 1043 1043 + # <- { "return": {} } 1044 1044 + # 1045 1045 + ## 1046 1046 + { 'command': 'system_reset' } 1047 1047 + 1048 1048 + ## 1049 1049 + # @system_powerdown: 1050 1050 + # 1051 1051 + # Requests that a guest perform a powerdown operation. 1052 1052 + # 1053 1053 + # Since: 0.14.0 1054 1054 + # 1055 1055 + # Notes: A guest may or may not respond to this command. This command 1056 1056 + # returning does not indicate that a guest has accepted the request or 1057 1057 + # that it has shut down. Many guests will respond to this command by 1058 1058 + # prompting the user in some way. 1059 1059 + # Example: 1060 1060 + # 1061 1061 + # -> { "execute": "system_powerdown" } 1062 1062 + # <- { "return": {} } 1063 1063 + # 1064 1064 + ## 1065 1065 + { 'command': 'system_powerdown' } 1066 1066 + 1067 1067 + ## 1068 1068 + # @cpu-add: 1069 1069 + # 1070 1070 + # Adds CPU with specified ID 1071 1071 + # 1072 1072 + # @id: ID of CPU to be created, valid values [0..max_cpus) 1073 1073 + # 1074 1074 + # Returns: Nothing on success 1075 1075 + # 1076 1076 + # Since: 1.5 1077 1077 + # 1078 1078 + # Example: 1079 1079 + # 1080 1080 + # -> { "execute": "cpu-add", "arguments": { "id": 2 } } 1081 1081 + # <- { "return": {} } 1082 1082 + # 1083 1083 + ## 1084 1084 + { 'command': 'cpu-add', 'data': {'id': 'int'} } 1085 1085 + 1086 1086 + ## 1087 1087 + # @memsave: 1088 1088 + # 1089 1089 + # Save a portion of guest memory to a file. 1090 1090 + # 1091 1091 + # @val: the virtual address of the guest to start from 1092 1092 + # 1093 1093 + # @size: the size of memory region to save 1094 1094 + # 1095 1095 + # @filename: the file to save the memory to as binary data 1096 1096 + # 1097 1097 + # @cpu-index: the index of the virtual CPU to use for translating the 1098 1098 + # virtual address (defaults to CPU 0) 1099 1099 + # 1100 1100 + # Returns: Nothing on success 1101 1101 + # 1102 1102 + # Since: 0.14.0 1103 1103 + # 1104 1104 + # Notes: Errors were not reliably returned until 1.1 1105 1105 + # 1106 1106 + # Example: 1107 1107 + # 1108 1108 + # -> { "execute": "memsave", 1109 1109 + # "arguments": { "val": 10, 1110 1110 + # "size": 100, 1111 1111 + # "filename": "/tmp/virtual-mem-dump" } } 1112 1112 + # <- { "return": {} } 1113 1113 + # 1114 1114 + ## 1115 1115 + { 'command': 'memsave', 1116 1116 + 'data': {'val': 'int', 'size': 'int', 'filename': 'str', '*cpu-index': 'int'} } 1117 1117 + 1118 1118 + ## 1119 1119 + # @pmemsave: 1120 1120 + # 1121 1121 + # Save a portion of guest physical memory to a file. 1122 1122 + # 1123 1123 + # @val: the physical address of the guest to start from 1124 1124 + # 1125 1125 + # @size: the size of memory region to save 1126 1126 + # 1127 1127 + # @filename: the file to save the memory to as binary data 1128 1128 + # 1129 1129 + # Returns: Nothing on success 1130 1130 + # 1131 1131 + # Since: 0.14.0 1132 1132 + # 1133 1133 + # Notes: Errors were not reliably returned until 1.1 1134 1134 + # 1135 1135 + # Example: 1136 1136 + # 1137 1137 + # -> { "execute": "pmemsave", 1138 1138 + # "arguments": { "val": 10, 1139 1139 + # "size": 100, 1140 1140 + # "filename": "/tmp/physical-mem-dump" } } 1141 1141 + # <- { "return": {} } 1142 1142 + # 1143 1143 + ## 1144 1144 + { 'command': 'pmemsave', 1145 1145 + 'data': {'val': 'int', 'size': 'int', 'filename': 'str'} } 1146 1146 + 1147 1147 + ## 1148 1148 + # @cont: 1149 1149 + # 1150 1150 + # Resume guest VCPU execution. 1151 1151 + # 1152 1152 + # Since: 0.14.0 1153 1153 + # 1154 1154 + # Returns: If successful, nothing 1155 1155 + # 1156 1156 + # Notes: This command will succeed if the guest is currently running. It 1157 1157 + # will also succeed if the guest is in the "inmigrate" state; in 1158 1158 + # this case, the effect of the command is to make sure the guest 1159 1159 + # starts once migration finishes, removing the effect of the -S 1160 1160 + # command line option if it was passed. 1161 1161 + # 1162 1162 + # Example: 1163 1163 + # 1164 1164 + # -> { "execute": "cont" } 1165 1165 + # <- { "return": {} } 1166 1166 + # 1167 1167 + ## 1168 1168 + { 'command': 'cont' } 1169 1169 + 1170 1170 + ## 1171 1171 + # @system_wakeup: 1172 1172 + # 1173 1173 + # Wakeup guest from suspend. Does nothing in case the guest isn't suspended. 1174 1174 + # 1175 1175 + # Since: 1.1 1176 1176 + # 1177 1177 + # Returns: nothing. 1178 1178 + # 1179 1179 + # Example: 1180 1180 + # 1181 1181 + # -> { "execute": "system_wakeup" } 1182 1182 + # <- { "return": {} } 1183 1183 + # 1184 1184 + ## 1185 1185 + { 'command': 'system_wakeup' } 1186 1186 + 1187 1187 + ## 1188 1188 + # @inject-nmi: 1189 1189 + # 1190 1190 + # Injects a Non-Maskable Interrupt into the default CPU (x86/s390) or all CPUs (ppc64). 1191 1191 + # The command fails when the guest doesn't support injecting. 1192 1192 + # 1193 1193 + # Returns: If successful, nothing 1194 1194 + # 1195 1195 + # Since: 0.14.0 1196 1196 + # 1197 1197 + # Note: prior to 2.1, this command was only supported for x86 and s390 VMs 1198 1198 + # 1199 1199 + # Example: 1200 1200 + # 1201 1201 + # -> { "execute": "inject-nmi" } 1202 1202 + # <- { "return": {} } 1203 1203 + # 1204 1204 + ## 1205 1205 + { 'command': 'inject-nmi' } 1206 1206 + 1207 1207 + ## 1208 1208 + # @balloon: 1209 1209 + # 1210 1210 + # Request the balloon driver to change its balloon size. 1211 1211 + # 1212 1212 + # @value: the target size of the balloon in bytes 1213 1213 + # 1214 1214 + # Returns: Nothing on success 1215 1215 + # If the balloon driver is enabled but not functional because the KVM 1216 1216 + # kernel module cannot support it, KvmMissingCap 1217 1217 + # If no balloon device is present, DeviceNotActive 1218 1218 + # 1219 1219 + # Notes: This command just issues a request to the guest. When it returns, 1220 1220 + # the balloon size may not have changed. A guest can change the balloon 1221 1221 + # size independent of this command. 1222 1222 + # 1223 1223 + # Since: 0.14.0 1224 1224 + # 1225 1225 + # Example: 1226 1226 + # 1227 1227 + # -> { "execute": "balloon", "arguments": { "value": 536870912 } } 1228 1228 + # <- { "return": {} } 1229 1229 + # 1230 1230 + ## 1231 1231 + { 'command': 'balloon', 'data': {'value': 'int'} } 1232 1232 + 1233 1233 + ## 1234 1234 + # @human-monitor-command: 1235 1235 + # 1236 1236 + # Execute a command on the human monitor and return the output. 1237 1237 + # 1238 1238 + # @command-line: the command to execute in the human monitor 1239 1239 + # 1240 1240 + # @cpu-index: The CPU to use for commands that require an implicit CPU 1241 1241 + # 1242 1242 + # Returns: the output of the command as a string 1243 1243 + # 1244 1244 + # Since: 0.14.0 1245 1245 + # 1246 1246 + # Notes: This command only exists as a stop-gap. Its use is highly 1247 1247 + # discouraged. The semantics of this command are not 1248 1248 + # guaranteed: this means that command names, arguments and 1249 1249 + # responses can change or be removed at ANY time. Applications 1250 1250 + # that rely on long term stability guarantees should NOT 1251 1251 + # use this command. 1252 1252 + # 1253 1253 + # Known limitations: 1254 1254 + # 1255 1255 + # * This command is stateless, this means that commands that depend 1256 1256 + # on state information (such as getfd) might not work 1257 1257 + # 1258 1258 + # * Commands that prompt the user for data don't currently work 1259 1259 + # 1260 1260 + # Example: 1261 1261 + # 1262 1262 + # -> { "execute": "human-monitor-command", 1263 1263 + # "arguments": { "command-line": "info kvm" } } 1264 1264 + # <- { "return": "kvm support: enabled\r\n" } 1265 1265 + # 1266 1266 + ## 1267 1267 + { 'command': 'human-monitor-command', 1268 1268 + 'data': {'command-line': 'str', '*cpu-index': 'int'}, 1269 1269 + 'returns': 'str' } 1270 1270 + 1271 1271 + ## 1272 1272 + # @ObjectPropertyInfo: 1273 1273 + # 1274 1274 + # @name: the name of the property 1275 1275 + # 1276 1276 + # @type: the type of the property. This will typically come in one of four 1277 1277 + # forms: 1278 1278 + # 1279 1279 + # 1) A primitive type such as 'u8', 'u16', 'bool', 'str', or 'double'. 1280 1280 + # These types are mapped to the appropriate JSON type. 1281 1281 + # 1282 1282 + # 2) A child type in the form 'child<subtype>' where subtype is a qdev 1283 1283 + # device type name. Child properties create the composition tree. 1284 1284 + # 1285 1285 + # 3) A link type in the form 'link<subtype>' where subtype is a qdev 1286 1286 + # device type name. Link properties form the device model graph. 1287 1287 + # 1288 1288 + # Since: 1.2 1289 1289 + ## 1290 1290 + { 'struct': 'ObjectPropertyInfo', 1291 1291 + 'data': { 'name': 'str', 'type': 'str' } } 1292 1292 + 1293 1293 + ## 1294 1294 + # @qom-list: 1295 1295 + # 1296 1296 + # This command will list any properties of a object given a path in the object 1297 1297 + # model. 1298 1298 + # 1299 1299 + # @path: the path within the object model. See @qom-get for a description of 1300 1300 + # this parameter. 1301 1301 + # 1302 1302 + # Returns: a list of @ObjectPropertyInfo that describe the properties of the 1303 1303 + # object. 1304 1304 + # 1305 1305 + # Since: 1.2 1306 1306 + ## 1307 1307 + { 'command': 'qom-list', 1308 1308 + 'data': { 'path': 'str' }, 1309 1309 + 'returns': [ 'ObjectPropertyInfo' ] } 1310 1310 + 1311 1311 + ## 1312 1312 + # @qom-get: 1313 1313 + # 1314 1314 + # This command will get a property from a object model path and return the 1315 1315 + # value. 1316 1316 + # 1317 1317 + # @path: The path within the object model. There are two forms of supported 1318 1318 + # paths--absolute and partial paths. 1319 1319 + # 1320 1320 + # Absolute paths are derived from the root object and can follow child<> 1321 1321 + # or link<> properties. Since they can follow link<> properties, they 1322 1322 + # can be arbitrarily long. Absolute paths look like absolute filenames 1323 1323 + # and are prefixed with a leading slash. 1324 1324 + # 1325 1325 + # Partial paths look like relative filenames. They do not begin 1326 1326 + # with a prefix. The matching rules for partial paths are subtle but 1327 1327 + # designed to make specifying objects easy. At each level of the 1328 1328 + # composition tree, the partial path is matched as an absolute path. 1329 1329 + # The first match is not returned. At least two matches are searched 1330 1330 + # for. A successful result is only returned if only one match is 1331 1331 + # found. If more than one match is found, a flag is return to 1332 1332 + # indicate that the match was ambiguous. 1333 1333 + # 1334 1334 + # @property: The property name to read 1335 1335 + # 1336 1336 + # Returns: The property value. The type depends on the property 1337 1337 + # type. child<> and link<> properties are returned as #str 1338 1338 + # pathnames. All integer property types (u8, u16, etc) are 1339 1339 + # returned as #int. 1340 1340 + # 1341 1341 + # Since: 1.2 1342 1342 + ## 1343 1343 + { 'command': 'qom-get', 1344 1344 + 'data': { 'path': 'str', 'property': 'str' }, 1345 1345 + 'returns': 'any' } 1346 1346 + 1347 1347 + ## 1348 1348 + # @qom-set: 1349 1349 + # 1350 1350 + # This command will set a property from a object model path. 1351 1351 + # 1352 1352 + # @path: see @qom-get for a description of this parameter 1353 1353 + # 1354 1354 + # @property: the property name to set 1355 1355 + # 1356 1356 + # @value: a value who's type is appropriate for the property type. See @qom-get 1357 1357 + # for a description of type mapping. 1358 1358 + # 1359 1359 + # Since: 1.2 1360 1360 + ## 1361 1361 + { 'command': 'qom-set', 1362 1362 + 'data': { 'path': 'str', 'property': 'str', 'value': 'any' } } 1363 1363 + 1364 1364 + ## 1365 1365 + # @change: 1366 1366 + # 1367 1367 + # This command is multiple commands multiplexed together. 1368 1368 + # 1369 1369 + # @device: This is normally the name of a block device but it may also be 'vnc'. 1370 1370 + # when it's 'vnc', then sub command depends on @target 1371 1371 + # 1372 1372 + # @target: If @device is a block device, then this is the new filename. 1373 1373 + # If @device is 'vnc', then if the value 'password' selects the vnc 1374 1374 + # change password command. Otherwise, this specifies a new server URI 1375 1375 + # address to listen to for VNC connections. 1376 1376 + # 1377 1377 + # @arg: If @device is a block device, then this is an optional format to open 1378 1378 + # the device with. 1379 1379 + # If @device is 'vnc' and @target is 'password', this is the new VNC 1380 1380 + # password to set. See change-vnc-password for additional notes. 1381 1381 + # 1382 1382 + # Returns: Nothing on success. 1383 1383 + # If @device is not a valid block device, DeviceNotFound 1384 1384 + # 1385 1385 + # Notes: This interface is deprecated, and it is strongly recommended that you 1386 1386 + # avoid using it. For changing block devices, use 1387 1387 + # blockdev-change-medium; for changing VNC parameters, use 1388 1388 + # change-vnc-password. 1389 1389 + # 1390 1390 + # Since: 0.14.0 1391 1391 + # 1392 1392 + # Example: 1393 1393 + # 1394 1394 + # 1. Change a removable medium 1395 1395 + # 1396 1396 + # -> { "execute": "change", 1397 1397 + # "arguments": { "device": "ide1-cd0", 1398 1398 + # "target": "/srv/images/Fedora-12-x86_64-DVD.iso" } } 1399 1399 + # <- { "return": {} } 1400 1400 + # 1401 1401 + # 2. Change VNC password 1402 1402 + # 1403 1403 + # -> { "execute": "change", 1404 1404 + # "arguments": { "device": "vnc", "target": "password", 1405 1405 + # "arg": "foobar1" } } 1406 1406 + # <- { "return": {} } 1407 1407 + # 1408 1408 + ## 1409 1409 + { 'command': 'change', 1410 1410 + 'data': {'device': 'str', 'target': 'str', '*arg': 'str'} } 1411 1411 + 1412 1412 + ## 1413 1413 + # @ObjectTypeInfo: 1414 1414 + # 1415 1415 + # This structure describes a search result from @qom-list-types 1416 1416 + # 1417 1417 + # @name: the type name found in the search 1418 1418 + # 1419 1419 + # @abstract: the type is abstract and can't be directly instantiated. 1420 1420 + # Omitted if false. (since 2.10) 1421 1421 + # 1422 1422 + # @parent: Name of parent type, if any (since 2.10) 1423 1423 + # 1424 1424 + # Since: 1.1 1425 1425 + ## 1426 1426 + { 'struct': 'ObjectTypeInfo', 1427 1427 + 'data': { 'name': 'str', '*abstract': 'bool', '*parent': 'str' } } 1428 1428 + 1429 1429 + ## 1430 1430 + # @qom-list-types: 1431 1431 + # 1432 1432 + # This command will return a list of types given search parameters 1433 1433 + # 1434 1434 + # @implements: if specified, only return types that implement this type name 1435 1435 + # 1436 1436 + # @abstract: if true, include abstract types in the results 1437 1437 + # 1438 1438 + # Returns: a list of @ObjectTypeInfo or an empty list if no results are found 1439 1439 + # 1440 1440 + # Since: 1.1 1441 1441 + ## 1442 1442 + { 'command': 'qom-list-types', 1443 1443 + 'data': { '*implements': 'str', '*abstract': 'bool' }, 1444 1444 + 'returns': [ 'ObjectTypeInfo' ] } 1445 1445 + 1446 1446 + ## 1447 1447 + # @DevicePropertyInfo: 1448 1448 + # 1449 1449 + # Information about device properties. 1450 1450 + # 1451 1451 + # @name: the name of the property 1452 1452 + # @type: the typename of the property 1453 1453 + # @description: if specified, the description of the property. 1454 1454 + # (since 2.2) 1455 1455 + # 1456 1456 + # Since: 1.2 1457 1457 + ## 1458 1458 + { 'struct': 'DevicePropertyInfo', 1459 1459 + 'data': { 'name': 'str', 'type': 'str', '*description': 'str' } } 1460 1460 + 1461 1461 + ## 1462 1462 + # @device-list-properties: 1463 1463 + # 1464 1464 + # List properties associated with a device. 1465 1465 + # 1466 1466 + # @typename: the type name of a device 1467 1467 + # 1468 1468 + # Returns: a list of DevicePropertyInfo describing a devices properties 1469 1469 + # 1470 1470 + # Since: 1.2 1471 1471 + ## 1472 1472 + { 'command': 'device-list-properties', 1473 1473 + 'data': { 'typename': 'str'}, 1474 1474 + 'returns': [ 'DevicePropertyInfo' ] } 1475 1475 + 1476 1476 + ## 1477 1477 + # @xen-set-global-dirty-log: 1478 1478 + # 1479 1479 + # Enable or disable the global dirty log mode. 1480 1480 + # 1481 1481 + # @enable: true to enable, false to disable. 1482 1482 + # 1483 1483 + # Returns: nothing 1484 1484 + # 1485 1485 + # Since: 1.3 1486 1486 + # 1487 1487 + # Example: 1488 1488 + # 1489 1489 + # -> { "execute": "xen-set-global-dirty-log", 1490 1490 + # "arguments": { "enable": true } } 1491 1491 + # <- { "return": {} } 1492 1492 + # 1493 1493 + ## 1494 1494 + { 'command': 'xen-set-global-dirty-log', 'data': { 'enable': 'bool' } } 1495 1495 + 1496 1496 + ## 1497 1497 + # @device_add: 1498 1498 + # 1499 1499 + # @driver: the name of the new device's driver 1500 1500 + # 1501 1501 + # @bus: the device's parent bus (device tree path) 1502 1502 + # 1503 1503 + # @id: the device's ID, must be unique 1504 1504 + # 1505 1505 + # Additional arguments depend on the type. 1506 1506 + # 1507 1507 + # Add a device. 1508 1508 + # 1509 1509 + # Notes: 1510 1510 + # 1. For detailed information about this command, please refer to the 1511 1511 + # 'docs/qdev-device-use.txt' file. 1512 1512 + # 1513 1513 + # 2. It's possible to list device properties by running QEMU with the 1514 1514 + # "-device DEVICE,help" command-line argument, where DEVICE is the 1515 1515 + # device's name 1516 1516 + # 1517 1517 + # Example: 1518 1518 + # 1519 1519 + # -> { "execute": "device_add", 1520 1520 + # "arguments": { "driver": "e1000", "id": "net1", 1521 1521 + # "bus": "pci.0", 1522 1522 + # "mac": "52:54:00:12:34:56" } } 1523 1523 + # <- { "return": {} } 1524 1524 + # 1525 1525 + # TODO: This command effectively bypasses QAPI completely due to its 1526 1526 + # "additional arguments" business. It shouldn't have been added to 1527 1527 + # the schema in this form. It should be qapified properly, or 1528 1528 + # replaced by a properly qapified command. 1529 1529 + # 1530 1530 + # Since: 0.13 1531 1531 + ## 1532 1532 + { 'command': 'device_add', 1533 1533 + 'data': {'driver': 'str', '*bus': 'str', '*id': 'str'}, 1534 1534 + 'gen': false } # so we can get the additional arguments 1535 1535 + 1536 1536 + ## 1537 1537 + # @device_del: 1538 1538 + # 1539 1539 + # Remove a device from a guest 1540 1540 + # 1541 1541 + # @id: the device's ID or QOM path 1542 1542 + # 1543 1543 + # Returns: Nothing on success 1544 1544 + # If @id is not a valid device, DeviceNotFound 1545 1545 + # 1546 1546 + # Notes: When this command completes, the device may not be removed from the 1547 1547 + # guest. Hot removal is an operation that requires guest cooperation. 1548 1548 + # This command merely requests that the guest begin the hot removal 1549 1549 + # process. Completion of the device removal process is signaled with a 1550 1550 + # DEVICE_DELETED event. Guest reset will automatically complete removal 1551 1551 + # for all devices. 1552 1552 + # 1553 1553 + # Since: 0.14.0 1554 1554 + # 1555 1555 + # Example: 1556 1556 + # 1557 1557 + # -> { "execute": "device_del", 1558 1558 + # "arguments": { "id": "net1" } } 1559 1559 + # <- { "return": {} } 1560 1560 + # 1561 1561 + # -> { "execute": "device_del", 1562 1562 + # "arguments": { "id": "/machine/peripheral-anon/device[0]" } } 1563 1563 + # <- { "return": {} } 1564 1564 + # 1565 1565 + ## 1566 1566 + { 'command': 'device_del', 'data': {'id': 'str'} } 1567 1567 + 1568 1568 + ## 1569 1569 + # @DEVICE_DELETED: 1570 1570 + # 1571 1571 + # Emitted whenever the device removal completion is acknowledged by the guest. 1572 1572 + # At this point, it's safe to reuse the specified device ID. Device removal can 1573 1573 + # be initiated by the guest or by HMP/QMP commands. 1574 1574 + # 1575 1575 + # @device: device name 1576 1576 + # 1577 1577 + # @path: device path 1578 1578 + # 1579 1579 + # Since: 1.5 1580 1580 + # 1581 1581 + # Example: 1582 1582 + # 1583 1583 + # <- { "event": "DEVICE_DELETED", 1584 1584 + # "data": { "device": "virtio-net-pci-0", 1585 1585 + # "path": "/machine/peripheral/virtio-net-pci-0" }, 1586 1586 + # "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } 1587 1587 + # 1588 1588 + ## 1589 1589 + { 'event': 'DEVICE_DELETED', 1590 1590 + 'data': { '*device': 'str', 'path': 'str' } } 1591 1591 + 1592 1592 + ## 1593 1593 + # @DumpGuestMemoryFormat: 1594 1594 + # 1595 1595 + # An enumeration of guest-memory-dump's format. 1596 1596 + # 1597 1597 + # @elf: elf format 1598 1598 + # 1599 1599 + # @kdump-zlib: kdump-compressed format with zlib-compressed 1600 1600 + # 1601 1601 + # @kdump-lzo: kdump-compressed format with lzo-compressed 1602 1602 + # 1603 1603 + # @kdump-snappy: kdump-compressed format with snappy-compressed 1604 1604 + # 1605 1605 + # Since: 2.0 1606 1606 + ## 1607 1607 + { 'enum': 'DumpGuestMemoryFormat', 1608 1608 + 'data': [ 'elf', 'kdump-zlib', 'kdump-lzo', 'kdump-snappy' ] } 1609 1609 + 1610 1610 + ## 1611 1611 + # @dump-guest-memory: 1612 1612 + # 1613 1613 + # Dump guest's memory to vmcore. It is a synchronous operation that can take 1614 1614 + # very long depending on the amount of guest memory. 1615 1615 + # 1616 1616 + # @paging: if true, do paging to get guest's memory mapping. This allows 1617 1617 + # using gdb to process the core file. 1618 1618 + # 1619 1619 + # IMPORTANT: this option can make QEMU allocate several gigabytes 1620 1620 + # of RAM. This can happen for a large guest, or a 1621 1621 + # malicious guest pretending to be large. 1622 1622 + # 1623 1623 + # Also, paging=true has the following limitations: 1624 1624 + # 1625 1625 + # 1. The guest may be in a catastrophic state or can have corrupted 1626 1626 + # memory, which cannot be trusted 1627 1627 + # 2. The guest can be in real-mode even if paging is enabled. For 1628 1628 + # example, the guest uses ACPI to sleep, and ACPI sleep state 1629 1629 + # goes in real-mode 1630 1630 + # 3. Currently only supported on i386 and x86_64. 1631 1631 + # 1632 1632 + # @protocol: the filename or file descriptor of the vmcore. The supported 1633 1633 + # protocols are: 1634 1634 + # 1635 1635 + # 1. file: the protocol starts with "file:", and the following 1636 1636 + # string is the file's path. 1637 1637 + # 2. fd: the protocol starts with "fd:", and the following string 1638 1638 + # is the fd's name. 1639 1639 + # 1640 1640 + # @detach: if true, QMP will return immediately rather than 1641 1641 + # waiting for the dump to finish. The user can track progress 1642 1642 + # using "query-dump". (since 2.6). 1643 1643 + # 1644 1644 + # @begin: if specified, the starting physical address. 1645 1645 + # 1646 1646 + # @length: if specified, the memory size, in bytes. If you don't 1647 1647 + # want to dump all guest's memory, please specify the start @begin 1648 1648 + # and @length 1649 1649 + # 1650 1650 + # @format: if specified, the format of guest memory dump. But non-elf 1651 1651 + # format is conflict with paging and filter, ie. @paging, @begin and 1652 1652 + # @length is not allowed to be specified with non-elf @format at the 1653 1653 + # same time (since 2.0) 1654 1654 + # 1655 1655 + # Note: All boolean arguments default to false 1656 1656 + # 1657 1657 + # Returns: nothing on success 1658 1658 + # 1659 1659 + # Since: 1.2 1660 1660 + # 1661 1661 + # Example: 1662 1662 + # 1663 1663 + # -> { "execute": "dump-guest-memory", 1664 1664 + # "arguments": { "protocol": "fd:dump" } } 1665 1665 + # <- { "return": {} } 1666 1666 + # 1667 1667 + ## 1668 1668 + { 'command': 'dump-guest-memory', 1669 1669 + 'data': { 'paging': 'bool', 'protocol': 'str', '*detach': 'bool', 1670 1670 + '*begin': 'int', '*length': 'int', 1671 1671 + '*format': 'DumpGuestMemoryFormat'} } 1672 1672 + 1673 1673 + ## 1674 1674 + # @DumpStatus: 1675 1675 + # 1676 1676 + # Describe the status of a long-running background guest memory dump. 1677 1677 + # 1678 1678 + # @none: no dump-guest-memory has started yet. 1679 1679 + # 1680 1680 + # @active: there is one dump running in background. 1681 1681 + # 1682 1682 + # @completed: the last dump has finished successfully. 1683 1683 + # 1684 1684 + # @failed: the last dump has failed. 1685 1685 + # 1686 1686 + # Since: 2.6 1687 1687 + ## 1688 1688 + { 'enum': 'DumpStatus', 1689 1689 + 'data': [ 'none', 'active', 'completed', 'failed' ] } 1690 1690 + 1691 1691 + ## 1692 1692 + # @DumpQueryResult: 1693 1693 + # 1694 1694 + # The result format for 'query-dump'. 1695 1695 + # 1696 1696 + # @status: enum of @DumpStatus, which shows current dump status 1697 1697 + # 1698 1698 + # @completed: bytes written in latest dump (uncompressed) 1699 1699 + # 1700 1700 + # @total: total bytes to be written in latest dump (uncompressed) 1701 1701 + # 1702 1702 + # Since: 2.6 1703 1703 + ## 1704 1704 + { 'struct': 'DumpQueryResult', 1705 1705 + 'data': { 'status': 'DumpStatus', 1706 1706 + 'completed': 'int', 1707 1707 + 'total': 'int' } } 1708 1708 + 1709 1709 + ## 1710 1710 + # @query-dump: 1711 1711 + # 1712 1712 + # Query latest dump status. 1713 1713 + # 1714 1714 + # Returns: A @DumpStatus object showing the dump status. 1715 1715 + # 1716 1716 + # Since: 2.6 1717 1717 + # 1718 1718 + # Example: 1719 1719 + # 1720 1720 + # -> { "execute": "query-dump" } 1721 1721 + # <- { "return": { "status": "active", "completed": 1024000, 1722 1722 + # "total": 2048000 } } 1723 1723 + # 1724 1724 + ## 1725 1725 + { 'command': 'query-dump', 'returns': 'DumpQueryResult' } 1726 1726 + 1727 1727 + ## 1728 1728 + # @DUMP_COMPLETED: 1729 1729 + # 1730 1730 + # Emitted when background dump has completed 1731 1731 + # 1732 1732 + # @result: DumpQueryResult type described in qapi-schema.json. 1733 1733 + # 1734 1734 + # @error: human-readable error string that provides 1735 1735 + # hint on why dump failed. Only presents on failure. The 1736 1736 + # user should not try to interpret the error string. 1737 1737 + # 1738 1738 + # Since: 2.6 1739 1739 + # 1740 1740 + # Example: 1741 1741 + # 1742 1742 + # { "event": "DUMP_COMPLETED", 1743 1743 + # "data": {"result": {"total": 1090650112, "status": "completed", 1744 1744 + # "completed": 1090650112} } } 1745 1745 + # 1746 1746 + ## 1747 1747 + { 'event': 'DUMP_COMPLETED' , 1748 1748 + 'data': { 'result': 'DumpQueryResult', '*error': 'str' } } 1749 1749 + 1750 1750 + ## 1751 1751 + # @DumpGuestMemoryCapability: 1752 1752 + # 1753 1753 + # A list of the available formats for dump-guest-memory 1754 1754 + # 1755 1755 + # Since: 2.0 1756 1756 + ## 1757 1757 + { 'struct': 'DumpGuestMemoryCapability', 1758 1758 + 'data': { 1759 1759 + 'formats': ['DumpGuestMemoryFormat'] } } 1760 1760 + 1761 1761 + ## 1762 1762 + # @query-dump-guest-memory-capability: 1763 1763 + # 1764 1764 + # Returns the available formats for dump-guest-memory 1765 1765 + # 1766 1766 + # Returns: A @DumpGuestMemoryCapability object listing available formats for 1767 1767 + # dump-guest-memory 1768 1768 + # 1769 1769 + # Since: 2.0 1770 1770 + # 1771 1771 + # Example: 1772 1772 + # 1773 1773 + # -> { "execute": "query-dump-guest-memory-capability" } 1774 1774 + # <- { "return": { "formats": 1775 1775 + # ["elf", "kdump-zlib", "kdump-lzo", "kdump-snappy"] } 1776 1776 + # 1777 1777 + ## 1778 1778 + { 'command': 'query-dump-guest-memory-capability', 1779 1779 + 'returns': 'DumpGuestMemoryCapability' } 1780 1780 + 1781 1781 + ## 1782 1782 + # @dump-skeys: 1783 1783 + # 1784 1784 + # Dump guest's storage keys 1785 1785 + # 1786 1786 + # @filename: the path to the file to dump to 1787 1787 + # 1788 1788 + # This command is only supported on s390 architecture. 1789 1789 + # 1790 1790 + # Since: 2.5 1791 1791 + # 1792 1792 + # Example: 1793 1793 + # 1794 1794 + # -> { "execute": "dump-skeys", 1795 1795 + # "arguments": { "filename": "/tmp/skeys" } } 1796 1796 + # <- { "return": {} } 1797 1797 + # 1798 1798 + ## 1799 1799 + { 'command': 'dump-skeys', 1800 1800 + 'data': { 'filename': 'str' } } 1801 1801 + 1802 1802 + ## 1803 1803 + # @object-add: 1804 1804 + # 1805 1805 + # Create a QOM object. 1806 1806 + # 1807 1807 + # @qom-type: the class name for the object to be created 1808 1808 + # 1809 1809 + # @id: the name of the new object 1810 1810 + # 1811 1811 + # @props: a dictionary of properties to be passed to the backend 1812 1812 + # 1813 1813 + # Returns: Nothing on success 1814 1814 + # Error if @qom-type is not a valid class name 1815 1815 + # 1816 1816 + # Since: 2.0 1817 1817 + # 1818 1818 + # Example: 1819 1819 + # 1820 1820 + # -> { "execute": "object-add", 1821 1821 + # "arguments": { "qom-type": "rng-random", "id": "rng1", 1822 1822 + # "props": { "filename": "/dev/hwrng" } } } 1823 1823 + # <- { "return": {} } 1824 1824 + # 1825 1825 + ## 1826 1826 + { 'command': 'object-add', 1827 1827 + 'data': {'qom-type': 'str', 'id': 'str', '*props': 'any'} } 1828 1828 + 1829 1829 + ## 1830 1830 + # @object-del: 1831 1831 + # 1832 1832 + # Remove a QOM object. 1833 1833 + # 1834 1834 + # @id: the name of the QOM object to remove 1835 1835 + # 1836 1836 + # Returns: Nothing on success 1837 1837 + # Error if @id is not a valid id for a QOM object 1838 1838 + # 1839 1839 + # Since: 2.0 1840 1840 + # 1841 1841 + # Example: 1842 1842 + # 1843 1843 + # -> { "execute": "object-del", "arguments": { "id": "rng1" } } 1844 1844 + # <- { "return": {} } 1845 1845 + # 1846 1846 + ## 1847 1847 + { 'command': 'object-del', 'data': {'id': 'str'} } 1848 1848 + 1849 1849 + ## 1850 1850 + # @getfd: 1851 1851 + # 1852 1852 + # Receive a file descriptor via SCM rights and assign it a name 1853 1853 + # 1854 1854 + # @fdname: file descriptor name 1855 1855 + # 1856 1856 + # Returns: Nothing on success 1857 1857 + # 1858 1858 + # Since: 0.14.0 1859 1859 + # 1860 1860 + # Notes: If @fdname already exists, the file descriptor assigned to 1861 1861 + # it will be closed and replaced by the received file 1862 1862 + # descriptor. 1863 1863 + # 1864 1864 + # The 'closefd' command can be used to explicitly close the 1865 1865 + # file descriptor when it is no longer needed. 1866 1866 + # 1867 1867 + # Example: 1868 1868 + # 1869 1869 + # -> { "execute": "getfd", "arguments": { "fdname": "fd1" } } 1870 1870 + # <- { "return": {} } 1871 1871 + # 1872 1872 + ## 1873 1873 + { 'command': 'getfd', 'data': {'fdname': 'str'} } 1874 1874 + 1875 1875 + ## 1876 1876 + # @closefd: 1877 1877 + # 1878 1878 + # Close a file descriptor previously passed via SCM rights 1879 1879 + # 1880 1880 + # @fdname: file descriptor name 1881 1881 + # 1882 1882 + # Returns: Nothing on success 1883 1883 + # 1884 1884 + # Since: 0.14.0 1885 1885 + # 1886 1886 + # Example: 1887 1887 + # 1888 1888 + # -> { "execute": "closefd", "arguments": { "fdname": "fd1" } } 1889 1889 + # <- { "return": {} } 1890 1890 + # 1891 1891 + ## 1892 1892 + { 'command': 'closefd', 'data': {'fdname': 'str'} } 1893 1893 + 1894 1894 + ## 1895 1895 + # @MachineInfo: 1896 1896 + # 1897 1897 + # Information describing a machine. 1898 1898 + # 1899 1899 + # @name: the name of the machine 1900 1900 + # 1901 1901 + # @alias: an alias for the machine name 1902 1902 + # 1903 1903 + # @is-default: whether the machine is default 1904 1904 + # 1905 1905 + # @cpu-max: maximum number of CPUs supported by the machine type 1906 1906 + # (since 1.5.0) 1907 1907 + # 1908 1908 + # @hotpluggable-cpus: cpu hotplug via -device is supported (since 2.7.0) 1909 1909 + # 1910 1910 + # Since: 1.2.0 1911 1911 + ## 1912 1912 + { 'struct': 'MachineInfo', 1913 1913 + 'data': { 'name': 'str', '*alias': 'str', 1914 1914 + '*is-default': 'bool', 'cpu-max': 'int', 1915 1915 + 'hotpluggable-cpus': 'bool'} } 1916 1916 + 1917 1917 + ## 1918 1918 + # @query-machines: 1919 1919 + # 1920 1920 + # Return a list of supported machines 1921 1921 + # 1922 1922 + # Returns: a list of MachineInfo 1923 1923 + # 1924 1924 + # Since: 1.2.0 1925 1925 + ## 1926 1926 + { 'command': 'query-machines', 'returns': ['MachineInfo'] } 1927 1927 + 1928 1928 + ## 1929 1929 + # @CpuDefinitionInfo: 1930 1930 + # 1931 1931 + # Virtual CPU definition. 1932 1932 + # 1933 1933 + # @name: the name of the CPU definition 1934 1934 + # 1935 1935 + # @migration-safe: whether a CPU definition can be safely used for 1936 1936 + # migration in combination with a QEMU compatibility machine 1937 1937 + # when migrating between different QMU versions and between 1938 1938 + # hosts with different sets of (hardware or software) 1939 1939 + # capabilities. If not provided, information is not available 1940 1940 + # and callers should not assume the CPU definition to be 1941 1941 + # migration-safe. (since 2.8) 1942 1942 + # 1943 1943 + # @static: whether a CPU definition is static and will not change depending on 1944 1944 + # QEMU version, machine type, machine options and accelerator options. 1945 1945 + # A static model is always migration-safe. (since 2.8) 1946 1946 + # 1947 1947 + # @unavailable-features: List of properties that prevent 1948 1948 + # the CPU model from running in the current 1949 1949 + # host. (since 2.8) 1950 1950 + # @typename: Type name that can be used as argument to @device-list-properties, 1951 1951 + # to introspect properties configurable using -cpu or -global. 1952 1952 + # (since 2.9) 1953 1953 + # 1954 1954 + # @unavailable-features is a list of QOM property names that 1955 1955 + # represent CPU model attributes that prevent the CPU from running. 1956 1956 + # If the QOM property is read-only, that means there's no known 1957 1957 + # way to make the CPU model run in the current host. Implementations 1958 1958 + # that choose not to provide specific information return the 1959 1959 + # property name "type". 1960 1960 + # If the property is read-write, it means that it MAY be possible 1961 1961 + # to run the CPU model in the current host if that property is 1962 1962 + # changed. Management software can use it as hints to suggest or 1963 1963 + # choose an alternative for the user, or just to generate meaningful 1964 1964 + # error messages explaining why the CPU model can't be used. 1965 1965 + # If @unavailable-features is an empty list, the CPU model is 1966 1966 + # runnable using the current host and machine-type. 1967 1967 + # If @unavailable-features is not present, runnability 1968 1968 + # information for the CPU is not available. 1969 1969 + # 1970 1970 + # Since: 1.2.0 1971 1971 + ## 1972 1972 + { 'struct': 'CpuDefinitionInfo', 1973 1973 + 'data': { 'name': 'str', '*migration-safe': 'bool', 'static': 'bool', 1974 1974 + '*unavailable-features': [ 'str' ], 'typename': 'str' } } 1975 1975 + 1976 1976 + ## 1977 1977 + # @MemoryInfo: 1978 1978 + # 1979 1979 + # Actual memory information in bytes. 1980 1980 + # 1981 1981 + # @base-memory: size of "base" memory specified with command line 1982 1982 + # option -m. 1983 1983 + # 1984 1984 + # @plugged-memory: size of memory that can be hot-unplugged. This field 1985 1985 + # is omitted if target doesn't support memory hotplug 1986 1986 + # (i.e. CONFIG_MEM_HOTPLUG not defined on build time). 1987 1987 + # 1988 1988 + # Since: 2.11.0 1989 1989 + ## 1990 1990 + { 'struct': 'MemoryInfo', 1991 1991 + 'data' : { 'base-memory': 'size', '*plugged-memory': 'size' } } 1992 1992 + 1993 1993 + ## 1994 1994 + # @query-memory-size-summary: 1995 1995 + # 1996 1996 + # Return the amount of initially allocated and present hotpluggable (if 1997 1997 + # enabled) memory in bytes. 1998 1998 + # 1999 1999 + # Example: 2000 2000 + # 2001 2001 + # -> { "execute": "query-memory-size-summary" } 2002 2002 + # <- { "return": { "base-memory": 4294967296, "plugged-memory": 0 } } 2003 2003 + # 2004 2004 + # Since: 2.11.0 2005 2005 + ## 2006 2006 + { 'command': 'query-memory-size-summary', 'returns': 'MemoryInfo' } 2007 2007 + 2008 2008 + ## 2009 2009 + # @query-cpu-definitions: 2010 2010 + # 2011 2011 + # Return a list of supported virtual CPU definitions 2012 2012 + # 2013 2013 + # Returns: a list of CpuDefInfo 2014 2014 + # 2015 2015 + # Since: 1.2.0 2016 2016 + ## 2017 2017 + { 'command': 'query-cpu-definitions', 'returns': ['CpuDefinitionInfo'] } 2018 2018 + 2019 2019 + ## 2020 2020 + # @CpuModelInfo: 2021 2021 + # 2022 2022 + # Virtual CPU model. 2023 2023 + # 2024 2024 + # A CPU model consists of the name of a CPU definition, to which 2025 2025 + # delta changes are applied (e.g. features added/removed). Most magic values 2026 2026 + # that an architecture might require should be hidden behind the name. 2027 2027 + # However, if required, architectures can expose relevant properties. 2028 2028 + # 2029 2029 + # @name: the name of the CPU definition the model is based on 2030 2030 + # @props: a dictionary of QOM properties to be applied 2031 2031 + # 2032 2032 + # Since: 2.8.0 2033 2033 + ## 2034 2034 + { 'struct': 'CpuModelInfo', 2035 2035 + 'data': { 'name': 'str', 2036 2036 + '*props': 'any' } } 2037 2037 + 2038 2038 + ## 2039 2039 + # @CpuModelExpansionType: 2040 2040 + # 2041 2041 + # An enumeration of CPU model expansion types. 2042 2042 + # 2043 2043 + # @static: Expand to a static CPU model, a combination of a static base 2044 2044 + # model name and property delta changes. As the static base model will 2045 2045 + # never change, the expanded CPU model will be the same, independent of 2046 2046 + # independent of QEMU version, machine type, machine options, and 2047 2047 + # accelerator options. Therefore, the resulting model can be used by 2048 2048 + # tooling without having to specify a compatibility machine - e.g. when 2049 2049 + # displaying the "host" model. static CPU models are migration-safe. 2050 2050 + # 2051 2051 + # @full: Expand all properties. The produced model is not guaranteed to be 2052 2052 + # migration-safe, but allows tooling to get an insight and work with 2053 2053 + # model details. 2054 2054 + # 2055 2055 + # Note: When a non-migration-safe CPU model is expanded in static mode, some 2056 2056 + # features enabled by the CPU model may be omitted, because they can't be 2057 2057 + # implemented by a static CPU model definition (e.g. cache info passthrough and 2058 2058 + # PMU passthrough in x86). If you need an accurate representation of the 2059 2059 + # features enabled by a non-migration-safe CPU model, use @full. If you need a 2060 2060 + # static representation that will keep ABI compatibility even when changing QEMU 2061 2061 + # version or machine-type, use @static (but keep in mind that some features may 2062 2062 + # be omitted). 2063 2063 + # 2064 2064 + # Since: 2.8.0 2065 2065 + ## 2066 2066 + { 'enum': 'CpuModelExpansionType', 2067 2067 + 'data': [ 'static', 'full' ] } 2068 2068 + 2069 2069 + 2070 2070 + ## 2071 2071 + # @CpuModelExpansionInfo: 2072 2072 + # 2073 2073 + # The result of a cpu model expansion. 2074 2074 + # 2075 2075 + # @model: the expanded CpuModelInfo. 2076 2076 + # 2077 2077 + # Since: 2.8.0 2078 2078 + ## 2079 2079 + { 'struct': 'CpuModelExpansionInfo', 2080 2080 + 'data': { 'model': 'CpuModelInfo' } } 2081 2081 + 2082 2082 + 2083 2083 + ## 2084 2084 + # @query-cpu-model-expansion: 2085 2085 + # 2086 2086 + # Expands a given CPU model (or a combination of CPU model + additional options) 2087 2087 + # to different granularities, allowing tooling to get an understanding what a 2088 2088 + # specific CPU model looks like in QEMU under a certain configuration. 2089 2089 + # 2090 2090 + # This interface can be used to query the "host" CPU model. 2091 2091 + # 2092 2092 + # The data returned by this command may be affected by: 2093 2093 + # 2094 2094 + # * QEMU version: CPU models may look different depending on the QEMU version. 2095 2095 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2096 2096 + # * machine-type: CPU model may look different depending on the machine-type. 2097 2097 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2098 2098 + # * machine options (including accelerator): in some architectures, CPU models 2099 2099 + # may look different depending on machine and accelerator options. (Except for 2100 2100 + # CPU models reported as "static" in query-cpu-definitions.) 2101 2101 + # * "-cpu" arguments and global properties: arguments to the -cpu option and 2102 2102 + # global properties may affect expansion of CPU models. Using 2103 2103 + # query-cpu-model-expansion while using these is not advised. 2104 2104 + # 2105 2105 + # Some architectures may not support all expansion types. s390x supports 2106 2106 + # "full" and "static". 2107 2107 + # 2108 2108 + # Returns: a CpuModelExpansionInfo. Returns an error if expanding CPU models is 2109 2109 + # not supported, if the model cannot be expanded, if the model contains 2110 2110 + # an unknown CPU definition name, unknown properties or properties 2111 2111 + # with a wrong type. Also returns an error if an expansion type is 2112 2112 + # not supported. 2113 2113 + # 2114 2114 + # Since: 2.8.0 2115 2115 + ## 2116 2116 + { 'command': 'query-cpu-model-expansion', 2117 2117 + 'data': { 'type': 'CpuModelExpansionType', 2118 2118 + 'model': 'CpuModelInfo' }, 2119 2119 + 'returns': 'CpuModelExpansionInfo' } 2120 2120 + 2121 2121 + ## 2122 2122 + # @CpuModelCompareResult: 2123 2123 + # 2124 2124 + # An enumeration of CPU model comparison results. The result is usually 2125 2125 + # calculated using e.g. CPU features or CPU generations. 2126 2126 + # 2127 2127 + # @incompatible: If model A is incompatible to model B, model A is not 2128 2128 + # guaranteed to run where model B runs and the other way around. 2129 2129 + # 2130 2130 + # @identical: If model A is identical to model B, model A is guaranteed to run 2131 2131 + # where model B runs and the other way around. 2132 2132 + # 2133 2133 + # @superset: If model A is a superset of model B, model B is guaranteed to run 2134 2134 + # where model A runs. There are no guarantees about the other way. 2135 2135 + # 2136 2136 + # @subset: If model A is a subset of model B, model A is guaranteed to run 2137 2137 + # where model B runs. There are no guarantees about the other way. 2138 2138 + # 2139 2139 + # Since: 2.8.0 2140 2140 + ## 2141 2141 + { 'enum': 'CpuModelCompareResult', 2142 2142 + 'data': [ 'incompatible', 'identical', 'superset', 'subset' ] } 2143 2143 + 2144 2144 + ## 2145 2145 + # @CpuModelCompareInfo: 2146 2146 + # 2147 2147 + # The result of a CPU model comparison. 2148 2148 + # 2149 2149 + # @result: The result of the compare operation. 2150 2150 + # @responsible-properties: List of properties that led to the comparison result 2151 2151 + # not being identical. 2152 2152 + # 2153 2153 + # @responsible-properties is a list of QOM property names that led to 2154 2154 + # both CPUs not being detected as identical. For identical models, this 2155 2155 + # list is empty. 2156 2156 + # If a QOM property is read-only, that means there's no known way to make the 2157 2157 + # CPU models identical. If the special property name "type" is included, the 2158 2158 + # models are by definition not identical and cannot be made identical. 2159 2159 + # 2160 2160 + # Since: 2.8.0 2161 2161 + ## 2162 2162 + { 'struct': 'CpuModelCompareInfo', 2163 2163 + 'data': {'result': 'CpuModelCompareResult', 2164 2164 + 'responsible-properties': ['str'] 2165 2165 + } 2166 2166 + } 2167 2167 + 2168 2168 + ## 2169 2169 + # @query-cpu-model-comparison: 2170 2170 + # 2171 2171 + # Compares two CPU models, returning how they compare in a specific 2172 2172 + # configuration. The results indicates how both models compare regarding 2173 2173 + # runnability. This result can be used by tooling to make decisions if a 2174 2174 + # certain CPU model will run in a certain configuration or if a compatible 2175 2175 + # CPU model has to be created by baselining. 2176 2176 + # 2177 2177 + # Usually, a CPU model is compared against the maximum possible CPU model 2178 2178 + # of a certain configuration (e.g. the "host" model for KVM). If that CPU 2179 2179 + # model is identical or a subset, it will run in that configuration. 2180 2180 + # 2181 2181 + # The result returned by this command may be affected by: 2182 2182 + # 2183 2183 + # * QEMU version: CPU models may look different depending on the QEMU version. 2184 2184 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2185 2185 + # * machine-type: CPU model may look different depending on the machine-type. 2186 2186 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2187 2187 + # * machine options (including accelerator): in some architectures, CPU models 2188 2188 + # may look different depending on machine and accelerator options. (Except for 2189 2189 + # CPU models reported as "static" in query-cpu-definitions.) 2190 2190 + # * "-cpu" arguments and global properties: arguments to the -cpu option and 2191 2191 + # global properties may affect expansion of CPU models. Using 2192 2192 + # query-cpu-model-expansion while using these is not advised. 2193 2193 + # 2194 2194 + # Some architectures may not support comparing CPU models. s390x supports 2195 2195 + # comparing CPU models. 2196 2196 + # 2197 2197 + # Returns: a CpuModelBaselineInfo. Returns an error if comparing CPU models is 2198 2198 + # not supported, if a model cannot be used, if a model contains 2199 2199 + # an unknown cpu definition name, unknown properties or properties 2200 2200 + # with wrong types. 2201 2201 + # 2202 2202 + # Since: 2.8.0 2203 2203 + ## 2204 2204 + { 'command': 'query-cpu-model-comparison', 2205 2205 + 'data': { 'modela': 'CpuModelInfo', 'modelb': 'CpuModelInfo' }, 2206 2206 + 'returns': 'CpuModelCompareInfo' } 2207 2207 + 2208 2208 + ## 2209 2209 + # @CpuModelBaselineInfo: 2210 2210 + # 2211 2211 + # The result of a CPU model baseline. 2212 2212 + # 2213 2213 + # @model: the baselined CpuModelInfo. 2214 2214 + # 2215 2215 + # Since: 2.8.0 2216 2216 + ## 2217 2217 + { 'struct': 'CpuModelBaselineInfo', 2218 2218 + 'data': { 'model': 'CpuModelInfo' } } 2219 2219 + 2220 2220 + ## 2221 2221 + # @query-cpu-model-baseline: 2222 2222 + # 2223 2223 + # Baseline two CPU models, creating a compatible third model. The created 2224 2224 + # model will always be a static, migration-safe CPU model (see "static" 2225 2225 + # CPU model expansion for details). 2226 2226 + # 2227 2227 + # This interface can be used by tooling to create a compatible CPU model out 2228 2228 + # two CPU models. The created CPU model will be identical to or a subset of 2229 2229 + # both CPU models when comparing them. Therefore, the created CPU model is 2230 2230 + # guaranteed to run where the given CPU models run. 2231 2231 + # 2232 2232 + # The result returned by this command may be affected by: 2233 2233 + # 2234 2234 + # * QEMU version: CPU models may look different depending on the QEMU version. 2235 2235 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2236 2236 + # * machine-type: CPU model may look different depending on the machine-type. 2237 2237 + # (Except for CPU models reported as "static" in query-cpu-definitions.) 2238 2238 + # * machine options (including accelerator): in some architectures, CPU models 2239 2239 + # may look different depending on machine and accelerator options. (Except for 2240 2240 + # CPU models reported as "static" in query-cpu-definitions.) 2241 2241 + # * "-cpu" arguments and global properties: arguments to the -cpu option and 2242 2242 + # global properties may affect expansion of CPU models. Using 2243 2243 + # query-cpu-model-expansion while using these is not advised. 2244 2244 + # 2245 2245 + # Some architectures may not support baselining CPU models. s390x supports 2246 2246 + # baselining CPU models. 2247 2247 + # 2248 2248 + # Returns: a CpuModelBaselineInfo. Returns an error if baselining CPU models is 2249 2249 + # not supported, if a model cannot be used, if a model contains 2250 2250 + # an unknown cpu definition name, unknown properties or properties 2251 2251 + # with wrong types. 2252 2252 + # 2253 2253 + # Since: 2.8.0 2254 2254 + ## 2255 2255 + { 'command': 'query-cpu-model-baseline', 2256 2256 + 'data': { 'modela': 'CpuModelInfo', 2257 2257 + 'modelb': 'CpuModelInfo' }, 2258 2258 + 'returns': 'CpuModelBaselineInfo' } 2259 2259 + 2260 2260 + ## 2261 2261 + # @AddfdInfo: 2262 2262 + # 2263 2263 + # Information about a file descriptor that was added to an fd set. 2264 2264 + # 2265 2265 + # @fdset-id: The ID of the fd set that @fd was added to. 2266 2266 + # 2267 2267 + # @fd: The file descriptor that was received via SCM rights and 2268 2268 + # added to the fd set. 2269 2269 + # 2270 2270 + # Since: 1.2.0 2271 2271 + ## 2272 2272 + { 'struct': 'AddfdInfo', 'data': {'fdset-id': 'int', 'fd': 'int'} } 2273 2273 + 2274 2274 + ## 2275 2275 + # @add-fd: 2276 2276 + # 2277 2277 + # Add a file descriptor, that was passed via SCM rights, to an fd set. 2278 2278 + # 2279 2279 + # @fdset-id: The ID of the fd set to add the file descriptor to. 2280 2280 + # 2281 2281 + # @opaque: A free-form string that can be used to describe the fd. 2282 2282 + # 2283 2283 + # Returns: @AddfdInfo on success 2284 2284 + # 2285 2285 + # If file descriptor was not received, FdNotSupplied 2286 2286 + # 2287 2287 + # If @fdset-id is a negative value, InvalidParameterValue 2288 2288 + # 2289 2289 + # Notes: The list of fd sets is shared by all monitor connections. 2290 2290 + # 2291 2291 + # If @fdset-id is not specified, a new fd set will be created. 2292 2292 + # 2293 2293 + # Since: 1.2.0 2294 2294 + # 2295 2295 + # Example: 2296 2296 + # 2297 2297 + # -> { "execute": "add-fd", "arguments": { "fdset-id": 1 } } 2298 2298 + # <- { "return": { "fdset-id": 1, "fd": 3 } } 2299 2299 + # 2300 2300 + ## 2301 2301 + { 'command': 'add-fd', 'data': {'*fdset-id': 'int', '*opaque': 'str'}, 2302 2302 + 'returns': 'AddfdInfo' } 2303 2303 + 2304 2304 + ## 2305 2305 + # @remove-fd: 2306 2306 + # 2307 2307 + # Remove a file descriptor from an fd set. 2308 2308 + # 2309 2309 + # @fdset-id: The ID of the fd set that the file descriptor belongs to. 2310 2310 + # 2311 2311 + # @fd: The file descriptor that is to be removed. 2312 2312 + # 2313 2313 + # Returns: Nothing on success 2314 2314 + # If @fdset-id or @fd is not found, FdNotFound 2315 2315 + # 2316 2316 + # Since: 1.2.0 2317 2317 + # 2318 2318 + # Notes: The list of fd sets is shared by all monitor connections. 2319 2319 + # 2320 2320 + # If @fd is not specified, all file descriptors in @fdset-id 2321 2321 + # will be removed. 2322 2322 + # 2323 2323 + # Example: 2324 2324 + # 2325 2325 + # -> { "execute": "remove-fd", "arguments": { "fdset-id": 1, "fd": 3 } } 2326 2326 + # <- { "return": {} } 2327 2327 + # 2328 2328 + ## 2329 2329 + { 'command': 'remove-fd', 'data': {'fdset-id': 'int', '*fd': 'int'} } 2330 2330 + 2331 2331 + ## 2332 2332 + # @FdsetFdInfo: 2333 2333 + # 2334 2334 + # Information about a file descriptor that belongs to an fd set. 2335 2335 + # 2336 2336 + # @fd: The file descriptor value. 2337 2337 + # 2338 2338 + # @opaque: A free-form string that can be used to describe the fd. 2339 2339 + # 2340 2340 + # Since: 1.2.0 2341 2341 + ## 2342 2342 + { 'struct': 'FdsetFdInfo', 2343 2343 + 'data': {'fd': 'int', '*opaque': 'str'} } 2344 2344 + 2345 2345 + ## 2346 2346 + # @FdsetInfo: 2347 2347 + # 2348 2348 + # Information about an fd set. 2349 2349 + # 2350 2350 + # @fdset-id: The ID of the fd set. 2351 2351 + # 2352 2352 + # @fds: A list of file descriptors that belong to this fd set. 2353 2353 + # 2354 2354 + # Since: 1.2.0 2355 2355 + ## 2356 2356 + { 'struct': 'FdsetInfo', 2357 2357 + 'data': {'fdset-id': 'int', 'fds': ['FdsetFdInfo']} } 2358 2358 + 2359 2359 + ## 2360 2360 + # @query-fdsets: 2361 2361 + # 2362 2362 + # Return information describing all fd sets. 2363 2363 + # 2364 2364 + # Returns: A list of @FdsetInfo 2365 2365 + # 2366 2366 + # Since: 1.2.0 2367 2367 + # 2368 2368 + # Note: The list of fd sets is shared by all monitor connections. 2369 2369 + # 2370 2370 + # Example: 2371 2371 + # 2372 2372 + # -> { "execute": "query-fdsets" } 2373 2373 + # <- { "return": [ 2374 2374 + # { 2375 2375 + # "fds": [ 2376 2376 + # { 2377 2377 + # "fd": 30, 2378 2378 + # "opaque": "rdonly:/path/to/file" 2379 2379 + # }, 2380 2380 + # { 2381 2381 + # "fd": 24, 2382 2382 + # "opaque": "rdwr:/path/to/file" 2383 2383 + # } 2384 2384 + # ], 2385 2385 + # "fdset-id": 1 2386 2386 + # }, 2387 2387 + # { 2388 2388 + # "fds": [ 2389 2389 + # { 2390 2390 + # "fd": 28 2391 2391 + # }, 2392 2392 + # { 2393 2393 + # "fd": 29 2394 2394 + # } 2395 2395 + # ], 2396 2396 + # "fdset-id": 0 2397 2397 + # } 2398 2398 + # ] 2399 2399 + # } 2400 2400 + # 2401 2401 + ## 2402 2402 + { 'command': 'query-fdsets', 'returns': ['FdsetInfo'] } 2403 2403 + 2404 2404 + ## 2405 2405 + # @TargetInfo: 2406 2406 + # 2407 2407 + # Information describing the QEMU target. 2408 2408 + # 2409 2409 + # @arch: the target architecture (eg "x86_64", "i386", etc) 2410 2410 + # 2411 2411 + # Since: 1.2.0 2412 2412 + ## 2413 2413 + { 'struct': 'TargetInfo', 2414 2414 + 'data': { 'arch': 'str' } } 2415 2415 + 2416 2416 + ## 2417 2417 + # @query-target: 2418 2418 + # 2419 2419 + # Return information about the target for this QEMU 2420 2420 + # 2421 2421 + # Returns: TargetInfo 2422 2422 + # 2423 2423 + # Since: 1.2.0 2424 2424 + ## 2425 2425 + { 'command': 'query-target', 'returns': 'TargetInfo' } 2426 2426 + 2427 2427 + ## 2428 2428 + # @AcpiTableOptions: 2429 2429 + # 2430 2430 + # Specify an ACPI table on the command line to load. 2431 2431 + # 2432 2432 + # At most one of @file and @data can be specified. The list of files specified 2433 2433 + # by any one of them is loaded and concatenated in order. If both are omitted, 2434 2434 + # @data is implied. 2435 2435 + # 2436 2436 + # Other fields / optargs can be used to override fields of the generic ACPI 2437 2437 + # table header; refer to the ACPI specification 5.0, section 5.2.6 System 2438 2438 + # Description Table Header. If a header field is not overridden, then the 2439 2439 + # corresponding value from the concatenated blob is used (in case of @file), or 2440 2440 + # it is filled in with a hard-coded value (in case of @data). 2441 2441 + # 2442 2442 + # String fields are copied into the matching ACPI member from lowest address 2443 2443 + # upwards, and silently truncated / NUL-padded to length. 2444 2444 + # 2445 2445 + # @sig: table signature / identifier (4 bytes) 2446 2446 + # 2447 2447 + # @rev: table revision number (dependent on signature, 1 byte) 2448 2448 + # 2449 2449 + # @oem_id: OEM identifier (6 bytes) 2450 2450 + # 2451 2451 + # @oem_table_id: OEM table identifier (8 bytes) 2452 2452 + # 2453 2453 + # @oem_rev: OEM-supplied revision number (4 bytes) 2454 2454 + # 2455 2455 + # @asl_compiler_id: identifier of the utility that created the table 2456 2456 + # (4 bytes) 2457 2457 + # 2458 2458 + # @asl_compiler_rev: revision number of the utility that created the 2459 2459 + # table (4 bytes) 2460 2460 + # 2461 2461 + # @file: colon (:) separated list of pathnames to load and 2462 2462 + # concatenate as table data. The resultant binary blob is expected to 2463 2463 + # have an ACPI table header. At least one file is required. This field 2464 2464 + # excludes @data. 2465 2465 + # 2466 2466 + # @data: colon (:) separated list of pathnames to load and 2467 2467 + # concatenate as table data. The resultant binary blob must not have an 2468 2468 + # ACPI table header. At least one file is required. This field excludes 2469 2469 + # @file. 2470 2470 + # 2471 2471 + # Since: 1.5 2472 2472 + ## 2473 2473 + { 'struct': 'AcpiTableOptions', 2474 2474 + 'data': { 2475 2475 + '*sig': 'str', 2476 2476 + '*rev': 'uint8', 2477 2477 + '*oem_id': 'str', 2478 2478 + '*oem_table_id': 'str', 2479 2479 + '*oem_rev': 'uint32', 2480 2480 + '*asl_compiler_id': 'str', 2481 2481 + '*asl_compiler_rev': 'uint32', 2482 2482 + '*file': 'str', 2483 2483 + '*data': 'str' }} 2484 2484 + 2485 2485 + ## 2486 2486 + # @CommandLineParameterType: 2487 2487 + # 2488 2488 + # Possible types for an option parameter. 2489 2489 + # 2490 2490 + # @string: accepts a character string 2491 2491 + # 2492 2492 + # @boolean: accepts "on" or "off" 2493 2493 + # 2494 2494 + # @number: accepts a number 2495 2495 + # 2496 2496 + # @size: accepts a number followed by an optional suffix (K)ilo, 2497 2497 + # (M)ega, (G)iga, (T)era 2498 2498 + # 2499 2499 + # Since: 1.5 2500 2500 + ## 2501 2501 + { 'enum': 'CommandLineParameterType', 2502 2502 + 'data': ['string', 'boolean', 'number', 'size'] } 2503 2503 + 2504 2504 + ## 2505 2505 + # @CommandLineParameterInfo: 2506 2506 + # 2507 2507 + # Details about a single parameter of a command line option. 2508 2508 + # 2509 2509 + # @name: parameter name 2510 2510 + # 2511 2511 + # @type: parameter @CommandLineParameterType 2512 2512 + # 2513 2513 + # @help: human readable text string, not suitable for parsing. 2514 2514 + # 2515 2515 + # @default: default value string (since 2.1) 2516 2516 + # 2517 2517 + # Since: 1.5 2518 2518 + ## 2519 2519 + { 'struct': 'CommandLineParameterInfo', 2520 2520 + 'data': { 'name': 'str', 2521 2521 + 'type': 'CommandLineParameterType', 2522 2522 + '*help': 'str', 2523 2523 + '*default': 'str' } } 2524 2524 + 2525 2525 + ## 2526 2526 + # @CommandLineOptionInfo: 2527 2527 + # 2528 2528 + # Details about a command line option, including its list of parameter details 2529 2529 + # 2530 2530 + # @option: option name 2531 2531 + # 2532 2532 + # @parameters: an array of @CommandLineParameterInfo 2533 2533 + # 2534 2534 + # Since: 1.5 2535 2535 + ## 2536 2536 + { 'struct': 'CommandLineOptionInfo', 2537 2537 + 'data': { 'option': 'str', 'parameters': ['CommandLineParameterInfo'] } } 2538 2538 + 2539 2539 + ## 2540 2540 + # @query-command-line-options: 2541 2541 + # 2542 2542 + # Query command line option schema. 2543 2543 + # 2544 2544 + # @option: option name 2545 2545 + # 2546 2546 + # Returns: list of @CommandLineOptionInfo for all options (or for the given 2547 2547 + # @option). Returns an error if the given @option doesn't exist. 2548 2548 + # 2549 2549 + # Since: 1.5 2550 2550 + # 2551 2551 + # Example: 2552 2552 + # 2553 2553 + # -> { "execute": "query-command-line-options", 2554 2554 + # "arguments": { "option": "option-rom" } } 2555 2555 + # <- { "return": [ 2556 2556 + # { 2557 2557 + # "parameters": [ 2558 2558 + # { 2559 2559 + # "name": "romfile", 2560 2560 + # "type": "string" 2561 2561 + # }, 2562 2562 + # { 2563 2563 + # "name": "bootindex", 2564 2564 + # "type": "number" 2565 2565 + # } 2566 2566 + # ], 2567 2567 + # "option": "option-rom" 2568 2568 + # } 2569 2569 + # ] 2570 2570 + # } 2571 2571 + # 2572 2572 + ## 2573 2573 + {'command': 'query-command-line-options', 'data': { '*option': 'str' }, 2574 2574 + 'returns': ['CommandLineOptionInfo'] } 2575 2575 + 2576 2576 + ## 2577 2577 + # @X86CPURegister32: 2578 2578 + # 2579 2579 + # A X86 32-bit register 2580 2580 + # 2581 2581 + # Since: 1.5 2582 2582 + ## 2583 2583 + { 'enum': 'X86CPURegister32', 2584 2584 + 'data': [ 'EAX', 'EBX', 'ECX', 'EDX', 'ESP', 'EBP', 'ESI', 'EDI' ] } 2585 2585 + 2586 2586 + ## 2587 2587 + # @X86CPUFeatureWordInfo: 2588 2588 + # 2589 2589 + # Information about a X86 CPU feature word 2590 2590 + # 2591 2591 + # @cpuid-input-eax: Input EAX value for CPUID instruction for that feature word 2592 2592 + # 2593 2593 + # @cpuid-input-ecx: Input ECX value for CPUID instruction for that 2594 2594 + # feature word 2595 2595 + # 2596 2596 + # @cpuid-register: Output register containing the feature bits 2597 2597 + # 2598 2598 + # @features: value of output register, containing the feature bits 2599 2599 + # 2600 2600 + # Since: 1.5 2601 2601 + ## 2602 2602 + { 'struct': 'X86CPUFeatureWordInfo', 2603 2603 + 'data': { 'cpuid-input-eax': 'int', 2604 2604 + '*cpuid-input-ecx': 'int', 2605 2605 + 'cpuid-register': 'X86CPURegister32', 2606 2606 + 'features': 'int' } } 2607 2607 + 2608 2608 + ## 2609 2609 + # @DummyForceArrays: 2610 2610 + # 2611 2611 + # Not used by QMP; hack to let us use X86CPUFeatureWordInfoList internally 2612 2612 + # 2613 2613 + # Since: 2.5 2614 2614 + ## 2615 2615 + { 'struct': 'DummyForceArrays', 2616 2616 + 'data': { 'unused': ['X86CPUFeatureWordInfo'] } } 2617 2617 + 2618 2618 + 2619 2619 + ## 2620 2620 + # @NumaOptionsType: 2621 2621 + # 2622 2622 + # @node: NUMA nodes configuration 2623 2623 + # 2624 2624 + # @dist: NUMA distance configuration (since 2.10) 2625 2625 + # 2626 2626 + # @cpu: property based CPU(s) to node mapping (Since: 2.10) 2627 2627 + # 2628 2628 + # Since: 2.1 2629 2629 + ## 2630 2630 + { 'enum': 'NumaOptionsType', 2631 2631 + 'data': [ 'node', 'dist', 'cpu' ] } 2632 2632 + 2633 2633 + ## 2634 2634 + # @NumaOptions: 2635 2635 + # 2636 2636 + # A discriminated record of NUMA options. (for OptsVisitor) 2637 2637 + # 2638 2638 + # Since: 2.1 2639 2639 + ## 2640 2640 + { 'union': 'NumaOptions', 2641 2641 + 'base': { 'type': 'NumaOptionsType' }, 2642 2642 + 'discriminator': 'type', 2643 2643 + 'data': { 2644 2644 + 'node': 'NumaNodeOptions', 2645 2645 + 'dist': 'NumaDistOptions', 2646 2646 + 'cpu': 'NumaCpuOptions' }} 2647 2647 + 2648 2648 + ## 2649 2649 + # @NumaNodeOptions: 2650 2650 + # 2651 2651 + # Create a guest NUMA node. (for OptsVisitor) 2652 2652 + # 2653 2653 + # @nodeid: NUMA node ID (increase by 1 from 0 if omitted) 2654 2654 + # 2655 2655 + # @cpus: VCPUs belonging to this node (assign VCPUS round-robin 2656 2656 + # if omitted) 2657 2657 + # 2658 2658 + # @mem: memory size of this node; mutually exclusive with @memdev. 2659 2659 + # Equally divide total memory among nodes if both @mem and @memdev are 2660 2660 + # omitted. 2661 2661 + # 2662 2662 + # @memdev: memory backend object. If specified for one node, 2663 2663 + # it must be specified for all nodes. 2664 2664 + # 2665 2665 + # Since: 2.1 2666 2666 + ## 2667 2667 + { 'struct': 'NumaNodeOptions', 2668 2668 + 'data': { 2669 2669 + '*nodeid': 'uint16', 2670 2670 + '*cpus': ['uint16'], 2671 2671 + '*mem': 'size', 2672 2672 + '*memdev': 'str' }} 2673 2673 + 2674 2674 + ## 2675 2675 + # @NumaDistOptions: 2676 2676 + # 2677 2677 + # Set the distance between 2 NUMA nodes. 2678 2678 + # 2679 2679 + # @src: source NUMA node. 2680 2680 + # 2681 2681 + # @dst: destination NUMA node. 2682 2682 + # 2683 2683 + # @val: NUMA distance from source node to destination node. 2684 2684 + # When a node is unreachable from another node, set the distance 2685 2685 + # between them to 255. 2686 2686 + # 2687 2687 + # Since: 2.10 2688 2688 + ## 2689 2689 + { 'struct': 'NumaDistOptions', 2690 2690 + 'data': { 2691 2691 + 'src': 'uint16', 2692 2692 + 'dst': 'uint16', 2693 2693 + 'val': 'uint8' }} 2694 2694 + 2695 2695 + ## 2696 2696 + # @NumaCpuOptions: 2697 2697 + # 2698 2698 + # Option "-numa cpu" overrides default cpu to node mapping. 2699 2699 + # It accepts the same set of cpu properties as returned by 2700 2700 + # query-hotpluggable-cpus[].props, where node-id could be used to 2701 2701 + # override default node mapping. 2702 2702 + # 2703 2703 + # Since: 2.10 2704 2704 + ## 2705 2705 + { 'struct': 'NumaCpuOptions', 2706 2706 + 'base': 'CpuInstanceProperties', 2707 2707 + 'data' : {} } 2708 2708 + 2709 2709 + ## 2710 2710 + # @HostMemPolicy: 2711 2711 + # 2712 2712 + # Host memory policy types 2713 2713 + # 2714 2714 + # @default: restore default policy, remove any nondefault policy 2715 2715 + # 2716 2716 + # @preferred: set the preferred host nodes for allocation 2717 2717 + # 2718 2718 + # @bind: a strict policy that restricts memory allocation to the 2719 2719 + # host nodes specified 2720 2720 + # 2721 2721 + # @interleave: memory allocations are interleaved across the set 2722 2722 + # of host nodes specified 2723 2723 + # 2724 2724 + # Since: 2.1 2725 2725 + ## 2726 2726 + { 'enum': 'HostMemPolicy', 2727 2727 + 'data': [ 'default', 'preferred', 'bind', 'interleave' ] } 2728 2728 + 2729 2729 + ## 2730 2730 + # @Memdev: 2731 2731 + # 2732 2732 + # Information about memory backend 2733 2733 + # 2734 2734 + # @id: backend's ID if backend has 'id' property (since 2.9) 2735 2735 + # 2736 2736 + # @size: memory backend size 2737 2737 + # 2738 2738 + # @merge: enables or disables memory merge support 2739 2739 + # 2740 2740 + # @dump: includes memory backend's memory in a core dump or not 2741 2741 + # 2742 2742 + # @prealloc: enables or disables memory preallocation 2743 2743 + # 2744 2744 + # @host-nodes: host nodes for its memory policy 2745 2745 + # 2746 2746 + # @policy: memory policy of memory backend 2747 2747 + # 2748 2748 + # Since: 2.1 2749 2749 + ## 2750 2750 + { 'struct': 'Memdev', 2751 2751 + 'data': { 2752 2752 + '*id': 'str', 2753 2753 + 'size': 'size', 2754 2754 + 'merge': 'bool', 2755 2755 + 'dump': 'bool', 2756 2756 + 'prealloc': 'bool', 2757 2757 + 'host-nodes': ['uint16'], 2758 2758 + 'policy': 'HostMemPolicy' }} 2759 2759 + 2760 2760 + ## 2761 2761 + # @query-memdev: 2762 2762 + # 2763 2763 + # Returns information for all memory backends. 2764 2764 + # 2765 2765 + # Returns: a list of @Memdev. 2766 2766 + # 2767 2767 + # Since: 2.1 2768 2768 + # 2769 2769 + # Example: 2770 2770 + # 2771 2771 + # -> { "execute": "query-memdev" } 2772 2772 + # <- { "return": [ 2773 2773 + # { 2774 2774 + # "id": "mem1", 2775 2775 + # "size": 536870912, 2776 2776 + # "merge": false, 2777 2777 + # "dump": true, 2778 2778 + # "prealloc": false, 2779 2779 + # "host-nodes": [0, 1], 2780 2780 + # "policy": "bind" 2781 2781 + # }, 2782 2782 + # { 2783 2783 + # "size": 536870912, 2784 2784 + # "merge": false, 2785 2785 + # "dump": true, 2786 2786 + # "prealloc": true, 2787 2787 + # "host-nodes": [2, 3], 2788 2788 + # "policy": "preferred" 2789 2789 + # } 2790 2790 + # ] 2791 2791 + # } 2792 2792 + # 2793 2793 + ## 2794 2794 + { 'command': 'query-memdev', 'returns': ['Memdev'] } 2795 2795 + 2796 2796 + ## 2797 2797 + # @PCDIMMDeviceInfo: 2798 2798 + # 2799 2799 + # PCDIMMDevice state information 2800 2800 + # 2801 2801 + # @id: device's ID 2802 2802 + # 2803 2803 + # @addr: physical address, where device is mapped 2804 2804 + # 2805 2805 + # @size: size of memory that the device provides 2806 2806 + # 2807 2807 + # @slot: slot number at which device is plugged in 2808 2808 + # 2809 2809 + # @node: NUMA node number where device is plugged in 2810 2810 + # 2811 2811 + # @memdev: memory backend linked with device 2812 2812 + # 2813 2813 + # @hotplugged: true if device was hotplugged 2814 2814 + # 2815 2815 + # @hotpluggable: true if device if could be added/removed while machine is running 2816 2816 + # 2817 2817 + # Since: 2.1 2818 2818 + ## 2819 2819 + { 'struct': 'PCDIMMDeviceInfo', 2820 2820 + 'data': { '*id': 'str', 2821 2821 + 'addr': 'int', 2822 2822 + 'size': 'int', 2823 2823 + 'slot': 'int', 2824 2824 + 'node': 'int', 2825 2825 + 'memdev': 'str', 2826 2826 + 'hotplugged': 'bool', 2827 2827 + 'hotpluggable': 'bool' 2828 2828 + } 2829 2829 + } 2830 2830 + 2831 2831 + ## 2832 2832 + # @MemoryDeviceInfo: 2833 2833 + # 2834 2834 + # Union containing information about a memory device 2835 2835 + # 2836 2836 + # Since: 2.1 2837 2837 + ## 2838 2838 + { 'union': 'MemoryDeviceInfo', 'data': {'dimm': 'PCDIMMDeviceInfo'} } 2839 2839 + 2840 2840 + ## 2841 2841 + # @query-memory-devices: 2842 2842 + # 2843 2843 + # Lists available memory devices and their state 2844 2844 + # 2845 2845 + # Since: 2.1 2846 2846 + # 2847 2847 + # Example: 2848 2848 + # 2849 2849 + # -> { "execute": "query-memory-devices" } 2850 2850 + # <- { "return": [ { "data": 2851 2851 + # { "addr": 5368709120, 2852 2852 + # "hotpluggable": true, 2853 2853 + # "hotplugged": true, 2854 2854 + # "id": "d1", 2855 2855 + # "memdev": "/objects/memX", 2856 2856 + # "node": 0, 2857 2857 + # "size": 1073741824, 2858 2858 + # "slot": 0}, 2859 2859 + # "type": "dimm" 2860 2860 + # } ] } 2861 2861 + # 2862 2862 + ## 2863 2863 + { 'command': 'query-memory-devices', 'returns': ['MemoryDeviceInfo'] } 2864 2864 + 2865 2865 + ## 2866 2866 + # @MEM_UNPLUG_ERROR: 2867 2867 + # 2868 2868 + # Emitted when memory hot unplug error occurs. 2869 2869 + # 2870 2870 + # @device: device name 2871 2871 + # 2872 2872 + # @msg: Informative message 2873 2873 + # 2874 2874 + # Since: 2.4 2875 2875 + # 2876 2876 + # Example: 2877 2877 + # 2878 2878 + # <- { "event": "MEM_UNPLUG_ERROR" 2879 2879 + # "data": { "device": "dimm1", 2880 2880 + # "msg": "acpi: device unplug for unsupported device" 2881 2881 + # }, 2882 2882 + # "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } 2883 2883 + # 2884 2884 + ## 2885 2885 + { 'event': 'MEM_UNPLUG_ERROR', 2886 2886 + 'data': { 'device': 'str', 'msg': 'str' } } 2887 2887 + 2888 2888 + ## 2889 2889 + # @ACPISlotType: 2890 2890 + # 2891 2891 + # @DIMM: memory slot 2892 2892 + # @CPU: logical CPU slot (since 2.7) 2893 2893 + ## 2894 2894 + { 'enum': 'ACPISlotType', 'data': [ 'DIMM', 'CPU' ] } 2895 2895 + 2896 2896 + ## 2897 2897 + # @ACPIOSTInfo: 2898 2898 + # 2899 2899 + # OSPM Status Indication for a device 2900 2900 + # For description of possible values of @source and @status fields 2901 2901 + # see "_OST (OSPM Status Indication)" chapter of ACPI5.0 spec. 2902 2902 + # 2903 2903 + # @device: device ID associated with slot 2904 2904 + # 2905 2905 + # @slot: slot ID, unique per slot of a given @slot-type 2906 2906 + # 2907 2907 + # @slot-type: type of the slot 2908 2908 + # 2909 2909 + # @source: an integer containing the source event 2910 2910 + # 2911 2911 + # @status: an integer containing the status code 2912 2912 + # 2913 2913 + # Since: 2.1 2914 2914 + ## 2915 2915 + { 'struct': 'ACPIOSTInfo', 2916 2916 + 'data' : { '*device': 'str', 2917 2917 + 'slot': 'str', 2918 2918 + 'slot-type': 'ACPISlotType', 2919 2919 + 'source': 'int', 2920 2920 + 'status': 'int' } } 2921 2921 + 2922 2922 + ## 2923 2923 + # @query-acpi-ospm-status: 2924 2924 + # 2925 2925 + # Return a list of ACPIOSTInfo for devices that support status 2926 2926 + # reporting via ACPI _OST method. 2927 2927 + # 2928 2928 + # Since: 2.1 2929 2929 + # 2930 2930 + # Example: 2931 2931 + # 2932 2932 + # -> { "execute": "query-acpi-ospm-status" } 2933 2933 + # <- { "return": [ { "device": "d1", "slot": "0", "slot-type": "DIMM", "source": 1, "status": 0}, 2934 2934 + # { "slot": "1", "slot-type": "DIMM", "source": 0, "status": 0}, 2935 2935 + # { "slot": "2", "slot-type": "DIMM", "source": 0, "status": 0}, 2936 2936 + # { "slot": "3", "slot-type": "DIMM", "source": 0, "status": 0} 2937 2937 + # ]} 2938 2938 + # 2939 2939 + ## 2940 2940 + { 'command': 'query-acpi-ospm-status', 'returns': ['ACPIOSTInfo'] } 2941 2941 + 2942 2942 + ## 2943 2943 + # @ACPI_DEVICE_OST: 2944 2944 + # 2945 2945 + # Emitted when guest executes ACPI _OST method. 2946 2946 + # 2947 2947 + # @info: ACPIOSTInfo type as described in qapi-schema.json 2948 2948 + # 2949 2949 + # Since: 2.1 2950 2950 + # 2951 2951 + # Example: 2952 2952 + # 2953 2953 + # <- { "event": "ACPI_DEVICE_OST", 2954 2954 + # "data": { "device": "d1", "slot": "0", 2955 2955 + # "slot-type": "DIMM", "source": 1, "status": 0 } } 2956 2956 + # 2957 2957 + ## 2958 2958 + { 'event': 'ACPI_DEVICE_OST', 2959 2959 + 'data': { 'info': 'ACPIOSTInfo' } } 2960 2960 + 2961 2961 + ## 2962 2962 + # @rtc-reset-reinjection: 2963 2963 + # 2964 2964 + # This command will reset the RTC interrupt reinjection backlog. 2965 2965 + # Can be used if another mechanism to synchronize guest time 2966 2966 + # is in effect, for example QEMU guest agent's guest-set-time 2967 2967 + # command. 2968 2968 + # 2969 2969 + # Since: 2.1 2970 2970 + # 2971 2971 + # Example: 2972 2972 + # 2973 2973 + # -> { "execute": "rtc-reset-reinjection" } 2974 2974 + # <- { "return": {} } 2975 2975 + # 2976 2976 + ## 2977 2977 + { 'command': 'rtc-reset-reinjection' } 2978 2978 + 2979 2979 + ## 2980 2980 + # @RTC_CHANGE: 2981 2981 + # 2982 2982 + # Emitted when the guest changes the RTC time. 2983 2983 + # 2984 2984 + # @offset: offset between base RTC clock (as specified by -rtc base), and 2985 2985 + # new RTC clock value 2986 2986 + # 2987 2987 + # Note: This event is rate-limited. 2988 2988 + # 2989 2989 + # Since: 0.13.0 2990 2990 + # 2991 2991 + # Example: 2992 2992 + # 2993 2993 + # <- { "event": "RTC_CHANGE", 2994 2994 + # "data": { "offset": 78 }, 2995 2995 + # "timestamp": { "seconds": 1267020223, "microseconds": 435656 } } 2996 2996 + # 2997 2997 + ## 2998 2998 + { 'event': 'RTC_CHANGE', 2999 2999 + 'data': { 'offset': 'int' } } 3000 3000 + 3001 3001 + ## 3002 3002 + # @ReplayMode: 3003 3003 + # 3004 3004 + # Mode of the replay subsystem. 3005 3005 + # 3006 3006 + # @none: normal execution mode. Replay or record are not enabled. 3007 3007 + # 3008 3008 + # @record: record mode. All non-deterministic data is written into the 3009 3009 + # replay log. 3010 3010 + # 3011 3011 + # @play: replay mode. Non-deterministic data required for system execution 3012 3012 + # is read from the log. 3013 3013 + # 3014 3014 + # Since: 2.5 3015 3015 + ## 3016 3016 + { 'enum': 'ReplayMode', 3017 3017 + 'data': [ 'none', 'record', 'play' ] } 3018 3018 + 3019 3019 + ## 3020 3020 + # @xen-load-devices-state: 3021 3021 + # 3022 3022 + # Load the state of all devices from file. The RAM and the block devices 3023 3023 + # of the VM are not loaded by this command. 3024 3024 + # 3025 3025 + # @filename: the file to load the state of the devices from as binary 3026 3026 + # data. See xen-save-devices-state.txt for a description of the binary 3027 3027 + # format. 3028 3028 + # 3029 3029 + # Since: 2.7 3030 3030 + # 3031 3031 + # Example: 3032 3032 + # 3033 3033 + # -> { "execute": "xen-load-devices-state", 3034 3034 + # "arguments": { "filename": "/tmp/resume" } } 3035 3035 + # <- { "return": {} } 3036 3036 + # 3037 3037 + ## 3038 3038 + { 'command': 'xen-load-devices-state', 'data': {'filename': 'str'} } 3039 3039 + 3040 3040 + ## 3041 3041 + # @GICCapability: 3042 3042 + # 3043 3043 + # The struct describes capability for a specific GIC (Generic 3044 3044 + # Interrupt Controller) version. These bits are not only decided by 3045 3045 + # QEMU/KVM software version, but also decided by the hardware that 3046 3046 + # the program is running upon. 3047 3047 + # 3048 3048 + # @version: version of GIC to be described. Currently, only 2 and 3 3049 3049 + # are supported. 3050 3050 + # 3051 3051 + # @emulated: whether current QEMU/hardware supports emulated GIC 3052 3052 + # device in user space. 3053 3053 + # 3054 3054 + # @kernel: whether current QEMU/hardware supports hardware 3055 3055 + # accelerated GIC device in kernel. 3056 3056 + # 3057 3057 + # Since: 2.6 3058 3058 + ## 3059 3059 + { 'struct': 'GICCapability', 3060 3060 + 'data': { 'version': 'int', 3061 3061 + 'emulated': 'bool', 3062 3062 + 'kernel': 'bool' } } 3063 3063 + 3064 3064 + ## 3065 3065 + # @query-gic-capabilities: 3066 3066 + # 3067 3067 + # This command is ARM-only. It will return a list of GICCapability 3068 3068 + # objects that describe its capability bits. 3069 3069 + # 3070 3070 + # Returns: a list of GICCapability objects. 3071 3071 + # 3072 3072 + # Since: 2.6 3073 3073 + # 3074 3074 + # Example: 3075 3075 + # 3076 3076 + # -> { "execute": "query-gic-capabilities" } 3077 3077 + # <- { "return": [{ "version": 2, "emulated": true, "kernel": false }, 3078 3078 + # { "version": 3, "emulated": false, "kernel": true } ] } 3079 3079 + # 3080 3080 + ## 3081 3081 + { 'command': 'query-gic-capabilities', 'returns': ['GICCapability'] } 3082 3082 + 3083 3083 + ## 3084 3084 + # @CpuInstanceProperties: 3085 3085 + # 3086 3086 + # List of properties to be used for hotplugging a CPU instance, 3087 3087 + # it should be passed by management with device_add command when 3088 3088 + # a CPU is being hotplugged. 3089 3089 + # 3090 3090 + # @node-id: NUMA node ID the CPU belongs to 3091 3091 + # @socket-id: socket number within node/board the CPU belongs to 3092 3092 + # @core-id: core number within socket the CPU belongs to 3093 3093 + # @thread-id: thread number within core the CPU belongs to 3094 3094 + # 3095 3095 + # Note: currently there are 4 properties that could be present 3096 3096 + # but management should be prepared to pass through other 3097 3097 + # properties with device_add command to allow for future 3098 3098 + # interface extension. This also requires the filed names to be kept in 3099 3099 + # sync with the properties passed to -device/device_add. 3100 3100 + # 3101 3101 + # Since: 2.7 3102 3102 + ## 3103 3103 + { 'struct': 'CpuInstanceProperties', 3104 3104 + 'data': { '*node-id': 'int', 3105 3105 + '*socket-id': 'int', 3106 3106 + '*core-id': 'int', 3107 3107 + '*thread-id': 'int' 3108 3108 + } 3109 3109 + } 3110 3110 + 3111 3111 + ## 3112 3112 + # @HotpluggableCPU: 3113 3113 + # 3114 3114 + # @type: CPU object type for usage with device_add command 3115 3115 + # @props: list of properties to be used for hotplugging CPU 3116 3116 + # @vcpus-count: number of logical VCPU threads @HotpluggableCPU provides 3117 3117 + # @qom-path: link to existing CPU object if CPU is present or 3118 3118 + # omitted if CPU is not present. 3119 3119 + # 3120 3120 + # Since: 2.7 3121 3121 + ## 3122 3122 + { 'struct': 'HotpluggableCPU', 3123 3123 + 'data': { 'type': 'str', 3124 3124 + 'vcpus-count': 'int', 3125 3125 + 'props': 'CpuInstanceProperties', 3126 3126 + '*qom-path': 'str' 3127 3127 + } 3128 3128 + } 3129 3129 + 3130 3130 + ## 3131 3131 + # @query-hotpluggable-cpus: 3132 3132 + # 3133 3133 + # Returns: a list of HotpluggableCPU objects. 3134 3134 + # 3135 3135 + # Since: 2.7 3136 3136 + # 3137 3137 + # Example: 3138 3138 + # 3139 3139 + # For pseries machine type started with -smp 2,cores=2,maxcpus=4 -cpu POWER8: 3140 3140 + # 3141 3141 + # -> { "execute": "query-hotpluggable-cpus" } 3142 3142 + # <- {"return": [ 3143 3143 + # { "props": { "core": 8 }, "type": "POWER8-spapr-cpu-core", 3144 3144 + # "vcpus-count": 1 }, 3145 3145 + # { "props": { "core": 0 }, "type": "POWER8-spapr-cpu-core", 3146 3146 + # "vcpus-count": 1, "qom-path": "/machine/unattached/device[0]"} 3147 3147 + # ]}' 3148 3148 + # 3149 3149 + # For pc machine type started with -smp 1,maxcpus=2: 3150 3150 + # 3151 3151 + # -> { "execute": "query-hotpluggable-cpus" } 3152 3152 + # <- {"return": [ 3153 3153 + # { 3154 3154 + # "type": "qemu64-x86_64-cpu", "vcpus-count": 1, 3155 3155 + # "props": {"core-id": 0, "socket-id": 1, "thread-id": 0} 3156 3156 + # }, 3157 3157 + # { 3158 3158 + # "qom-path": "/machine/unattached/device[0]", 3159 3159 + # "type": "qemu64-x86_64-cpu", "vcpus-count": 1, 3160 3160 + # "props": {"core-id": 0, "socket-id": 0, "thread-id": 0} 3161 3161 + # } 3162 3162 + # ]} 3163 3163 + # 3164 3164 + # For s390x-virtio-ccw machine type started with -smp 1,maxcpus=2 -cpu qemu 3165 3165 + # (Since: 2.11): 3166 3166 + # 3167 3167 + # -> { "execute": "query-hotpluggable-cpus" } 3168 3168 + # <- {"return": [ 3169 3169 + # { 3170 3170 + # "type": "qemu-s390x-cpu", "vcpus-count": 1, 3171 3171 + # "props": { "core-id": 1 } 3172 3172 + # }, 3173 3173 + # { 3174 3174 + # "qom-path": "/machine/unattached/device[0]", 3175 3175 + # "type": "qemu-s390x-cpu", "vcpus-count": 1, 3176 3176 + # "props": { "core-id": 0 } 3177 3177 + # } 3178 3178 + # ]} 3179 3179 + # 3180 3180 + ## 3181 3181 + { 'command': 'query-hotpluggable-cpus', 'returns': ['HotpluggableCPU'] } 3182 3182 + 3183 3183 + ## 3184 3184 + # @GuidInfo: 3185 3185 + # 3186 3186 + # GUID information. 3187 3187 + # 3188 3188 + # @guid: the globally unique identifier 3189 3189 + # 3190 3190 + # Since: 2.9 3191 3191 + ## 3192 3192 + { 'struct': 'GuidInfo', 'data': {'guid': 'str'} } 3193 3193 + 3194 3194 + ## 3195 3195 + # @query-vm-generation-id: 3196 3196 + # 3197 3197 + # Show Virtual Machine Generation ID 3198 3198 + # 3199 3199 + # Since: 2.9 3200 3200 + ## 3201 3201 + { 'command': 'query-vm-generation-id', 'returns': 'GuidInfo' }

+1 -1

qdev-monitor.c

··· 22 22 #include "hw/sysbus.h" 23 23 #include "monitor/monitor.h" 24 24 #include "monitor/qdev.h" 25 25 - #include "qmp-commands.h" 26 25 #include "sysemu/arch_init.h" 27 26 #include "qapi/error.h" 27 27 + #include "qapi/qapi-commands-misc.h" 28 28 #include "qapi/qmp/qdict.h" 29 29 #include "qapi/qmp/qerror.h" 30 30 #include "qemu/config-file.h"

+3 -1

qmp.c

··· 21 21 #include "sysemu/sysemu.h" 22 22 #include "qemu/config-file.h" 23 23 #include "qemu/uuid.h" 24 24 - #include "qmp-commands.h" 25 24 #include "chardev/char.h" 26 25 #include "ui/qemu-spice.h" 27 26 #include "ui/vnc.h" ··· 32 31 #include "sysemu/block-backend.h" 33 32 #include "qom/qom-qobject.h" 34 33 #include "qapi/error.h" 34 34 + #include "qapi/qapi-commands-block-core.h" 35 35 + #include "qapi/qapi-commands-misc.h" 36 36 + #include "qapi/qapi-commands-ui.h" 35 37 #include "qapi/qmp/qdict.h" 36 38 #include "qapi/qmp/qerror.h" 37 39 #include "qapi/qobject-input-visitor.h"

+1 -1

stubs/uuid.c

··· 1 1 #include "qemu/osdep.h" 2 2 #include "qemu-common.h" 3 3 + #include "qapi/qapi-commands-misc.h" 3 4 #include "qemu/uuid.h" 4 4 - #include "qmp-commands.h" 5 5 6 6 UuidInfo *qmp_query_uuid(Error **errp) 7 7 {

+1 -1

stubs/vmgenid.c

··· 1 1 #include "qemu/osdep.h" 2 2 - #include "qmp-commands.h" 3 2 #include "qapi/error.h" 3 3 + #include "qapi/qapi-commands-misc.h" 4 4 #include "qapi/qmp/qerror.h" 5 5 6 6 GuidInfo *qmp_query_vm_generation_id(Error **errp)

+1 -1

stubs/xen-hvm.c

··· 12 12 #include "qemu-common.h" 13 13 #include "hw/xen/xen.h" 14 14 #include "exec/memory.h" 15 15 - #include "qmp-commands.h" 15 15 + #include "qapi/qapi-commands-misc.h" 16 16 17 17 int xen_pci_slot_get_pirq(PCIDevice *pci_dev, int irq_num) 18 18 {

+2 -1

target/arm/monitor.c

··· 19 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 20 20 * THE SOFTWARE. 21 21 */ 22 22 + 22 23 #include "qemu/osdep.h" 23 23 - #include "qmp-commands.h" 24 24 #include "hw/boards.h" 25 25 #include "kvm_arm.h" 26 26 + #include "qapi/qapi-commands-misc.h" 26 27 27 28 static GICCapability *gic_cap_new(int version) 28 29 {

+2 -2

target/i386/cpu.c

··· 31 31 #include "qemu/option.h" 32 32 #include "qemu/config-file.h" 33 33 #include "qapi/error.h" 34 34 + #include "qapi/qapi-visit-misc.h" 35 35 + #include "qapi/qapi-visit-run-state.h" 34 36 #include "qapi/qmp/qdict.h" 35 37 #include "qapi/qmp/qerror.h" 36 36 - 37 37 - #include "qapi-visit.h" 38 38 #include "qapi/visitor.h" 39 39 #include "qom/qom-qobject.h" 40 40 #include "sysemu/arch_init.h"

+2 -1

target/s390x/cpu.c

··· 35 35 #include "qemu/error-report.h" 36 36 #include "trace.h" 37 37 #include "qapi/visitor.h" 38 38 - #include "qapi-visit.h" 38 38 + #include "qapi/qapi-visit-misc.h" 39 39 + #include "qapi/qapi-visit-run-state.h" 39 40 #include "sysemu/hw_accel.h" 40 41 #include "exec/exec-all.h" 41 42 #include "hw/qdev-properties.h"

+1 -1

target/s390x/sigp.c

··· 17 17 #include "exec/exec-all.h" 18 18 #include "sysemu/sysemu.h" 19 19 #include "trace.h" 20 20 - #include "qapi-types.h" 20 20 + #include "qapi/qapi-types-misc.h" 21 21 22 22 QemuMutex qemu_sigp_mutex; 23 23

+2 -1

tests/qmp-test.c

··· 12 12 13 13 #include "qemu/osdep.h" 14 14 #include "libqtest.h" 15 15 - #include "qapi-visit.h" 16 15 #include "qapi/error.h" 16 16 + #include "qapi/qapi-visit-introspect.h" 17 17 + #include "qapi/qapi-visit-misc.h" 17 18 #include "qapi/qmp/qdict.h" 18 19 #include "qapi/qmp/qlist.h" 19 20 #include "qapi/qobject-input-visitor.h"

+1 -1

tests/test-qobject-input-visitor.c

··· 15 15 16 16 #include "qemu-common.h" 17 17 #include "qapi/error.h" 18 18 + #include "qapi/qapi-visit-introspect.h" 18 19 #include "qapi/qobject-input-visitor.h" 19 20 #include "test-qapi-visit.h" 20 21 #include "qapi/qmp/qbool.h" ··· 25 26 #include "qapi/qmp/qjson.h" 26 27 #include "test-qmp-introspect.h" 27 28 #include "qmp-introspect.h" 28 28 - #include "qapi-visit.h" 29 29 30 30 typedef struct TestInputVisitorData { 31 31 QObject *obj;

-1

tests/test-visitor-serialization.c

··· 23 23 #include "qapi/qobject-output-visitor.h" 24 24 #include "qapi/string-input-visitor.h" 25 25 #include "qapi/string-output-visitor.h" 26 26 - #include "qapi-visit.h" 27 26 #include "qapi/dealloc-visitor.h" 28 27 29 28 enum PrimitiveTypeKind {

+1 -1

ui/gtk.c

··· 37 37 #include "qemu/osdep.h" 38 38 #include "qemu-common.h" 39 39 #include "qapi/error.h" 40 40 + #include "qapi/qapi-commands-misc.h" 40 41 #include "qemu/cutils.h" 41 42 42 43 #include "ui/console.h" ··· 52 53 #include "trace.h" 53 54 #include "ui/input.h" 54 55 #include "sysemu/sysemu.h" 55 55 - #include "qmp-commands.h" 56 56 #include "keymaps.h" 57 57 #include "chardev/char.h" 58 58 #include "qom/object.h"

+1 -1

util/qemu-config.c

··· 1 1 #include "qemu/osdep.h" 2 2 #include "qapi/error.h" 3 3 + #include "qapi/qapi-commands-misc.h" 3 4 #include "qapi/qmp/qdict.h" 4 5 #include "qapi/qmp/qlist.h" 5 6 #include "qemu-common.h" 6 7 #include "qemu/error-report.h" 7 8 #include "qemu/option.h" 8 9 #include "qemu/config-file.h" 9 9 - #include "qmp-commands.h" 10 10 11 11 static QemuOptsList *vm_config_groups[48]; 12 12 static QemuOptsList *drive_config_groups[5];

+3 -1

vl.c

··· 100 100 #include "qemu/option.h" 101 101 #include "qemu/config-file.h" 102 102 #include "qemu-options.h" 103 103 - #include "qmp-commands.h" 104 103 #include "qemu/main-loop.h" 105 104 #ifdef CONFIG_VIRTFS 106 105 #include "fsdev/qemu-fsdev.h" ··· 126 125 #include "sysemu/replay.h" 127 126 #include "qapi/qapi-events-run-state.h" 128 127 #include "qapi/qapi-visit-block-core.h" 128 128 + #include "qapi/qapi-commands-block-core.h" 129 129 + #include "qapi/qapi-commands-misc.h" 130 130 + #include "qapi/qapi-commands-run-state.h" 129 131 #include "qapi/qmp/qerror.h" 130 132 #include "sysemu/iothread.h" 131 133