libraries/libvirt: managesave running VMs on shutdown by default

Signed-off-by: Robby Workman <rworkman@slackbuilds.org>

1 files changed, 16 insertions, 0 deletions

diff --git a/libraries/libvirt/README b/libraries/libvirt/README
index 55b664a2e7..fbe09fd2b6 100644
--- a/libraries/libvirt/README
+++ b/libraries/libvirt/README
@@ -18,6 +18,7 @@ to /etc/rc.d/rc.local
   if [ -x /etc/rc.d/rc.libvirt ]; then
     /etc/rc.d/rc.libvirt start
   fi
+
 and if you want it to stop at shutdown add this to
 /etc/rc.d/rc.local_shutdown
 
@@ -26,6 +27,21 @@ and if you want it to stop at shutdown add this to
     /etc/rc.d/rc.libvirt stop
   fi
 
+The enclosed rc.libvirt script will do a 'managedsave' on all running 
+and paused guests when issuing 'rc.libvirt stop'. Please note that this 
+saves the RAM of each guest to the host system's disk (by default under 
+/var/lib/libvirt/qemu/save) - so make sure enough space is available. If 
+you prefer to perform a full shutdown on all running guests instead, 
+issue a 'rc.libvirt guests_shutdown' followed by 'rc.libvirt shutdown'.
+
+By default 'rc.libvirt stop' and 'rc.libvirt guests_shutdown' will wait 
+a maximum of 5 minutes for all guests to shutdown, after which any 
+guests still running will be destroyed. Adjust this to a suitable value 
+for your system, as destroying a running guest carries a high risk of 
+data loss!
+
+There is also a 'guests_reboot' for rebooting all running guests.
+
 Have a look at the commented part of rc.libvirt for some gotchas.
 
 netcat-openbsd is an optional dependency (needed if you