ChangeLog/2.3

System emulation

Command-line compatibility

• Behavior when the three SMP topology options (socket, cores, threads) are specified but don't match the number of VCPUs was changed. In previous versions QEMU silently adjusted the "threads" option to (try to) make the topology match the number of VCPUs, now QEMU will abort when sockets*cores*threads don't match the number of VCPUs.

Future incompatible changes

• Three options are using different names on the command line and in configuration file. In particular:
  • The "acpi" configuration file section matches command-line option "acpitable";
  • The "boot-opts" configuration file section matches command-line option "boot";
  • The "smp-opts" configuration file section matches command-line option "smp".

-readconfig will standardize on the name for the command line option.

• Behavior of automatic calculation of SMP topology when some SMP topology options for -smp are omitted (sockets, cores, threads) will change in the future. If guest ABI needs to be preserved on upgrades while using the SMP topology options, users should either set set all options explicitly (sockets, cores, threads), or omit all of them.
• Image encryption is fatally flawed, and will be dropped entirely. It'll remain available only in qemu-img, so you can use 'qemu-img convert' to convert encrypted images to uncrypted ones.

ARM

• When semihosting mode is active, the exit code is passed to the operating system.
• New option -semihosting-config that supersedes -semihosting. A new suboption target=native forces QEMU to execute semihosting operations even when running under GDB. This helps for targets that do not implement semihosting calls in GDB.
• The virt board now has a fw_cfg device. It allows use of the boot order options, as well as supporting -kernel/-initrd/-append even when you're using a firmware (-bios/-pflash) and not booting directly to the kernel.
• The virt board now has a generic PCIe host bridge that uses the pci-host-ecam-generic driver in Linux.
• Crypto instructions work on big-endian hosts too.
• Support for emulation of the Netduino 2 boards.
• The integratorcp board implements CARDIN and WPROT signals correctly.

KVM

• The virt board supports 32-bit guests on 64-bit hosts

MIPS

• Support for 5KEc and 5KEf MIPS64r2 processors.
• Support for M14K and M14Kc MIPS32r2 microMIPS processors.
• qemu-mips64 uses the 5KEf processor.
• Many fixes.

PowerPC

• Pseudo-support for transactional memory extensions; the transaction will fail immediately, but no illegal instruction exception will be generated. This is valid behavior, though of course suboptimal.

IBM (pSeries)

• Support for switching VGA endianness at run time (for ppc64le guest support)
• The PAPR RTC interface supports the RTC_CHANGE event, the -rtc command line option and the date QOM property.
• Support for EEH RTAS calls.

PReP

• Improved support for m48t59 NVRAM.

s390

• PCI bus support (requires KVM).
• Improvements to TCG support (can run GMP in the guest).
• Support for reipl (reboot) from different disks for the virtio-ccw machine
  • Note that the bios is now mandatory for virtio-ccw machines!
• Various fixes and improvements regarding memory accesses
• Support for autodetection of DASD geometry.
• The ccw bios is now relocateable, allowing e.g. for bigger ramdisks.
• Handling of slow SIGP (signal processor) functions has been moved to qemu from kvm.

SPARC

• Improved support for m48t59 NVRAM.

TriCore

• More complete emulation

x86

• New CPU model IvyBridge.
• Consistent with the latest Intel microcode, RTM and HLE have been disabled on the Haswell and Broadwell CPU models.

KVM

• Support for running under valgrind with KVM enabled.
• Support for the XSAVES feature. The feature is not yet available in any predefined CPU model, but can be enabled with "-cpu host" or "-cpu ...,+xsaves".
• kvm_stat now supports AArch64.
• kvm_stat output is prettier.

Xen

• Support for the ioreq-server API.

Device emulation and assignment

Audio

• Small improvements to the SoundBlaster 16 emulation (which, however, is still very buggy). Some Epic games now work with the "SoundBlaster Clone" setting.

SCSI

• vhost-scsi supports the bootindex property.

TPM

