LXR qemu/docs/config/q35-emulated.cfg

   1# q35 - Emulated guest (graphical console)
   2# =========================================================
   3#
   4# Usage:
   5#
   6#   $ qemu-system-x86_64 \
   7#     -nodefaults \
   8#     -readconfig q35-emulated.cfg
   9#
  10# You will probably need to tweak the lines marked as
  11# CHANGE ME before being able to use this configuration!
  12#
  13# The guest will have a selection of emulated devices that
  14# closely resembles that of a physical machine, and will be
  15# accessed through a graphical console.
  16#
  17# ---------------------------------------------------------
  18#
  19# Using -nodefaults is required to have full control over
  20# the virtual hardware: when it's specified, QEMU will
  21# populate the board with only the builtin peripherals
  22# plus a small selection of core PCI devices and
  23# controllers; the user will then have to explicitly add
  24# further devices.
  25#
  26# The core PCI devices show up in the guest as:
  27#
  28#   00:00.0 Host bridge
  29#   00:1f.0 ISA bridge / LPC
  30#   00:1f.2 SATA (AHCI) controller
  31#   00:1f.3 SMBus controller
  32#
  33# This configuration file adds a number of devices that
  34# are pretty much guaranteed to be present in every single
  35# physical machine based on q35, more specifically:
  36#
  37#   00:01.0 VGA compatible controller
  38#   00:19.0 Ethernet controller
  39#   00:1a.* USB controller (#2)
  40#   00:1b.0 Audio device
  41#   00:1c.* PCI bridge (PCI Express Root Ports)
  42#   00:1d.* USB Controller (#1)
  43#   00:1e.0 PCI bridge (legacy PCI bridge)
  44#
  45# More information about these devices is available below.
  46
  47
  48# Machine options
  49# =========================================================
  50#
  51# We use the q35 machine type and enable KVM acceleration
  52# for better performance.
  53#
  54# Using less than 1 GiB of memory is probably not going to
  55# yield good performance in the guest, and might even lead
  56# to obscure boot issues in some cases.
  57#
  58# Unfortunately, there is no way to configure the CPU model
  59# in this file, so it will have to be provided on the
  60# command line.
  61
  62[machine]
  63  type = "q35"
  64  accel = "kvm"
  65
  66[memory]
  67  size = "1024"
  68
  69
  70# PCI bridge (PCI Express Root Ports)
  71# =========================================================
  72#
  73# We add four PCI Express Root Ports, all sharing the same
  74# slot on the PCI Express  Root Bus. These ports support
  75# hotplug.
  76
  77[device "ich9-pcie-port-1"]
  78  driver = "ioh3420"
  79  multifunction = "on"
  80  bus = "pcie.0"
  81  addr = "1c.0"
  82  port = "1"
  83  chassis = "1"
  84
  85[device "ich9-pcie-port-2"]
  86  driver = "ioh3420"
  87  multifunction = "on"
  88  bus = "pcie.0"
  89  addr = "1c.1"
  90  port = "2"
  91  chassis = "2"
  92
  93[device "ich9-pcie-port-3"]
  94  driver = "ioh3420"
  95  multifunction = "on"
  96  bus = "pcie.0"
  97  addr = "1c.2"
  98  port = "3"
  99  chassis = "3"
 100
 101[device "ich9-pcie-port-4"]
 102  driver = "ioh3420"
 103  multifunction = "on"
 104  bus = "pcie.0"
 105  addr = "1c.3"
 106  port = "4"
 107  chassis = "4"
 108
 109
 110# PCI bridge (legacy PCI bridge)
 111# =========================================================
 112#
 113# This bridge can be used to build an independent topology
 114# for legacy PCI devices. PCI Express devices should be
 115# plugged into PCI Express slots instead, so ideally there
 116# will be no devices connected to this bridge.
 117
 118[device "ich9-pci-bridge"]
 119  driver = "i82801b11-bridge"
 120  bus = "pcie.0"
 121  addr = "1e.0"
 122
 123
 124# SATA storage
 125# =========================================================
 126#
 127# An implicit SATA controller is created automatically for
 128# every single q35 guest; here we create a disk, backed by
 129# a qcow2 disk image on the host's filesystem, and attach
 130# it to that controller so that the guest can use it.
 131#
 132# We also create an optical disk, mostly for installation
 133# purposes: once the guest OS has been successfully
 134# installed, the guest will no longer boot from optical
 135# media. If you don't want, or no longer want, to have an
 136# optical disk in the guest you can safely comment out
 137# all relevant sections below.
 138
 139[device "sata-disk"]
 140  driver = "ide-hd"
 141  bus = "ide.0"
 142  drive = "disk"
 143  bootindex = "1"
 144
 145[drive "disk"]
 146  file = "guest.qcow2"                          # CHANGE ME
 147  format = "qcow2"
 148  if = "none"
 149
 150[device "sata-optical-disk"]
 151  driver = "ide-cd"
 152  bus = "ide.1"
 153  drive = "optical-disk"
 154  bootindex = "2"
 155
 156[drive "optical-disk"]
 157  file = "install.iso"                          # CHANGE ME
 158  format = "raw"
 159  if = "none"
 160
 161
 162# USB controller (#1)
 163# =========================================================
 164#
 165# EHCI controller + UHCI companion controllers.
 166
 167[device "ich9-ehci-1"]
 168  driver = "ich9-usb-ehci1"
 169  multifunction = "on"
 170  bus = "pcie.0"
 171  addr = "1d.7"
 172
 173[device "ich9-uhci-1"]
 174  driver = "ich9-usb-uhci1"
 175  multifunction = "on"
 176  bus = "pcie.0"
 177  addr = "1d.0"
 178  masterbus = "ich9-ehci-1.0"
 179  firstport = "0"
 180
 181[device "ich9-uhci-2"]
 182  driver = "ich9-usb-uhci2"
 183  multifunction = "on"
 184  bus = "pcie.0"
 185  addr = "1d.1"
 186  masterbus = "ich9-ehci-1.0"
 187  firstport = "2"
 188
 189[device "ich9-uhci-3"]
 190  driver = "ich9-usb-uhci3"
 191  multifunction = "on"
 192  bus = "pcie.0"
 193  addr = "1d.2"
 194  masterbus = "ich9-ehci-1.0"
 195  firstport = "4"
 196
 197
 198# USB controller (#2)
 199# =========================================================
 200#
 201# EHCI controller + UHCI companion controllers.
 202
 203[device "ich9-ehci-2"]
 204  driver = "ich9-usb-ehci2"
 205  multifunction = "on"
 206  bus = "pcie.0"
 207  addr = "1a.7"
 208
 209[device "ich9-uhci-4"]
 210  driver = "ich9-usb-uhci4"
 211  multifunction = "on"
 212  bus = "pcie.0"
 213  addr = "1a.0"
 214  masterbus = "ich9-ehci-2.0"
 215  firstport = "0"
 216
 217[device "ich9-uhci-5"]
 218  driver = "ich9-usb-uhci5"
 219  multifunction = "on"
 220  bus = "pcie.0"
 221  addr = "1a.1"
 222  masterbus = "ich9-ehci-2.0"
 223  firstport = "2"
 224
 225[device "ich9-uhci-6"]
 226  driver = "ich9-usb-uhci6"
 227  multifunction = "on"
 228  bus = "pcie.0"
 229  addr = "1a.2"
 230  masterbus = "ich9-ehci-2.0"
 231  firstport = "4"
 232
 233
 234# Ethernet controller
 235# =========================================================
 236#
 237# We add a Gigabit Ethernet interface to the guest; on the
 238# host side, we take advantage of user networking so that
 239# the QEMU process doesn't require any additional
 240# privileges.
 241
 242[netdev "hostnet"]
 243  type = "user"
 244
 245[device "net"]
 246  driver = "e1000"
 247  netdev = "hostnet"
 248  bus = "pcie.0"
 249  addr = "19.0"
 250
 251
 252# VGA compatible controller
 253# =========================================================
 254#
 255# We use stdvga instead of Cirrus as it supports more video
 256# modes and is closer to what actual hardware looks like.
 257#
 258# If you're running the guest on a remote, potentially
 259# headless host, you will probably want to append something
 260# like
 261#
 262#   -display vnc=127.0.0.1:0
 263#
 264# to the command line in order to prevent QEMU from
 265# creating a graphical display window on the host and
 266# enable remote access instead.
 267
 268[device "video"]
 269  driver = "VGA"
 270  bus = "pcie.0"
 271  addr = "01.0"
 272
 273
 274# Audio device
 275# =========================================================
 276#
 277# The sound card is a legacy PCI device that is plugged
 278# directly into the PCI Express Root Bus.
 279
 280[device "ich9-hda-audio"]
 281  driver = "ich9-intel-hda"
 282  bus = "pcie.0"
 283  addr = "1b.0"
 284
 285[device "ich9-hda-duplex"]
 286  driver = "hda-duplex"
 287  bus = "ich9-hda-audio.0"
 288  cad = "0"
 289