diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index a1042a314c..6df4a8b26e 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -3340,15 +3340,26 @@
backingStore
This element describes the backing store used by the disk - specified by sibling source element. It is - currently ignored on input and only used for output to - describe the detected backing chains of running - domains since 1.2.4 (although a - future version of libvirt may start accepting chains on input, - or output information for offline domains). An - empty backingStore element means the sibling - source is self-contained and is not based on any backing - store. For backing chain information to be accurate, the + specified by sibling source element. + Since 1.2.4. + + If the hypervisor driver does not support the + + backingStoreInput + (Since 5.10.0) + domain feature the backingStore is ignored on + input and only used for output to describe the detected + backing chains of running domains. + + If backingStoreInput is supported + the backingStore is used as the backing image of + source or other backingStore overriding + any backing image information recorded in the image metadata. + + An empty backingStore element means the sibling + source is self-contained and is not based on any backing store. + + For the detected backing chain information to be accurate, the backing format must be correctly specified in the metadata of each file of the chain (files created by libvirt satisfy this property, but using existing external files for snapshot or