Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7D06DC433DF for ; Mon, 1 Jun 2020 16:51:38 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 54F76207D0 for ; Mon, 1 Jun 2020 16:51:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 54F76207D0 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=citrix.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jfnec-0003yZ-8g; Mon, 01 Jun 2020 16:51:14 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jfneb-0003yU-LU for xen-devel@lists.xenproject.org; Mon, 01 Jun 2020 16:51:13 +0000 X-Inumbo-ID: 19731ca8-a428-11ea-81bc-bc764e2007e4 Received: from esa5.hc3370-68.iphmx.com (unknown [216.71.155.168]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id 19731ca8-a428-11ea-81bc-bc764e2007e4; Mon, 01 Jun 2020 16:51:12 +0000 (UTC) Authentication-Results: esa5.hc3370-68.iphmx.com; dkim=none (message not signed) header.i=none IronPort-SDR: NKYITG2Nna1s56beZgklef6jwSPFDnR0DvWsVEs7qjASBC12AIVJNkHr7X8LsCmNseY9g7+oiW 9dpkM0VYSfTOaBpP1CYvLIXbO4bVeX+PWaHr9sSSq0/OVQ2VslLxqbi3B7w2raVr5ZstXfu7cT YRkGVKIGaInch/AqT6h7etus5OftTxgWaookItUq1Rn2gRf2cJ3vWSayqj+bnViLT02UxQ7NeE 4+SjNND5lMZ0NdVmwqNATzcyVCZA7DPnRnjelHDeSw1v9Z7dRfyg2bx8UUqO9GcmzQYGQoYu9N u6Y= X-SBRS: 2.7 X-MesageID: 19197850 X-Ironport-Server: esa5.hc3370-68.iphmx.com X-Remote-IP: 162.221.158.21 X-Policy: $RELAYED X-IronPort-AV: E=Sophos;i="5.73,461,1583211600"; d="scan'208";a="19197850" Date: Mon, 1 Jun 2020 18:51:05 +0200 From: Roger Pau =?utf-8?B?TW9ubsOp?= To: Andrew Cooper Subject: Re: [PATCH for-4.14] docs/ucode: Extend runtime microcode loading documentation Message-ID: <20200601165105.GU1195@Air-de-Roger> References: <20200601134025.24142-1-andrew.cooper3@citrix.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20200601134025.24142-1-andrew.cooper3@citrix.com> X-ClientProxiedBy: AMSPEX02CAS02.citrite.net (10.69.22.113) To AMSPEX02CL02.citrite.net (10.69.22.126) X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Stefano Stabellini , Julien Grall , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Paul Durrant , Jan Beulich , Ian Jackson , Xen-devel Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" On Mon, Jun 01, 2020 at 02:40:25PM +0100, Andrew Cooper wrote: > Extend the disclaimer about runtime loading. While we've done our best to > make the mechaism reliable, the safety of late loading does ultimately depend > on the contents of the blobs. > > Extend the xen-ucode portion with examples of how to use it. > > Signed-off-by: Andrew Cooper Reviewed-by: Roger Pau Monné > --- > CC: George Dunlap > CC: Ian Jackson > CC: Jan Beulich > CC: Konrad Rzeszutek Wilk > CC: Stefano Stabellini > CC: Wei Liu > CC: Julien Grall > CC: Paul Durrant > --- > docs/admin-guide/microcode-loading.rst | 22 +++++++++++++++++++--- > 1 file changed, 19 insertions(+), 3 deletions(-) > > diff --git a/docs/admin-guide/microcode-loading.rst b/docs/admin-guide/microcode-loading.rst > index 5f0f661a2e..8cd5d0351b 100644 > --- a/docs/admin-guide/microcode-loading.rst > +++ b/docs/admin-guide/microcode-loading.rst > @@ -104,8 +104,8 @@ modules to find any CPIO archives, and search the archive for the applicable > file. Xen will stop searching at the first match. > > > -Run time microcode loading > --------------------------- > +Runtime microcode loading > +------------------------- > > .. warning:: > > @@ -113,7 +113,23 @@ Run time microcode loading > or at boot time. Not all microcode updates (or parts thereof) can be > applied at runtime. > > -The ``xen-ucode`` utility can be used to initiate a runtime microcode load. > + Given the proprietry nature of microcode, we are unable to make any claim > + that a runtime microcode is risk-free. Any runtime microcode loading needs > + adequate testing on a dev instance before being rolled out to production > + systems. > + > +The ``xen-ucode`` utility can be used to initiate a runtime microcode load:: > + > + [root@host ~]# xen-ucode > + xen-ucode: Xen microcode updating tool > + Usage: xen-ucode > + [root@host ~]# > + > +e.g. With a Linux dom0 on a Haswell system:: > + > + [root@host ~]# xen-ucode /lib/firmware/intel-ucode/06-3c-03 Could you expand a bit on the nomenclature used here? I assume it's something like -- but might be good to provide people a hint to know how to find the appropriate blob for their system if possible. Thanks, Roger.