• Improved support.

VFIO

• Support for device request notification, a new feature in Linux 4.0 (FIXME: correct/expand)

VGA

• The standard VGA (PCI id 1234:1111) is now available on all targets that support PCI; it was missing for example on ARM and SH.

GUI

• VNC support for multiseat.
• New query-vnc-servers QMP command, providing more information over query-vnc.
• SPICE now supports Unix sockets (AF_LOCAL).
• QEMU (with GTK+, SDL, SPICE, VNC interfaces) directly uses framebuffer data from the guest RAM for most pixel formats. This reduces CPU usage.

Monitor

• Improvements to hotplug error messages.
• New "human" monitor commands "qom-list", "qom-set", "info qom-tree".

Migration

• "-incoming defer" can be used to start QEMU in incoming-migration mode, but without actually setting up the connection to the source machine. This makes it possible to set migration capabilities that may affect the incoming connection process.
• A new "migrate_incoming" command can be used to start an incoming migration after "-incoming defer" was passed on the command line.
• Commands "info migration" ("human" monitor) and "query-migration" (QMP) now return the "cancelling" state explicitly. Previously, the "cancelling" state was reported as "active". Note that the cancelling state lasts for a fraction of a second and is probably changed to "cancelled" by the time QEMU receives the "info migration", so the effect is mostly theoretical.
• A JSON description of the migration schema is included, as a debugging aid, at the end of the migration stream.

Block devices in system emulation

• Support for SD cards on PCI systems, through the new device "sdhci-pci".
• QEMU will restrict writes to the first sector when an image is autodetected as a raw image, so that the next time the VM is started it will not be autodetected e.g. as qcow2. To avoid this restriction, start QEMU with an explicit "format=raw" option.
• virtio-blk SCSI requests (SG_IO) are now handled asynchronously.
• Support for merging reads in virtio-blk.
• New command blockdev-backup.

Block devices and tools

• qcow2 images (compat level 1.1) can now be created and used with a different reference count entry width than 16 bits (refcount_bits option), allowing powers of two from 1 to 64. If you do not intend to use internal snapshots, you can for instance use refcount_bits=1 to reduce disk usage a little. qemu-img amend does not yet support changing this option.
• Improved support for DMG images.
• Support for optimized WRITE SAME operation on files using the fallocate system call.
• Better interoperability with other hypervisors on large (>127GB) .vpc images.

Guest agent

• New commands guest-get-memory-blocks, guest-set-memory-blocks, guest-get-memory-block-info (Linux guests only).
• New command guest-set-user-password.
• File commands are supported for Windows guests.

User-mode emulation

• Support for shmat.
• Support for SCM_CREDENTIALS.
• Fixed build on NetBSD/sparc64 and NetBSD/arm.

Build dependencies

• System emulators (qemu-system-*) and block tools (qemu-img, qemu-io, qemu-nbd) now use "__thread" for thread-local storage on all architectures; Previously they only used it on Windows. If your system does not have native TLS support, you will need GCC 4.3 or newer to compile QEMU (this was already the case for Windows in previous releases). In particular, compiling QEMU on Mac OS X with Apple's GCC 4.2.1 is not supported:
  • on Mac OS X 10.7 or newer, you can use Clang (which should be the default compiler when compiling QEMU on these version)
  • on Mac OS X 10.6 or older, you need to build a newer GCC (Apple doesn't provide GPLv3 compilers) or install a binary from fink, homebrew, MacPorts or a similar distribution.

Known issues

• NVMe guest ABI changed from 2.2 to 2.3.
• The mac99 and pseries machines do not obey "-machine usb=no" currently.
• Migration incorrectly expects that the receiver does not stop receiving data after receiving the end-of-stream marker.
• --enable-profiler compilation is broken.

Licensing

• All code licensed under the SoftFloat-2b license (which is not compatible with the GPL version 2, the license under which QEMU as a whole is distributed) has been removed from QEMU or relicensed under a GPL-compatible license.