2010-03-26 14:49:45 +00:00
|
|
|
/*
|
2012-12-12 17:00:34 +00:00
|
|
|
* virhook.h: internal entry points needed for synchronous hooks support
|
2010-03-26 14:49:45 +00:00
|
|
|
*
|
|
|
|
* Copyright (C) 2010 Red Hat, Inc.
|
|
|
|
* Copyright (C) 2010 Daniel Veillard
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2012-09-20 22:30:55 +00:00
|
|
|
* License along with this library. If not, see
|
2012-07-21 10:06:23 +00:00
|
|
|
* <http://www.gnu.org/licenses/>.
|
2010-03-26 14:49:45 +00:00
|
|
|
*
|
|
|
|
* Author: Daniel Veillard <veillard@redhat.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __VIR_HOOKS_H__
|
|
|
|
# define __VIR_HOOKS_H__
|
|
|
|
|
|
|
|
# include "internal.h"
|
|
|
|
|
|
|
|
enum virHookDriverType {
|
|
|
|
VIR_HOOK_DRIVER_DAEMON = 0, /* Daemon related events */
|
|
|
|
VIR_HOOK_DRIVER_QEMU, /* QEmu domains related events */
|
|
|
|
VIR_HOOK_DRIVER_LXC, /* LXC domains related events */
|
|
|
|
|
|
|
|
VIR_HOOK_DRIVER_LAST,
|
|
|
|
};
|
|
|
|
|
|
|
|
enum virHookDaemonOpType {
|
|
|
|
VIR_HOOK_DAEMON_OP_START, /* daemon is about to start */
|
|
|
|
VIR_HOOK_DAEMON_OP_SHUTDOWN, /* daemon is about to shutdown */
|
|
|
|
VIR_HOOK_DAEMON_OP_RELOAD, /* driver reload with SIGHUP */
|
|
|
|
|
|
|
|
VIR_HOOK_DAEMON_OP_LAST,
|
|
|
|
};
|
|
|
|
|
|
|
|
enum virHookSubopType {
|
|
|
|
VIR_HOOK_SUBOP_NONE, /* no sub-operation */
|
|
|
|
VIR_HOOK_SUBOP_BEGIN, /* beginning of the operation */
|
|
|
|
VIR_HOOK_SUBOP_END, /* end of the operation */
|
|
|
|
|
|
|
|
VIR_HOOK_SUBOP_LAST,
|
|
|
|
};
|
|
|
|
|
|
|
|
enum virHookQemuOpType {
|
|
|
|
VIR_HOOK_QEMU_OP_START, /* domain is about to start */
|
|
|
|
VIR_HOOK_QEMU_OP_STOPPED, /* domain has stopped */
|
2011-03-22 13:12:36 +00:00
|
|
|
VIR_HOOK_QEMU_OP_PREPARE, /* domain startup initiated */
|
|
|
|
VIR_HOOK_QEMU_OP_RELEASE, /* domain destruction is over */
|
2012-02-28 12:42:42 +00:00
|
|
|
VIR_HOOK_QEMU_OP_MIGRATE, /* domain is being migrated */
|
Add some missing hook functions
A core use case of the hook scripts is to be able to do things
to a guest's network configuration. It is possible to hook into
the 'start' operation for a QEMU guest which runs just before
the guest is started. The TAP devices will exist at this point,
but the QEMU process will not. It can be desirable to have a
'started' hook too, which runs once QEMU has started.
If libvirtd is restarted it will re-populate firewall rules,
but there is no QEMU hook to trigger for existing domains.
This is solved with a 'reconnect' hook.
Finally, if attaching to an external QEMU process there needs
to be an 'attach' hook script.
This all also applies to the LXC driver
* docs/hooks.html.in: Document new operations
* src/util/hooks.c, src/util/hooks.c: Add 'started', 'reconnect'
and 'attach' operations for QEMU. Add 'prepare', 'started',
'release' and 'reconnect' operations for LXC
* src/lxc/lxc_driver.c: Add hooks for 'prepare', 'started',
'release' and 'reconnect' operations
* src/qemu/qemu_process.c: Add hooks for 'started', 'reconnect'
and 'reconnect' operations
2012-05-28 14:04:31 +00:00
|
|
|
VIR_HOOK_QEMU_OP_STARTED, /* domain has started */
|
|
|
|
VIR_HOOK_QEMU_OP_RECONNECT, /* domain is being reconnected by libvirt */
|
|
|
|
VIR_HOOK_QEMU_OP_ATTACH, /* domain is being attached to be libvirt */
|
2010-03-26 14:49:45 +00:00
|
|
|
|
|
|
|
VIR_HOOK_QEMU_OP_LAST,
|
|
|
|
};
|
|
|
|
|
|
|
|
enum virHookLxcOpType {
|
|
|
|
VIR_HOOK_LXC_OP_START, /* domain is about to start */
|
|
|
|
VIR_HOOK_LXC_OP_STOPPED, /* domain has stopped */
|
Add some missing hook functions
A core use case of the hook scripts is to be able to do things
to a guest's network configuration. It is possible to hook into
the 'start' operation for a QEMU guest which runs just before
the guest is started. The TAP devices will exist at this point,
but the QEMU process will not. It can be desirable to have a
'started' hook too, which runs once QEMU has started.
If libvirtd is restarted it will re-populate firewall rules,
but there is no QEMU hook to trigger for existing domains.
This is solved with a 'reconnect' hook.
Finally, if attaching to an external QEMU process there needs
to be an 'attach' hook script.
This all also applies to the LXC driver
* docs/hooks.html.in: Document new operations
* src/util/hooks.c, src/util/hooks.c: Add 'started', 'reconnect'
and 'attach' operations for QEMU. Add 'prepare', 'started',
'release' and 'reconnect' operations for LXC
* src/lxc/lxc_driver.c: Add hooks for 'prepare', 'started',
'release' and 'reconnect' operations
* src/qemu/qemu_process.c: Add hooks for 'started', 'reconnect'
and 'reconnect' operations
2012-05-28 14:04:31 +00:00
|
|
|
VIR_HOOK_LXC_OP_PREPARE, /* domain startup initiated */
|
|
|
|
VIR_HOOK_LXC_OP_RELEASE, /* domain destruction is over */
|
|
|
|
VIR_HOOK_LXC_OP_STARTED, /* domain has started */
|
|
|
|
VIR_HOOK_LXC_OP_RECONNECT, /* domain is being reconnected by libvirt */
|
2010-03-26 14:49:45 +00:00
|
|
|
|
|
|
|
VIR_HOOK_LXC_OP_LAST,
|
|
|
|
};
|
|
|
|
|
|
|
|
int virHookInitialize(void);
|
|
|
|
|
|
|
|
int virHookPresent(int driver);
|
|
|
|
|
|
|
|
int virHookCall(int driver, const char *id, int op, int sub_op,
|
2012-02-27 16:06:22 +00:00
|
|
|
const char *extra, const char *input, char **output);
|
2010-03-26 14:49:45 +00:00
|
|
|
|
|
|
|
#endif /* __VIR_HOOKS_H__ */
|