fc6feafd4e
- Update to v5.2.0: See http://wiki.qemu.org/ChangeLog/5.2 Take note that ongoing feature deprecation is tracked at both http://wiki.qemu-project.org/Features/LegacyRemoval and in the deprecated.html file installed with the qemu package Some noteworthy changes: * Dropped system emulators: qemu-system-lm32, qemu-system-unicore32 * Dropped linux user emulator: qemu-ppc64abi32 * Added linux user emulator: qemu-extensaeb * Unicore32 and lm32 guest support dropped * New sub-packages (most due to ongoing modularization of QEMU): qemu-audio-spice, qemu-hw-chardev-spice, qemu-hw-display-virtio-vga, qemu-hw-display-virtio-gpu, qemu-hw-display-virtio-gpu-pci, qemu-ui-spice-core, qemu-ui-opengl, qemu-ivshmem-tools * x86: A new KVM feature which improves the handling of asynchronous page faults is available with -cpu ...,kvm-async-pf-int (requires Linux 5.8) * s390: More instructions emulated under TCG * PowerPC: nvdimm= machine option now functions correctly; misc improvements * ARM: new boards: mps2-an386 (Cortex-M4 based) and mps2-an500 (Cortex-M7 based), raspi3ap (the Pi 3 model A+), raspi0 (the Pi Zero) and raspi1ap (the Pi A+) * RISC-V: OpenSBI v0.8 included by default; Generic OpenSBI platform used when no -bios argument is supplied; Support for NUMA sockets on Virt and Spike Machines; Support for migrating machines; misc improvements * Misc NVMe improvements * The 'vhost-user-blk' export type has been added, allowing qemu-storage-daemon to act as a vhost-user-blk device backend * The SMBIOS OEM strings can now come from a file * 9pfs - misc performance related improvements * virtiofs - misc improvements * migration: The default migration bandwidth has been increased to 1Gbps (users are still encouraged to tune it to their own hardware); The new 'calc-dirty-rate' and 'query-dirty-rate' QMP commands can help determine the likelihood of precopy migration success; TLS+multifd now supported for higher bandwidth encrypted migration; misc minor features added * Misc minor block features added * Misc doc improvements * qemu-microvm subpackage change: the bios-microvm.bin is now SeaBIOS based, and the qboot based on is now qboot.rom * elf2dmp is no longer part of qemu-tools (it was never intended to be a packaged binary) * Some subpackages which were 'Requires' are now 'Recommends', allowing for a smaller qemu packaging footprint if needed * Patches dropped (included in release tarball, unless otherwise noted): docs-fix-trace-docs-build-with-sphinx-3..patch (fixed differently) hw-hyperv-vmbus-Fix-32bit-compilation.patch linux-user-properly-test-for-infinite-ti.patch Switch-order-of-libraries-for-mpath-supp.patch (fixed differently) Conditionalize-ui-bitmap-installation-be.patch (fixed differently) hw-usb-hcd-xhci-Fix-GCC-9-build-warning.patch (no longer using gcc9) hw-usb-dev-mtp-Fix-GCC-9-build-warning.patch (no longer using gcc9) roms-Makefile-enable-cross-compile-for-b.patch (fixed with different patch) libvhost-user-handle-endianness-as-manda.patch virtio-add-vhost-user-fs-ccw-device.patch Fix-s-directive-argument-is-null-error.patch build-Workaround-compilation-error-with-.patch build-Be-explicit-about-fcommon-compiler.patch intel-Avoid-spurious-compiler-warning-on.patch golan-Add-explicit-type-casts-for-nodnic.patch Do-not-apply-WORKAROUND_CFLAGS-for-host-.patch ensure-headers-included-are-compatible-w.patch Enable-cross-compile-prefix-for-C-compil.patch (fixed differently) hw-net-net_tx_pkt-fix-assertion-failure-.patch hw-net-xgmac-Fix-buffer-overflow-in-xgma.patch s390x-protvirt-allow-to-IPL-secure-guest.patch usb-fix-setup_len-init-CVE-2020-14364.patch * Patches added: meson-install-ivshmem-client-and-ivshmem.patch Revert-roms-efirom-tests-uefi-test-tools.patch Makefile-Don-t-check-pc-bios-as-pre-requ.patch roms-Makefile-add-cross-file-to-qboot-me.patch qboot-add-cross.ini-file-to-handle-aarch.patch usb-Help-compiler-out-to-avoid-a-warning.patch - In spec file, where reasonable, switch BuildRequires: XXX-devel to be pkgconfig(XXX') instead - No longer disable link time optimization for qemu for x86. It looks like either the build service, qemu code changes and/or the switch to meson have resolved issues previously seen there. We still see problems for other architectures however. - For the record, the following issues reported for SUSE SLE15-SP2 are either fixed in this current package, or are otherwise no longer an issue: bsc#1172384 bsc#1174386 bsc#1174641 bsc#1174863 bsc#1175370 bsc#1175441 bsc#1176494 CVE-2020-13361 CVE-2020-14364 CVE-2020-15863 CVE-2020-16092 CVE-2020-24352 and the following feature requests are satisfied by this package: jsc#SLE-13689 jsc#SEL-13780 jsc#SLE-13840 - To be more accurate, and to align with other qemu packaging practices, rename the qemu-s390 package to qemu-s390x. The old name (in the rpm namespace) is provided with a "Provides" directive, and an "Obsoletes" done against that name for prior qemu versions, as is standard practice (boo#1177764 jsc#SLE-17060) - Take this opportunity to remove some ancient Split-Provides mechanisms which can't conceivably be needed any more: qemu-block-curl provided: qemu:%_libdir/%name/block-curl.so qemu-guest-agent provided: qemu:%_bindir/qemu-ga qemu-tools provided: qemu:%_libexecdir/qemu-bridge-helper - Disable linux-user 'ls' test on 32 bit arm. It's failing with "Allocating guest commpage: Cannot allocate memory" error, which we should hunt down, but for now we don't want it to prevent the package from being built OBS-URL: https://build.opensuse.org/request/show/854151 OBS-URL: https://build.opensuse.org/package/show/Virtualization/qemu?expand=0&rev=597
849 lines
27 KiB
Plaintext
849 lines
27 KiB
Plaintext
[qemu-s390 package document]
|
|
|
|
SLES 15 SP3 QEMU/KVM RELATED SUPPORT STATEMENTS
|
|
|
|
Overview
|
|
--------
|
|
|
|
The QEMU based packages included with SLES 15 SP3 provide a large variety of
|
|
features, from the very latest customer requests to features of questionable
|
|
quality or value. The linux kernel includes components which contribute KVM
|
|
virtualization features as well. This document was created to assist the user
|
|
in deciding which features can be relied upon to build enterprise class
|
|
virtualization solutions. KVM based virtualization for x86 (Intel 64/AMD64),
|
|
for IBM System z (s390x), and for the ARM64 architecture (AArch64) are offered
|
|
at the L3 (full support) level. The bulk of this document deals with L3
|
|
supported features and is primarily s390x centric. This document should be
|
|
considered a companion to the standard virtualization documentation delivered
|
|
with the product.
|
|
|
|
KVM is implemented in linux kernel modules which enable the linux kernel to
|
|
function as an integral part of the KVM hypervisor. The hypervisor-guest
|
|
interaction is managed by QEMU through the /dev/kvm ioctl interface. The linux
|
|
host assists in the virtualization of storage, networking and display
|
|
resources as well as allowing direct hardware passthrough of PCI devices.
|
|
Linux memory and cpu management features are used by QEMU/KVM to enable guests
|
|
to share those host resources as efficiently as possible.
|
|
|
|
QEMU is a primary component of KVM based virtualization. The legacy qemu-kvm
|
|
program is available for continuity with pre SLES 12 usage, including in
|
|
libvirt domain xml references. The QEMU emulator binary qemu-system-s390x is
|
|
now the primary program to use to access KVM virtualization. When using this
|
|
program, the -machine option accel=kvm (or its alias -enable-kvm) or --accel
|
|
kvm option must be specified for KVM acceleration to be used by the guest.
|
|
|
|
Libvirt is the preferred means of accessing QEMU/KVM functionality and is
|
|
documented elsewhere. This document focuses on the features and direct usage
|
|
of QEMU/KVM as provided by the QEMU based packages.
|
|
|
|
Major QEMU/KVM Supported Features
|
|
---------------------------------
|
|
|
|
- KVM virtualization is accomplished by using the QEMU program in KVM
|
|
acceleration mode. KVM acceleration requires that both guest and host have
|
|
the same fundamental architecture.
|
|
|
|
- Guest images created under previous QEMU versions are supported by machine
|
|
version compatibilities built into more recent QEMU versions.
|
|
|
|
- For ease of use, the QEMU program has defaults which represent traditional
|
|
usage patterns.
|
|
|
|
- Guest virtual machine characteristics are specified by a combination of
|
|
internal defaults, options provided on the QEMU program command-line, runtime
|
|
configurations set via the monitor interfaces and optional config files. The
|
|
runtime control of a VM is effected either through the Human Monitor
|
|
"Protocol" (HMP), or the JSON based programmatical QEMU Monitor Protocol (QMP)
|
|
interface. For QMP details, see qemu-qmp-ref man page.
|
|
Since a KVM guest runs in the context of a normal linux process, some types
|
|
of execution controls are managed with linux tools.
|
|
|
|
- QEMU incorporates virtualized, s390 specific, ccw bus based firmware for
|
|
booting s390 guests. This firmware is automatically incorporated and
|
|
doesn't need to be explicitly referenced.
|
|
|
|
- Some QEMU messages have been localized to various languages. This is provided
|
|
by the optional qemu-lang package. Keyboard mappings for various nationalities
|
|
is also provided.
|
|
|
|
- Virtual machine lifecycle controls include startup through the ccw firmware or
|
|
kernel boot, firmware based shutdown, execution pausing, the saving and
|
|
restoring of machine state or disk state, VM migration to another host, and
|
|
miscellaneous controls available through the "monitors" mentioned above.
|
|
|
|
- Guest execution state may be "moved" in both time (save/restore) and space
|
|
(static and live migration). These migrations or save/restore operations can
|
|
take place either from certain prior SLES versioned hosts to a SLES 15 SP3
|
|
host or between hosts of the same version. Certain other restrictions also
|
|
apply.
|
|
|
|
- Security considerations include privileged helpers and a security model which
|
|
allows running guests as a non-root user.
|
|
|
|
- QEMU provides best effort reuse of existing disk images, including those with
|
|
systems installed, through geometry probing. Also disk images produced by
|
|
other popular virtualization technologies may be imported into QEMU supported
|
|
storage formats. These QEMU formats include features which exploit the
|
|
benefits of virtualization.
|
|
|
|
- Memory, cpu and disk space overcommit are possible and can be beneficial when
|
|
done responsibly. Additional management of these resources comes in the form
|
|
of memory ballooning or hotplug, host KSM, vcpu hot-add, online disk resizing,
|
|
trim, discard and hole punching.
|
|
|
|
- Guest performance is enhanced through the use of virtio devices, various disk
|
|
caching modes, network acceleration via the vhost-net kernel module, multi-
|
|
queue network transmit capabilities, host transparent huge pages (THP) and
|
|
direct hugetlb usage. Physical PCI devices may also be passed through to the
|
|
guest, including SR-IOV VF's.
|
|
|
|
- The guest UI is accessable via GTK, VNC, and serial (including curses TUI)
|
|
interfaces.
|
|
|
|
- Guest timekeeping is supported in a variety of ways, including a paravirtual
|
|
clocksource, and options for the various guest clocks for how to handle the
|
|
timeslicing of the guest's execution on the host.
|
|
|
|
- In addition to the para-virtualized devices already mentioned, other devices
|
|
and infrastructure designed to avoid virtualization "problem areas" are
|
|
available such as SPICE graphics, vmmouse emulation, tablet style pointer
|
|
interfaces and virtio based UI interfaces.
|
|
|
|
- A built-in user-mode network (SLIRP) stack is available.
|
|
|
|
- Portions of the host file system may be shared with a guest by using virtFS.
|
|
|
|
- A guest "agent" is available for SLES 15 SP3 KVM guests via the
|
|
qemu-guest-agent package. This allows some introspection and control of the
|
|
guest OS environment from the host.
|
|
|
|
QEMU/KVM Technology Previews
|
|
----------------------------
|
|
|
|
- All features indicated as not being supported in this document fall under the
|
|
Technology Preview definition contained in the main product's release notes.
|
|
|
|
Noteworthy QEMU/KVM Unsupported Features
|
|
----------------------------------------
|
|
|
|
- Note that some features are unsupported simply due to lack of validation. If
|
|
an existing feature is desired, but not marked supported, let SUSE know about
|
|
your requirements.
|
|
|
|
- The TCG "acceleration" mode may be helpful for problem isolation, but
|
|
otherwise presents insufficient benefit and stability.
|
|
|
|
- GlusterFS integration is not enabled.
|
|
|
|
Deprecated, Superseded, Modified and Dropped Features
|
|
-----------------------------------------------------
|
|
|
|
- http://wiki.qemu-project.org/Features/LegacyRemoval
|
|
This website tracks feature deprecation and removal at the upstream
|
|
development level. Our qemu package inherits this community direction, but be
|
|
aware that we can and will deviate as needed. Those deviations and additional
|
|
information can be found in this section. Feature deprecation is also tracked
|
|
in Appendix B of the qemu-doc.* files installed with the qemu package.
|
|
|
|
- The use of "?" as a parameter to "-cpu", "-soundhw", "-device", "-M",
|
|
"-machine" and "-d" is now considered deprecated. Use "help"
|
|
instead.
|
|
|
|
- The use of "if=scsi" as a parameter to "-drive" does not work anymore with PC
|
|
machine types, as it created an obsolete SCSI controller model.
|
|
|
|
- Use of aio=native without direct cache mode also being specified (cache=none,
|
|
cache=directsync, or cache.direct=on) is no longer allowed.
|
|
|
|
- The use of image encryption in qcow and qcow2 formats is now considered
|
|
deprecated.
|
|
Analysis has shown it to be weak encryption, in addition to suffering from
|
|
poor design. Images can easily be converted to a non-encrypted format.
|
|
|
|
- Use of acpi, boot-opts, and smp-opts in a -readconfig config file are now
|
|
considered deprecated. In the future those names will be standardized to
|
|
acpitable, boot, and smp respectively.
|
|
|
|
- This previously supported command line option is now considered deprecated:
|
|
-device virtio-blk,scsi= (use virtio-scsi instead)
|
|
-device virtio-blk-pci,scsi= (use virtio-scsi instead)
|
|
-realtime mlock= (use -overcommit mem-lock= instead)
|
|
|
|
- These previously supported command line options are no longer supported:
|
|
<previously mentioned items have been moved to another category>
|
|
|
|
- These previously supported command line options are no longer recognized:
|
|
-balloon (use -device virtio-balloon instead)
|
|
-clock
|
|
-device ivshmem (use ivshmem-doorbell or ivshmem-plain instead)
|
|
-device pc-sysfw (no longer needed)
|
|
-device pci-assign, -device kvm-pci-assign (use -device vfio-pci instead)
|
|
-display sdl
|
|
-no-frame
|
|
-nodefconfig (use -no-user-config instead)
|
|
-sdl
|
|
-virtioconsole (use -device virtconsole instead)
|
|
|
|
- Specifying a cpu feature with both "+feature/-feature" and "feature=on/off"
|
|
will now cause a warning. The current behavior for this combination where
|
|
"+feature/-feature" wins over "feature=on/off", will be changed going forward
|
|
so that "+feature" and "-feature" will be synonyms for "feature=on" and
|
|
"feature=off" respectively.
|
|
|
|
- The previously supported blkdev-add QMP command has been flagged as lacking
|
|
and could possibly change syntax in the future.
|
|
|
|
- These previously unsupported command line options are now deprecated:
|
|
-bt
|
|
-device ide-drive (use ide-hd or ide-cd)
|
|
-device scsi-disk (use scsi-hd or scsi-cd)
|
|
-soundhw (use -device ... instead)
|
|
-tb-size
|
|
|
|
- These previously unsupported command line options are no longer recognized:
|
|
-device mmio_interface
|
|
-device ramfb
|
|
-device vhost-user-vsock-pci-transitional
|
|
-device vhost-vsock-pci-transitional
|
|
-device virtio-iommu-pci-transitional
|
|
-enable-hax
|
|
-tdf
|
|
-xen-create
|
|
|
|
- These previously supported QMP commands are now deprecated:
|
|
change (use blockdev-change-medium or change-vnc-password instead)
|
|
cpu-add
|
|
migrate-set-cache-size (use migrate-set-parameters instead)
|
|
migrate_set_downtime (use migrate-set-parameters instead)
|
|
migrate_set_speed (use migrate-set-parameters instead)
|
|
query-cpus (use query-cpus-fast instead)
|
|
query-events
|
|
query-migrate-cache-size (use query-migrate-parameters instead)
|
|
|
|
- These previously supported monitor commands are now deprecated:
|
|
change
|
|
migrate_set_downtime
|
|
migrate_set_speed
|
|
|
|
- These previously supported monitor commands are no longer recognized:
|
|
cpu-add
|
|
pci_add (use device_add instead)
|
|
pci_del (use device_del instead)
|
|
|
|
- These previously unsupported monitor command are now deprecated:
|
|
acl_add ...
|
|
acl_policy ...
|
|
acl_remove ...
|
|
acl_reset ...
|
|
acl_show ...
|
|
|
|
- These previously unsupported monitor commands are no longer recognized:
|
|
host_net_add
|
|
host_net_remove
|
|
usb_add
|
|
usb_del
|
|
|
|
- These previously unsupported QMP commands are now supported under a new name:
|
|
x-block-dirty-bitmap-disable (use block-dirty-bitmap-disable instead)
|
|
x-block-dirty-bitmap-enable (use block-dirty-bitmap-enable instead)
|
|
x-block-dirty-bitmap-merge (use block-dirty-bitmap-merge instead)
|
|
x-block-latency-histogram-set (use block-latency-histogram-set instead)
|
|
x-blockdev-create (use blockdev-create instead)
|
|
|
|
- This previously unsupported QMP commands is no longer recognized:
|
|
x-nbd-server-add-bitmap
|
|
|
|
- Due to upstream's decision to no longer fully support the qed storage format
|
|
going forward (since it really provides no benefit over qcow2 and is now no
|
|
longer actively maintained upstream), creating qed storage images is no longer
|
|
supported and it is highly discouraged to continue using existing qed images.
|
|
They should instead be converted to another supported format.
|
|
|
|
QEMU Command-Line and Monitor Syntax and Support
|
|
------------------------------------------------
|
|
|
|
- The QEMU program command-line syntax is as follows:
|
|
qemu-system-s390x [options]
|
|
|
|
Where 'options' are taken from the options listed below.
|
|
The images used with -drive or -cdrom, may be in the raw (no format) or qcow2
|
|
storage formats, and may be located in files within the host filesystem,
|
|
logical volumes, host physical disks, or network based storage. Read only
|
|
media may also be accessed via URL style protocol specifiers.
|
|
|
|
Note that as a general rule, as new command line options are added which serve
|
|
to replace an older option or interface, you are strongly encouraged to adapt
|
|
your usage to the new option. The new option is being introduced to provide
|
|
better functionality and usability going forward. In some cases existing
|
|
problems or even bugs in older interfaces cannot be fixed due to functional
|
|
expectations, but are resolved in the newer interface or option.
|
|
This advice includes moving to the most recent machine type (eg
|
|
s390-ccw-virtio-5.2 instead of s390-ccw-virtio-4.2) if possible.
|
|
|
|
- The following command line options are supported:
|
|
-accel ...
|
|
-add-fd ...
|
|
-alt-grab
|
|
-append ...
|
|
-audio-help
|
|
-audiodev
|
|
-bios ...
|
|
-blockdev ...
|
|
-boot ...
|
|
-cdrom ...
|
|
-chardev ..
|
|
-cpu host
|
|
-ctrl-grab
|
|
-d ...
|
|
-daemonize
|
|
-debugcon ...
|
|
-device
|
|
|
|
[virtio-net-pci|virtio-blk-pci|virtio-balloon-pci|virtserialport|
|
|
virtconsole|virtio-serial-pci|virtio-scsi-pci|scsi-cd|scsi-hd|
|
|
scsi-generic|scsi-disk|scsi-block|virtio-rng-pci|pci-bridge|
|
|
megasas-gen2|e1000e|e1000|zpci|virtio-gpu-ccw|virtio-keyboard-ccw|
|
|
vhost-user-blk-pci|vhost-user-scsi|vhost-user-scsi-pci|
|
|
vhost-vsock-ccw|virtio-balloon-ccw|virtio-blk-ccw|vhost-scsi-ccw|
|
|
vhost-user-blk|virtio-crypto-ccw|virtio-net-ccw|virtio-rng-ccw|
|
|
virtio-scsi-ccw|virtio-serial-ccw|virtio-mouse-ccw|virtio-tablet-ccw|
|
|
vfio-pci|virtio-vga|vhost-scsi-pci-non-transitional|
|
|
vhost-scsi-pci-transitional|vhost-user-blk-pci-non-transitional|
|
|
vhost-user-blk-pci-transitional|vhost-user-scsi-pci-non-transitional|
|
|
vhost-user-scsi-pci-transitional|vhost-vsock-pci-non-transitional|
|
|
virtio-9p-ccw|virtio-9p-pci-non-transitional|
|
|
virtio-9p-pci-transitional|virtio-balloon-pci-non-transitional|
|
|
virtio-balloon-pci-transitional|virtio-blk-pci-non-transitional|
|
|
virtio-blk-pci-transitional|virtio-input-host-pci-non-transitional|
|
|
virtio-input-host-pci-transitional|virtio-net-pci-non-transitional|
|
|
virtio-net-pci-transitional|virtio-rng-pci-non-transitional|
|
|
virtio-rng-pci-transitional|virtio-scsi-pci-non-transitional|
|
|
virtio-scsi-pci-transitional|virtio-serial-pci-non-transitional|
|
|
virtio-serial-pci-transitional|vhost-user-fs-pci|vhost-user-gpu|
|
|
vhost-user-pci-pci|vhost-user-input|vhost-user-input-pci|
|
|
vhost-user-vga]
|
|
(the following are aliases of these supported devices: virtio-blk|
|
|
virtio-input-host|virtio-keyboard|virtio-mouse|virtio-tablet|
|
|
virtio-gpu|virtio-9p|virtio-net|virtio-serial|virtio-balloon|
|
|
virtio-scsi|virtio-rng)
|
|
|
|
-dfilter range, ...
|
|
-display ...
|
|
-drive
|
|
|
|
... (if specified if=[virtio] and format=[qcow2|raw] and
|
|
snapshot=off only)
|
|
|
|
-echr ...
|
|
-enable-fips
|
|
-enable-kvm
|
|
-fsdev ...
|
|
-full-screen
|
|
-fw_cfg ...
|
|
-gdb ...
|
|
-global ...
|
|
-h
|
|
-help
|
|
-incoming ...
|
|
-initrd ...
|
|
-iscsi ...
|
|
-k ...
|
|
-kernel ...
|
|
-loadvm ...
|
|
-m ...
|
|
-M
|
|
|
|
[help|?|none|s390-ccw-virtio|s390-ccw-virtio-2.6|s390-ccw-virtio-2.9|
|
|
s390-ccw-virtio-2.11|s390-ccw-virtio-3.1|s390-ccw-virtio-4.2|
|
|
s390-ccw-virtio-5.2]
|
|
|
|
-machine
|
|
|
|
[help|?|none|s390-ccw-virtio|s390-ccw-virtio-2.6|s390-ccw-virtio-2.9|
|
|
s390-ccw-virtio-2.11|s390-ccw-virtio-3.1|s390-ccw-virtio-4.2|
|
|
s390-ccw-virtio-5.2]
|
|
|
|
-mem-path ...
|
|
-mem-prealloc
|
|
-mon ...
|
|
-monitor ...
|
|
-msg ...
|
|
-name ...
|
|
-net
|
|
|
|
[bridge|l2tpv3|nic|none|tap|user] ... (for model= only e1000, rtl8139,
|
|
and virtio are supported)
|
|
|
|
-netdev [bridge|tap|user] ...
|
|
-nic ...
|
|
-nodefaults
|
|
-nographic
|
|
-no-quit
|
|
-no-reboot
|
|
-no-shutdown
|
|
-no-user-config
|
|
-object ...
|
|
-only-migratable
|
|
-parallel ...
|
|
-pidfile ...
|
|
-plugin ...
|
|
-qmp ...
|
|
-qmp-pretty ...
|
|
-readconfig ...
|
|
-realtime ...
|
|
-rtc ...
|
|
-runas ...
|
|
-s
|
|
-S
|
|
-sandbox ...
|
|
-seed ...
|
|
-serial ...
|
|
-show-cursor
|
|
-smp ...
|
|
-trace ...
|
|
-uuid ..
|
|
-version
|
|
-vga [none|qxl|std]
|
|
-virtfs ...
|
|
-vnc ...
|
|
-watchdog ...
|
|
-watchdog-action ...
|
|
-writeconfig ...
|
|
|
|
- The following monitor commands are supported:
|
|
?
|
|
announce_self ...
|
|
balloon ...
|
|
block_resize ...
|
|
boot_set ...
|
|
c
|
|
change ...
|
|
chardev-add ...
|
|
chardev-change ...
|
|
chardev-remove ...
|
|
chardev-send-break ...
|
|
client_migrate_info ...
|
|
closefd ...
|
|
cont
|
|
cpu ...
|
|
delvm ...
|
|
device_add ...
|
|
device_del ...
|
|
drive_add ...
|
|
drive_backup ...
|
|
drive_del ...
|
|
dump_guest_memory ...
|
|
eject ...
|
|
gdbserver ...
|
|
gpa2hpa ...
|
|
gpa2hva ...
|
|
gva2gpa ...
|
|
help
|
|
i ...
|
|
info ...
|
|
loadvm ...
|
|
logfile ...
|
|
logitem ...
|
|
mce ...
|
|
memsave ...
|
|
migrate ...
|
|
migrate_cancel
|
|
migrate_continue ...
|
|
migrate_incoming
|
|
migrate_pause
|
|
migrate_recover ...
|
|
migrate_set_cache_size ...
|
|
migrate_set_capability ...
|
|
migrate_set_downtime ...
|
|
migrate_set_parameter ...
|
|
migrate_set_speed ...
|
|
migrate_start_post_copy
|
|
mouse_button ...
|
|
mouse_move ...
|
|
mouse_set ...
|
|
nmi ...
|
|
o ...
|
|
object_add ...
|
|
object_del ...
|
|
p ...
|
|
pmemsave ...
|
|
print ...
|
|
q
|
|
qemu-io ...
|
|
qom-list
|
|
qom-set
|
|
ringbuf_read ...
|
|
ringbuf_write ...
|
|
savevm ...
|
|
screendump ...
|
|
sendkey ...
|
|
snapshot_blkdev_internal ...
|
|
snapshot_delete_blkdev_internal ...
|
|
stop
|
|
sum ...
|
|
system_powerdown
|
|
system_reset
|
|
system_wakeup
|
|
trace-event ...
|
|
watchdog_action ...
|
|
x ...
|
|
xp ...
|
|
|
|
- The following QMP commands are supported:
|
|
add_client
|
|
add-fd
|
|
announce-self
|
|
balloon
|
|
blockdev-add
|
|
blockdev-backup
|
|
blockdev-change-medium
|
|
blockdev-close-tray
|
|
blockdev-create
|
|
blockdev-del
|
|
blockdev-mirror
|
|
blockdev-open-tray
|
|
blockdev-snapshot
|
|
blockdev-snapshot-delete-internal-sync
|
|
blockdev-snapshot-internal-sync
|
|
blockdev-snapshot-sync
|
|
block-commit
|
|
block-dirty-bitmap-add
|
|
block-dirty-bitmap-clear
|
|
block-dirty-bitmap-disable
|
|
block-dirty-bitmap-enable
|
|
block-dirty-bitmap-merge
|
|
block-dirty-bitmap-remove
|
|
block-export-add
|
|
block-export-del
|
|
block-latency-histogram-set
|
|
block_passwd
|
|
block_resize
|
|
block_set_io_throttle
|
|
block-set-write-threshold
|
|
block_stream
|
|
calc-dirty-rate
|
|
change
|
|
change-vnc-password
|
|
chardev-add
|
|
chardev-change
|
|
chardev-remove
|
|
chardev-send-break
|
|
client_migrate_info
|
|
closefd
|
|
cont
|
|
cpu
|
|
cpu-add
|
|
device_add
|
|
device_del
|
|
device-list-properties
|
|
dump-guest-memory
|
|
eject
|
|
expire_password
|
|
getfd
|
|
human-monitor-command
|
|
inject-nmi
|
|
input-send-event
|
|
job-cancel
|
|
job-complete
|
|
job-dismiss
|
|
job-finalize
|
|
job-pause
|
|
job-resume
|
|
memsave
|
|
migrate
|
|
migrate_cancel
|
|
migrate-continue
|
|
migrate-incoming
|
|
migrate-pause
|
|
migrate-resume
|
|
migrate-set-cache-size
|
|
migrate-set-capabilities
|
|
migrate_set_downtime
|
|
migrate_set_speed
|
|
migrate-set-parameters
|
|
migrate-start-postcopy
|
|
object-add
|
|
object-del
|
|
pmemsave
|
|
qmp_capabilities
|
|
qom-get
|
|
qom-list
|
|
qom-list-types
|
|
qom-set
|
|
query-acpi-ospm-status
|
|
query-balloon
|
|
query-block
|
|
query-block-exports
|
|
query-block-jobs
|
|
query-blockstats
|
|
query-chardev
|
|
query-chardev-backends
|
|
query-command-line-options
|
|
query-commands
|
|
query-cpu-definitions
|
|
query-cpu-model-baseline
|
|
query-cpu-model-comparison
|
|
query-cpu-model-expansion
|
|
query-cpus
|
|
query-cpus-fast
|
|
query-current-machine
|
|
query-dirty-rate
|
|
query-display-options
|
|
query-dump
|
|
query-dump-guest-memory-capability
|
|
query-events
|
|
query-fdsets
|
|
query-gic-capabilities
|
|
query-hotpluggable-cpus
|
|
query-iothreads
|
|
query-jobs
|
|
query-kvm
|
|
query-machines
|
|
query-memdev
|
|
query-memory-devices
|
|
query-memory-size-summary
|
|
query-mice
|
|
query-migrate
|
|
query-migrate-cache-size
|
|
query-migrate-capabilities
|
|
query-migrate-parameters
|
|
query-name
|
|
query-named-block-nodes
|
|
query-pci
|
|
query-pr-managers
|
|
query-qmp-schema
|
|
query-rocker
|
|
query-rocker-of-dpa-flows
|
|
query-rocker-of-dpa-groups
|
|
query-rocker-ports
|
|
query-rx-filter
|
|
query-spice
|
|
query-status
|
|
query-target
|
|
query-uuid
|
|
query-version
|
|
query-vnc
|
|
query-vnc-servers
|
|
query-xen-replication-status
|
|
quit
|
|
remove-fd
|
|
ringbuf-read
|
|
ringbuf-write
|
|
screendump
|
|
send-key
|
|
set_link
|
|
set_password
|
|
stop
|
|
system_powerdown
|
|
system_reset
|
|
system_wakeup
|
|
trace-event-get-state
|
|
trace-event-set-state
|
|
transaction
|
|
watchdog-set-action
|
|
|
|
- The following command line options are unsupported:
|
|
|
|
-acpitable ...
|
|
-chroot ...
|
|
-cpu ... (all except host)
|
|
-curses
|
|
-device
|
|
|
|
[AC97|adlib|am53c974|amd-iommu|AMDVI-PCI|ccid-card-emulated|
|
|
ccid-card-passthrough|cirrus-vga|cs4231a|dc390|diag288|e1000-82544gc|
|
|
e1000-82545em|edu|ES1370|floppy|generic-sdhci|gus|hda-duplex|
|
|
hda-micro|hda-output|hyperv-testdev|*-i386-cpu|i8042|i82550|i82551|
|
|
i82557a|i82557b|i82557c|i82558a|i82558b|i82559a|i82559b|i82559c|
|
|
i82562|i82801|i82801b11-bridge|ib700|ich9-intel-hda|ich9-usb-ehci1|
|
|
ich9-usb-ehci2|ich9-usb-uhci1|ich9-usb-uhci2|ich9-usb-uhci3|
|
|
ich9-usb-uhci4|ich9-usb-uhci5|ich9-usb-uhci6|ide-cd|ide-drive|ide-hd|
|
|
igd-passthrough-isa-bridge|intel-hda|intel_iommu|ioh3420|
|
|
ipmi-bmc-extern|ipmi-bmc-sim|ipoctal232|isa-applesmc|isa-cirrus-vga|
|
|
isa-debugcon|isa-debug-exit|isa-fdc|isa-ide|isa-ipmi-bt|isa-ipmi-kcs|
|
|
isa-parallel|isa-serial|isa-vga|lsi53c810|lsi53c810a|max-s390x-cpu|
|
|
megasas|mptsas1068|ne2k_isa|ne2k_pci|nec-usb-xhci|nvdimm|nvme|pc-dimm|
|
|
pci-testdev|pcnet|pc-testdev|piix3-ide|piix3-ide|piix3-ide-xen|
|
|
piix4-usb-uhci|pvscsi|pxb|pxb-host|pxb-pcie|qemu-s390-cpu|rocker|
|
|
s390-flic|s390-flic-qemu|s390-ipl|s390-pcihost|
|
|
s390-sclp-event-facility|s390-skeys-qemu|sb16|sclp|sclpconsole|
|
|
sclp-cpu-hotplug|sclplmconsole|sclp-memory-hotplug-dev|sclpquiesce|
|
|
sd-card|sdhci-pci|secondary-vga|sga|smbus-eeprom|tpci200|usb-audio|
|
|
usb-bot|usb-ccid|usb-mtp|usb-uas|vfio-ap|vfio-pci-nohotplug|
|
|
virtio-9p-device|virtual-css-bridge|vmcoreinfo|vmgenid|vmware-svga|
|
|
vmxnet3|vt82c686b-usb-uhci|x3130-upstream|*-x86_64-cpu|xen-backend|
|
|
xen-pci-passthrough|xen-platform|xen-pvdevice|xio3130-downstream|
|
|
z10BC.2-base-s390x-cpu|z10BC.2-s390x-cpu|z10BC-base-s390x-cpu|
|
|
z10BC-s390x-cpu|z10EC.2-base-s390x-cpu|z10EC.2-s390x-cpu|
|
|
z10EC.3-base-s390x-cpu|z10EC.3-s390x-cpu|z10EC-base-s390x-cpu|
|
|
z10EC-s390x-cpu|z114-base-s390x-cpu|z114-s390x-cpu|
|
|
z13.2-base-s390x-cpu|z13.2-s390x-cpu|z13-base-s390x-cpu|z13-s390x-cpu|
|
|
z13s-base-s390x-cpu|z13s-s390x-cpu|z196.2-base-s390x-cpu|
|
|
z196.2-s390x-cpu|z196-base-s390x-cpu|z196-s390x-cpu|
|
|
z800-base-s390x-cpu|z800-s390x-cpu|z890.2-base-s390x-cpu|
|
|
z890.2-s390x-cpu|z890.3-base-s390x-cpu|z890.3-s390x-cpu|
|
|
z890-base-s390x-cpu|z890-s390x-cpu|z900.2-base-s390x-cpu|
|
|
z900.2-s390x-cpu|z900.3-base-s390x-cpu|z900.3-s390x-cpu|
|
|
z900-base-s390x-cpu|z900-s390x-cpu|z990.2-base-s390x-cpu|
|
|
z990.2-s390x-cpu|z990.3-base-s390x-cpu|z990.3-s390x-cpu|
|
|
z990.4-base-s390x-cpu|z990.4-s390x-cpu|z990.5-base-s390x-cpu|
|
|
z990.5-s390x-cpu|z990-base-s390x-cpu|z990-s390x-cpu|
|
|
z9BC.2-base-s390x-cpu|z9BC.2-s390x-cpu|z9BC-base-s390x-cpu|
|
|
z9BC-s390x-cpu|z9EC.2-base-s390x-cpu|z9EC.2-s390x-cpu|
|
|
z9EC.3-base-s390x-cpu|z9EC.3-s390x-cpu|z9EC-base-s390x-cpu|
|
|
z9EC-s390x-cpu|z14ZR1-base-s390x-cpu|z14ZR1-s390x-cpu|
|
|
zBC12-base-s390x-cpu|zBC12-s390x-cpu|zEC12.2-base-s390x-cpu|
|
|
zEC12.2-s390x-cpu|zEC12-base-s390x-cpu|zEC12-s390x-cpu|cpu-cluster|
|
|
z14.2-base-s390x-cpu|z14.2-s390x-cpu|vhost-user-fs-device|
|
|
virtio-iommu-device|virtio-iommu-pci|
|
|
virtio-iommu-pci-non-transitional|vhost-user-vsock-device|
|
|
vhost-user-vsock-pci|vhost-user-vsock-pci-non-transitional|
|
|
vhost-user-fs-ccw]
|
|
(the following are aliases of these unsupported devices: lsi|
|
|
ahci|e1000-82540em|vfio-ccw)
|
|
(note that some of these device names represent supported devices and
|
|
are used internally, but are not specifyable via -device even though
|
|
they appear in the list of devices)
|
|
|
|
-drive
|
|
|
|
,if=[scsi|mtd|pflash], snapshot=on, format=[anything besides qcow2 or
|
|
raw]
|
|
|
|
-dtb file
|
|
-enable-hax
|
|
-enable-sync-profile
|
|
-fda/-fdb ...
|
|
-g ...
|
|
-hda/-hdb/-hdc/-hdd ...
|
|
-icount ...
|
|
-L ...
|
|
-M
|
|
|
|
[s390-ccw-virtio-2.4|s390-ccw-virtio-2.5|s390-ccw-virtio-2.7|
|
|
s390-ccw-virtio-2.8|s390-ccw-virtio-2.10|s390-ccw-virtio-2.12|
|
|
s390-ccw-virtio-3.0|s390-ccw-virtio-4.0|s390-ccw-virtio-4.1|
|
|
s390-ccw-virtio-5.0|s390-ccw-virtio-5.1]
|
|
|
|
-machine
|
|
|
|
[s390-ccw-virtio-2.4|s390-ccw-virtio-2.5|s390-ccw-virtio-2.7|
|
|
s390-ccw-virtio-2.8|s390-ccw-virtio-2.10|s390-ccw-virtio-2.12|
|
|
s390-ccw-virtio-3.0|s390-ccw-virtio-4.0|s390-ccw-virtio-4.1|
|
|
s390-ccw-virtio-5.0|s390-ccw-virtio-5.1]
|
|
|
|
-mtdblock file
|
|
-net [dump|socket|vde] ...
|
|
-netdev [dump|hubport|l2tpv3|socket|vde] ...
|
|
-no-acpi
|
|
-no-fd-bootchk
|
|
-no-hpet
|
|
-no-kvm
|
|
-no-kvm-irqchip
|
|
-no-kvm-pit
|
|
-no-kvm-pit-reinjection
|
|
-numa cpu ...
|
|
-numa dist ...
|
|
-numa node ...
|
|
-option-rom ...
|
|
-overcommit ...
|
|
-pflash file
|
|
-portrait
|
|
-preconfig
|
|
-prom-env ...
|
|
-qtest ...
|
|
-qtest-log ...
|
|
-rotate
|
|
-sd file
|
|
-sdl
|
|
-set ...
|
|
-singlestep
|
|
-smbios ...
|
|
-snapshot
|
|
-soundhw ...
|
|
-spice
|
|
-tb-size ...
|
|
-tdf
|
|
-tpmdev emulator ...
|
|
-tpmdev passthrough ...
|
|
-usb
|
|
-usbdevice [braile|disk|host|mouse|net|serial|tablet]
|
|
-vga [cg3|tcx|virtio|cirrus|xenfb|vmware]
|
|
-win2k-hack
|
|
-xen-attach ...
|
|
-xen-domid ...
|
|
-xen-domid-restrict ...
|
|
|
|
- The following monitor commands are unsupported:
|
|
acl_add ...
|
|
acl_policy ...
|
|
acl_remove ...
|
|
acl_reset ...
|
|
acl_show ...
|
|
block_job_cancel ...
|
|
block_job_complete ...
|
|
block_job_pause ...
|
|
block_job_resume ...
|
|
block_job_set_speed ...
|
|
block_passwd ...
|
|
commit ...
|
|
drive_mirror ...
|
|
exit_preconfig
|
|
expire_password ...
|
|
hostfwd_add ...
|
|
hostfwd_remove ...
|
|
nbd_server_add ...
|
|
nbd server_start ...
|
|
nbd_server_stop ...
|
|
netdev_add
|
|
netdev_del ...
|
|
pcie_aer_inject_error ...
|
|
replay_break ...
|
|
replay_delete_break
|
|
replay_seek ...
|
|
set_link ...
|
|
set_password ...
|
|
singlestep ...
|
|
snapshot_blkdev ...
|
|
stopcapture ...
|
|
sync-profile ...
|
|
wavcapture ...
|
|
x_colo_lost_heartbeat
|
|
|
|
- The following QMP commands are unsupported:
|
|
block-job-cancel
|
|
block-job-complete
|
|
block-job-pause
|
|
block-job-resume
|
|
block-job-set-speed
|
|
change-backing-file
|
|
drive-backup
|
|
drive-mirror
|
|
dump-skeys
|
|
netdev_add
|
|
netdev_del
|
|
nbd-server-add
|
|
nbd-server-start
|
|
nbd-server-stop
|
|
query-colo-status
|
|
query-tpm
|
|
query-tpm-models
|
|
query-tpm-types
|
|
replay_break
|
|
replay_delete_break
|
|
replay_seek
|
|
x-blockdev-amend
|
|
x-blockdev-change
|
|
x-blockdev-insert-medium
|
|
x-blockdev-remove-medium
|
|
x-blockdev-reopen
|
|
x-colo-lost-heartbeat
|
|
x-debug-block-dirty-bitmap-sha256
|
|
x-debug-query-block-graph
|
|
x-exit-preconfig
|
|
xen-colo-do-checkpoint
|
|
xen-load-devices-state
|
|
xen-save-devices-state
|
|
xen-set-global-dirty-log
|
|
xen-set-replication
|