From: Peter Krempa Date: Thu, 22 Aug 2024 15:20:32 +0000 (+0200) Subject: docs: formatdomain: Clarify that NVRAM template is also being autoselected X-Git-Tag: v10.10.0-rc1~136 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f90567f3a86007d35a4e2a38d3cca68360d847e0;p=thirdparty%2Flibvirt.git docs: formatdomain: Clarify that NVRAM template is also being autoselected The NVRAM template file may be autoselected same as the loader/firmware image. Add a hint that this can occur and also that it doesn't necessarily need to be from the 'qemu.conf' configured files. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik Reviewed-by: Ján Tomko --- diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index c50744b57b..cec11270b9 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -268,12 +268,14 @@ harddisk, cdrom, network) determining where to obtain/find the boot image. 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 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` + up libvirt copies so called master NVRAM store file either selected by the + firmware autoselection process or defined in ``qemu.conf``. + If needed, the ``template`` attribute can be used to override the + automatically chosen NVRAM template. + + 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` :since:`Since 8.5.0`, it's possible for the element to have ``type`` attribute (accepts values ``file``, ``block`` and ``network``) in that case the NVRAM