aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorKeir Fraser <keir.fraser@citrix.com>2008-01-25 13:28:25 +0000
committerKeir Fraser <keir.fraser@citrix.com>2008-01-25 13:28:25 +0000
commit961f9b1fc95c51ed8f076782835d148b040d0005 (patch)
treebd91a386df38715f661271725aef02b5ba079113 /docs
parentbb09427c71cd621637565fb906c2114a2a6878cf (diff)
downloadxen-961f9b1fc95c51ed8f076782835d148b040d0005.tar.gz
xen-961f9b1fc95c51ed8f076782835d148b040d0005.tar.bz2
xen-961f9b1fc95c51ed8f076782835d148b040d0005.zip
(Re)introduce notion of crashed VM power state.
The crashed power state is necessary to allow both core-dumping a crashed but preserved VM and renaming/restarting a crashed VM. Signed-off-by: Jim Fehlig <jfehlig@novell.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/xen-api/vm-lifecycle.tex5
-rw-r--r--docs/xen-api/vm_lifecycle.dot4
-rw-r--r--docs/xen-api/xenapi-datamodel.tex1
3 files changed, 8 insertions, 2 deletions
diff --git a/docs/xen-api/vm-lifecycle.tex b/docs/xen-api/vm-lifecycle.tex
index b082356935..c584b67e33 100644
--- a/docs/xen-api/vm-lifecycle.tex
+++ b/docs/xen-api/vm-lifecycle.tex
@@ -21,7 +21,10 @@
\end{figure}
Figure~\ref{fig-vm-lifecycle} shows the states that a VM can be in
-and the API calls that can be used to move the VM between these states.
+and the API calls that can be used to move the VM between these states. The crashed
+state indicates that the guest OS running within the VM has crashed. There is no
+API to explicitly move to the crashed state, however a hardShutdown will move the
+VM to the powered down state.
\section{VM boot parameters}
diff --git a/docs/xen-api/vm_lifecycle.dot b/docs/xen-api/vm_lifecycle.dot
index fdc97523e2..2c062f98d0 100644
--- a/docs/xen-api/vm_lifecycle.dot
+++ b/docs/xen-api/vm_lifecycle.dot
@@ -1,6 +1,6 @@
digraph g{
-node [shape=box]; "powered down" paused running suspended;
+node [shape=box]; "powered down" paused running suspended crashed;
"powered down" -> paused [label="start(paused=true)"];
"powered down" -> running [label="start(paused=false)"];
@@ -11,5 +11,7 @@ paused -> suspended [label="suspend"];
paused -> running [label="resume"];
running -> "powered down" [label="cleanShutdown /\nhardShutdown"];
running -> paused [label="pause"];
+running -> crashed [label="guest OS crash"]
+crashed -> "powered down" [label="hardShutdown"]
} \ No newline at end of file
diff --git a/docs/xen-api/xenapi-datamodel.tex b/docs/xen-api/xenapi-datamodel.tex
index c6a95883a5..102b59e04c 100644
--- a/docs/xen-api/xenapi-datamodel.tex
+++ b/docs/xen-api/xenapi-datamodel.tex
@@ -156,6 +156,7 @@ The following enumeration types are used:
\hspace{0.5cm}{\tt Paused} & Paused \\
\hspace{0.5cm}{\tt Running} & Running \\
\hspace{0.5cm}{\tt Suspended} & Suspended \\
+\hspace{0.5cm}{\tt Crashed} & Crashed \\
\hspace{0.5cm}{\tt Unknown} & Some other unknown state \\
\hline
\end{longtable}