From nobody Tue Feb 10 04:29:37 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=none dis=none) header.from=nutanix.com Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1649440203226538.2516359360035; Fri, 8 Apr 2022 10:50:03 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-368-8vGHARWIOyCUZ1P4HdNuXg-1; Fri, 08 Apr 2022 13:49:29 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 635FE80C8D9; Fri, 8 Apr 2022 17:49:25 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 4948840CFD06; Fri, 8 Apr 2022 17:49:25 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id E39E2194034D; Fri, 8 Apr 2022 17:49:23 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 4CBD01940357 for ; Fri, 8 Apr 2022 17:49:21 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 3E4C3432467; Fri, 8 Apr 2022 17:49:21 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast05.extmail.prod.ext.rdu2.redhat.com [10.11.55.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 39E27432460 for ; Fri, 8 Apr 2022 17:49:21 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 1D5B4801E67 for ; Fri, 8 Apr 2022 17:49:21 +0000 (UTC) Received: from mx0a-002c1b01.pphosted.com (mx0a-002c1b01.pphosted.com [148.163.151.68]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-483-RpMogZ-8OuKS157JSykcpw-1; Fri, 08 Apr 2022 13:49:19 -0400 Received: from pps.filterd (m0127838.ppops.net [127.0.0.1]) by mx0a-002c1b01.pphosted.com (8.16.1.2/8.16.1.2) with ESMTP id 238EMqEr009873 for ; Fri, 8 Apr 2022 10:49:18 -0700 Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2170.outbound.protection.outlook.com [104.47.58.170]) by mx0a-002c1b01.pphosted.com (PPS) with ESMTPS id 3f6p1yp13w-5 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 08 Apr 2022 10:49:17 -0700 Received: from SJ0PR02MB8564.namprd02.prod.outlook.com (2603:10b6:a03:3f6::16) by BY5PR02MB6533.namprd02.prod.outlook.com (2603:10b6:a03:1d5::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5144.26; Fri, 8 Apr 2022 17:49:15 +0000 Received: from SJ0PR02MB8564.namprd02.prod.outlook.com ([fe80::b167:3939:c2e0:64e8]) by SJ0PR02MB8564.namprd02.prod.outlook.com ([fe80::b167:3939:c2e0:64e8%6]) with mapi id 15.20.5144.023; Fri, 8 Apr 2022 17:49:15 +0000 X-MC-Unique: 8vGHARWIOyCUZ1P4HdNuXg-1 X-Original-To: libvir-list@listman.corp.redhat.com X-MC-Unique: RpMogZ-8OuKS157JSykcpw-1 From: Rohit Kumar To: libvir-list@redhat.com Subject: [PATCH v2 6/8] Update NVRAM documentation Date: Fri, 8 Apr 2022 10:48:49 -0700 Message-Id: <20220408174851.1077477-7-rohit.kumar3@nutanix.com> In-Reply-To: <20220408174851.1077477-1-rohit.kumar3@nutanix.com> References: <20220408174851.1077477-1-rohit.kumar3@nutanix.com> X-ClientProxiedBy: SJ0PR03CA0363.namprd03.prod.outlook.com (2603:10b6:a03:3a1::8) To SJ0PR02MB8564.namprd02.prod.outlook.com (2603:10b6:a03:3f6::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d130b14d-60b1-404e-e3ad-08da198818c6 X-MS-TrafficTypeDiagnostic: BY5PR02MB6533:EE_ X-Microsoft-Antispam-PRVS: x-proofpoint-crosstenant: true X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0 X-Microsoft-Antispam-Message-Info: 3TR4H6tL1pwb2TUlw7ktrSw/pONieUEzCjRxQTcRti5g0Ny1Cyy0RKRjbmEP69+EouBChilmjA69vX/oMm6F2YF6FnuaNyfjymNs83u8HybZ28scX5Ey776GNywkhbYcTX14XM9Jhzx12iKXNHZl4esCrmy0FRliP7K7ztFc9ybiuBBIB7wATtdZaAJuhiYvH9Ny/VhW8KAYWbGhXmVHNnReQdBcWi85IvkpDDd+J7SfuCXPv7ga5kT2BH1pVWncs0jAQEKXMFPFn428v1JP8fK60gG0H2lnCRPs5RSEGplWlpLJzzFRmh4U3/plwxvxOt16lc+r6EYHYtLQ+FMVYdsEiL8GOXv7emMR8Cb8qqsTzbB4qp9jynbZf5cIDtbeLFn2FlRcO3bAn4HAr4xxPlmknOlhlfG4zqKfGUwmZ/z4sdZCBcYHXyYhDDIKC+GZ+4diNYcdjtJza0O+6cWXXccWBFyErPI3uLURbthPLNRDvEtpe/twrx0QQ4+cJfI9CvAlY8IL5UaWzF5yzGpg3dJMEkTzIjDI1miqjTwvSNMeolNv4KLVFvkH55A+miHEDXcT2zOALN2Q8gprV4ntyFjwZqZocbV/lI+0w+FUaE9LzGlAtLcqvZ3Dp5rW+heMj0cypUq6O/SBr8sub8TLb80aV9nmi4yT+X7tfLTeD5vQD2mLNvAxqXrjeO8j0gLLEd0RqqF/JSPjPby/WLtk5g== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR02MB8564.namprd02.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(6666004)(38350700002)(38100700002)(6486002)(83380400001)(8936002)(508600001)(2906002)(86362001)(5660300002)(66476007)(36756003)(66556008)(2616005)(107886003)(8676002)(4326008)(66946007)(6512007)(6916009)(54906003)(26005)(186003)(52116002)(6506007)(1076003)(316002); DIR:OUT; SFP:1102 X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?O0GaRt3m4C87h9ue2+gBNaC+JhApAPktO3g6+45OUUEUDzJ9K0d3fZyvBOMS?= =?us-ascii?Q?slPVVimSFIyYhEGbqmDUAlwlyfl3dmKQz1REIehCYMIsNPwTCxYdLktX7z7v?= =?us-ascii?Q?ApJzA7pOOEPgz94F7VvEoWUZuRI1M7WFVB8xcH2ejLQ55v/yhgU1vu+DwlDE?= =?us-ascii?Q?Fler0/d2o8AZQTE9Lm3Ll9ZrqBDpAdz5EpkCPrSekW/CZ7K/WkKExqgkt+nd?= =?us-ascii?Q?fuBmjEqGx/CpDED2496uCIcYQ+V1mE+q26YhQlYRPvCmVQnof+/hi5fg+ypI?= =?us-ascii?Q?qzi95ufHNuYVFeVcpt5NrYJbznfuea3/5FV7soL2d5aN+AAuwumi8Ur97RTi?= =?us-ascii?Q?syEccq/oH3tA7/2Nz6XpR9Q7TxTTZIlbHbtFyKcBdO9/hkvBh0Szn7ee3qxd?= =?us-ascii?Q?TqWO4Zn8H0CiIJ9NDt2Y5Z30lh6jdivYtq8ksLy3ejFMLt48a8jipKhMlhiz?= =?us-ascii?Q?Bm9ivA09BOHYygkxV52WA30sRvJytxGH2KblzW4iU76kzjQnz2cQn6JpHz4n?= =?us-ascii?Q?yQITN3NX86BfIpVdT0RxaBQTCwQGXSn7o9Sfx5X9gWKLqQjZWfA/rw+s26D9?= =?us-ascii?Q?sMQLqsC2yFmNy15Ue1JrwAF36YIblx949a9UkE0bR6K4d+1RXjOAULQvVf+a?= =?us-ascii?Q?SzTQaOXHtZKLxHF3GcrjFXYCJAgXzF+s48Atc9GQzYHkLBQ7tlv7U/iENJR7?= =?us-ascii?Q?jf3hWgxeEnz285HYLlBvaka7z8yuy1swUMZAz96hUEdXLC+yBAeQti5W5uul?= =?us-ascii?Q?zMFEXS9k/ek0haBlD96dgw30FoDsywOj9kIrEu7IpY3g4XTh+VEUsivxzQlm?= =?us-ascii?Q?DexZ7QfWoJOy/eXPOr1FtVWQjFf6femrp3cJy4NXEueO66c2jPe3tCyDERYX?= =?us-ascii?Q?PJ0S+QQE0mSNtx0hRQrXa3PxUXYHqkIzf+1ij8uHGcJvO7SWJCM2Jtc6XvEU?= =?us-ascii?Q?bLhGipcRVa7we/8Q5ZFFZiDIbOOEXrPawmrqWI1AHqEoMJvZRLV27C/Mvqr4?= =?us-ascii?Q?/YZYRP3ATKBPm3Tqi7xTDlJdPIOQEyY2oL1t1VWBfEWhovP8iARqPaCuRmQ1?= =?us-ascii?Q?Fg+nx7Wio6RYf7QPUCvFEFd/RT85PYaLl2aJZMiV5nMx1UX62Jt21gqlTGiz?= =?us-ascii?Q?Ms0gLZ/PnWzXA4w70K4mph1RQ6LpkbiIEWlPPSqDuryVtJ/4BXFmfUGom3au?= =?us-ascii?Q?bml3jKHw9gxH7Xe0z9VHIKTn/SEBDakqalLrnfAIrKa5VDO7xN+rHl2pDwd8?= =?us-ascii?Q?8p/Vj1ugVCd7eWNPJAWeSYHwAIxLb4NRROCT59pLtjyQGG2HuTsUrvo+toOJ?= =?us-ascii?Q?fN0jhp1Ngl4Nd5Rll6A5AllzDZjujh0h7HhktWx1nUDtlDDGsfFgHb3ViR80?= =?us-ascii?Q?eiPmEh+C0QPhHjm2biZThet++WwD2PwH2ZNOBDy1/AbY8fuo5e7meY0VCl6w?= =?us-ascii?Q?rN/0gCJeRcLIiypZW+63Gtq6el/wGXCEwBiMyZtMDWAJEL6jXTGN6sG10yM9?= =?us-ascii?Q?kLi13fUxvxpXqY4uvYpWzHMS8gyy5Y8r8MxfNQF8Ls/pQQ93pZKHit2n4HEe?= =?us-ascii?Q?PbvZth5Z4euUMBjgiLKrliFtf53gCPNx0jj0yPVX8YxALgzTQcWDqL9vxxrj?= =?us-ascii?Q?OroOI1pnFRQVC+NnGGKJ4ze7lZaDE7sK1e2mynxt9m47UH8D6kLLst9V6jZE?= =?us-ascii?Q?COnfG71U6gttj/uaGYoJxxKFoE6SEDG83tdX4VKIVJUvBoRvYulBFqQhtVbK?= =?us-ascii?Q?b94L5WkSieXrw12bnD7lzvA7rmndYyM=3D?= X-OriginatorOrg: nutanix.com X-MS-Exchange-CrossTenant-Network-Message-Id: d130b14d-60b1-404e-e3ad-08da198818c6 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR02MB8564.namprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Apr 2022 17:49:15.0155 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: bb047546-786f-4de1-bd75-24e5b6f79043 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 8h3moW0nd6U2tka19lrdWnvVuU2KMdGi9vKdMN0+FpcZiE2HWKQ7ddfrbv54f3PbHk0F8PpItMIDJbUF1gJYaT5PRD7GNBrtChM4r9wyCkQ= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR02MB6533 X-Proofpoint-ORIG-GUID: owlMli45XYhni5wcLv5Qq600OBDdYWGv X-Proofpoint-GUID: owlMli45XYhni5wcLv5Qq600OBDdYWGv X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.858,Hydra:6.0.425,FMLib:17.11.64.514 definitions=2022-04-08_05,2022-04-08_01,2022-02-23_01 X-Proofpoint-Spam-Reason: safe X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 2.85 on 10.11.54.9 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: prachatos.mitra@nutanix.com, Rohit Kumar , Florian Schmidt , prerna.saxena@nutanix.com Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 2.84 on 10.11.54.1 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1649440203991100001 Content-Type: text/plain; charset="utf-8" Updating the doc as now NVRAM can be remote as well. Signed-off-by: Prerna Saxena Signed-off-by: Florian Schmidt Signed-off-by: Rohit Kumar --- docs/formatdomain.rst | 43 +++++++++++++++++++++++++++++++++++-------- 1 file changed, 35 insertions(+), 8 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 24fbfd8670..53361c7996 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -141,6 +141,31 @@ harddisk, cdrom, network) determining where to obtain/= find the boot image. ... =20 + + ... + + hvm + /usr/share/OV= MF/OVMF_CODE.fd + + + + + ... + + + ... + + hvm + /usr/share/OV= MF/OVMF_CODE.fd + + + + + + + + ... + ... @@ -222,14 +247,16 @@ harddisk, cdrom, network) determining where to obtain= /find the boot image. :since:`Since 2.1.0` ``nvram`` Some UEFI firmwares may want to use a non-volatile memory to store some - variables. In the host, this is represented as a file and the absolute = path - to the file is stored in this element. Moreover, when the domain is sta= rted - up libvirt copies so called master NVRAM store file defined in ``qemu.c= onf``. - If needed, the ``template`` attribute can be used to per domain overrid= e map - of master NVRAM stores from the config file. Note, that for transient d= omains - if the NVRAM file has been created by libvirt it is left behind and it = is - management application's responsibility to save and remove file (if nee= ded to - be persistent). :since:`Since 1.2.8` + variables. They can be present on host or on some network storage. + In the host, this is represented as a file and the absolute path + to the file is stored in this element. On network storage, + this can be accessed by providing network path. Moreover, when the doma= in + is started up libvirt copies so called master NVRAM store file defined + in ``qemu.conf``. If needed, the ``template`` attribute can be used to = per + domain override map of master NVRAM stores from the config file. Note, = that + for transient domains if the NVRAM file has been created by libvirt + it is left behind and it is management application's responsibility to + save and remove file (if needed to be persistent). :since:`Since 1.2.8` ``boot`` The ``dev`` attribute takes one of the values "fd", "hd", "cdrom" or "network" and is used to specify the next boot device to consider. The --=20 2.25.1