From 22de841a7660bb2c69b3b95152ee3d364c8897db Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Mon, 12 Apr 2010 17:13:32 +0200 Subject: [PATCH] Add documentation for synchronous hooks * docs/sitemap.html.in: add in navigation under Documentation/Deployment/Hooks * docs/hooks.html.in: new doc describing current support for 0.8.0 --- docs/hooks.html.in | 70 ++++++++++++++++++++++++++++++++++++++++++++ docs/sitemap.html.in | 4 +++ 2 files changed, 74 insertions(+) create mode 100644 docs/hooks.html.in diff --git a/docs/hooks.html.in b/docs/hooks.html.in new file mode 100644 index 0000000000..2afdecfe14 --- /dev/null +++ b/docs/hooks.html.in @@ -0,0 +1,70 @@ + + + +

Hooks for specific system management

+

Libvirt includes synchronous hooks, starting from version 0.8.0, as a + way to tie in specific tailored system actions at a specific time. + If these scripts are present on the host where the hypervisor + is running, then they are called when the libvirt daemon is doingi + some significant action.

+

The scripts are expected to execute quickly, return a zero exit + status if all conditions are set for the daemon to continue the + action (non zero will be considered a failure which may + be ignored but in general will stop the ongoing operation). + The script also should not call back into libvirt as the daemon + is waiting for the script exit and deadlock is likely to occur.

+

The scripts are stored in the directory /etc/libvirt/hooks/ + when using a standard installation path + ($SYSCONF_DIR/libvirt/hooks/ in general).

+

Each script is given the following command line arguments:

+ +

There are currently scripts for 3 domains of operation: +

+

+ + diff --git a/docs/sitemap.html.in b/docs/sitemap.html.in index 0c3f0c3e07..0117c8d724 100644 --- a/docs/sitemap.html.in +++ b/docs/sitemap.html.in @@ -50,6 +50,10 @@ Logging The library and the daemon logging support +
  • + Hooks + Hooks for system specific management +
  • -- GitLab