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
  65 [accel]
  66   accel = "kvm"
  67
  68 [memory]
  69   size = "1024"
  70
  71
  72 # PCI bridge (PCI Express Root Ports)
  73 # =========================================================
  74 #
  75 # We add four PCI Express Root Ports, all sharing the same
  76 # slot on the PCI Express  Root Bus. These ports support
  77 # hotplug.
  78
  79 [device "ich9-pcie-port-1"]
  80   driver = "ioh3420"
  81   multifunction = "on"
  82   bus = "pcie.0"
  83   addr = "1c.0"
  84   port = "1"
  85   chassis = "1"
  86
  87 [device "ich9-pcie-port-2"]
  88   driver = "ioh3420"
  89   multifunction = "on"
  90   bus = "pcie.0"
  91   addr = "1c.1"
  92   port = "2"
  93   chassis = "2"
  94
  95 [device "ich9-pcie-port-3"]
  96   driver = "ioh3420"
  97   multifunction = "on"
  98   bus = "pcie.0"
  99   addr = "1c.2"
 100   port = "3"
 101   chassis = "3"
 102
 103 [device "ich9-pcie-port-4"]
 104   driver = "ioh3420"
 105   multifunction = "on"
 106   bus = "pcie.0"
 107   addr = "1c.3"
 108   port = "4"
 109   chassis = "4"
 110
 111
 112 # PCI bridge (legacy PCI bridge)
 113 # =========================================================
 114 #
 115 # This bridge can be used to build an independent topology
 116 # for legacy PCI devices. PCI Express devices should be
 117 # plugged into PCI Express slots instead, so ideally there
 118 # will be no devices connected to this bridge.
 119
 120 [device "ich9-pci-bridge"]
 121   driver = "i82801b11-bridge"
 122   bus = "pcie.0"
 123   addr = "1e.0"
 124
 125
 126 # SATA storage
 127 # =========================================================
 128 #
 129 # An implicit SATA controller is created automatically for
 130 # every single q35 guest; here we create a disk, backed by
 131 # a qcow2 disk image on the host's filesystem, and attach
 132 # it to that controller so that the guest can use it.
 133 #
 134 # We also create an optical disk, mostly for installation
 135 # purposes: once the guest OS has been successfully
 136 # installed, the guest will no longer boot from optical
 137 # media. If you don't want, or no longer want, to have an
 138 # optical disk in the guest you can safely comment out
 139 # all relevant sections below.
 140
 141 [device "sata-disk"]
 142   driver = "ide-hd"
 143   bus = "ide.0"
 144   drive = "disk"
 145   bootindex = "1"
 146
 147 [drive "disk"]
 148   file = "guest.qcow2"                          # CHANGE ME
 149   format = "qcow2"
 150   if = "none"
 151
 152 [device "sata-optical-disk"]
 153   driver = "ide-cd"
 154   bus = "ide.1"
 155   drive = "optical-disk"
 156   bootindex = "2"
 157
 158 [drive "optical-disk"]
 159   file = "install.iso"                          # CHANGE ME
 160   format = "raw"
 161   if = "none"
 162
 163
 164 # USB controller (#1)
 165 # =========================================================
 166 #
 167 # EHCI controller + UHCI companion controllers.
 168
 169 [device "ich9-ehci-1"]
 170   driver = "ich9-usb-ehci1"
 171   multifunction = "on"
 172   bus = "pcie.0"
 173   addr = "1d.7"
 174
 175 [device "ich9-uhci-1"]
 176   driver = "ich9-usb-uhci1"
 177   multifunction = "on"
 178   bus = "pcie.0"
 179   addr = "1d.0"
 180   masterbus = "ich9-ehci-1.0"
 181   firstport = "0"
 182
 183 [device "ich9-uhci-2"]
 184   driver = "ich9-usb-uhci2"
 185   multifunction = "on"
 186   bus = "pcie.0"
 187   addr = "1d.1"
 188   masterbus = "ich9-ehci-1.0"
 189   firstport = "2"
 190
 191 [device "ich9-uhci-3"]
 192   driver = "ich9-usb-uhci3"
 193   multifunction = "on"
 194   bus = "pcie.0"
 195   addr = "1d.2"
 196   masterbus = "ich9-ehci-1.0"
 197   firstport = "4"
 198
 199
 200 # USB controller (#2)
 201 # =========================================================
 202 #
 203 # EHCI controller + UHCI companion controllers.
 204
 205 [device "ich9-ehci-2"]
 206   driver = "ich9-usb-ehci2"
 207   multifunction = "on"
 208   bus = "pcie.0"
 209   addr = "1a.7"
 210
 211 [device "ich9-uhci-4"]
 212   driver = "ich9-usb-uhci4"
 213   multifunction = "on"
 214   bus = "pcie.0"
 215   addr = "1a.0"
 216   masterbus = "ich9-ehci-2.0"
 217   firstport = "0"
 218
 219 [device "ich9-uhci-5"]
 220   driver = "ich9-usb-uhci5"
 221   multifunction = "on"
 222   bus = "pcie.0"
 223   addr = "1a.1"
 224   masterbus = "ich9-ehci-2.0"
 225   firstport = "2"
 226
 227 [device "ich9-uhci-6"]
 228   driver = "ich9-usb-uhci6"
 229   multifunction = "on"
 230   bus = "pcie.0"
 231   addr = "1a.2"
 232   masterbus = "ich9-ehci-2.0"
 233   firstport = "4"
 234
 235
 236 # Ethernet controller
 237 # =========================================================
 238 #
 239 # We add a Gigabit Ethernet interface to the guest; on the
 240 # host side, we take advantage of user networking so that
 241 # the QEMU process doesn't require any additional
 242 # privileges.
 243
 244 [netdev "hostnet"]
 245   type = "user"
 246
 247 [device "net"]
 248   driver = "e1000"
 249   netdev = "hostnet"
 250   bus = "pcie.0"
 251   addr = "19.0"
 252
 253
 254 # VGA compatible controller
 255 # =========================================================
 256 #
 257 # We use stdvga instead of Cirrus as it supports more video
 258 # modes and is closer to what actual hardware looks like.
 259 #
 260 # If you're running the guest on a remote, potentially
 261 # headless host, you will probably want to append something
 262 # like
 263 #
 264 #   -display vnc=127.0.0.1:0
 265 #
 266 # to the command line in order to prevent QEMU from
 267 # creating a graphical display window on the host and
 268 # enable remote access instead.
 269
 270 [device "video"]
 271   driver = "VGA"
 272   bus = "pcie.0"
 273   addr = "01.0"
 274
 275
 276 # Audio device
 277 # =========================================================
 278 #
 279 # The sound card is a legacy PCI device that is plugged
 280 # directly into the PCI Express Root Bus.
 281
 282 [device "ich9-hda-audio"]
 283   driver = "ich9-intel-hda"
 284   bus = "pcie.0"
 285   addr = "1b.0"
 286
 287 [device "ich9-hda-duplex"]
 288   driver = "hda-duplex"
 289   bus = "ich9-hda-audio.0"
 290   cad = "0"
 291   audiodev = "audiodev0"
 292
 293 [audiodev "audiodev0"]
 294   driver = "none"                      # CHANGE ME