From patchwork Tue Jun 27 17:14:58 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Venu Busireddy X-Patchwork-Id: 9812813 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 754EC60351 for ; Tue, 27 Jun 2017 17:17:57 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5AA79281F9 for ; Tue, 27 Jun 2017 17:17:57 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 4F4542858E; Tue, 27 Jun 2017 17:17:57 +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, UNPARSEABLE_RELAY 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 F031C281F9 for ; Tue, 27 Jun 2017 17:17:56 +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 1dPu5j-000856-4V; Tue, 27 Jun 2017 17:15:55 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dPu5h-00084J-PK for xen-devel@lists.xen.org; Tue, 27 Jun 2017 17:15:53 +0000 Received: from [193.109.254.147] by server-9.bemta-6.messagelabs.com id 3E/96-03557-9C292595; Tue, 27 Jun 2017 17:15:53 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrNLMWRWlGSWpSXmKPExsXSO6nOVffEpKB Ig/NT1SyWfFzM4sDocXT3b6YAxijWzLyk/IoE1ozbs9azFOwXqJg97SFTA+Nf3i5GTg4hgYlM EtN/JHYxcgHZvxkl7r3ZxALhbGSU2DL/DzOEM5FR4suBlywgLWwCBhJHD/ewgtgiArkSF7uPs oHYzALSEteevAWzhQVMJSbM28IEYrMIqErcO/IIrJdXwFbi0c0/YL0SAnISS7dfZwaxOQXsJJ pX/mCFOMlWYvu0DmaIGkOJzxuXMk9g5FvAyLCKUb04tagstUjXUC+pKDM9oyQ3MTNH19DATC8 3tbg4MT01JzGpWC85P3cTIzBQGIBgB+PO506HGCU5mJREeU91BkUK8SXlp1RmJBZnxBeV5qQW H2KU4eBQkuA9MhEoJ1iUmp5akZaZAwxZmLQEB4+SCC/PBKA0b3FBYm5xZjpE6hSjopQ4bytIn wBIIqM0D64NFieXGGWlhHkZgQ4R4ilILcrNLEGVf8UozsGoJMzLDzKeJzOvBG76K6DFTECLWe YFgCwuSURISTUwiuoaGEofWxESJqHEUrXhhfaqR6o7FDIm1slET1e+yds36ZLvqUmx7u+eGRi wCRYeie9i+Gf9fusbaY8CUb1d5bKfynYbxRxpOL7mwqs816cffR97tounZM3/0Bh1VefUqiMr ncRPnmZdbx2esm33GkfbvVqyM449Kz50/IPv47NnW+czvJ8RrsRSnJFoqMVcVJwIADsqf9eOA gAA X-Env-Sender: venu.busireddy@oracle.com X-Msg-Ref: server-10.tower-27.messagelabs.com!1498583751!86520313!1 X-Originating-IP: [141.146.126.69] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogMTQxLjE0Ni4xMjYuNjkgPT4gMjc3MjE4\n X-StarScan-Received: X-StarScan-Version: 9.4.19; banners=-,-,- X-VirusChecked: Checked Received: (qmail 45546 invoked from network); 27 Jun 2017 17:15:52 -0000 Received: from aserp1040.oracle.com (HELO aserp1040.oracle.com) (141.146.126.69) by server-10.tower-27.messagelabs.com with DHE-RSA-AES256-GCM-SHA384 encrypted SMTP; 27 Jun 2017 17:15:52 -0000 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v5RHFiRR006731 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Jun 2017 17:15:44 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v5RHFiAa030987 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Jun 2017 17:15:44 GMT Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v5RHFhVG009401; Tue, 27 Jun 2017 17:15:43 GMT Received: from ban25uut183.us.oracle.com (/10.153.74.183) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 27 Jun 2017 10:15:43 -0700 From: Venu Busireddy To: venu.busireddy@oracle.com, Ian Jackson , Wei Liu Date: Tue, 27 Jun 2017 12:14:58 -0500 Message-Id: <20170627171458.2529-7-venu.busireddy@oracle.com> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170627171458.2529-1-venu.busireddy@oracle.com> References: <20170627171458.2529-1-venu.busireddy@oracle.com> X-Source-IP: userv0022.oracle.com [156.151.31.74] Cc: xen-devel@lists.xen.org Subject: [Xen-devel] [PATCH 6/6] docs: Document the new commands. 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 docs: Document the new commands. Add documentation for the newly added commands "pci-assignable-hide", "pci-assignable-unhide", and "pci-assignable-list-hidden". Signed-off-by: Venu Busireddy --- docs/man/xl.pod.1.in | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/man/xl.pod.1.in b/docs/man/xl.pod.1.in index 78bf884..86f7089 100644 --- a/docs/man/xl.pod.1.in +++ b/docs/man/xl.pod.1.in @@ -1462,6 +1462,13 @@ These are devices in the system which are configured to be available for passthrough and are bound to a suitable PCI backend driver in domain 0 rather than a real driver. +=item B + +List all the assignable PCI devices that are hidden. +When a PCI device assigned to a guest in passthrough mode causes +unrecoverable AER errors, the hypervisor shuts down the guest and hides +the device from being assignable to the guests. + =item B I Make the device at PCI Bus/Device/Function BDF assignable to guests. @@ -1484,6 +1491,23 @@ it will also attempt to re-bind the device to its original driver, making it usable by Domain 0 again. If the device is not bound to pciback, it will return success. +=item B I + +Hide the device at PCI Bus/Device/Function BDF from being assignable +to guests, similar to the way the hypervisor would hide the device that +caused unrecoverable AER errors. +When a PCI device assigned to a guest in passthrough mode causes +unrecoverable AER errors, the hypervisor shuts down the guest and hides +the device from being assignable to the guests. + +=item B I + +Unhide the device at PCI Bus/Device/Function BDF that was previously +hidden by the hypervisor due to unrecoverable AER errors. +When a PCI device assigned to a guest in passthrough mode causes +unrecoverable AER errors, the hypervisor shuts down the guest and hides +the device from being assignable to the guests. + =item B I I Hot-plug a new pass-through pci device to the specified domain.