diff --git a/docs/hooks.html.in b/docs/hooks.html.in index 7c9d3ef7f3e81603e46b04ca83009877147cd53f..a38ba05522ea2b5c13d4e85544ee327db349b3b6 100644 --- a/docs/hooks.html.in +++ b/docs/hooks.html.in @@ -36,6 +36,9 @@
/usr/local/etc/libvirt/hooks/
./etc/libvirt/hooks/<driver>.d/
.To use hook scripts, you will need to create this hooks
directory manually, place the desired hook scripts inside, then make
@@ -59,6 +62,10 @@
Executed when a network is started or stopped or an
interface is plugged/unplugged to/from the network
+
Since 6.5.0, you can also have
+ several scripts with any name in the directories
+ /etc/libvirt/hooks/<driver>.d/
. They are
+ executed in alphabetical order after main script.
/etc/libvirt/hooks/qemu.d/
. They are executed in
+ alphabetical order after main script. In this case each script also
+ acts as filter and can modify the domain XML and print it out on
+ its standart output. This script output is passed to standard input
+ next script in order. Empty output from any script is also identical
+ to copying the input XML without changing it.
+ In case any script returns failure common process will be aborted,
+ but all scripts from the directory will are executed./etc/libvirt/hooks/libxl.d/
. They are executed in
+ alphabetical order after main script. In this case each script also
+ acts as filter and can modify the domain XML and print it out on
+ its standart output. This script output is passed to standard input
+ next script in order. Empty output from any script is also identical
+ to copying the input XML without changing it.
+ In case any script returns failure common process will be aborted,
+ but all scripts from the directory will are executed.