QEMU System Emulation User’s Guide

This manual is the overall guide for users using QEMU for full system emulation (as opposed to user-mode emulation). This includes working with hypervisors such as KVM, Xen, Hax or Hypervisor.Framework.

Contents:

• Quick Start
• Invocation
  • Standard options
  • Block device options
  • USB options
  • Display options
  • i386 target only
  • Network options
  • Character device options
  • TPM device options
  • Linux/Multiboot boot specific
  • Debug/Expert options
  • Generic object creation
  • Device URL Syntax
• Keys in the graphical frontends
• Keys in the character backend multiplexer
• QEMU Monitor
  • Commands
  • Integer expressions
• Disk Images
  • Quick start for disk image creation
  • Snapshot mode
  • VM snapshots
  • Disk image file formats
  • Read-only formats
  • Using host drives
    • Linux
    • Windows
    • Mac OS X
  • Virtual FAT disk images
  • NBD access
  • Sheepdog disk images
  • iSCSI LUNs
  • GlusterFS disk images
  • Secure Shell (ssh) disk images
  • NVMe disk images
  • Disk image file locking
• Network emulation
  • Using TAP network interfaces
    • Linux host
    • Windows host
  • Using the user mode network stack
  • Hubs
  • Connecting emulated networks between QEMU instances
• QEMU virtio-net standby (net_failover)
  • Restrictions
  • Usecase
  • Usage
  • Hotplug
  • Migration
• USB emulation
  • Connecting USB devices
  • Using host USB devices on a Linux host
• Inter-VM Shared Memory device
  • Migration with ivshmem
  • ivshmem and hugepages
• Direct Linux Boot
• VNC security
  • Without passwords
  • With passwords
  • With x509 certificates
  • With x509 certificates and client verification
  • With x509 certificates, client verification and passwords
  • With SASL authentication
  • With x509 certificates and SASL authentication
  • Configuring SASL mechanisms
• TLS setup for network services
  • Setup the Certificate Authority
  • Issuing server certificates
  • Issuing client certificates
  • TLS x509 credential configuration
  • TLS Pre-Shared Keys (PSK)
• GDB usage
• Managed start up options
• Virtual CPU hotplug
  • vCPU hotplug
  • vCPU hot-unplug
• virtio pmem
  • Usecase
  • How does virtio-pmem compare to the nvdimm emulation?
  • virtio pmem usage
  • Hotplug
  • Guest Data Persistence
  • Limitations
• Persistent reservation managers
  • Defining a persistent reservation manager
  • Multipath devices and persistent reservations
• QEMU System Emulator Targets
  • x86 System emulator
    • Board-specific documentation
    • Recommendations for KVM CPU model configuration on x86 hosts
    • Syntax for configuring CPU models
    • OS requirements
  • PowerPC System emulator
  • Sparc32 System emulator
  • Sparc64 System emulator
  • MIPS System emulator
    • Supported CPU model configurations on MIPS hosts
    • nanoMIPS System emulator
  • Arm System emulator
    • Choosing a board model
    • Board-specific documentation
    • Arm CPU features
  • ColdFire System emulator
  • Xtensa System emulator
  • s390x System emulator
    • Device support
    • Architectural features
  • RX System emulator
  • AVR System emulator
• Security
  • Overview
  • Security Requirements
    • Virtualization Use Case
    • Non-virtualization Use Case
  • Architecture
    • Guest Isolation
    • Principle of Least Privilege
    • Isolation mechanisms
  • Sensitive configurations
    • Monitor console (QMP and HMP)
