qemu/docs/qdev-device-use.txt

23 Example: device i440FX-pcihost is on the root bus, and provides a PCI
25 FOO,bus=/i440FX-pcihost/pci.0,addr=4.  The abbreviated form bus=pci.0
26 also works as long as the bus name is unique.
32 In the general case, the guest device is connected to a controller
33 device.  For instance, the IDE controller provides two IDE buses, each
38 together into a single device.  For instance, the ISA floppy
41 The old ways to define block devices define host and guest part
43 addition to the block device.
45 The new way keeps the parts separate: you create the host part with
48 The various old ways to define drives all boil down to the common form
52 TYPE, BUS and UNIT identify the controller device, which of its buses
53 to use, and the drive's address on that bus.  Details depend on TYPE.
57 In the new way, this becomes something like
62 The old OPTS get split into HOST-OPTS and DEV-OPTS as follows:
73 * media is special.  In the old way, it selects disk vs. CD-ROM with
74   if=ide, if=scsi and if=xen.  The new way uses DEVNAME for that.
79 The -device argument differs in detail for each type of drive:
90   The old way implicitly creates SCSI controllers as needed.  The new
96   control the PCI device address.
110   1.  You can use -nodefaults to suppress the default unit 0, see
123   control the PCI device address.  This replaces option addr available
128 For USB devices, the old way was actually different:
134 The old way provided much less control than -drive's OPTS...  The new
139 The removable parameter gives control over the SCSI INQUIRY removable
145 automatically.  The automatic creation guesses what kind of guest part
146 to create from the host part, like -drive if=scsi.  Host and guest
153 The old ways to define character devices define host and guest part
156 The new way keeps the parts separate: you create the host part with
157 -chardev, and the guest device with -device.
159 The various old ways to define a character device are all of the
164 where FOO-OPTS... is specific to -FOO, and the host part
165 LEGACY-CHARDEV is the same everywhere.
167 In the new way, this becomes
172 The appropriate DEVNAME depends on the machine type.  For type "pc":
225 * mon:LEGACY-CHARDEV is special: it multiplexes the monitor onto the
229   switching the input focus.
240 The old way to define the guest part looks like this:
250 The new way is -device:
254 DEVNAME equals MODEL, except for virtio you have to name the virtio
255 device appropriate for the bus (virtio-net-pci for PCI), and for USB
258 The old name=ID parameter becomes the usual id=ID with -device.
260 For PCI devices, you can add bus=PCI-BUS,addr=DEVFN to control the PCI
261 device address, as usual.  The old -net nic provides parameter addr
262 for that, which is silently ignored when the NIC is not a PCI device.
280 The old way to define the guest graphics device is -vga VGA.  Not all
283 The new way is -device.  The mapping from -vga argument to -device
284 depends on the machine type.  For machine "pc", it's:
294 the PCI device address.
306 Bug: the new way doesn't work for machine types "pc" and "isapc",
314 The old way to define guest audio devices is -soundhw C1,...
316 The new way is to define each guest audio device separately with
330 For PCI devices, you can add bus=PCI-BUS,addr=DEVFN to control the PCI
335 The old way to define a virtual USB device is -usbdevice DRIVER:OPTS...
337 The new way is -device DEVNAME,DEV-OPTS...  Details depend on DRIVER:
358 The old way to define a guest watchdog device is -watchdog DEVNAME.
359 The new way is -device DEVNAME.  For PCI devices, you can add
360 bus=PCI-BUS,addr=DEVFN to control the PCI device address, as usual.
369 The old way to assign a USB host device
373 was removed in v2.12.0.  Any of BUS, ADDR, VID, PRID could be the
376 The new way is
384 QEMU creates a number of devices by default, depending on the machine
399 The default NIC is connected to a default part created along with it.
401 that a bug).  -net and -netdev suppress the default NIC.
403 -nodefaults suppresses all the default devices mentioned above, plus a