mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-29 00:55:22 +00:00
b1aa91e140
Documentation for the "guest-set-vcpus" command describes a proper algorithm how to set vcpus. This patch makes the following changes: - state of cpus that has not changed is not updated - if the command was partially successful the command is re-tried with the rest of the arguments to get a proper error message - code is more robust against malicious guest agent - fix testsuite to the new semantics
124 lines
4.0 KiB
C
124 lines
4.0 KiB
C
/*
|
|
* qemu_agent.h: interaction with QEMU guest agent
|
|
*
|
|
* Copyright (C) 2006-2012 Red Hat, Inc.
|
|
* Copyright (C) 2006 Daniel P. Berrange
|
|
*
|
|
* 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/>.
|
|
*
|
|
* Author: Daniel P. Berrange <berrange@redhat.com>
|
|
*/
|
|
|
|
|
|
#ifndef __QEMU_AGENT_H__
|
|
# define __QEMU_AGENT_H__
|
|
|
|
# include "internal.h"
|
|
# include "domain_conf.h"
|
|
|
|
typedef struct _qemuAgent qemuAgent;
|
|
typedef qemuAgent *qemuAgentPtr;
|
|
|
|
typedef struct _qemuAgentCallbacks qemuAgentCallbacks;
|
|
typedef qemuAgentCallbacks *qemuAgentCallbacksPtr;
|
|
struct _qemuAgentCallbacks {
|
|
void (*destroy)(qemuAgentPtr mon,
|
|
virDomainObjPtr vm);
|
|
void (*eofNotify)(qemuAgentPtr mon,
|
|
virDomainObjPtr vm);
|
|
void (*errorNotify)(qemuAgentPtr mon,
|
|
virDomainObjPtr vm);
|
|
};
|
|
|
|
|
|
qemuAgentPtr qemuAgentOpen(virDomainObjPtr vm,
|
|
const virDomainChrSourceDef *config,
|
|
qemuAgentCallbacksPtr cb);
|
|
|
|
void qemuAgentClose(qemuAgentPtr mon);
|
|
|
|
void qemuAgentNotifyClose(qemuAgentPtr mon);
|
|
|
|
typedef enum {
|
|
QEMU_AGENT_EVENT_NONE = 0,
|
|
QEMU_AGENT_EVENT_SHUTDOWN,
|
|
QEMU_AGENT_EVENT_SUSPEND,
|
|
QEMU_AGENT_EVENT_RESET,
|
|
} qemuAgentEvent;
|
|
|
|
void qemuAgentNotifyEvent(qemuAgentPtr mon,
|
|
qemuAgentEvent event);
|
|
|
|
typedef enum {
|
|
QEMU_AGENT_SHUTDOWN_POWERDOWN,
|
|
QEMU_AGENT_SHUTDOWN_REBOOT,
|
|
QEMU_AGENT_SHUTDOWN_HALT,
|
|
|
|
QEMU_AGENT_SHUTDOWN_LAST,
|
|
} qemuAgentShutdownMode;
|
|
|
|
int qemuAgentShutdown(qemuAgentPtr mon,
|
|
qemuAgentShutdownMode mode);
|
|
|
|
int qemuAgentFSFreeze(qemuAgentPtr mon,
|
|
const char **mountpoints, unsigned int nmountpoints);
|
|
int qemuAgentFSThaw(qemuAgentPtr mon);
|
|
int qemuAgentGetFSInfo(qemuAgentPtr mon, virDomainFSInfoPtr **info,
|
|
virDomainDefPtr vmdef);
|
|
|
|
int qemuAgentSuspend(qemuAgentPtr mon,
|
|
unsigned int target);
|
|
|
|
int qemuAgentArbitraryCommand(qemuAgentPtr mon,
|
|
const char *cmd,
|
|
char **result,
|
|
int timeout);
|
|
int qemuAgentFSTrim(qemuAgentPtr mon,
|
|
unsigned long long minimum);
|
|
|
|
|
|
typedef struct _qemuAgentCPUInfo qemuAgentCPUInfo;
|
|
typedef qemuAgentCPUInfo *qemuAgentCPUInfoPtr;
|
|
struct _qemuAgentCPUInfo {
|
|
unsigned int id; /* logical cpu ID */
|
|
bool online; /* true if the CPU is activated */
|
|
bool offlinable; /* true if the CPU can be offlined */
|
|
|
|
bool modified; /* set to true if the vcpu state needs to be changed */
|
|
};
|
|
|
|
int qemuAgentGetVCPUs(qemuAgentPtr mon, qemuAgentCPUInfoPtr *info);
|
|
int qemuAgentSetVCPUs(qemuAgentPtr mon, qemuAgentCPUInfoPtr cpus, size_t ncpus);
|
|
int qemuAgentUpdateCPUInfo(unsigned int nvcpus,
|
|
qemuAgentCPUInfoPtr cpuinfo,
|
|
int ncpuinfo);
|
|
|
|
int qemuAgentGetTime(qemuAgentPtr mon,
|
|
long long *seconds,
|
|
unsigned int *nseconds);
|
|
int qemuAgentSetTime(qemuAgentPtr mon,
|
|
long long seconds,
|
|
unsigned int nseconds,
|
|
bool sync);
|
|
|
|
int qemuAgentGetInterfaces(qemuAgentPtr mon,
|
|
virDomainInterfacePtr **ifaces);
|
|
|
|
int qemuAgentSetUserPassword(qemuAgentPtr mon,
|
|
const char *user,
|
|
const char *password,
|
|
bool crypted);
|
|
#endif /* __QEMU_AGENT_H__ */
|