docs: formatdomain: Document the temporary file for transient disks

Mention that hypervisors may need a temporary file and document the qemu
template for creating them.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
Peter Krempa 2024-10-18 16:15:43 +02:00
parent 36080e1b57
commit 54bd75fcce

View File

@ -3479,6 +3479,13 @@ paravirtualized driver is specified via the ``disk`` element.
``shareBacking`` attribute should be set to ``yes``. Note that hypervisor ``shareBacking`` attribute should be set to ``yes``. Note that hypervisor
drivers may need to hotplug such disk and thus it works only with drivers may need to hotplug such disk and thus it works only with
configurations supporting hotplug. :since:`Since 7.4.0` configurations supporting hotplug. :since:`Since 7.4.0`
Hypervisors may need to store a temporary file containing the data written
by the domain while running, which may be stored in the same location
as the original source of the disk (The ``qemu`` driver stores the temporary
files as ``$(origsource).TRANSIENT-$(vmname)``, where ``$(origsource)`` is
the full original path of the disk source and ``$(vmname)`` is the name of the
domain).
``serial`` ``serial``
If present, this specify serial number of virtual hard drive. For example, it If present, this specify serial number of virtual hard drive. For example, it
may look like ``<serial>WD-WMAP9A966149</serial>``. Not supported for may look like ``<serial>WD-WMAP9A966149</serial>``. Not supported for