virsh: Clarify documentation for virsh dompmsuspend command

Clarify the docs to make more clear what this command does and that it
requires a guest agent running in the guest.
(cherry picked from commit e16d434da75430b05545f4d85d156f36b1ce51d1)

diff --git a/tools/virsh.c b/tools/virsh.c
index 15baf78491c4c7d2089d66fdca7249a320215d0a..a81a3de14222df4883cf271bf17670fe3360dd7f 100644 (file)
--- a/tools/virsh.c
+++ b/tools/virsh.c
@@ -2486,8 +2486,11 @@ cmdSuspend(vshControl *ctl, const vshCmd *cmd)
  * "dompmsuspend" command
  */
 static const vshCmdInfo info_dom_pm_suspend[] = {
-    {"help", N_("suspend a domain for a given time duration")},
-    {"desc", N_("Suspend a running domain for a given time duration.")},
+    {"help", N_("suspend a domain gracefully using power management "
+                "functions")},
+    {"desc", N_("Suspends a running domain using guest OS's power management. "
+                "(Note: This requires a guest agent configured and running in "
+                "the guest OS).")},
     {NULL, NULL}
 };
 

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 468df1d7ef17ea0f80291e95d08ee522f200d812..3bb5b10037c6ccbbff2fe07f3fa37431b95eec84 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1372,7 +1372,7 @@ Moves a domain out of the suspended state.  This will allow a previously
 suspended domain to now be eligible for scheduling by the underlying
 hypervisor.
 
-=item B<dompmsuspend> I<domain-id> I<target>
+=item B<dompmsuspend> I<domain-id> I<target> [I<--duration>]
 
 Suspend a running domain into one of these states (possible I<target>
 values):
@@ -1380,6 +1380,14 @@ values):
     disk equivallent of S4 ACPI state
     hybrid RAM is saved to disk but not powered off
 
+The I<--duration> argument specifies number of seconds before the domain is
+woken up after it was suspended (see also B<dompmwakeup>). Default is 0 for
+unlimited suspend time. (This feature isn't currently supported by any
+hypervisor driver and 0 should be used.).
+
+Note that this command requires a guest agent configured and running in the
+domain's guest OS.
+
 =item B<dompmwakeup> I<domain-id>
 
 Wakeup a domain suspended by dompmsuspend command. Injects a wakeup