|Original author(s)||Fabrice Bellard|
Peter Maydell, et al.
6.2.0 / 14 December 2021
|Operating system||Linux, Microsoft Windows, macOS and some other UNIX platforms|
QEMU is a free and open-source hypervisor. It emulates the machine's processor through dynamic binary translation and provides a set of different hardware and device models for the machine, enabling it to run a variety of guest operating systems. It can interoperate with Kernel-based Virtual Machine (KVM) to run virtual machines at near-native speed. QEMU can also do emulation for user-level processes, allowing applications compiled for one architecture to run on another.
QEMU was written by Fabrice Bellard and is free software, mainly licensed under the GNU General Public License (GPL for short). Various parts are released under the BSD license, GNU Lesser General Public License (LGPL) or other GPL-compatible licenses.
QEMU has multiple operating modes:
- User-mode emulation
- In this mode QEMU runs single Linux or Darwin/macOS programs that were compiled for a different instruction set. System calls are thunked for endianness and for 32/64 bit mismatches. Fast cross-compilation and cross-debugging are the main targets for user-mode emulation.
- System emulation
- In this mode QEMU emulates a full computer system, including peripherals. It can be used to provide virtual hosting of several virtual computers on a single computer. QEMU can boot many guest operating systems, including Linux, Solaris, Microsoft Windows, DOS, and BSD; it supports emulating several instruction sets, including x86, MIPS, 32-bit ARMv7, ARMv8, PowerPC, SPARC, ETRAX CRIS and MicroBlaze.
- KVM Hosting
- Here QEMU deals with the setting up and migration of KVM images. It is still involved in the emulation of hardware, but the execution of the guest is done by KVM as requested by QEMU.
- Xen Hosting
- QEMU is involved only in the emulation of hardware; the execution of the guest is done within Xen and is totally hidden from QEMU.
QEMU can save and restore the state of the virtual machine with all programs running. Guest operating systems do not need patching in order to run inside QEMU.
QEMU supports the emulation of various architectures, including x86, MIPS64 (up to Release 6), SPARC (sun4m and sun4u), ARM (Integrator/CP and Versatile/PB), SuperH, PowerPC (PReP and Power Macintosh), ETRAX CRIS, MicroBlaze, and RISC-V.
The virtual machine can interface with many types of physical host hardware, including the user's hard disks, CD-ROM drives, network cards, audio interfaces, and USB devices. USB devices can be completely emulated, or the host's USB devices can be used, although this requires administrator privileges and does not work with all devices.
Virtual disk images can be stored in a special format (qcow or qcow2) that only takes up as much disk space as the guest OS actually uses. This way, an emulated 120 GB disk may occupy only a few hundred megabytes on the host. The QCOW2 format also allows the creation of overlay images that record the difference from another (unmodified) base image file. This provides the possibility for reverting the emulated disk's contents to an earlier state. For example, a base image could hold a fresh install of an operating system that is known to work, and the overlay images are used. Should the guest system become unusable (through virus attack, accidental system destruction, etc.), the user can delete the overlay and use an earlier emulated disk image.
QEMU can emulate network cards (of different models) which share the host system's connectivity by doing network address translation, effectively allowing the guest to use the same network as the host. The virtual network cards can also connect to network cards of other instances of QEMU or to local TAP interfaces. Network connectivity can also be achieved by bridging a TUN/TAP interface used by QEMU with a non-virtual Ethernet interface on the host OS using the host OS's bridging features.
QEMU integrates several services to allow the host and guest systems to communicate; for example, an integrated SMB server and network-port redirection (to allow incoming connections to the virtual machine). It can also boot Linux kernels without a bootloader.
QEMU does not depend on the presence of graphical output methods on the host system. Instead, it can allow one to access the screen of the guest OS via an integrated VNC server. It can also use an emulated serial line, without any screen, with applicable operating systems.
Simulating multiple CPUs running SMP is possible.
QEMU does not require administrative rights to run unless additional kernel modules for improving speed (like KQEMU) are used or certain modes of its network connectivity model are utilized.
Tiny Code Generator
The Tiny Code Generator (TCG) aims to remove the shortcoming of relying on a particular version of GCC or any compiler, instead incorporating the compiler (code generator) into other tasks performed by QEMU at run time. The whole translation task thus consists of two parts: basic blocks of target code (TBs) being rewritten in TCG ops - a kind of machine-independent intermediate notation, and subsequently this notation being compiled for the host's architecture by TCG. Optional optimisation passes are performed between them, for a just-in-time compiler (JIT) mode.
TCG requires dedicated code written to support every architecture it runs on, so that the JIT knows what to translate the TCG ops to. If no dedicated JIT code is available for the architecture, TCG falls back to a slow interpreter mode called TCG Interpreter (TCI). It also requires updating the target code to use TCG ops instead of the old dyngen ops.
KQEMU was a Linux kernel module, also written by Fabrice Bellard, which notably sped up emulation of x86 or x86-64 guests on platforms with the same CPU architecture. This worked by running user mode code (and optionally some kernel code) directly on the host computer's CPU, and by using processor and peripheral emulation only for kernel-mode and real-mode code. KQEMU could execute code from many guest OSes even if the host CPU did not support hardware-assisted virtualization. KQEMU was initially a closed-source product available free of charge, but starting from version 1.3.0pre10 (February 2007), it was relicensed under the GNU General Public License. QEMU versions starting with 0.12.0 (as of August 2009[update]) support large memory which makes them incompatible with KQEMU. Newer releases of QEMU have completely removed support for KQEMU.
QVM86 was a GNU GPLv2 licensed drop-in replacement for the then closed-source KQEMU. The developers of QVM86 ceased development in January, 2007.
Kernel-based Virtual Machine (KVM) has mostly taken over as the Linux-based hardware-assisted virtualization solution for use with QEMU in the wake of the lack of support for KQEMU and QVM86. QEMU can also use KVM on other architectures like ARM and MIPS.
Intel's Hardware Accelerated Execution Manager (HAXM) is an open-source alternative to KVM for x86-based hardware-assisted virtualization on NetBSD, Linux, Windows and macOS using Intel VT. As of 2013[update] Intel mostly solicits its use with QEMU for Android development. Starting with version 2.9.0, the official QEMU includes support for HAXM, under the name hax.
QEMU also supports the following accelerators:
- hvf, Apple's
Hypervisor.frameworkbased on Intel VT.
- whpx, Microsoft's Windows Hypervisor Platform based on Intel VT or AMD-V.
- tcg, QEMU's own Tiny Code Generator. This is the default.
Supported disk image formats
- macOS Universal Disk Image Format (
.dmg) – Read-only
- Bochs – Read-only
- Linux cloop – Read-only
- Parallels disk image (
.hds) – Read-only
- QEMU copy-on-write (
- VirtualBox Virtual Disk Image (
- Virtual PC Virtual Hard Disk (
- Virtual VFAT
- VMware Virtual Machine Disk (
- Raw images (
.img) that contain sector-by-sector contents of a disk
- CD/DVD images (
.iso) that contain sector-by-sector contents of an optical disk (e.g. booting live OSes)
QEMU Object Model
The QEMU Object Model (QOM) provides a framework for registering user creatable types and instantiating objects from those types.
QOM provides the following features:
- System for dynamically registering types
- Support for single-inheritance of types
- Multiple inheritance of stateless interfaces
See also: Object model
The MIPS-compatible Loongson-3 processor adds 200 new instructions to help QEMU translate x86 instructions; those new instructions lower the overhead of executing x86/CISC-style instructions in the MIPS pipeline. With additional improvements in QEMU by the Chinese Academy of Sciences, Loongson-3 achieves an average of 70% the performance of executing native binaries while running x86 binaries from nine benchmarks. As of June 2020[update], no source code has been published for this fork, so the claim cannot be verified independently.
Virtualization solutions that use QEMU are able to execute multiple virtual CPUs in parallel. For user-mode emulation QEMU maps emulated threads to host threads. For full system emulation, QEMU is capable of running a host thread for each emulated virtual CPU (vCPU). This is dependent on the guest having been updated to support parallel system emulation, currently ARM, Alpha, HP-PA, PowerPC, RISC-V, s390x, x86 and Xtensa. Otherwise a single thread is used to emulate all virtual CPUS (vCPUS) which executes each vCPU in a round-robin manner.
VirtualBox, first released in January 2007, used some of QEMU's virtual hardware devices, and had a built-in dynamic recompiler based on QEMU. As with KQEMU, VirtualBox runs nearly all guest code natively on the host via the VMM (Virtual Machine Manager) and uses the recompiler only as a fallback mechanism - for example, when guest code executes in real mode. In addition, VirtualBox did a lot of code analysis and patching using a built-in disassembler in order to minimize recompilation. VirtualBox is free and open-source (available under GPL), except for certain features.
Xen, a virtual machine monitor, can run in HVM (hardware virtual machine) mode, using Intel VT-x or AMD-V hardware x86 virtualization extensions and ARM Cortex-A7 and Cortex-A15 virtualization extension. This means that instead of paravirtualized devices, a real set of virtual hardware is exposed to the domU to use real device drivers to talk to.
QEMU includes several components: CPU emulators, emulated devices, generic devices, machine descriptions, user interface, and a debugger. The emulated devices and generic devices in QEMU make up its device models for I/O virtualization. They comprise a PIIX3 IDE (with some rudimentary PIIX4 capabilities), Cirrus Logic or plain VGA emulated video, RTL8139 or E1000 network emulation, and ACPI support. APIC support is provided by Xen.
Xen-HVM has device emulation based on the QEMU project to provide I/O virtualization to the VMs. Hardware is emulated via a QEMU "device model" daemon running as a backend in dom0. Unlike other QEMU running modes (dynamic translation or KVM), virtual CPUs are completely managed to the hypervisor, which takes care of stopping them while QEMU is emulating memory-mapped I/O accesses.
KVM (Kernel-based Virtual Machine) is a FreeBSD and Linux kernel module that allows a user space program access to the hardware virtualization features of various processors, with which QEMU is able to offer virtualization for x86, PowerPC, and S/390 guests. When the target architecture is the same as the host architecture, QEMU can make use of KVM particular features, such as acceleration.
Win4Lin Pro Desktop
In early 2005, Win4Lin introduced Win4Lin Pro Desktop, based on a 'tuned' version of QEMU and KQEMU and it hosts NT-versions of Windows. In June 2006, Win4Lin released Win4Lin Virtual Desktop Server based on the same code base. Win4Lin Virtual Desktop Server serves Microsoft Windows sessions to thin clients from a Linux server.
In September 2006, Win4Lin announced a change of the company name to Virtual Bridges with the release of Win4BSD Pro Desktop, a port of the product to FreeBSD and PC-BSD. Solaris support followed in May 2007 with the release of Win4Solaris Pro Desktop and Win4Solaris Virtual Desktop Server.
SerialICE is a QEMU-based firmware debugging tool running system firmware inside of QEMU while accessing real hardware through a serial connection to a host system. This can be used as a cheap replacement for hardware in-circuit emulators (ICE).
Unicorn is a CPU emulation framework based on QEMU's "TCG" CPU emulator. Unlike QEMU, Unicorn focuses on the CPU only: no emulation of any peripherals is provided and raw binary code (outside of the context of an executable file or a system image) can be run directly. Unicorn is thread-safe and has multiple bindings and instrumentation interfaces.
Emulated hardware platforms
Besides the CPU (which is also configurable and can emulate a number of Intel CPU models including (as of 3 March 2018) Sandy Bridge, Ivy Bridge, Haswell, Broadwell and Skylake), the following devices are emulated:
- CD/DVD-ROM drive using an ISO image
- Floppy disk drive
- ATA controller or Serial ATA AHCI controller
- Graphics card: Cirrus CLGD 5446 PCI VGA-card, Standard-VGA graphics card with Bochs-VBE, Red Hat QXL VGA
- Network card: Realtek 8139C+ PCI, NE2000 PCI, NE2000 ISA, PCnet, E1000 (PCI Intel Gigabit Ethernet) and E1000E (PCIe Intel Gigabit Ethernet)
- NVMe disk interface
- Serial port
- Parallel port
- PC speaker
- i440FX/PIIX3 or Q35/ICH9 chipsets
- PS/2 mouse and keyboard
- SCSI controller: LSI MegaRAID SAS 1078, LSI53C895A, NCR53C9x as found in the AMD PCscsi and Tekram DC-390 controllers
- Sound card: Sound Blaster 16, AudioPCI ES1370 (AC97), Gravis Ultrasound, and Intel HD Audio
- Watchdog timer (Intel 6300 ESB PCI, or iB700 ISA)
- USB 1.x/2.x/3.x controllers (UHCI, EHCI, xHCI)
- USB devices: Audio, Bluetooth dongle, HID (keyboard/mouse/tablet), MTP, serial interface, CAC smartcard reader, storage (bulk-only transfer and USB Attached SCSI), Wacom tablet
- Paravirtualized VirtIO devices: block device, network card, SCSI controller, video device, serial interface, balloon driver, 9pfs filesystem driver
- Paravirtualized Xen devices: block device, network card, console, framebuffer and input device
QEMU emulates the following PowerMac peripherals:
- UniNorth PCI bridge
- PCI-VGA-compatible graphics card which maps the VESA Bochs Extensions
- Two PMAC-IDE-Interfaces with hard disk and CD-ROM support.
- NE2000 PCI adapter
- Non-volatile RAM
- VIA-CUDA with ADB keyboard and mouse.
OpenBIOS is used as the firmware.
QEMU emulates the following PREP peripherals:
- PCI bridge
- PCI VGA-compatible graphics card with VESA Bochs Extensions
- Two IDE interfaces with hard disk and CD-ROM support
- Floppy disk drive
- NE2000 network adapter
- Serial interface
- PREP non-volatile RAM
- PC-compatible keyboard and mouse
On the PREP target, Open Hack'Ware, an Open-Firmware-compatible BIOS, is used.
IBM System p
QEMU can emulate the paravirtual sPAPR interface with the following peripherals:
- PCI bridge, for access to virtio devices, VGA-compatible graphics, USB, etc.
- Virtual I/O network adapter, SCSI controller, and serial interface
- sPAPR non-volatile RAM
On the sPAPR target, another Open-Firmware-compatible BIOS is used, called SLOF.
QEMU emulates the ARMv7 instruction set (and down to ARMv5TEJ) with NEON extension. It emulates full systems like Integrator/CP board, Versatile baseboard, RealView Emulation baseboard, XScale-based PDAs, Palm Tungsten|E PDA, Nokia N800 and Nokia N810 Internet tablets etc. QEMU also powers the Android emulator which is part of the Android SDK (most current Android implementations are ARM-based). Starting from version 2.0.0 of their Bada SDK, Samsung has chosen QEMU to help development on emulated 'Wave' devices.
In 1.5.0 and 1.6.0 Samsung Exynos 4210 (dual-core Cortex a9) and Versatile Express ARM Cortex-A9 ARM Cortex-A15 are emulated. In 1.6.0, the 32-bit instructions of the ARMv8 (AARCH64) architecture are emulated, but 64-bit instructions are unsupported.
The Xilinx Cortex A9-based Zynq SoC is modeled, with the following elements:
- Zynq-7000 ARM Cortex-A9 CPU
- Zynq-7000 ARM Cortex-A9 MPCore
- Triple Timer Counter
- DDR Memory Controller
- DMA Controller (PL330)
- Static Memory Controller (NAND/NOR Flash)
- SD/SDIO Peripheral Controller (SDHCI)
- Zynq Gigabit Ethernet Controller
- USB Controller (EHCI - Host support only)
- Zynq UART Controller
- SPI and QSPI Controllers
- I2C Controller
QEMU has support for both 32- and 64-bit SPARC architectures.
QEMU emulates the following sun4m/sun4c/sun4d peripherals:
- IOMMU or IO-UNITs
- TCX Frame buffer (graphics card)
- Lance (Am7990) Ethernet
- Non-volatile RAM M48T02/M48T08
- Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard and power/reset logic
- ESP SCSI controller with hard disk and CD-ROM support
- Floppy drive (not on SS-600MP)
- CS4231 sound device (only on SS-5, not working yet)
- UltraSparc IIi APB PCI Bridge
- PCI VGA-compatible card with VESA Bochs Extensions
- PS/2 mouse and keyboard
- Non-volatile RAM M48T59
- PC-compatible serial ports
- 2 PCI IDE interfaces with hard disk and CD-ROM support
- Floppy disk
- MicroBlaze with/without MMU, including
- AXI Timer and Interrupt controller peripherals
- AXI External Memory Controller
- AXI DMA Controller
- Xilinx AXI Ethernet
- AXI Ethernet Lite
- AXI UART 16650 and UARTLite
- AXI SPI Controller
Supported peripherals: From the Milkymist SoC
- Memory card
This section is empty. You can help by adding to it. (January 2011)
This section is empty. You can help by adding to it. (August 2012)
External trees exist, supporting the following targets:
- "QEMU version 6.2.0 released". 14 December 2021. Retrieved 18 December 2021.
- Speed, Richard (2019-04-25). "QEMU 4 arrives with toys for Arm admirers, RISC-V revolutionaries, POWER patriots... you get the idea". www.theregister.co.uk. The Register. Archived from the original on 2019-10-01. Retrieved 2019-10-01.
- "License - QEMU". wiki.qemu.org.
- "QEMU Internals". qemu.weilnetz.de.[permanent dead link]
- "QEMU OS Support List". www.claunia.com.
- "QEMU PRIP 1 - support for MIPS64 Release 6 - PRPL". wiki.prplfoundation.org. Archived from the original on 2017-04-21. Retrieved 2014-12-22.
- "[Qemu-devel] ANNOUNCE: Release 0.10.0 of QEMU". lists.gnu.org.
- Filardo, Nathaniel (September 11, 2007). "Porting QEMU to Plan 9: QEMU Internals and Port Strategy" (PDF). gsoc.cat-v.org. -- a review of how the old dyngen worked
- "KQEMU 1.3.0pre10 released - under the GPL [LWN.net]". Lwn.net. February 6, 2007. Retrieved 2009-01-03.
- Liguori, Anthony (10 August 2009). "[Qemu-devel] [PATCH 1/2] Unbreak large mem support by removing kqemu". Retrieved 2010-03-11.
- "QEMU / KVM CPU model configuration". QEMU 5.0.50 (v5.0.0-962-g49ee115552) documentation.
- "HAXM goes open source". QEMU developers. 2017-11-17. Retrieved 2017-01-14.
HAXM is now open source
- "Intel Hardware Accelerated Execution Manager". Intel. 2013-11-27. Retrieved 2014-05-12.
The Intel Hardware Accelerated Execution Manager (Intel® HAXM) is a hardware-assisted virtualization engine (hypervisor) that uses Intel Virtualization Technology (Intel® VT) to speed up Android app emulation on a host machine.
- "Invocation". QEMU 5.0.50 (v5.0.0-962-g49ee115552) documentation.
- "QEMU Emulator User Documentation". qemu.weilnetz.de.
- "Booting from an ISO image using qemu". Linux Tips. 3 August 2015.
- "Qemu Readme". GitHub. 26 October 2021.
- Hu, Weiwu; Wang, Jian; Gao, Xiang; Chen, Yunji; Liu, Qi; Li, Guojie (2009). "Godson-3: A Scalable Multicore RISC Processor with x86 Emulation". IEEE Micro. IEEE. 29 (2): 17–29. doi:10.1109/MM.2009.30. S2CID 726798. Retrieved 2009-04-16.
- "VirtualBox Developer FAQ". Retrieved 2015-02-02.
- "Xen ARM with Virtualization Extensions".
- "Oracle and Sun Microsystems - Strategic Acquisitions - Oracle" (PDF). www.sun.com.
- Demystifying Xen HVM Archived December 22, 2007, at the Wayback Machine
- win4lin VDS announcement Archived February 10, 2008, at the Wayback Machine
- Win4Solaris announcement Archived December 23, 2007, at the Wayback Machine
- "SerialICE". serialice.com.
- "WinUAE 3.0.0". English Amiga Board. 2014-12-17. Retrieved 2016-03-25.
- "Unicorn & QEMU". Unicorn Engine.
- "[Qemu-devel] [PATCH 3/3] add SandyBridge CPU model". lists.gnu.org.
- "Qemu-Changelog-2.3 x86". wiki.qemu.org.
- "QEMU-changelog-2.6, x86 KVM". wiki.qemu.org.
- "QEMU-changelog-2.1, x86 KVM". wiki.qemu.org.
- "QEMU-changelog-2.5, x86 CPU Models and Features". wiki.qemu.org.
- https://qemu.weilnetz.de/doc/qemu-doc.html#pcsys_005fnetwork "i82551, i82557b, i82559er, ne2k_pci, ne2k_isa, pcnet, rtl8139, e1000, smc91c111, lance and mcf_fec"
- http://pclosmag.com/html/issues/201208/page11.html Networking on QEMU: Setting Up The E1000 & Novell NE2000 ISA Evaluation
- "ChangeLog/0.14". Retrieved 2011-08-08.
- "UEFI/OVMF - Ubuntu Wiki".
- "gitorious.org Git - rowboat: external-qemu.git/commit". gitorious.org.
- "Zaitcev's Linux". 090427 people.redhat.com
- "QEMU Z80 Target". Archived from the original on 2016-06-06. 090506 homepage.ntlworld.com
- "Download - RISC-V". Archived from the original on 2016-01-23. Retrieved 2014-12-27.
|Wikimedia Commons has media related to QEMU.|
|Wikibooks has more on the topic of: QEMU|
- Official website
- Systems emulation with QEMU an IBM developerWorks article by M. Tim Jones
- QVM86 project page
- Debian on an emulated ARM machine
- Fedora ARM port emulation with QEMU
- The Wikibook "QEMU and KVM" (in German, or computer translated to English)
- QEMU on Windows
- QEMU Binaries for Windows
- Microblaze emulation with QEMU
- QEMU speed comparison
- UnifiedSessionsManager - An unofficial QEMU/KVM configuration file definition
- Couverture, a code coverage project based on QEMU
- QOM documentation pages