dfaggioli/qemu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs/qdev-device-use: Clean up the sentences related to -usbdevice

Browse Source 
Most of the -usbdevice paramaters have been removed already. Update
the doc accordingly.

Signed-off-by: Thomas Huth <thuth@redhat.com>
Message-id: 20200710065520.24784-1-thuth@redhat.com
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
This commit is contained in:
Thomas Huth
2020-07-10 08:55:20 +02:00
committed by Gerd Hoffmann
parent 4f50d4a48e
commit 480324ec8d
1 changed files with 3 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/qdev-device-use.txt
View File

@@ -125,12 +125,7 @@ The -device argument differs in detail for each type of drive:
* if=pflash, if=mtd, if=sd, if=xen are not yet available with -device * if=pflash, if=mtd, if=sd, if=xen are not yet available with -device
For USB devices, the old way is actually different: For USB storage devices, you can use something like:
-usbdevice disk:format=FMT:FILENAME
Provides much less control than -drive's OPTS... The new way fixes
that:
-device usb-storage,drive=DRIVE-ID,removable=RMB -device usb-storage,drive=DRIVE-ID,removable=RMB
@@ -177,8 +172,6 @@ The appropriate DEVNAME depends on the machine type. For type "pc":
This lets you control I/O ports and IRQs. This lets you control I/O ports and IRQs.
* -usbdevice serial::chardev becomes -device usb-serial,chardev=dev.
* -usbdevice braille doesn't support LEGACY-CHARDEV syntax. It always * -usbdevice braille doesn't support LEGACY-CHARDEV syntax. It always
uses "braille". With -device, this useful default is gone, so you uses "braille". With -device, this useful default is gone, so you
have to use something like have to use something like
@@ -238,10 +231,6 @@ The old way to define the guest part looks like this:
-net nic,netdev=NET-ID,macaddr=MACADDR,model=MODEL,name=ID,addr=STR,vectors=V -net nic,netdev=NET-ID,macaddr=MACADDR,model=MODEL,name=ID,addr=STR,vectors=V
Except for USB it looks like this:
-usbdevice net:netdev=NET-ID,macaddr=MACADDR,name=ID
The new way is -device: The new way is -device:
-device DEVNAME,netdev=NET-ID,mac=MACADDR,DEV-OPTS... -device DEVNAME,netdev=NET-ID,mac=MACADDR,DEV-OPTS...
@@ -336,12 +325,7 @@ The new way is -device DEVNAME,DEV-OPTS... Details depend on DRIVER:
* mouse -device usb-mouse * mouse -device usb-mouse
* tablet -device usb-tablet * tablet -device usb-tablet
* wacom-tablet -device usb-wacom-tablet * wacom-tablet -device usb-wacom-tablet
* host:... See "Host Device Assignment"
* disk:... See "Block Devices"
* serial:... See "Character Devices"
* braille See "Character Devices" * braille See "Character Devices"
* net:... See "Network Devices"
* bt:... not yet available with -device
=== Watchdog Devices === === Watchdog Devices ===
@@ -358,17 +342,11 @@ and host USB devices. PCI devices can only be assigned with -device:
-device vfio-pci,host=ADDR,id=ID -device vfio-pci,host=ADDR,id=ID
The old way to assign a host USB device is To assign a host USB device use:
-usbdevice host:auto:BUS.ADDR:VID:PRID
where any of BUS, ADDR, VID, PRID can be the wildcard *.
The new way is
-device usb-host,hostbus=BUS,hostaddr=ADDR,vendorid=VID,productid=PRID -device usb-host,hostbus=BUS,hostaddr=ADDR,vendorid=VID,productid=PRID
Omitted options match anything, just like the old way's wildcard. Omitted options match anything.
=== Default Devices === === Default Devices ===