LXR qemu/docs/config/q35-virtio-serial.cfg

   1# q35 - VirtIO guest (serial console)
   2# =========================================================
   3#
   4# Usage:
   5#
   6#   $ qemu-system-x86_64 \
   7#     -nodefaults \
   8#     -readconfig q35-virtio-serial.cfg \
   9#     -display none -serial mon:stdio
  10#
  11# You will probably need to tweak the lines marked as
  12# CHANGE ME before being able to use this configuration!
  13#
  14# The guest will have a selection of VirtIO devices
  15# tailored towards optimal performance with modern guests,
  16# and will be accessed through the serial console.
  17#
  18# ---------------------------------------------------------
  19#
  20# Using -nodefaults is required to have full control over
  21# the virtual hardware: when it's specified, QEMU will
  22# populate the board with only the builtin peripherals
  23# plus a small selection of core PCI devices and
  24# controllers; the user will then have to explicitly add
  25# further devices.
  26#
  27# The core PCI devices show up in the guest as:
  28#
  29#   00:00.0 Host bridge
  30#   00:1f.0 ISA bridge / LPC
  31#   00:1f.2 SATA (AHCI) controller
  32#   00:1f.3 SMBus controller
  33#
  34# This configuration file adds a number of other useful
  35# devices, more specifically:
  36#
  37#   00.1c.* PCI bridge (PCI Express Root Ports)
  38#   01:00.0 SCSI storage controller
  39#   02:00.0 Ethernet controller
  40#
  41# More information about these devices is available below.
  42#
  43# We use '-display none' to prevent QEMU from creating a
  44# graphical display window, which would serve no use in
  45# this specific configuration, and '-serial mon:stdio' to
  46# multiplex the guest's serial console and the QEMU monitor
  47# to the host's stdio; use 'Ctrl+A h' to learn how to
  48# switch between the two and more.
  49
  50
  51# Machine options
  52# =========================================================
  53#
  54# We use the q35 machine type and enable KVM acceleration
  55# for better performance.
  56#
  57# Using less than 1 GiB of memory is probably not going to
  58# yield good performance in the guest, and might even lead
  59# to obscure boot issues in some cases.
  60
  61[machine]
  62  type = "q35"
  63  accel = "kvm"
  64
  65[memory]
  66  size = "1024"
  67
  68
  69# PCI bridge (PCI Express Root Ports)
  70# =========================================================
  71#
  72# We create eight PCI Express Root Ports, and we plug them
  73# all into separate functions of the same slot. Some of
  74# them will be used by devices, the rest will remain
  75# available for hotplug.
  76
  77[device "pcie.1"]
  78  driver = "pcie-root-port"
  79  bus = "pcie.0"
  80  addr = "1c.0"
  81  port = "1"
  82  chassis = "1"
  83  multifunction = "on"
  84
  85[device "pcie.2"]
  86  driver = "pcie-root-port"
  87  bus = "pcie.0"
  88  addr = "1c.1"
  89  port = "2"
  90  chassis = "2"
  91
  92[device "pcie.3"]
  93  driver = "pcie-root-port"
  94  bus = "pcie.0"
  95  addr = "1c.2"
  96  port = "3"
  97  chassis = "3"
  98
  99[device "pcie.4"]
 100  driver = "pcie-root-port"
 101  bus = "pcie.0"
 102  addr = "1c.3"
 103  port = "4"
 104  chassis = "4"
 105
 106[device "pcie.5"]
 107  driver = "pcie-root-port"
 108  bus = "pcie.0"
 109  addr = "1c.4"
 110  port = "5"
 111  chassis = "5"
 112
 113[device "pcie.6"]
 114  driver = "pcie-root-port"
 115  bus = "pcie.0"
 116  addr = "1c.5"
 117  port = "6"
 118  chassis = "6"
 119
 120[device "pcie.7"]
 121  driver = "pcie-root-port"
 122  bus = "pcie.0"
 123  addr = "1c.6"
 124  port = "7"
 125  chassis = "7"
 126
 127[device "pcie.8"]
 128  driver = "pcie-root-port"
 129  bus = "pcie.0"
 130  addr = "1c.7"
 131  port = "8"
 132  chassis = "8"
 133
 134
 135# SCSI storage controller (and storage)
 136# =========================================================
 137#
 138# We use virtio-scsi here so that we can (hot)plug a large
 139# number of disks without running into issues; a SCSI disk,
 140# backed by a qcow2 disk image on the host's filesystem, is
 141# attached to it.
 142#
 143# We also create an optical disk, mostly for installation
 144# purposes: once the guest OS has been successfully
 145# installed, the guest will no longer boot from optical
 146# media. If you don't want, or no longer want, to have an
 147# optical disk in the guest you can safely comment out
 148# all relevant sections below.
 149
 150[device "scsi"]
 151  driver = "virtio-scsi-pci"
 152  bus = "pcie.1"
 153  addr = "00.0"
 154
 155[device "scsi-disk"]
 156  driver = "scsi-hd"
 157  bus = "scsi.0"
 158  drive = "disk"
 159  bootindex = "1"
 160
 161[drive "disk"]
 162  file = "guest.qcow2"                          # CHANGE ME
 163  format = "qcow2"
 164  if = "none"
 165
 166[device "scsi-optical-disk"]
 167  driver = "scsi-cd"
 168  bus = "scsi.0"
 169  drive = "optical-disk"
 170  bootindex = "2"
 171
 172[drive "optical-disk"]
 173  file = "install.iso"                          # CHANGE ME
 174  format = "raw"
 175  if = "none"
 176
 177
 178# Ethernet controller
 179# =========================================================
 180#
 181# We use virtio-net for improved performance over emulated
 182# hardware; on the host side, we take advantage of user
 183# networking so that the QEMU process doesn't require any
 184# additional privileges.
 185
 186[netdev "hostnet"]
 187  type = "user"
 188
 189[device "net"]
 190  driver = "virtio-net-pci"
 191  netdev = "hostnet"
 192  bus = "pcie.2"
 193  addr = "00.0"
 194