qemu/docs/qdev-device-use.txt

30 A QEMU block device (drive) has a host and a guest part.
35 and is connected to a host part.
39 controller is connected to up to two host drives.
41 The old ways to define block devices define host and guest part
45 The new way keeps the parts separate: you create the host part with
59    -drive if=none,id=DRIVE-ID,HOST-OPTS...
62 The old OPTS get split into HOST-OPTS and DEV-OPTS as follows:
65   HOST-OPTS.
67 * cyls, head, secs and trans go into HOST-OPTS.  Future work: they
75   Additionally, readonly=on goes into HOST-OPTS.
146 to create from the host part, like -drive if=scsi.  Host and guest
151 A QEMU character device has a host and a guest part.
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
164 where FOO-OPTS... is specific to -FOO, and the host part
169     -chardev HOST-OPTS...,id=CHR-ID
191 LEGACY-CHARDEV translates to -chardev HOST-OPTS... as follows:
209 * tcp:HOST:PORT,OPTS... becomes -chardev socket,host=HOST,port=PORT,OPTS...
211 * telnet:HOST:PORT,OPTS... becomes
212   -chardev socket,host=HOST,port=PORT,OPTS...,telnet=on
214 * udp:HOST:PORT@LOCALADDR:LOCALPORT becomes
215   -chardev udp,host=HOST,port=PORT,localaddr=LOCALADDR,localport=LOCALPORT
228   single host part.  You need to pass mux=on to -chardev to enable
234 LEGACY-CHARDEV to refer to a host part defined with -chardev.
238 Host and guest part of network devices have always been separate.
278 Host and guest part of graphics devices have always been separate.
312 Host and guest part of audio devices have always been separate.
349 * host:...        See "Host Device Assignment"
356 Host and guest part of watchdog devices have always been separate.
362 === Host Device Assignment ===
364 QEMU supports assigning host PCI devices (qemu-kvm only at this time)
365 and host USB devices.  PCI devices can only be assigned with -device:
367     -device vfio-pci,host=ADDR,id=ID
369 The old way to assign a USB host device
371     -usbdevice host:auto:BUS.ADDR:VID:PRID
378     -device usb-host,hostbus=BUS,hostaddr=ADDR,vendorid=VID,productid=PRID