mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-07-12 21:05:48 +00:00
95f5ac9ae5
Some layered products such as oVirt have requested a way to avoid being blocked by guest agent commands when querying a loaded vm. For example, many guest agent commands are polled periodically to monitor changes, and rather than blocking the calling process, they'd prefer to simply time out when an agent query is taking too long. This patch adds a way for the user to specify a custom agent timeout that is applied to all agent commands. One special case to note here is the 'guest-sync' command. 'guest-sync' is issued internally prior to calling any other command. (For example, when libvirt wants to call 'guest-get-fsinfo', we first call 'guest-sync' and then call 'guest-get-fsinfo'). Previously, the 'guest-sync' command used a 5-second timeout (VIR_DOMAIN_QEMU_AGENT_COMMAND_DEFAULT), whereas the actual command that followed always blocked indefinitely (VIR_DOMAIN_QEMU_AGENT_COMMAND_BLOCK). As part of this patch, if a custom timeout is specified that is shorter than 5 seconds, this new timeout is also used for 'guest-sync'. If there is no custom timeout or if the custom timeout is longer than 5 seconds, we will continue to use the 5-second timeout. Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com> Signed-off-by: Michal Privoznik <mprivozn@redhat.com> Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
105 lines
4.1 KiB
C
105 lines
4.1 KiB
C
/* -*- c -*-
|
|
* libvirt-qemu.h: Interfaces specific for QEMU/KVM driver
|
|
* Summary: qemu specific interfaces
|
|
* Description: Provides the interfaces of the libvirt library to handle
|
|
* qemu specific methods
|
|
*
|
|
* Copyright (C) 2010-2014 Red Hat, Inc.
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#ifndef LIBVIRT_QEMU_H
|
|
# define LIBVIRT_QEMU_H
|
|
|
|
# include <libvirt/libvirt.h>
|
|
|
|
# ifdef __cplusplus
|
|
extern "C" {
|
|
# endif
|
|
|
|
typedef enum {
|
|
VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0,
|
|
VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP = (1 << 0), /* cmd is in HMP */
|
|
} virDomainQemuMonitorCommandFlags;
|
|
|
|
int virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
|
|
char **result, unsigned int flags);
|
|
|
|
virDomainPtr virDomainQemuAttach(virConnectPtr domain,
|
|
unsigned int pid_value,
|
|
unsigned int flags);
|
|
|
|
typedef enum {
|
|
VIR_DOMAIN_QEMU_AGENT_COMMAND_MIN = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK,
|
|
VIR_DOMAIN_QEMU_AGENT_COMMAND_BLOCK = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK,
|
|
VIR_DOMAIN_QEMU_AGENT_COMMAND_DEFAULT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT,
|
|
VIR_DOMAIN_QEMU_AGENT_COMMAND_NOWAIT = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT,
|
|
VIR_DOMAIN_QEMU_AGENT_COMMAND_SHUTDOWN = 60,
|
|
} virDomainQemuAgentCommandTimeoutValues;
|
|
|
|
char *virDomainQemuAgentCommand(virDomainPtr domain, const char *cmd,
|
|
int timeout, unsigned int flags);
|
|
|
|
/**
|
|
* virConnectDomainQemuMonitorEventCallback:
|
|
* @conn: the connection pointer
|
|
* @dom: the domain pointer
|
|
* @event: the name of the event
|
|
* @seconds: the qemu timestamp of the event: seconds since Epoch, or -1 if
|
|
* not available
|
|
* @micros: the qemu timestamp of the event: microseconds within the second
|
|
* @details: the JSON details of the event, if any were given
|
|
* @opaque: application specified data
|
|
*
|
|
* The callback signature to use when registering for a qemu monitor
|
|
* event with virConnectDomainQemuMonitorEventRegister().
|
|
*/
|
|
typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn,
|
|
virDomainPtr dom,
|
|
const char *event,
|
|
long long seconds,
|
|
unsigned int micros,
|
|
const char *details,
|
|
void *opaque);
|
|
|
|
|
|
typedef enum {
|
|
/* Event filter is a regex rather than a literal string */
|
|
VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_REGEX = (1 << 0),
|
|
|
|
/* Event filter is case insensitive */
|
|
VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_NOCASE = (1 << 1),
|
|
} virConnectDomainQemuMonitorEventRegisterFlags;
|
|
|
|
|
|
int virConnectDomainQemuMonitorEventRegister(virConnectPtr conn,
|
|
virDomainPtr dom,
|
|
const char *event,
|
|
virConnectDomainQemuMonitorEventCallback cb,
|
|
void *opaque,
|
|
virFreeCallback freecb,
|
|
unsigned int flags);
|
|
|
|
int virConnectDomainQemuMonitorEventDeregister(virConnectPtr conn,
|
|
int callbackID);
|
|
|
|
|
|
# ifdef __cplusplus
|
|
}
|
|
# endif
|
|
|
|
#endif /* LIBVIRT_QEMU_H */
|