Update the man page regarding passthrough of USB devices to HVM domains via qemu USB emulation.
Signed-off-by: Juergen Gross <jgr...@suse.com> Acked-by: Wei Liu <wei.l...@citrix.com> Acked-by: Ian Jackson <ian.jack...@eu.citrix.com> --- V3: wording adjusted (Ian Jackson) --- docs/man/xl.cfg.pod.5.in | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in index 77a1be3..d8108e3 100644 --- a/docs/man/xl.cfg.pod.5.in +++ b/docs/man/xl.cfg.pod.5.in @@ -745,19 +745,29 @@ Specifies the usb controller type. "qusb" specifies a qemu base backend for pvusb. +"devicemodel" specifies a USB controller emulated by qemu. +It will show up as a PCI-device in the guest. + "auto" (the default) determines whether a kernel based backend is installed. If this is the case, "pv" is selected, "qusb" will be selected if no kernel backend is currently available. +For HVM domains "devicemodel" will be selected. =item B<version=VERSION> Specifies the usb controller version. Possible values include -1 (USB1.1) and 2 (USB2.0). Default is 2 (USB2.0). +1 (USB1.1), 2 (USB2.0) and 3 (USB3.0). +Default is 2 (USB2.0). +3 (USB3.0) is available for the type "devicemodel" only. =item B<ports=PORTS> Specifies the total ports of the usb controller. The maximum number is 31. Default is 8. +With the type "devicemodel" the number of ports is more limited: +a USB1.1 controller always has 2 ports, +a USB2.0 controller always has 6 ports +and a USB3.0 controller can have up to 15 ports. USB controller ids start from 0. In line with the USB spec, however, ports on a controller start from 1. -- 2.6.6 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xen.org https://lists.xen.org/xen-devel
