stubs: Move qemu_timer_notify_cb() and remove qemu_notify_event() stub
[qemu.git] / docs / config / q35-virtio-graphical.cfg
1 # q35 - VirtIO guest (graphical console)
2 # =========================================================
3 #
4 # Usage:
5 #
6 #   $ qemu-system-x86_64 \
7 #     -nodefaults \
8 #     -readconfig q35-virtio-graphical.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 VirtIO devices
14 # tailored towards optimal performance with modern guests,
15 # and will be 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 other useful
34 # devices, more specifically:
35 #
36 #   00:01.0 VGA compatible controller
37 #   00:1b.0 Audio device
38 #   00.1c.* PCI bridge (PCI Express Root Ports)
39 #   01:00.0 SCSI storage controller
40 #   02:00.0 Ethernet controller
41 #   03:00.0 USB controller
42 #
43 # More information about these devices is available below.
44
45
46 # Machine options
47 # =========================================================
48 #
49 # We use the q35 machine type and enable KVM acceleration
50 # for better performance.
51 #
52 # Using less than 1 GiB of memory is probably not going to
53 # yield good performance in the guest, and might even lead
54 # to obscure boot issues in some cases.
55
56 [machine]
57   type = "q35"
58   accel = "kvm"
59
60 [memory]
61   size = "1024"
62
63
64 # PCI bridge (PCI Express Root Ports)
65 # =========================================================
66 #
67 # We create eight PCI Express Root Ports, and we plug them
68 # all into separate functions of the same slot. Some of
69 # them will be used by devices, the rest will remain
70 # available for hotplug.
71
72 [device "pcie.1"]
73   driver = "pcie-root-port"
74   bus = "pcie.0"
75   addr = "1c.0"
76   port = "1"
77   chassis = "1"
78   multifunction = "on"
79
80 [device "pcie.2"]
81   driver = "pcie-root-port"
82   bus = "pcie.0"
83   addr = "1c.1"
84   port = "2"
85   chassis = "2"
86
87 [device "pcie.3"]
88   driver = "pcie-root-port"
89   bus = "pcie.0"
90   addr = "1c.2"
91   port = "3"
92   chassis = "3"
93
94 [device "pcie.4"]
95   driver = "pcie-root-port"
96   bus = "pcie.0"
97   addr = "1c.3"
98   port = "4"
99   chassis = "4"
100
101 [device "pcie.5"]
102   driver = "pcie-root-port"
103   bus = "pcie.0"
104   addr = "1c.4"
105   port = "5"
106   chassis = "5"
107
108 [device "pcie.6"]
109   driver = "pcie-root-port"
110   bus = "pcie.0"
111   addr = "1c.5"
112   port = "6"
113   chassis = "6"
114
115 [device "pcie.7"]
116   driver = "pcie-root-port"
117   bus = "pcie.0"
118   addr = "1c.6"
119   port = "7"
120   chassis = "7"
121
122 [device "pcie.8"]
123   driver = "pcie-root-port"
124   bus = "pcie.0"
125   addr = "1c.7"
126   port = "8"
127   chassis = "8"
128
129
130 # SCSI storage controller (and storage)
131 # =========================================================
132 #
133 # We use virtio-scsi here so that we can (hot)plug a large
134 # number of disks without running into issues; a SCSI disk,
135 # backed by a qcow2 disk image on the host's filesystem, is
136 # attached to it.
137 #
138 # We also create an optical disk, mostly for installation
139 # purposes: once the guest OS has been successfully
140 # installed, the guest will no longer boot from optical
141 # media. If you don't want, or no longer want, to have an
142 # optical disk in the guest you can safely comment out
143 # all relevant sections below.
144
145 [device "scsi"]
146   driver = "virtio-scsi-pci"
147   bus = "pcie.1"
148   addr = "00.0"
149
150 [device "scsi-disk"]
151   driver = "scsi-hd"
152   bus = "scsi.0"
153   drive = "disk"
154   bootindex = "1"
155
156 [drive "disk"]
157   file = "guest.qcow2"                          # CHANGE ME
158   format = "qcow2"
159   if = "none"
160
161 [device "scsi-optical-disk"]
162   driver = "scsi-cd"
163   bus = "scsi.0"
164   drive = "optical-disk"
165   bootindex = "2"
166
167 [drive "optical-disk"]
168   file = "install.iso"                          # CHANGE ME
169   format = "raw"
170   if = "none"
171
172
173 # Ethernet controller
174 # =========================================================
175 #
176 # We use virtio-net for improved performance over emulated
177 # hardware; on the host side, we take advantage of user
178 # networking so that the QEMU process doesn't require any
179 # additional privileges.
180
181 [netdev "hostnet"]
182   type = "user"
183
184 [device "net"]
185   driver = "virtio-net-pci"
186   netdev = "hostnet"
187   bus = "pcie.2"
188   addr = "00.0"
189
190
191 # USB controller (and input devices)
192 # =========================================================
193 #
194 # We add a virtualization-friendly USB 3.0 controller and
195 # a USB tablet so that graphical guests can be controlled
196 # appropriately. A USB keyboard is not needed, as q35
197 # guests get a PS/2 one added automatically.
198
199 [device "usb"]
200   driver = "nec-usb-xhci"
201   bus = "pcie.3"
202   addr = "00.0"
203
204 [device "tablet"]
205   driver = "usb-tablet"
206   bus = "usb.0"
207
208
209 # VGA compatible controller
210 # =========================================================
211 #
212 # We plug the QXL video card directly into the PCI Express
213 # Root Bus as it is a legacy PCI device; this way, we can
214 # reduce the number of PCI Express controllers in the
215 # guest.
216 #
217 # If you're running the guest on a remote, potentially
218 # headless host, you will probably want to append something
219 # like
220 #
221 #   -display vnc=127.0.0.1:0
222 #
223 # to the command line in order to prevent QEMU from
224 # creating a graphical display window on the host and
225 # enable remote access instead.
226
227 [device "video"]
228   driver = "qxl-vga"
229   bus = "pcie.0"
230   addr = "01.0"
231
232
233 # Audio device
234 # =========================================================
235 #
236 # Like the video card, the sound card is a legacy PCI
237 # device and as such can be plugged directly into the PCI
238 # Express Root Bus.
239
240 [device "sound"]
241   driver = "ich9-intel-hda"
242   bus = "pcie.0"
243   addr = "1b.0"
244
245 [device "duplex"]
246   driver = "hda-duplex"
247   bus = "sound.0"
248   cad = "0"