External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-22 05:35:25 +00:00
Code Issues Packages Projects Releases Wiki Activity

API: migration: Warn about use of VIR_MIGRATE_PERSIST_DEST with VIR_MIGRATE_PARAM_DEST_XML

Browse Source 
When a VM is being migrated to a destination host it can be made
persistent on the destination by using VIR_MIGRATE_PERSIST_DEST. That
may not work as intended if VIR_MIGRATE_PARAM_DEST_XML or the 'xmlin'
parameter is used as that allows overriding certain aspects of the VM
xml, but does not involve the persistent definition.
In most cases users will need to supply also VIR_MIGRATE_PARAM_PERSIST_XML
with the same set of modification.

Modify the man page to clarify the above so that users don't end up with
broken VM after migrating and restarting it.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
This commit is contained in:
Peter Krempa 2024-11-18 14:25:22 +01:00
parent 6f237f4642
commit 055379df23
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
include/libvirt/libvirt-domain.h
View File

@ -929,6 +929,19 @@ typedef enum {
* VIR_MIGRATE_UNDEFINE_SOURCE is not used, it will end up persistent on
* both hosts.
*
* Note: If VIR_MIGRATE_PERSIST_DEST flag is used together with the
* VIR_MIGRATE_PARAM_DEST_XML migration parameter which supplies an
* updated definition for the destination host it's required to
* supply also VIR_MIGRATE_PARAM_PERSIST_XML updated the same way.
* Otherwise the persistent definition on the destination will not
* contain the updates.
*
* The VIR_MIGRATE_PERSIST_DEST flag should not be used with the
* "xmlin" parameter of older APIs as that way an updated persistent
* XML can't be supplied and thus the persistent definition will
* likely be incorrect as it will be based on the persistent definition
* on the source of the migration.
*
* Since: 0.7.3
*/
VIR_MIGRATE_PERSIST_DEST = (1 << 3),