1 HXCOMM QMP dispatch table and documentation
2 HXCOMM Text between SQMP and EQMP is copied to the QMP documention file and
3 HXCOMM does not show up
in the other formats
.
9 This document describes all commands currently supported by QMP
.
11 Most of the time their usage is exactly the same as
in the user Monitor
, this
12 means that any other document which also describe
commands (the manpage
,
13 QEMU
's manual, etc) can and should be consulted.
15 QMP has two types of commands: regular and query commands. Regular commands
16 usually change the Virtual Machine's state someway
, while query commands just
17 return information
. The sections below are divided accordingly
.
19 It
's important to observe that all communication examples are formatted in
20 a reader-friendly way, so that they're easier to understand
. However
, in real
21 protocol usage
, they
're emitted as a single line.
23 Also, the following notation is used to denote data flow:
25 -> data issued by the Client
26 <- Server data response
28 Please, refer to the QMP specification (QMP/qmp-spec.txt) for detailed
29 information on the Server command and response formats.
31 NOTE: This document is temporary and will be replaced soon.
33 1. Stability Considerations
34 ===========================
36 The current QMP command set (described in this file) may be useful for a
37 number of use cases, however it's limited and several commands have bad
38 defined semantics
, specially with regard to command completion
.
40 These problems are going to be solved incrementally
in the next QEMU releases
41 and we
're going to establish a deprecation policy for badly defined commands.
43 If you're planning to adopt QMP
, please observe the following
:
45 1. The deprecation policy will take effect and be documented soon
, please
46 check the documentation of each used command as soon as a
new release of
49 2. DO NOT rely on anything which is not explicit documented
51 3. Errors
, in special
, are not documented
. Applications should NOT check
52 for specific errors classes or
data (it
's strongly recommended to only
53 check for the "error" key)
58 Server's responses
in the examples below are always a success response
, please
59 refer to the QMP specification
for more details on error responses
.
66 .mhandler
.cmd_new
= qmp_marshal_input_quit
,
79 -> { "execute": "quit" }
86 .args_type
= "force:-f,device:B",
87 .mhandler
.cmd_new
= qmp_marshal_input_eject
,
94 Eject a removable medium
.
98 - force
: force
ejection (json
-bool
, optional
)
99 - device
: device
name (json
-string
)
103 -> { "execute": "eject", "arguments": { "device": "ide1-cd0" } }
106 Note
: The
"force" argument defaults to
false.
112 .args_type
= "device:B,target:F,arg:s?",
113 .mhandler
.cmd_new
= qmp_marshal_input_change
,
120 Change a removable medium or VNC configuration
.
124 - "device": device
name (json
-string
)
125 - "target": filename or
item (json
-string
)
126 - "arg": additional
argument (json
-string
, optional
)
130 1. Change a removable medium
132 -> { "execute": "change",
133 "arguments": { "device": "ide1-cd0",
134 "target": "/srv/images/Fedora-12-x86_64-DVD.iso" } }
137 2. Change VNC password
139 -> { "execute": "change",
140 "arguments": { "device": "vnc", "target": "password",
147 .name
= "screendump",
148 .args_type
= "filename:F",
149 .mhandler
.cmd_new
= qmp_marshal_input_screendump
,
156 Save screen into PPM image
.
160 - "filename": file
path (json
-string
)
164 -> { "execute": "screendump", "arguments": { "filename": "/tmp/image" } }
172 .mhandler
.cmd_new
= qmp_marshal_input_stop
,
185 -> { "execute": "stop" }
193 .mhandler
.cmd_new
= qmp_marshal_input_cont
,
206 -> { "execute": "cont" }
212 .name
= "system_wakeup",
214 .mhandler
.cmd_new
= qmp_marshal_input_system_wakeup
,
221 Wakeup guest from suspend
.
227 -> { "execute": "system_wakeup" }
233 .name
= "system_reset",
235 .mhandler
.cmd_new
= qmp_marshal_input_system_reset
,
248 -> { "execute": "system_reset" }
254 .name
= "system_powerdown",
256 .mhandler
.cmd_new
= qmp_marshal_input_system_powerdown
,
263 Send system power down event
.
269 -> { "execute": "system_powerdown" }
275 .name
= "device_add",
276 .args_type
= "device:O",
277 .params
= "driver[,prop=value][,...]",
278 .help
= "add device, like -device on the command line",
279 .user_print
= monitor_user_noop
,
280 .mhandler
.cmd_new
= do_device_add
,
291 - "driver": the name of the
new device
's driver (json-string)
292 - "bus": the device's parent
bus (device tree path
, json
-string
, optional
)
293 - "id": the device
's ID, must be unique (json-string)
298 -> { "execute": "device_add", "arguments": { "driver": "e1000", "id": "net1" } }
303 (1) For detailed information about this command, please refer to the
304 'docs
/qdev
-device
-use
.txt
' file.
306 (2) It's possible to list device properties by running QEMU with the
307 "-device DEVICE,\?" command
-line argument
, where DEVICE is the device
's name
312 .name = "device_del",
314 .mhandler.cmd_new = qmp_marshal_input_device_del,
325 - "id": the device's
ID (json
-string
)
329 -> { "execute": "device_del", "arguments": { "id": "net1" } }
336 .args_type
= "keys:O,hold-time:i?",
337 .mhandler
.cmd_new
= qmp_marshal_input_send_key
,
349 - "key": key
sequence (a json
-array of key
enum values
)
351 - hold
-time
: time to delay key up events
, milliseconds
. Defaults to
100
356 -> { "execute": "send-key",
357 "arguments": { 'keys': [ 'ctrl', 'alt', 'delete' ] } }
364 .args_type
= "index:i",
365 .mhandler
.cmd_new
= qmp_marshal_input_cpu
,
376 - "index": the CPU
's index (json-int)
380 -> { "execute": "cpu", "arguments": { "index": 0 } }
383 Note: CPUs' indexes are obtained with the
'query-cpus' command
.
389 .args_type
= "val:l,size:i,filename:s,cpu:i?",
390 .mhandler
.cmd_new
= qmp_marshal_input_memsave
,
397 Save to disk virtual memory dump starting at
'val' of size
'size'.
401 - "val": the starting
address (json
-int
)
402 - "size": the memory size
, in bytes (json
-int
)
403 - "filename": file
path (json
-string
)
404 - "cpu": virtual CPU
index (json
-int
, optional
)
408 -> { "execute": "memsave",
409 "arguments": { "val": 10,
411 "filename": "/tmp/virtual-mem-dump" } }
418 .args_type
= "val:l,size:i,filename:s",
419 .mhandler
.cmd_new
= qmp_marshal_input_pmemsave
,
426 Save to disk physical memory dump starting at
'val' of size
'size'.
430 - "val": the starting
address (json
-int
)
431 - "size": the memory size
, in bytes (json
-int
)
432 - "filename": file
path (json
-string
)
436 -> { "execute": "pmemsave",
437 "arguments": { "val": 10,
439 "filename": "/tmp/physical-mem-dump" } }
445 .name
= "inject-nmi",
447 .mhandler
.cmd_new
= qmp_marshal_input_inject_nmi
,
454 Inject an NMI on guest
's CPUs.
460 -> { "execute": "inject-nmi" }
463 Note: inject-nmi fails when the guest doesn't support injecting
.
464 Currently
, only x86 guests
do.
469 .name
= "xen-save-devices-state",
470 .args_type
= "filename:F",
471 .mhandler
.cmd_new
= qmp_marshal_input_xen_save_devices_state
,
475 xen
-save
-devices
-state
478 Save the state of all devices to file
. The RAM and the block devices
479 of the VM are not saved by
this command
.
483 - "filename": the file to save the state of the devices to as binary
484 data
. See xen
-save
-devices
-state
.txt
for a description of the binary
489 -> { "execute": "xen-save-devices-state",
490 "arguments": { "filename": "/tmp/save" } }
496 .name
= "xen-set-global-dirty-log",
497 .args_type
= "enable:b",
498 .mhandler
.cmd_new
= qmp_marshal_input_xen_set_global_dirty_log
,
502 xen
-set
-global
-dirty
-log
505 Enable or disable the global dirty log mode
.
509 - "enable": Enable it or disable it
.
513 -> { "execute": "xen-set-global-dirty-log",
514 "arguments": { "enable": true } }
521 .args_type
= "detach:-d,blk:-b,inc:-i,uri:s",
522 .mhandler
.cmd_new
= qmp_marshal_input_migrate
,
533 - "blk": block migration
, full disk
copy (json
-bool
, optional
)
534 - "inc": incremental disk
copy (json
-bool
, optional
)
535 - "uri": Destination
URI (json
-string
)
539 -> { "execute": "migrate", "arguments": { "uri": "tcp:0:4446" } }
544 (1) The
'query-migrate' command should be used to check migration
's progress
545 and final result (this information is provided by the 'status
' member)
546 (2) All boolean arguments default to false
547 (3) The user Monitor's
"detach" argument is invalid
in QMP and should not
553 .name
= "migrate_cancel",
555 .mhandler
.cmd_new
= qmp_marshal_input_migrate_cancel
,
562 Cancel the current migration
.
568 -> { "execute": "migrate_cancel" }
573 .name
= "migrate-set-cache-size",
574 .args_type
= "value:o",
575 .mhandler
.cmd_new
= qmp_marshal_input_migrate_set_cache_size
,
579 migrate
-set
-cache
-size
580 ---------------------
582 Set cache size to be used by XBZRLE migration
, the cache size will be rounded
583 down to the nearest power of
2
587 - "value": cache size
in bytes (json
-int
)
591 -> { "execute": "migrate-set-cache-size", "arguments": { "value": 536870912 } }
596 .name
= "query-migrate-cache-size",
598 .mhandler
.cmd_new
= qmp_marshal_input_query_migrate_cache_size
,
602 query
-migrate
-cache
-size
603 ---------------------
605 Show cache size to be used by XBZRLE migration
607 returns a json
-object with the following information
:
612 -> { "execute": "query-migrate-cache-size" }
613 <- { "return": 67108864 }
618 .name
= "migrate_set_speed",
619 .args_type
= "value:o",
620 .mhandler
.cmd_new
= qmp_marshal_input_migrate_set_speed
,
627 Set maximum speed
for migrations
.
631 - "value": maximum speed
, in bytes per
second (json
-int
)
635 -> { "execute": "migrate_set_speed", "arguments": { "value": 1024 } }
641 .name
= "migrate_set_downtime",
642 .args_type
= "value:T",
643 .mhandler
.cmd_new
= qmp_marshal_input_migrate_set_downtime
,
650 Set maximum tolerated
downtime (in seconds
) for migrations
.
654 - "value": maximum
downtime (json
-number
)
658 -> { "execute": "migrate_set_downtime", "arguments": { "value": 0.1 } }
664 .name
= "client_migrate_info",
665 .args_type
= "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
666 .params
= "protocol hostname port tls-port cert-subject",
667 .help
= "send migration info to spice/vnc client",
668 .user_print
= monitor_user_noop
,
669 .mhandler
.cmd_async
= client_migrate_info
,
670 .flags
= MONITOR_CMD_ASYNC
,
677 Set the spice
/vnc connection info
for the migration target
. The spice
/vnc
678 server will ask the spice
/vnc client to automatically reconnect
using the
679 new parameters (if specified
) once the vm migration finished successfully
.
683 - "protocol": protocol
: "spice" or
"vnc" (json
-string
)
684 - "hostname": migration target
hostname (json
-string
)
685 - "port": spice
/vnc tcp port
for plaintext
channels (json
-int
, optional
)
686 - "tls-port": spice tcp port
for tls
-secured
channels (json
-int
, optional
)
687 - "cert-subject": server certificate
subject (json
-string
, optional
)
691 -> { "execute": "client_migrate_info",
692 "arguments": { "protocol": "spice",
693 "hostname": "virt42.lab.kraxel.org",
700 .name
= "dump-guest-memory",
701 .args_type
= "paging:b,protocol:s,begin:i?,end:i?",
702 .params
= "-p protocol [begin] [length]",
703 .help
= "dump guest memory to file",
704 .user_print
= monitor_user_noop
,
705 .mhandler
.cmd_new
= qmp_marshal_input_dump_guest_memory
,
712 Dump guest memory to file
. The file can be processed with crash or gdb
.
716 - "paging": do paging to get guest
's memory mapping (json-bool)
717 - "protocol": destination file(started with "file:") or destination file
718 descriptor (started with "fd:") (json-string)
719 - "begin": the starting physical address. It's optional
, and should be specified
720 with length
together (json
-int
)
721 - "length": the memory size
, in bytes
. It
's optional, and should be specified
722 with begin together (json-int)
726 -> { "execute": "dump-guest-memory", "arguments": { "protocol": "fd:dump" } }
731 (1) All boolean arguments default to false
736 .name = "netdev_add",
737 .args_type = "netdev:O",
738 .mhandler.cmd_new = qmp_netdev_add,
745 Add host network device.
749 - "type": the device type, "tap", "user", ... (json-string)
750 - "id": the device's ID
, must be
unique (json
-string
)
755 -> { "execute": "netdev_add", "arguments": { "type": "user", "id": "netdev1" } }
758 Note
: The supported device options are the same ones supported by the
'-net'
759 command
-line argument
, which are listed
in the
'-help' output or QEMU
's
765 .name = "netdev_del",
767 .mhandler.cmd_new = qmp_marshal_input_netdev_del,
774 Remove host network device.
778 - "id": the device's ID
, must be
unique (json
-string
)
782 -> { "execute": "netdev_del", "arguments": { "id": "netdev1" } }
789 .name
= "block_resize",
790 .args_type
= "device:B,size:o",
791 .mhandler
.cmd_new
= qmp_marshal_input_block_resize
,
798 Resize a block image
while a guest is running
.
802 - "device": the device
's ID, must be unique (json-string)
807 -> { "execute": "block_resize", "arguments": { "device": "scratch", "size": 1073741824 } }
813 .name = "block-stream",
814 .args_type = "device:B,base:s?,speed:o?,on-error:s?",
815 .mhandler.cmd_new = qmp_marshal_input_block_stream,
819 .name = "block-commit",
820 .args_type = "device:B,base:s?,top:s,speed:o?",
821 .mhandler.cmd_new = qmp_marshal_input_block_commit,
825 .name = "block-job-set-speed",
826 .args_type = "device:B,speed:o",
827 .mhandler.cmd_new = qmp_marshal_input_block_job_set_speed,
831 .name = "block-job-cancel",
832 .args_type = "device:B,force:b?",
833 .mhandler.cmd_new = qmp_marshal_input_block_job_cancel,
836 .name = "block-job-pause",
837 .args_type = "device:B",
838 .mhandler.cmd_new = qmp_marshal_input_block_job_pause,
841 .name = "block-job-resume",
842 .args_type = "device:B",
843 .mhandler.cmd_new = qmp_marshal_input_block_job_resume,
846 .name = "block-job-complete",
847 .args_type = "device:B",
848 .mhandler.cmd_new = qmp_marshal_input_block_job_complete,
851 .name = "transaction",
852 .args_type = "actions:q",
853 .mhandler.cmd_new = qmp_marshal_input_transaction,
860 Atomically operate on one or more block devices. The only supported
861 operation for now is snapshotting. If there is any failure performing
862 any of the operations, all snapshots for the group are abandoned, and
863 the original disks pre-snapshot attempt are used.
865 A list of dictionaries is accepted, that contains the actions to be performed.
866 For snapshots this is the device, the file to use for the new snapshot,
867 and the format. The default format, if not specified, is qcow2.
869 Each new snapshot defaults to being created by QEMU (wiping any
870 contents if the file already exists), but it is also possible to reuse
871 an externally-created file. In the latter case, you should ensure that
872 the new image file has the same contents as the current one; QEMU cannot
873 perform any meaningful check. Typically this is achieved by using the
874 current image file as the backing file for the new image.
879 - "type": the operation to perform. The only supported
880 value is "blockdev-snapshot-sync". (json-string)
881 - "data": a dictionary. The contents depend on the value
882 of "type". When "type" is "blockdev-snapshot-sync":
883 - "device": device name to snapshot (json-string)
884 - "snapshot-file": name of new image file (json-string)
885 - "format": format of new image (json-string, optional)
886 - "mode": whether and how QEMU should create the snapshot file
887 (NewImageMode, optional, default "absolute-paths")
891 -> { "execute": "transaction",
892 "arguments": { "actions": [
893 { 'type
': 'blockdev
-snapshot
-sync
', 'data
' : { "device": "ide-hd0",
894 "snapshot-file": "/some/place/my-image",
895 "format": "qcow2" } },
896 { 'type
': 'blockdev
-snapshot
-sync
', 'data
' : { "device": "ide-hd1",
897 "snapshot-file": "/some/place/my-image2",
899 "format": "qcow2" } } ] } }
905 .name = "blockdev-snapshot-sync",
906 .args_type = "device:B,snapshot-file:s,format:s?,mode:s?",
907 .mhandler.cmd_new = qmp_marshal_input_blockdev_snapshot_sync,
911 blockdev-snapshot-sync
912 ----------------------
914 Synchronous snapshot of a block device. snapshot-file specifies the
915 target of the new image. If the file exists, or if it is a device, the
916 snapshot will be created in the existing file/device. If does not
917 exist, a new file will be created. format specifies the format of the
918 snapshot image, default is qcow2.
922 - "device": device name to snapshot (json-string)
923 - "snapshot-file": name of new image file (json-string)
924 - "mode": whether and how QEMU should create the snapshot file
925 (NewImageMode, optional, default "absolute-paths")
926 - "format": format of new image (json-string, optional)
930 -> { "execute": "blockdev-snapshot-sync", "arguments": { "device": "ide-hd0",
932 "/some/place/my-image",
933 "format": "qcow2" } }
939 .name = "drive-mirror",
940 .args_type = "sync:s,device:B,target:s,speed:i?,mode:s?,format:s?,"
941 "on-source-error:s?,on-target-error:s?",
942 .mhandler.cmd_new = qmp_marshal_input_drive_mirror,
949 Start mirroring a block device's writes to a
new destination
. target
950 specifies the target of the
new image
. If the file exists
, or
if it is
951 a device
, it will be used as the
new destination
for writes
. If it does not
952 exist
, a
new file will be created
. format specifies the format of the
953 mirror image
, default is to probe
if mode
='existing', else the format
958 - "device": device name to operate
on (json
-string
)
959 - "target": name of
new image
file (json
-string
)
960 - "format": format of
new image (json
-string
, optional
)
961 - "mode": how an image file should be created into the target
962 file
/device (NewImageMode
, optional
, default 'absolute-paths')
963 - "speed": maximum speed of the streaming job
, in bytes per second
965 - "sync": what parts of the disk image should be copied to the destination
;
966 possibilities include
"full" for all the disk
, "top" for only the sectors
967 allocated
in the topmost image
, or
"none" to only replicate
new I
/O
969 - "on-source-error": the action to take on an error on the source
970 (BlockdevOnError
, default 'report')
971 - "on-target-error": the action to take on an error on the target
972 (BlockdevOnError
, default 'report')
978 -> { "execute": "drive-mirror", "arguments": { "device": "ide-hd0",
979 "target": "/some/place/my-image",
981 "format": "qcow2" } }
988 .args_type
= "value:M",
989 .mhandler
.cmd_new
= qmp_marshal_input_balloon
,
996 Request VM to change its memory
allocation (in bytes
).
1000 - "value": New memory
allocation (json
-int
)
1004 -> { "execute": "balloon", "arguments": { "value": 536870912 } }
1011 .args_type
= "name:s,up:b",
1012 .mhandler
.cmd_new
= qmp_marshal_input_set_link
,
1019 Change the link status of a network adapter
.
1023 - "name": network device
name (json
-string
)
1024 - "up": status is
up (json
-bool
)
1028 -> { "execute": "set_link", "arguments": { "name": "e1000.0", "up": false } }
1035 .args_type
= "fdname:s",
1036 .params
= "getfd name",
1037 .help
= "receive a file descriptor via SCM rights and assign it a name",
1038 .mhandler
.cmd_new
= qmp_marshal_input_getfd
,
1045 Receive a file descriptor via SCM rights and assign it a name
.
1049 - "fdname": file descriptor
name (json
-string
)
1053 -> { "execute": "getfd", "arguments": { "fdname": "fd1" } }
1058 (1) If the name specified by the
"fdname" argument already exists
,
1059 the file descriptor assigned to it will be closed and replaced
1060 by the received file descriptor
.
1061 (2) The
'closefd' command can be used to explicitly close the file
1062 descriptor when it is no longer needed
.
1068 .args_type
= "fdname:s",
1069 .params
= "closefd name",
1070 .help
= "close a file descriptor previously passed via SCM rights",
1071 .mhandler
.cmd_new
= qmp_marshal_input_closefd
,
1078 Close a file descriptor previously passed via SCM rights
.
1082 - "fdname": file descriptor
name (json
-string
)
1086 -> { "execute": "closefd", "arguments": { "fdname": "fd1" } }
1093 .args_type
= "fdset-id:i?,opaque:s?",
1094 .params
= "add-fd fdset-id opaque",
1095 .help
= "Add a file descriptor, that was passed via SCM rights, to an fd set",
1096 .mhandler
.cmd_new
= qmp_marshal_input_add_fd
,
1103 Add a file descriptor
, that was passed via SCM rights
, to an fd set
.
1107 - "fdset-id": The ID of the fd set to add the file descriptor to
.
1108 (json
-int
, optional
)
1109 - "opaque": A free
-form string that can be used to describe the fd
.
1110 (json
-string
, optional
)
1112 Return a json
-object with the following information
:
1114 - "fdset-id": The ID of the fd set that the fd was added to
. (json
-int
)
1115 - "fd": The file descriptor that was received via SCM rights and added to the
1120 -> { "execute": "add-fd", "arguments": { "fdset-id": 1 } }
1121 <- { "return": { "fdset-id": 1, "fd": 3 } }
1125 (1) The list of fd sets is shared by all monitor connections
.
1126 (2) If
"fdset-id" is not specified
, a
new fd set will be created
.
1131 .name
= "remove-fd",
1132 .args_type
= "fdset-id:i,fd:i?",
1133 .params
= "remove-fd fdset-id fd",
1134 .help
= "Remove a file descriptor from an fd set",
1135 .mhandler
.cmd_new
= qmp_marshal_input_remove_fd
,
1142 Remove a file descriptor from an fd set
.
1146 - "fdset-id": The ID of the fd set that the file descriptor belongs to
.
1148 - "fd": The file descriptor that is to be removed
. (json
-int
, optional
)
1152 -> { "execute": "remove-fd", "arguments": { "fdset-id": 1, "fd": 3 } }
1157 (1) The list of fd sets is shared by all monitor connections
.
1158 (2) If
"fd" is not specified
, all file descriptors
in "fdset-id" will be
1164 .name
= "query-fdsets",
1166 .help
= "Return information describing all fd sets",
1167 .mhandler
.cmd_new
= qmp_marshal_input_query_fdsets
,
1174 Return information describing all fd sets
.
1180 -> { "execute": "query-fdsets" }
1186 "opaque": "rdonly:/path/to/file"
1190 "opaque": "rdwr:/path/to/file"
1209 Note
: The list of fd sets is shared by all monitor connections
.
1214 .name
= "block_passwd",
1215 .args_type
= "device:B,password:s",
1216 .mhandler
.cmd_new
= qmp_marshal_input_block_passwd
,
1223 Set the password of encrypted block devices
.
1227 - "device": device
name (json
-string
)
1228 - "password": password (json
-string
)
1232 -> { "execute": "block_passwd", "arguments": { "device": "ide0-hd0",
1233 "password": "12345" } }
1239 .name
= "block_set_io_throttle",
1240 .args_type
= "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1241 .mhandler
.cmd_new
= qmp_marshal_input_block_set_io_throttle
,
1245 block_set_io_throttle
1248 Change I
/O throttle limits
for a block drive
.
1252 - "device": device
name (json
-string
)
1253 - "bps": total throughput limit
in bytes per
second(json
-int
)
1254 - "bps_rd": read throughput limit
in bytes per
second(json
-int
)
1255 - "bps_wr": read throughput limit
in bytes per
second(json
-int
)
1256 - "iops": total I
/O operations per
second(json
-int
)
1257 - "iops_rd": read I
/O operations per
second(json
-int
)
1258 - "iops_wr": write I
/O operations per
second(json
-int
)
1262 -> { "execute": "block_set_io_throttle", "arguments": { "device": "virtio0",
1274 .name
= "set_password",
1275 .args_type
= "protocol:s,password:s,connected:s?",
1276 .mhandler
.cmd_new
= qmp_marshal_input_set_password
,
1283 Set the password
for vnc
/spice protocols
.
1287 - "protocol": protocol
name (json
-string
)
1288 - "password": password (json
-string
)
1289 - "connected": [ keep | disconnect | fail
] (josn
-string
, optional
)
1293 -> { "execute": "set_password", "arguments": { "protocol": "vnc",
1294 "password": "secret" } }
1300 .name
= "expire_password",
1301 .args_type
= "protocol:s,time:s",
1302 .mhandler
.cmd_new
= qmp_marshal_input_expire_password
,
1309 Set the password expire time
for vnc
/spice protocols
.
1313 - "protocol": protocol
name (json
-string
)
1314 - "time": [ now |
never |
+secs | secs
] (json
-string
)
1318 -> { "execute": "expire_password", "arguments": { "protocol": "vnc",
1325 .name
= "add_client",
1326 .args_type
= "protocol:s,fdname:s,skipauth:b?,tls:b?",
1327 .mhandler
.cmd_new
= qmp_marshal_input_add_client
,
1334 Add a graphics client
1338 - "protocol": protocol
name (json
-string
)
1339 - "fdname": file descriptor
name (json
-string
)
1340 - "skipauth": whether to skip
authentication (json
-bool
, optional
)
1341 - "tls": whether to perform
TLS (json
-bool
, optional
)
1345 -> { "execute": "add_client", "arguments": { "protocol": "vnc",
1346 "fdname": "myclient" } }
1351 .name
= "qmp_capabilities",
1354 .help
= "enable QMP capabilities",
1355 .user_print
= monitor_user_noop
,
1356 .mhandler
.cmd_new
= do_qmp_capabilities
,
1363 Enable QMP capabilities
.
1369 -> { "execute": "qmp_capabilities" }
1372 Note
: This command must be issued before issuing any other command
.
1377 .name
= "human-monitor-command",
1378 .args_type
= "command-line:s,cpu-index:i?",
1379 .mhandler
.cmd_new
= qmp_marshal_input_human_monitor_command
,
1383 human
-monitor
-command
1384 ---------------------
1386 Execute a Human Monitor command
.
1390 - command
-line
: the command name and its arguments
, just like the
1391 Human Monitor
's shell (json-string)
1392 - cpu-index: select the CPU number to be used by commands which access CPU
1393 data, like 'info registers
'. The Monitor selects CPU 0 if this
1394 argument is not provided (json-int, optional)
1398 -> { "execute": "human-monitor-command", "arguments": { "command-line": "info kvm" } }
1399 <- { "return": "kvm support: enabled\r\n" }
1403 (1) The Human Monitor is NOT an stable interface, this means that command
1404 names, arguments and responses can change or be removed at ANY time.
1405 Applications that rely on long term stability guarantees should NOT
1410 o This command is stateless, this means that commands that depend
1411 on state information (such as getfd) might not work
1413 o Commands that prompt the user for data (eg. 'cont
' when the block
1414 device is encrypted) don't currently work
1419 HXCOMM Each query command below is inside a SQMP
/EQMP section
, do NOT change
1420 HXCOMM
this! We will possibly move query commands definitions inside those
1421 HXCOMM sections
, just like regular commands
.
1431 Return a json
-object with the following information
:
1433 - "qemu": A json
-object containing three integer values
:
1434 - "major": QEMU
's major version (json-int)
1435 - "minor": QEMU's minor
version (json
-int
)
1436 - "micro": QEMU
's micro version (json-int)
1437 - "package": package's
version (json
-string
)
1441 -> { "execute": "query-version" }
1456 .name
= "query-version",
1458 .mhandler
.cmd_new
= qmp_marshal_input_query_version
,
1465 List QMP available commands
.
1467 Each command is represented by a json
-object
, the returned value is a json
-array
1470 Each json
-object contain
:
1472 - "name": command
's name (json-string)
1476 -> { "execute": "query-commands" }
1480 "name":"query-balloon"
1483 "name":"system_powerdown"
1488 Note: This example has been shortened as the real response is too long.
1493 .name = "query-commands",
1495 .mhandler.cmd_new = qmp_marshal_input_query_commands,
1502 List QMP available events.
1504 Each event is represented by a json-object, the returned value is a json-array
1507 Each json-object contains:
1509 - "name": event's
name (json
-string
)
1513 -> { "execute": "query-events" }
1525 Note
: This example has been shortened as the real response is too long
.
1530 .name
= "query-events",
1532 .mhandler
.cmd_new
= qmp_marshal_input_query_events
,
1539 Each device is represented by a json
-object
. The returned value is a json
-array
1542 Each json
-object contain the following
:
1544 - "label": device
's label (json-string)
1545 - "filename": device's
file (json
-string
)
1549 -> { "execute": "query-chardev" }
1566 .name
= "query-chardev",
1568 .mhandler
.cmd_new
= qmp_marshal_input_query_chardev
,
1575 Show the block devices
.
1577 Each block device information is stored
in a json
-object and the returned value
1578 is a json
-array of all devices
.
1580 Each json
-object contain the following
:
1582 - "device": device
name (json
-string
)
1583 - "type": device
type (json
-string
)
1584 - deprecated
, retained
for backward compatibility
1585 - Possible values
: "unknown"
1586 - "removable": true if the device is removable
, false otherwise (json
-bool
)
1587 - "locked": true if the device is locked
, false otherwise (json
-bool
)
1588 - "tray-open": only present
if removable
, true if the device has a tray
,
1589 and it is
open (json
-bool
)
1590 - "inserted": only present
if the device is inserted
, it is a json
-object
1591 containing the following
:
1592 - "file": device file
name (json
-string
)
1593 - "ro": true if read
-only
, false otherwise (json
-bool
)
1594 - "drv": driver format
name (json
-string
)
1595 - Possible values
: "blkdebug", "bochs", "cloop", "cow", "dmg",
1596 "file", "file", "ftp", "ftps", "host_cdrom",
1597 "host_device", "host_floppy", "http", "https",
1598 "nbd", "parallels", "qcow", "qcow2", "raw",
1599 "tftp", "vdi", "vmdk", "vpc", "vvfat"
1600 - "backing_file": backing file
name (json
-string
, optional
)
1601 - "backing_file_depth": number of files
in the backing file
chain (json
-int
)
1602 - "encrypted": true if encrypted
, false otherwise (json
-bool
)
1603 - "bps": limit total bytes per
second (json
-int
)
1604 - "bps_rd": limit read bytes per
second (json
-int
)
1605 - "bps_wr": limit write bytes per
second (json
-int
)
1606 - "iops": limit total I
/O operations per
second (json
-int
)
1607 - "iops_rd": limit read operations per
second (json
-int
)
1608 - "iops_wr": limit write operations per
second (json
-int
)
1610 - "io-status": I
/O operation status
, only present
if the device supports it
1611 and the VM is configured to stop on errors
. It
's always reset
1612 to "ok" when the "cont" command is issued (json_string, optional)
1613 - Possible values: "ok", "failed", "nospace"
1617 -> { "execute": "query-block" }
1622 "device":"ide0-hd0",
1629 "file":"disks/test.img",
1630 "backing_file_depth":0,
1642 "device":"ide1-cd0",
1665 .name = "query-block",
1667 .mhandler.cmd_new = qmp_marshal_input_query_block,
1674 Show block device statistics.
1676 Each device statistic information is stored in a json-object and the returned
1677 value is a json-array of all devices.
1679 Each json-object contain the following:
1681 - "device": device name (json-string)
1682 - "stats": A json-object with the statistics information, it contains:
1683 - "rd_bytes": bytes read (json-int)
1684 - "wr_bytes": bytes written (json-int)
1685 - "rd_operations": read operations (json-int)
1686 - "wr_operations": write operations (json-int)
1687 - "flush_operations": cache flush operations (json-int)
1688 - "wr_total_time_ns": total time spend on writes in nano-seconds (json-int)
1689 - "rd_total_time_ns": total time spend on reads in nano-seconds (json-int)
1690 - "flush_total_time_ns": total time spend on cache flushes in nano-seconds (json-int)
1691 - "wr_highest_offset": Highest offset of a sector written since the
1692 BlockDriverState has been opened (json-int)
1693 - "parent": Contains recursively the statistics of the underlying
1694 protocol (e.g. the host file for a qcow2 image). If there is
1695 no underlying protocol, this field is omitted
1696 (json-object, optional)
1700 -> { "execute": "query-blockstats" }
1704 "device":"ide0-hd0",
1707 "wr_highest_offset":3686448128,
1709 "wr_operations":751,
1710 "rd_bytes":122567168,
1711 "rd_operations":36772
1712 "wr_total_times_ns":313253456
1713 "rd_total_times_ns":3465673657
1714 "flush_total_times_ns":49653
1715 "flush_operations":61,
1719 "wr_highest_offset":2821110784,
1721 "wr_operations":692,
1722 "rd_bytes":122739200,
1723 "rd_operations":36604
1724 "flush_operations":51,
1725 "wr_total_times_ns":313253456
1726 "rd_total_times_ns":3465673657
1727 "flush_total_times_ns":49653
1731 "device":"ide1-cd0",
1733 "wr_highest_offset":0,
1738 "flush_operations":0,
1739 "wr_total_times_ns":0
1740 "rd_total_times_ns":0
1741 "flush_total_times_ns":0
1747 "wr_highest_offset":0,
1752 "flush_operations":0,
1753 "wr_total_times_ns":0
1754 "rd_total_times_ns":0
1755 "flush_total_times_ns":0
1761 "wr_highest_offset":0,
1766 "flush_operations":0,
1767 "wr_total_times_ns":0
1768 "rd_total_times_ns":0
1769 "flush_total_times_ns":0
1778 .name = "query-blockstats",
1780 .mhandler.cmd_new = qmp_marshal_input_query_blockstats,
1787 Show CPU information.
1789 Return a json-array. Each CPU is represented by a json-object, which contains:
1791 - "CPU": CPU index (json-int)
1792 - "current": true if this is the current CPU, false otherwise (json-bool)
1793 - "halted": true if the cpu is halted, false otherwise (json-bool)
1794 - Current program counter. The key's name depends on the architecture
:
1795 "pc": i386
/x86_64 (json
-int
)
1796 "nip": PPC (json
-int
)
1797 "pc" and
"npc": sparc (json
-int
)
1798 "PC": mips (json
-int
)
1799 - "thread_id": ID of the underlying host
thread (json
-int
)
1803 -> { "execute": "query-cpus" }
1826 .name
= "query-cpus",
1828 .mhandler
.cmd_new
= qmp_marshal_input_query_cpus
,
1835 PCI buses and devices information
.
1837 The returned value is a json
-array of all buses
. Each bus is represented by
1838 a json
-object
, which has a key with a json
-array of all PCI devices attached
1839 to it
. Each device is represented by a json
-object
.
1841 The bus json
-object contains the following
:
1843 - "bus": bus
number (json
-int
)
1844 - "devices": a json
-array of json
-objects
, each json
-object represents a
1847 The PCI device json
-object contains the following
:
1849 - "bus": identical to the parent
's bus number (json-int)
1850 - "slot": slot number (json-int)
1851 - "function": function number (json-int)
1852 - "class_info": a json-object containing:
1853 - "desc": device class description (json-string, optional)
1854 - "class": device class number (json-int)
1855 - "id": a json-object containing:
1856 - "device": device ID (json-int)
1857 - "vendor": vendor ID (json-int)
1858 - "irq": device's IRQ
if assigned (json
-int
, optional
)
1859 - "qdev_id": qdev id
string (json
-string
)
1860 - "pci_bridge": It
's a json-object, only present if this device is a
1861 PCI bridge, contains:
1862 - "bus": bus number (json-int)
1863 - "secondary": secondary bus number (json-int)
1864 - "subordinate": subordinate bus number (json-int)
1865 - "io_range": I/O memory range information, a json-object with the
1867 - "base": base address, in bytes (json-int)
1868 - "limit": limit address, in bytes (json-int)
1869 - "memory_range": memory range information, a json-object with the
1871 - "base": base address, in bytes (json-int)
1872 - "limit": limit address, in bytes (json-int)
1873 - "prefetchable_range": Prefetchable memory range information, a
1874 json-object with the following members:
1875 - "base": base address, in bytes (json-int)
1876 - "limit": limit address, in bytes (json-int)
1877 - "devices": a json-array of PCI devices if there's any attached
, each
1878 each element is represented by a json
-object
, which contains
1879 the same members of the
'PCI device json-object' described
1881 - "regions": a json
-array of json
-objects
, each json
-object represents a
1882 memory region of
this device
1884 The memory range json
-object contains the following
:
1886 - "base": base memory
address (json
-int
)
1887 - "limit": limit
value (json
-int
)
1889 The region json
-object can be an I
/O region or a memory region
, an I
/O region
1890 json
-object contains the following
:
1892 - "type": "io" (json
-string
, fixed
)
1893 - "bar": BAR
number (json
-int
)
1894 - "address": memory
address (json
-int
)
1895 - "size": memory
size (json
-int
)
1897 A memory region json
-object contains the following
:
1899 - "type": "memory" (json
-string
, fixed
)
1900 - "bar": BAR
number (json
-int
)
1901 - "address": memory
address (json
-int
)
1902 - "size": memory
size (json
-int
)
1903 - "mem_type_64": true or
false (json
-bool
)
1904 - "prefetch": true or
false (json
-bool
)
1908 -> { "execute": "query-pci" }
1920 "desc":"Host bridge"
1954 "desc":"IDE controller"
1976 "desc":"VGA controller"
1986 "mem_type_64":false,
1989 "address":4026531840,
1994 "mem_type_64":false,
1997 "address":4060086272,
2002 "mem_type_64":false,
2017 "desc":"RAM controller"
2038 Note
: This example has been shortened as the real response is too long
.
2043 .name
= "query-pci",
2045 .mhandler
.cmd_new
= qmp_marshal_input_query_pci
,
2052 Show KVM information
.
2054 Return a json
-object with the following information
:
2056 - "enabled": true if KVM support is enabled
, false otherwise (json
-bool
)
2057 - "present": true if QEMU has KVM support
, false otherwise (json
-bool
)
2061 -> { "execute": "query-kvm" }
2062 <- { "return": { "enabled": true, "present": true } }
2067 .name
= "query-kvm",
2069 .mhandler
.cmd_new
= qmp_marshal_input_query_kvm
,
2076 Return a json
-object with the following information
:
2078 - "running": true if the VM is running
, or
false if it is
paused (json
-bool
)
2079 - "singlestep": true if the VM is
in single step mode
,
2080 false otherwise (json
-bool
)
2081 - "status": one of the following
values (json
-string
)
2082 "debug" - QEMU is running on a debugger
2083 "inmigrate" - guest is paused waiting
for an incoming migration
2084 "internal-error" - An internal error that prevents further guest
2085 execution has occurred
2086 "io-error" - the last IOP has failed and the device is configured
2087 to pause on I
/O errors
2088 "paused" - guest has been paused via the
'stop' command
2089 "postmigrate" - guest is paused following a successful
'migrate'
2090 "prelaunch" - QEMU was started with
-S and guest has not started
2091 "finish-migrate" - guest is paused to finish the migration process
2092 "restore-vm" - guest is paused to restore VM state
2093 "running" - guest is actively running
2094 "save-vm" - guest is paused to save the VM state
2095 "shutdown" - guest is shut
down (and
-no
-shutdown is
in use
)
2096 "watchdog" - the watchdog action is configured to pause and
2101 -> { "execute": "query-status" }
2102 <- { "return": { "running": true, "singlestep": false, "status": "running" } }
2107 .name
= "query-status",
2109 .mhandler
.cmd_new
= qmp_marshal_input_query_status
,
2116 Show VM mice information
.
2118 Each mouse is represented by a json
-object
, the returned value is a json
-array
2121 The mouse json
-object contains the following
:
2123 - "name": mouse
's name (json-string)
2124 - "index": mouse's
index (json
-int
)
2125 - "current": true if this mouse is receiving events
, false otherwise (json
-bool
)
2126 - "absolute": true if the mouse generates absolute input
events (json
-bool
)
2130 -> { "execute": "query-mice" }
2134 "name":"QEMU Microsoft Mouse",
2140 "name":"QEMU PS/2 Mouse",
2151 .name
= "query-mice",
2153 .mhandler
.cmd_new
= qmp_marshal_input_query_mice
,
2160 Show VNC server information
.
2162 Return a json
-object with server information
. Connected clients are returned
2163 as a json
-array of json
-objects
.
2165 The main json
-object contains the following
:
2167 - "enabled": true or
false (json
-bool
)
2168 - "host": server
's IP address (json-string)
2169 - "family": address family (json-string)
2170 - Possible values: "ipv4", "ipv6", "unix", "unknown"
2171 - "service": server's port
number (json
-string
)
2172 - "auth": authentication
method (json
-string
)
2173 - Possible values
: "invalid", "none", "ra2", "ra2ne", "sasl", "tight",
2174 "tls", "ultra", "unknown", "vencrypt", "vencrypt",
2175 "vencrypt+plain", "vencrypt+tls+none",
2176 "vencrypt+tls+plain", "vencrypt+tls+sasl",
2177 "vencrypt+tls+vnc", "vencrypt+x509+none",
2178 "vencrypt+x509+plain", "vencrypt+x509+sasl",
2179 "vencrypt+x509+vnc", "vnc"
2180 - "clients": a json
-array of all connected clients
2182 Clients are described by a json
-object
, each one contain the following
:
2184 - "host": client
's IP address (json-string)
2185 - "family": address family (json-string)
2186 - Possible values: "ipv4", "ipv6", "unix", "unknown"
2187 - "service": client's port
number (json
-string
)
2188 - "x509_dname": TLS
dname (json
-string
, optional
)
2189 - "sasl_username": SASL
username (json
-string
, optional
)
2193 -> { "execute": "query-vnc" }
2214 .name
= "query-vnc",
2216 .mhandler
.cmd_new
= qmp_marshal_input_query_vnc
,
2223 Show SPICE server information
.
2225 Return a json
-object with server information
. Connected clients are returned
2226 as a json
-array of json
-objects
.
2228 The main json
-object contains the following
:
2230 - "enabled": true or
false (json
-bool
)
2231 - "host": server
's IP address (json-string)
2232 - "port": server's port
number (json
-int
, optional
)
2233 - "tls-port": server
's port number (json-int, optional)
2234 - "auth": authentication method (json-string)
2235 - Possible values: "none", "spice"
2236 - "channels": a json-array of all active channels clients
2238 Channels are described by a json-object, each one contain the following:
2240 - "host": client's IP
address (json
-string
)
2241 - "family": address
family (json
-string
)
2242 - Possible values
: "ipv4", "ipv6", "unix", "unknown"
2243 - "port": client
's port number (json-string)
2244 - "connection-id": spice connection id. All channels with the same id
2245 belong to the same spice session (json-int)
2246 - "channel-type": channel type. "1" is the main control channel, filter for
2247 this one if you want track spice sessions only (json-int)
2248 - "channel-id": channel id. Usually "0", might be different needed when
2249 multiple channels of the same type exist, such as multiple
2250 display channels in a multihead setup (json-int)
2251 - "tls": whevener the channel is encrypted (json-bool)
2255 -> { "execute": "query-spice" }
2268 "connection-id": 1804289383,
2269 "host": "127.0.0.1",
2277 "connection-id": 1804289383,
2278 "host": "127.0.0.1",
2282 [ ... more channels follow ... ]
2289 #if defined(CONFIG_SPICE)
2291 .name = "query-spice",
2293 .mhandler.cmd_new = qmp_marshal_input_query_spice,
2303 Return a json-object with the following information:
2305 - "name": VM's
name (json
-string
, optional
)
2309 -> { "execute": "query-name" }
2310 <- { "return": { "name": "qemu-name" } }
2315 .name
= "query-name",
2317 .mhandler
.cmd_new
= qmp_marshal_input_query_name
,
2326 Return a json
-object with the following information
:
2328 - "UUID": Universally Unique
Identifier (json
-string
)
2332 -> { "execute": "query-uuid" }
2333 <- { "return": { "UUID": "550e8400-e29b-41d4-a716-446655440000" } }
2338 .name
= "query-uuid",
2340 .mhandler
.cmd_new
= qmp_marshal_input_query_uuid
,
2349 Return a json
-object
. If migration is active there will be another json
-object
2350 with RAM migration status and
if block migration is active another one with
2351 block migration status
.
2353 The main json
-object contains the following
:
2355 - "status": migration
status (json
-string
)
2356 - Possible values
: "active", "completed", "failed", "cancelled"
2357 - "total-time": total amount of ms since migration started
. If
2358 migration has ended
, it returns the total migration
2360 - "downtime": only present when migration has finished correctly
2361 total amount
in ms
for downtime that
happened (json
-int
)
2362 - "expected-downtime": only present
while migration is active
2363 total amount
in ms
for downtime that was calculated on
2364 the last bitmap
round (json
-int
)
2365 - "ram": only present
if "status" is
"active", it is a json
-object with the
2366 following RAM
information (in bytes
):
2367 - "transferred": amount
transferred (json
-int
)
2368 - "remaining": amount
remaining (json
-int
)
2369 - "total": total (json
-int
)
2370 - "duplicate": number of duplicated
pages (json
-int
)
2371 - "normal" : number of normal pages
transferred (json
-int
)
2372 - "normal-bytes" : number of normal bytes
transferred (json
-int
)
2373 - "disk": only present
if "status" is
"active" and it is a block migration
,
2374 it is a json
-object with the following disk
information (in bytes
):
2375 - "transferred": amount
transferred (json
-int
)
2376 - "remaining": amount
remaining (json
-int
)
2377 - "total": total (json
-int
)
2378 - "xbzrle-cache": only present
if XBZRLE is active
.
2379 It is a json
-object with the following XBZRLE information
:
2380 - "cache-size": XBZRLE cache size
2381 - "bytes": total XBZRLE bytes transferred
2382 - "pages": number of XBZRLE compressed pages
2383 - "cache-miss": number of cache misses
2384 - "overflow": number of XBZRLE overflows
2387 1. Before the first migration
2389 -> { "execute": "query-migrate" }
2392 2. Migration is done and has succeeded
2394 -> { "execute": "query-migrate" }
2396 "status": "completed",
2405 "normal-bytes":123456
2410 3. Migration is done and has failed
2412 -> { "execute": "query-migrate" }
2413 <- { "return": { "status": "failed" } }
2415 4. Migration is being performed and is not a block migration
:
2417 -> { "execute": "query-migrate" }
2426 "expected-downtime":12345,
2429 "normal-bytes":123456
2434 5. Migration is being performed and is a block migration
:
2436 -> { "execute": "query-migrate" }
2442 "remaining":1053304,
2445 "expected-downtime":12345,
2448 "normal-bytes":123456
2452 "remaining":20880384,
2458 6. Migration is being performed and XBZRLE is active
:
2460 -> { "execute": "query-migrate" }
2464 "capabilities" : [ { "capability": "xbzrle", "state" : true } ],
2467 "remaining":1053304,
2470 "expected-downtime":12345,
2473 "normal-bytes":3412992
2476 "cache-size":67108864,
2488 .name
= "query-migrate",
2490 .mhandler
.cmd_new
= qmp_marshal_input_query_migrate
,
2494 migrate
-set
-capabilities
2497 Enable
/Disable migration capabilities
2499 - "xbzrle": xbzrle support
2505 -> { "execute": "migrate-set-capabilities" , "arguments":
2506 { "capabilities": [ { "capability": "xbzrle", "state": true } ] } }
2511 .name
= "migrate-set-capabilities",
2512 .args_type
= "capabilities:O",
2513 .params
= "capability:s,state:b",
2514 .mhandler
.cmd_new
= qmp_marshal_input_migrate_set_capabilities
,
2517 query
-migrate
-capabilities
2520 Query current migration capabilities
2522 - "capabilities": migration capabilities state
2523 - "xbzrle" : XBZRLE
state (json
-bool
)
2529 -> { "execute": "query-migrate-capabilities" }
2531 "capabilities" : [ { "capability" : "xbzrle", "state" : false } ]
2537 .name
= "query-migrate-capabilities",
2539 .mhandler
.cmd_new
= qmp_marshal_input_query_migrate_capabilities
,
2546 Show balloon information
.
2548 Make an asynchronous request
for balloon info
. When the request completes a
2549 json
-object will be returned containing the following data
:
2551 - "actual": current balloon value
in bytes (json
-int
)
2552 - "mem_swapped_in": Amount of memory swapped
in bytes (json
-int
, optional
)
2553 - "mem_swapped_out": Amount of memory swapped out
in bytes (json
-int
, optional
)
2554 - "major_page_faults": Number of major
faults (json
-int
, optional
)
2555 - "minor_page_faults": Number of minor
faults (json
-int
, optional
)
2556 - "free_mem": Total amount of free and unused memory
in
2557 bytes (json
-int
, optional
)
2558 - "total_mem": Total amount of available memory
in bytes (json
-int
, optional
)
2562 -> { "execute": "query-balloon" }
2565 "actual":1073741824,
2567 "mem_swapped_out":0,
2568 "major_page_faults":142,
2569 "minor_page_faults":239245,
2570 "free_mem":1014185984,
2571 "total_mem":1044668416
2578 .name
= "query-balloon",
2580 .mhandler
.cmd_new
= qmp_marshal_input_query_balloon
,
2584 .name
= "query-block-jobs",
2586 .mhandler
.cmd_new
= qmp_marshal_input_query_block_jobs
,
2591 .args_type
= "path:s",
2592 .mhandler
.cmd_new
= qmp_marshal_input_qom_list
,
2597 .args_type
= "path:s,property:s,value:q",
2598 .mhandler
.cmd_new
= qmp_qom_set
,
2603 .args_type
= "path:s,property:s",
2604 .mhandler
.cmd_new
= qmp_qom_get
,
2608 .name
= "nbd-server-start",
2609 .args_type
= "addr:q",
2610 .mhandler
.cmd_new
= qmp_marshal_input_nbd_server_start
,
2613 .name
= "nbd-server-add",
2614 .args_type
= "device:B,writable:b?",
2615 .mhandler
.cmd_new
= qmp_marshal_input_nbd_server_add
,
2618 .name
= "nbd-server-stop",
2620 .mhandler
.cmd_new
= qmp_marshal_input_nbd_server_stop
,
2624 .name
= "change-vnc-password",
2625 .args_type
= "password:s",
2626 .mhandler
.cmd_new
= qmp_marshal_input_change_vnc_password
,
2629 .name
= "qom-list-types",
2630 .args_type
= "implements:s?,abstract:b?",
2631 .mhandler
.cmd_new
= qmp_marshal_input_qom_list_types
,
2635 .name
= "device-list-properties",
2636 .args_type
= "typename:s",
2637 .mhandler
.cmd_new
= qmp_marshal_input_device_list_properties
,
2641 .name
= "query-machines",
2643 .mhandler
.cmd_new
= qmp_marshal_input_query_machines
,
2647 .name
= "query-cpu-definitions",
2649 .mhandler
.cmd_new
= qmp_marshal_input_query_cpu_definitions
,
2653 .name
= "query-target",
2655 .mhandler
.cmd_new
= qmp_marshal_input_query_target
,