From: Peter Krempa Date: Fri, 18 Oct 2024 14:15:43 +0000 (+0200) Subject: docs: formatdomain: Document the temporary file for transient disks X-Git-Tag: v10.9.0-rc1~24 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=54bd75fcce59674770158e5acba68123f9c8266f;p=thirdparty%2Flibvirt.git 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 Reviewed-by: Daniel P. Berrangé --- diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index e6f09a728f..3253a28e5a 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -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 ``WD-WMAP9A966149``. Not supported for