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

usb: Document the missing -usbdevice options

Browse Source 
There are some more -usbdevice options that have never been mentioned
in the documentation. Now that we removed -usbdevice from the list
of deprecated features again, we should document them properly.

While we're at it, also sort them alphabetically.

Signed-off-by: Thomas Huth <thuth@redhat.com>
Message-Id: <20210310173323.1422754-5-thuth@redhat.com>
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
This commit is contained in:
Thomas Huth 2021-03-10 18:33:23 +01:00 committed by Gerd Hoffmann
parent 6db34277e3
commit c2a34ab2a0
1 changed files with 29 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
qemu-options.hx
View File

@ -1705,7 +1705,7 @@ ERST
DEFHEADING() DEFHEADING()
DEFHEADING(USB options:) DEFHEADING(USB convenience options:)
DEF("usb", 0, QEMU_OPTION_usb, DEF("usb", 0, QEMU_OPTION_usb,
"-usb enable on-board USB host controller (if not enabled by default)\n", "-usb enable on-board USB host controller (if not enabled by default)\n",
@ -1723,9 +1723,31 @@ DEF("usbdevice", HAS_ARG, QEMU_OPTION_usbdevice,
QEMU_ARCH_ALL) QEMU_ARCH_ALL)
SRST SRST
``-usbdevice devname`` ``-usbdevice devname``
Add the USB device devname. Note that this option is deprecated, Add the USB device devname, and enable an on-board USB controller
please use ``-device usb-...`` instead. See the chapter about if possible and necessary (just like it can be done via
``-machine usb=on``). Note that this option is mainly intended for
the user's convenience only. More fine-grained control can be
achieved by selecting a USB host controller (if necessary) and the
desired USB device via the ``-device`` option instead. For example,
instead of using ``-usbdevice mouse`` it is possible to use
``-device qemu-xhci -device usb-mouse`` to connect the USB mouse
to a USB 3.0 controller instead (at least on machines that support
PCI and do not have an USB controller enabled by default yet).
For more details, see the chapter about
:ref:`Connecting USB devices` in the System Emulation Users Guide. :ref:`Connecting USB devices` in the System Emulation Users Guide.
Possible devices for devname are:
``braille``
Braille device. This will use BrlAPI to display the braille
output on a real or fake device (i.e. it also creates a
corresponding ``braille`` chardev automatically beside the
``usb-braille`` USB device).
``ccid``
Smartcard reader device
``keyboard``
Standard USB keyboard. Will override the PS/2 keyboard (if present).
``mouse`` ``mouse``
Virtual Mouse. This will override the PS/2 mouse emulation when Virtual Mouse. This will override the PS/2 mouse emulation when
@ -1737,9 +1759,10 @@ SRST
position without having to grab the mouse. Also overrides the position without having to grab the mouse. Also overrides the
PS/2 mouse emulation when activated. PS/2 mouse emulation when activated.
``braille`` ``wacom-tablet``
Braille device. This will use BrlAPI to display the braille Wacom PenPartner USB tablet.
output on a real or fake device.
ERST ERST
DEFHEADING() DEFHEADING()