• Deprecated features
  • System emulator command line arguments
    • -usbdevice (since 2.10.0)
    • -drive file=json:{...{'driver':'file'}} (since 3.0)
    • -vnc acl (since 4.0.0)
    • QEMU_AUDIO_ environment variables and -audio-help (since 4.0)
    • Creating sound card devices and vnc without audiodev= property (since 4.2)
    • Creating sound card devices using -soundhw (since 5.1)
    • -mon ...,control=readline,pretty=on|off (since 4.1)
    • -realtime (since 4.1)
    • RISC-V -bios (since 5.1)
    • -tb-size option (since 5.0)
    • -show-cursor option (since 5.0)
    • Configuring floppies with ``-global
    • -drive with bogus interface type
  • QEMU Machine Protocol (QMP) commands
    • change (since 2.5.0)
    • blockdev-open-tray, blockdev-close-tray argument device (since 2.8.0)
    • eject argument device (since 2.8.0)
    • blockdev-change-medium argument device (since 2.8.0)
    • block_set_io_throttle argument device (since 2.8.0)
    • migrate_set_downtime and migrate_set_speed (since 2.8.0)
    • query-named-block-nodes result encryption_key_missing (since 2.10.0)
    • query-block result inserted.encryption_key_missing (since 2.10.0)
    • blockdev-add empty string argument backing (since 2.10.0)
    • migrate-set-cache-size and query-migrate-cache-size (since 2.11.0)
    • block-commit arguments base and top (since 3.1.0)
    • object-add option props (since 5.0)
    • query-named-block-nodes and query-block result dirty-bitmaps[i].status (since 4.0)
    • query-block result field dirty-bitmaps (Since 4.2)
    • query-cpus (since 2.12.0)
    • query-cpus-fast arch output member (since 3.0.0)
    • query-events (since 4.0)
    • chardev client socket with wait option (since 4.0)
    • nbd-server-add and nbd-server-remove (since 5.2)
  • Human Monitor Protocol (HMP) commands
    • acl_show, acl_reset, acl_policy, acl_add, acl_remove (since 4.0.0)
  • System emulator CPUS
    • moxie CPU (since 5.2.0)
    • compat property of server class POWER CPUs (since 5.0)
    • lm32 CPUs (since 5.2.0)
    • unicore32 CPUs (since 5.2.0)
    • Icelake-Client CPU Model (since 5.2.0)
    • MIPS I7200 CPU Model (since 5.2)
  • System emulator devices
    • ide-drive (since 4.2)
    • scsi-disk (since 4.2)
  • System emulator machines
    • mips fulong2e machine (since 5.1)
    • pc-1.0, pc-1.1, pc-1.2 and pc-1.3 (since 5.0)
    • Raspberry Pi raspi2 and raspi3 machines (since 5.2)
  • Device options
    • Emulated device options
    • Block device options
  • linux-user mode CPUs
    • tilegx CPUs (since 5.1.0)
    • ppc64abi32 CPUs (since 5.2.0)
    • MIPS I7200 CPU (since 5.2)
  • Related binaries
    • qemu-img amend to adjust backing file (since 5.1)
    • qemu-img backing file without format (since 5.1)
  • Backwards compatibility
    • Runnability guarantee of CPU models (since 4.1.0)
  • Guest Emulator ISAs
    • nanoMIPS ISA
• Recently removed features
  • System emulator command line arguments
    • -net ...,name=name (removed in 5.1)
    • -no-kvm (removed in 5.2)
  • QEMU Machine Protocol (QMP) commands
    • block-dirty-bitmap-add “autoload” parameter (since 4.2.0)
    • cpu-add (removed in 5.2)
  • Human Monitor Protocol (HMP) commands
    • The hub_id parameter of hostfwd_add / hostfwd_remove (removed in 5.0)
    • cpu-add (removed in 5.2)
  • Guest Emulator ISAs
    • RISC-V ISA privilege specification version 1.09.1 (removed in 5.1)
  • System emulator CPUS
    • KVM guest support on 32-bit Arm hosts (removed in 5.2)
    • RISC-V ISA Specific CPUs (removed in 5.1)
    • RISC-V no MMU CPUs (removed in 5.1)
  • System emulator machines
    • spike_v1.9.1 and spike_v1.10 (removed in 5.1)
    • mips r4k platform (removed in 5.2)
  • Related binaries
    • qemu-nbd --partition (removed in 5.0)
    • qemu-img convert -n -o (removed in 5.1)
    • qemu-img create -b bad file $size (removed in 5.1)
  • Command line options
    • -smp (invalid topologies) (removed 5.2)
    • -numa node (without memory specified) (removed 5.2)
    • -numa node,mem=size (removed in 5.1)
    • -mem-path fallback to RAM (removed in 5.0)
    • -smp (invalid topologies) (removed 5.2)
    • -machine enforce-config-section=on|off (removed 5.2)
  • Block devices
    • VXHS backend (removed in 5.1)
• Supported build platforms
  • Linux OS
  • Windows
  • macOS
  • FreeBSD
  • NetBSD
  • OpenBSD
• License