diff options
author | Ian Campbell <ian.campbell@citrix.com> | 2011-12-21 10:47:30 +0000 |
---|---|---|
committer | Ian Campbell <ian.campbell@citrix.com> | 2011-12-21 10:47:30 +0000 |
commit | 8528d14fd1ecf448af44d1b47c20a31ee1e4f337 (patch) | |
tree | 17ed387c1754bc0c75b2b281d5f789da8b407236 /docs/man/xl.pod.1 | |
parent | 79e162885078a9daaaf9679d547aaa65c78e3559 (diff) | |
download | xen-8528d14fd1ecf448af44d1b47c20a31ee1e4f337.tar.gz xen-8528d14fd1ecf448af44d1b47c20a31ee1e4f337.tar.bz2 xen-8528d14fd1ecf448af44d1b47c20a31ee1e4f337.zip |
libxl: report failure to reboot/shutdown due to lackof PV interfaces to caller
This allow the caller to react as they think is appropriate. xl now prints a
message much like the library did previously, although hopefully somewhat more
informative.
Update the xl(1) man page to be similarly more informative.
Signed-off-by: Ian Campbell <ian.campbell@citrix.com>
Committed-by: Ian Jackson <ian.jackson.citrix.com>
Acked-by: Ian Jackson <ian.jackson.citrix.com>
Diffstat (limited to 'docs/man/xl.pod.1')
-rw-r--r-- | docs/man/xl.pod.1 | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/man/xl.pod.1 b/docs/man/xl.pod.1 index 72196ee28b..17789b4766 100644 --- a/docs/man/xl.pod.1 +++ b/docs/man/xl.pod.1 @@ -360,7 +360,11 @@ Reboot a domain. This acts just as if the domain had the B<reboot> command run from the console. The command returns as soon as it has executed the reboot action, which may be significantly before the domain actually reboots. -It requires PV drivers installed in your guest OS. + +For HVM domains this requires PV drivers to be installed in your guest +OS. If PV drivers are not present but you have configured the guest OS +to behave appropriately you may be able to use the I<button-press> +subcommand to trigger a power button press. The behavior of what happens to a domain when it reboots is set by the B<on_reboot> parameter of the domain configuration file when the @@ -412,9 +416,15 @@ Leave domain running after creating the snapshot. Gracefully shuts down a domain. This coordinates with the domain OS to perform graceful shutdown, so there is no guarantee that it will succeed, and may take a variable length of time depending on what -services must be shutdown in the domain. The command returns -immediately after signally the domain unless that B<-w> flag is used. -For HVM domains it requires PV drivers to be installed in your guest OS. +services must be shutdown in the domain. + +For HVM domains this requires PV drivers to be installed in your guest +OS. If PV drivers are not present but you have configured the guest OS +to behave appropriately you may be able to use the I<button-press> +subcommand to trigger a power button press. + +The command returns immediately after signally the domain unless that +B<-w> flag is used. The behavior of what happens to a domain when it reboots is set by the B<on_shutdown> parameter of the domain configuration file when the |