mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-01-13 16:15:19 +00:00
docs: Update formatdomain for lifecycle events
This commit is contained in:
parent
efdcc92faa
commit
f60bd7c7a7
@ -967,7 +967,13 @@
|
|||||||
|
|
||||||
<p>
|
<p>
|
||||||
It is sometimes necessary to override the default actions taken
|
It is sometimes necessary to override the default actions taken
|
||||||
on various events.
|
on various events. Not all hypervisors support all events and actions.
|
||||||
|
The actions may be taken as a result of calls to libvirt APIs
|
||||||
|
<code class='docref'>virDomainReboot</code>,
|
||||||
|
<code class='docref'>virDomainShutdown</code>, or
|
||||||
|
<code class='docref'>virDomainShutdownFlags</code>.
|
||||||
|
Using <code>virsh reboot</code> or <code>virsh shutdown</code> would
|
||||||
|
also trigger the event.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<pre>
|
<pre>
|
||||||
@ -1004,20 +1010,29 @@
|
|||||||
<dl>
|
<dl>
|
||||||
<dt><code>destroy</code></dt>
|
<dt><code>destroy</code></dt>
|
||||||
<dd>The domain will be terminated completely and all resources
|
<dd>The domain will be terminated completely and all resources
|
||||||
released</dd>
|
released.</dd>
|
||||||
<dt><code>restart</code></dt>
|
<dt><code>restart</code></dt>
|
||||||
<dd>The domain will be terminated, and then restarted with
|
<dd>The domain will be terminated and then restarted with
|
||||||
the same configuration</dd>
|
the same configuration.</dd>
|
||||||
<dt><code>preserve</code></dt>
|
<dt><code>preserve</code></dt>
|
||||||
<dd>The domain will be terminated, and its resource preserved
|
<dd>The domain will be terminated and its resource preserved
|
||||||
to allow analysis.</dd>
|
to allow analysis.</dd>
|
||||||
<dt><code>rename-restart</code></dt>
|
<dt><code>rename-restart</code></dt>
|
||||||
<dd>The domain will be terminated, and then restarted with
|
<dd>The domain will be terminated and then restarted with
|
||||||
a new name</dd>
|
a new name.</dd>
|
||||||
</dl>
|
</dl>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
on_crash supports these additional
|
QEMU/KVM supports the <code>on_poweroff</code> and <code>on_reboot</code>
|
||||||
|
events handling the <code>destroy</code> and <code>restart</code> actions.
|
||||||
|
The <code>preserve</code> action for an <code>on_reboot</code> event
|
||||||
|
is treated as a <code>destroy</code> and the <code>rename-restart</code>
|
||||||
|
action for an <code>on_poweroff</code> event is treated as a
|
||||||
|
<code>restart</code> event.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
The <code>on_crash</code> event supports these additional
|
||||||
actions <span class="since">since 0.8.4</span>.
|
actions <span class="since">since 0.8.4</span>.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user