libvirt/src/util/virhook.h

/*
 * virhook.h: internal entry points needed for synchronous hooks support
 *
 * 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
 * License along with this library.  If not, see
 * <http://www.gnu.org/licenses/>.
 */

#pragma once

#include "internal.h"

typedef enum {
    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_NETWORK,           /* network related events */
    VIR_HOOK_DRIVER_LIBXL,             /* Xen libxl domains related events */
    VIR_HOOK_DRIVER_BHYVE,             /* Bhyve domains related events */

    VIR_HOOK_DRIVER_LAST,
} virHookDriverType;

typedef enum {
    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,
} virHookDaemonOpType;

typedef enum {
    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,
} virHookSubopType;

typedef enum {
    VIR_HOOK_QEMU_OP_START,            /* domain is about to start */
    VIR_HOOK_QEMU_OP_STOPPED,          /* domain has stopped */
    VIR_HOOK_QEMU_OP_PREPARE,          /* domain startup initiated */
    VIR_HOOK_QEMU_OP_RELEASE,          /* domain destruction is over */
    VIR_HOOK_QEMU_OP_MIGRATE,          /* domain is being migrated */
    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 */
    VIR_HOOK_QEMU_OP_RESTORE,          /* domain is being restored */

    VIR_HOOK_QEMU_OP_LAST,
} virHookQemuOpType;

typedef enum {
    VIR_HOOK_LXC_OP_START,            /* domain is about to start */
    VIR_HOOK_LXC_OP_STOPPED,          /* domain has stopped */
    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 */

    VIR_HOOK_LXC_OP_LAST,
} virHookLxcOpType;

typedef enum {
    VIR_HOOK_NETWORK_OP_START,          /* network is about to start */
    VIR_HOOK_NETWORK_OP_STARTED,        /* network has start */
    VIR_HOOK_NETWORK_OP_STOPPED,        /* network has stopped */
    VIR_HOOK_NETWORK_OP_PORT_CREATED,   /* port has been created in the network */
    VIR_HOOK_NETWORK_OP_PORT_DELETED,   /* port has been deleted in the network */
    VIR_HOOK_NETWORK_OP_UPDATED,        /* network has been updated */

    VIR_HOOK_NETWORK_OP_LAST,
} virHookNetworkOpType;

typedef enum {
    VIR_HOOK_LIBXL_OP_START,            /* domain is about to start */
    VIR_HOOK_LIBXL_OP_STOPPED,          /* domain has stopped */
    VIR_HOOK_LIBXL_OP_PREPARE,          /* domain startup initiated */
    VIR_HOOK_LIBXL_OP_RELEASE,          /* domain destruction is over */
    VIR_HOOK_LIBXL_OP_MIGRATE,          /* domain is being migrated */
    VIR_HOOK_LIBXL_OP_STARTED,          /* domain has started */
    VIR_HOOK_LIBXL_OP_RECONNECT,        /* domain is being reconnected by libvirt */

    VIR_HOOK_LIBXL_OP_LAST,
} virHookLibxlOpType;

typedef enum {
    VIR_HOOK_BHYVE_OP_START,            /* domain is about to start */
    VIR_HOOK_BHYVE_OP_STOPPED,          /* domain has stopped */
    VIR_HOOK_BHYVE_OP_PREPARE,          /* domain startup initiated */
    VIR_HOOK_BHYVE_OP_RELEASE,          /* domain destruction is over */
    VIR_HOOK_BHYVE_OP_STARTED,          /* domain has started */

    VIR_HOOK_BHYVE_OP_LAST,
} virHookBhyveOpType;

int virHookInitialize(void);

int virHookPresent(int driver);

int virHookCall(int driver, const char *id, int op, int sub_op,
                const char *extra, const char *input, char **output);