From patchwork Tue Sep 20 12:01:10 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Juergen Gross X-Patchwork-Id: 9341531 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 404FE607D0 for ; Tue, 20 Sep 2016 12:03:56 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3173929625 for ; Tue, 20 Sep 2016 12:03:56 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2632D2962A; Tue, 20 Sep 2016 12:03:56 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id BFFB529625 for ; Tue, 20 Sep 2016 12:03:51 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmJjj-00046y-J8; Tue, 20 Sep 2016 12:01:19 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmJji-00046E-8M for xen-devel@lists.xen.org; Tue, 20 Sep 2016 12:01:18 +0000 Received: from [193.109.254.147] by server-9.bemta-6.messagelabs.com id AE/8F-28857-D0521E75; Tue, 20 Sep 2016 12:01:17 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrCLMWRWlGSWpSXmKPExsVyuP0Ovy6v6sN wgx3NLBZLPi5mcWD0OLr7N1MAYxRrZl5SfkUCa8bHO3YF03grOg5+ZmpgbOTuYuTkkBAwkng7 8R9TFyMXh5DAQkaJVaeesoEk2ARUJTZcP8UKYosISEtc+3yZEcRmFiiWWPDtBVCcg0NYwFniz 69IkDALUPn8N1fBynkF7CRmPr3GBjFfTuL6zOlMIDangL3Ewd7/zCC2EFDN6tlvWCcwci9gZF jFqFGcWlSWWqRrZKGXVJSZnlGSm5iZo2toYKaXm1pcnJiempOYVKyXnJ+7iRHoWwYg2MF4fm3 gIUZJDiYlUV45vgfhQnxJ+SmVGYnFGfFFpTmpxYcYZTg4lCR4Pyg/DBcSLEpNT61Iy8wBBhlM WoKDR0mE9xtImre4IDG3ODMdInWKUVFKnPcmSEIAJJFRmgfXBgvsS4yyUsK8jECHCPEUpBblZ pagyr9iFOdgVBLm1VEBmsKTmVcCN/0V0GImoMVbfj4AWVySiJCSamDc5jA5Y4WKznfbHwdeTz 58uvmo/PyPKma/nhpkp6he/7Db9YFj+wq7r5ekFf6Eujx7+nSlyauqf2t91+mYT4mcPFt0/U/ Rm29vTDL7mbD83uHtAs7JFndlnzM8qktInXT9ToQAE8OqNZe+ttzcmPn1+oTc64E6/Ik7piaH 79M6ueNd4jJ/1ifF95RYijMSDbWYi4oTAc6rLEtnAgAA X-Env-Sender: jgross@suse.com X-Msg-Ref: server-15.tower-27.messagelabs.com!1474372876!7347881!1 X-Originating-IP: [195.135.220.15] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 8.84; banners=-,-,- X-VirusChecked: Checked Received: (qmail 61354 invoked from network); 20 Sep 2016 12:01:17 -0000 Received: from mx2.suse.de (HELO mx2.suse.de) (195.135.220.15) by server-15.tower-27.messagelabs.com with DHE-RSA-CAMELLIA256-SHA encrypted SMTP; 20 Sep 2016 12:01:17 -0000 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay1.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id 9F8B2ADAA; Tue, 20 Sep 2016 12:01:16 +0000 (UTC) From: Juergen Gross To: xen-devel@lists.xen.org Date: Tue, 20 Sep 2016 14:01:10 +0200 Message-Id: <1474372870-9408-5-git-send-email-jgross@suse.com> X-Mailer: git-send-email 2.6.6 In-Reply-To: <1474372870-9408-1-git-send-email-jgross@suse.com> References: <1474372870-9408-1-git-send-email-jgross@suse.com> Cc: George.Dunlap@eu.citrix.com, wei.liu2@citrix.com, ian.jackson@eu.citrix.com, Juergen Gross Subject: [Xen-devel] [PATCH v3 4/4] docs: add HVM USB passthrough documentation X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP Update the man page regarding passthrough of USB devices to HVM domains via qemu USB emulation. Signed-off-by: Juergen Gross Acked-by: Wei Liu Acked-by: Ian Jackson --- 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 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 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.