Document that runtime changes may be lost after S4 suspend

diff --git a/src/libvirt.c b/src/libvirt.c
index b1296116f9839e4a5fe0056bc2530fa308dafb3f..6967613431539172f2c5d5e3fb7076573521b058 100644 (file)
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -2472,6 +2472,13 @@ error:
  * Dependent on hypervisor used, this may require a
  * guest agent to be available, e.g. QEMU.
  *
+ * Beware that at least for QEMU, the domain's process will be terminated
+ * when VIR_NODE_SUSPEND_TARGET_DISK is used and a new process will be
+ * launched when libvirt is asked to wake up the domain. As a result of
+ * this, any runtime changes, such as device hotplug or memory settings,
+ * are lost unless such changes were made with VIR_DOMAIN_AFFECT_CONFIG
+ * flag.
+ *
  * Returns: 0 on success,
  *          -1 on failure.
  */

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 11984bcb05eb631cd677501296782dcbd68799c2..7c8ce18975e1b88da65892e6af3f9235dd722dbd 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1680,6 +1680,13 @@ hypervisor driver and 0 should be used.).
 Note that this command requires a guest agent configured and running in the
 domain's guest OS.
 
+Beware that at least for QEMU, the domain's process will be terminated when
+target disk is used and a new process will be launched when libvirt is asked
+to wake up the domain. As a result of this, any runtime changes, such as
+device hotplug or memory settings, are lost unless such changes were made
+with I<--config> flag.
+
+
 =item B<dompmwakeup> I<domain>
 
 Wakeup a domain from pmsuspended state (either suspended by dompmsuspend or