]> git.proxmox.com Git - mirror_qemu.git/blame - docs/q35-emulated.cfg
qcow2: Discard unaligned tail when wiping image
[mirror_qemu.git] / docs / q35-emulated.cfg
CommitLineData
9ca019c1
AB
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 succesfully
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"