Skip to content

Commit 480324e

Browse files
huthkraxel
authored andcommitted
docs/qdev-device-use: Clean up the sentences related to -usbdevice
Most of the -usbdevice paramaters have been removed already. Update the doc accordingly. Signed-off-by: Thomas Huth <[email protected]> Message-id: [email protected] Signed-off-by: Gerd Hoffmann <[email protected]>
1 parent 4f50d4a commit 480324e

File tree

1 file changed

+3
-25
lines changed

1 file changed

+3
-25
lines changed

docs/qdev-device-use.txt

Lines changed: 3 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -125,12 +125,7 @@ The -device argument differs in detail for each type of drive:
125125

126126
* if=pflash, if=mtd, if=sd, if=xen are not yet available with -device
127127

128-
For USB devices, the old way is actually different:
129-
130-
-usbdevice disk:format=FMT:FILENAME
131-
132-
Provides much less control than -drive's OPTS... The new way fixes
133-
that:
128+
For USB storage devices, you can use something like:
134129

135130
-device usb-storage,drive=DRIVE-ID,removable=RMB
136131

@@ -177,8 +172,6 @@ The appropriate DEVNAME depends on the machine type. For type "pc":
177172

178173
This lets you control I/O ports and IRQs.
179174

180-
* -usbdevice serial::chardev becomes -device usb-serial,chardev=dev.
181-
182175
* -usbdevice braille doesn't support LEGACY-CHARDEV syntax. It always
183176
uses "braille". With -device, this useful default is gone, so you
184177
have to use something like
@@ -238,10 +231,6 @@ The old way to define the guest part looks like this:
238231

239232
-net nic,netdev=NET-ID,macaddr=MACADDR,model=MODEL,name=ID,addr=STR,vectors=V
240233

241-
Except for USB it looks like this:
242-
243-
-usbdevice net:netdev=NET-ID,macaddr=MACADDR,name=ID
244-
245234
The new way is -device:
246235

247236
-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:
336325
* mouse -device usb-mouse
337326
* tablet -device usb-tablet
338327
* wacom-tablet -device usb-wacom-tablet
339-
* host:... See "Host Device Assignment"
340-
* disk:... See "Block Devices"
341-
* serial:... See "Character Devices"
342328
* braille See "Character Devices"
343-
* net:... See "Network Devices"
344-
* bt:... not yet available with -device
345329

346330
=== Watchdog Devices ===
347331

@@ -358,17 +342,11 @@ and host USB devices. PCI devices can only be assigned with -device:
358342

359343
-device vfio-pci,host=ADDR,id=ID
360344

361-
The old way to assign a host USB device is
362-
363-
-usbdevice host:auto:BUS.ADDR:VID:PRID
364-
365-
where any of BUS, ADDR, VID, PRID can be the wildcard *.
366-
367-
The new way is
345+
To assign a host USB device use:
368346

369347
-device usb-host,hostbus=BUS,hostaddr=ADDR,vendorid=VID,productid=PRID
370348

371-
Omitted options match anything, just like the old way's wildcard.
349+
Omitted options match anything.
372350

373351
=== Default Devices ===
374352

0 commit comments

Comments
 (0)