NuKVM/libvirt
3
0
Fork 0
mirror of https://github.com/libvirt/libvirt.git synced 2025-02-11 16:05:56 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs: document recent hook additions

Browse Source 
* src/qemu/qemu_process.c (qemuProcessStart, qemuProcessStop): Fix
typos.
* docs/hooks.html.in: Document 'prepare' and 'release' hooks.
This commit is contained in:
Eric Blake 2011-03-23 14:50:29 -06:00
parent 96d567862a
commit ef701fd8cb
2 changed files with 21 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
docs/hooks.html.in
View File

@ -100,11 +100,26 @@
<h5><a name="qemu">/etc/libvirt/hooks/qemu</a></h5> <h5><a name="qemu">/etc/libvirt/hooks/qemu</a></h5>
<ul> <ul>
<li>When a QEMU guest is started, the qemu hook script is called as:<br/> <li>Before a QEMU guest is started, the qemu hook script is
<pre>/etc/libvirt/hooks/qemu guest_name start begin -</pre></li> called in two locations; if either location fails, the guest
is not started. The first location, <span class="since">since
0.9.0</span>, is before libvirt performs any resource
labeling, and the hook can allocate resources not managed by
libvirt such as DRBD or missing bridges. This is called as:</br>
<pre>/etc/libvirt/hooks/qemu guest_name prepare begin -</pre>
The second location, available <span class="since">Since
0.8.0</span>, occurs after libvirt has finished labeling
all resources, but has not yet started the guest, called as:</br>
<pre>/etc/libvirt/hooks/qemu guest_name start begin -</pre></li>
<li>When a QEMU guest is stopped, the qemu hook script is called <li>When a QEMU guest is stopped, the qemu hook script is called
as:<br/> in two locations, to match the startup.
<pre>/etc/libvirt/hooks/qemu guest_name stopped end -</pre></li> First, <span class="since">since 0.8.0</span>, the hook is
called before libvirt restores any labels:</br>
<pre>/etc/libvirt/hooks/qemu guest_name stopped end -</pre>
Then, after libvirt has released all resources, the hook is
called again, <span class="since">since 0.9.0</span>, to allow
any additional resource cleanup:<br/>
<pre>/etc/libvirt/hooks/qemu guest_name release end -</pre></li>
</ul> </ul>
<h5><a name="lxc">/etc/libvirt/hooks/lxc</a></h5> <h5><a name="lxc">/etc/libvirt/hooks/lxc</a></h5>

4
src/qemu/qemu_process.c
View File

@ -1928,7 +1928,7 @@ int qemuProcessStart(virConnectPtr conn,
vm->def->id = driver->nextvmid++; vm->def->id = driver->nextvmid++;
/* Run a early hook to set-up missing devices */ /* Run an early hook to set-up missing devices */
if (virHookPresent(VIR_HOOK_DRIVER_QEMU)) { if (virHookPresent(VIR_HOOK_DRIVER_QEMU)) {
char *xml = virDomainDefFormat(vm->def, 0); char *xml = virDomainDefFormat(vm->def, 0);
int hookret; int hookret;
@ -2436,7 +2436,7 @@ retry:
VIR_FREE(priv->vcpupids); VIR_FREE(priv->vcpupids);
priv->nvcpupids = 0; priv->nvcpupids = 0;
/* The "release" hook cleans up additional ressources */ /* The "release" hook cleans up additional resources */
if (virHookPresent(VIR_HOOK_DRIVER_QEMU)) { if (virHookPresent(VIR_HOOK_DRIVER_QEMU)) {
char *xml = virDomainDefFormat(vm->def, 0); char *xml = virDomainDefFormat(vm->def, 0);