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
drivers may need to hotplug such disk and thus it works only with
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``
If present, this specify serial number of virtual hard drive. For example, it
may look like ``<serial>WD-WMAP9A966149</serial>``. Not supported for