2009-11-03 18:59:18 +00:00
|
|
|
/*
|
|
|
|
|
* qemu_monitor_json.h: interaction with QEMU monitor console
|
|
|
|
|
*
|
qemu: read backing chain names from qemu
https://bugzilla.redhat.com/show_bug.cgi?id=1199182 documents that
after a series of disk snapshots into existing destination images,
followed by active commits of the top image, it is possible for
qemu 2.2 and earlier to end up tracking a different name for the
image than what it would have had when opening the chain afresh.
That is, when starting with the chain 'a <- b <- c', the name
associated with 'b' is how it was spelled in the metadata of 'c',
but when starting with 'a', taking two snapshots into 'a <- b <- c',
then committing 'c' back into 'b', the name associated with 'b' is
now the name used when taking the first snapshot.
Sadly, older qemu doesn't know how to treat different spellings of
the same filename as identical files (it uses strcmp() instead of
checking for the same inode), which means libvirt's attempt to
commit an image using solely the names learned from qcow2 metadata
fails with a cryptic:
error: internal error: unable to execute QEMU command 'block-commit': Top image file /tmp/images/c/../b/b not found
even though the file exists. Trying to teach libvirt the rules on
which name qemu will expect is not worth the effort (besides, we'd
have to remember it across libvirtd restarts, and track whether a
file was opened via metadata or via snapshot creation for a given
qemu process); it is easier to just always directly ask qemu what
string it expects to see in the first place.
As a safety valve, we validate that any name returned by qemu
still maps to the same local file as we have tracked it, so that
a compromised qemu cannot accidentally cause us to act on an
incorrect file.
* src/qemu/qemu_monitor.h (qemuMonitorDiskNameLookup): New
prototype.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDiskNameLookup):
Likewise.
* src/qemu/qemu_monitor.c (qemuMonitorDiskNameLookup): New function.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONDiskNameLookup)
(qemuMonitorJSONDiskNameLookupOne): Likewise.
* src/qemu/qemu_driver.c (qemuDomainBlockCommit)
(qemuDomainBlockJobImpl): Use it.
Signed-off-by: Eric Blake <eblake@redhat.com>
2015-03-11 20:37:04 +00:00
|
|
|
* Copyright (C) 2006-2009, 2011-2015 Red Hat, Inc.
|
2009-11-03 18:59:18 +00:00
|
|
|
* 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
|
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/>.
|
2009-11-03 18:59:18 +00:00
|
|
|
*/
|
|
|
|
|
|
2019-06-18 16:12:37 +00:00
|
|
|
#pragma once
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2019-06-18 16:12:37 +00:00
|
|
|
#include "internal.h"
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2019-06-18 16:12:37 +00:00
|
|
|
#include "qemu_monitor.h"
|
|
|
|
|
#include "virbitmap.h"
|
|
|
|
|
#include "cpu/cpu.h"
|
|
|
|
|
#include "util/virgic.h"
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2016-04-27 14:50:43 +00:00
|
|
|
int qemuMonitorJSONIOProcessLine(qemuMonitorPtr mon,
|
|
|
|
|
const char *line,
|
2020-08-04 14:17:07 +00:00
|
|
|
qemuMonitorMessagePtr msg) G_GNUC_NO_INLINE;
|
2016-04-27 14:50:43 +00:00
|
|
|
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONIOProcess(qemuMonitorPtr mon,
|
|
|
|
|
const char *data,
|
|
|
|
|
size_t len,
|
|
|
|
|
qemuMonitorMessagePtr msg);
|
|
|
|
|
|
2019-09-19 15:13:31 +00:00
|
|
|
int qemuMonitorJSONHumanCommand(qemuMonitorPtr mon,
|
|
|
|
|
const char *cmd,
|
|
|
|
|
char **reply);
|
2011-03-09 20:24:04 +00:00
|
|
|
|
2010-02-12 13:45:20 +00:00
|
|
|
int qemuMonitorJSONSetCapabilities(qemuMonitorPtr mon);
|
|
|
|
|
|
2018-02-09 15:40:51 +00:00
|
|
|
int qemuMonitorJSONStartCPUs(qemuMonitorPtr mon);
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONStopCPUs(qemuMonitorPtr mon);
|
2011-09-27 09:42:04 +00:00
|
|
|
int qemuMonitorJSONGetStatus(qemuMonitorPtr mon,
|
|
|
|
|
bool *running,
|
|
|
|
|
virDomainPausedReason *reason);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONSystemPowerdown(qemuMonitorPtr mon);
|
2011-06-15 16:49:58 +00:00
|
|
|
int qemuMonitorJSONSystemReset(qemuMonitorPtr mon);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2016-07-08 13:36:27 +00:00
|
|
|
int qemuMonitorJSONQueryCPUs(qemuMonitorPtr mon,
|
2016-08-01 11:44:25 +00:00
|
|
|
struct qemuMonitorQueryCpusEntry **entries,
|
2016-12-04 17:53:03 +00:00
|
|
|
size_t *nentries,
|
2018-04-04 14:45:03 +00:00
|
|
|
bool force,
|
|
|
|
|
bool fast);
|
2014-12-10 14:31:23 +00:00
|
|
|
int qemuMonitorJSONUpdateVideoMemorySize(qemuMonitorPtr mon,
|
|
|
|
|
virDomainVideoDefPtr video,
|
|
|
|
|
char *path);
|
2016-02-23 16:04:19 +00:00
|
|
|
int qemuMonitorJSONUpdateVideoVram64Size(qemuMonitorPtr mon,
|
|
|
|
|
virDomainVideoDefPtr video,
|
|
|
|
|
char *path);
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONGetBalloonInfo(qemuMonitorPtr mon,
|
2012-03-02 20:27:39 +00:00
|
|
|
unsigned long long *currmem);
|
2010-04-12 11:31:15 +00:00
|
|
|
int qemuMonitorJSONGetMemoryStats(qemuMonitorPtr mon,
|
2013-07-11 23:18:48 +00:00
|
|
|
char *balloonpath,
|
2010-04-12 11:31:15 +00:00
|
|
|
virDomainMemoryStatPtr stats,
|
|
|
|
|
unsigned int nr_stats);
|
2013-06-27 15:00:31 +00:00
|
|
|
int qemuMonitorJSONSetMemoryStatsPeriod(qemuMonitorPtr mon,
|
|
|
|
|
char *balloonpath,
|
|
|
|
|
int period);
|
2011-09-13 13:49:50 +00:00
|
|
|
int qemuMonitorJSONGetBlockInfo(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *table);
|
2017-07-24 10:51:10 +00:00
|
|
|
|
2018-07-30 15:08:37 +00:00
|
|
|
virJSONValuePtr qemuMonitorJSONQueryBlockstats(qemuMonitorPtr mon);
|
2014-09-15 08:48:09 +00:00
|
|
|
int qemuMonitorJSONGetAllBlockStatsInfo(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *hash,
|
2014-12-11 22:28:41 +00:00
|
|
|
bool backingChain);
|
2014-09-25 10:03:26 +00:00
|
|
|
int qemuMonitorJSONBlockStatsUpdateCapacity(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *stats,
|
2014-12-11 22:28:41 +00:00
|
|
|
bool backingChain);
|
2018-06-28 10:35:16 +00:00
|
|
|
int qemuMonitorJSONBlockStatsUpdateCapacityBlockdev(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *stats);
|
2018-06-28 10:35:16 +00:00
|
|
|
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *
|
2019-12-09 06:46:53 +00:00
|
|
|
qemuMonitorJSONBlockGetNamedNodeDataJSON(virJSONValuePtr nodes);
|
|
|
|
|
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *
|
2020-01-21 15:51:40 +00:00
|
|
|
qemuMonitorJSONBlockGetNamedNodeData(qemuMonitorPtr mon,
|
|
|
|
|
bool supports_flat);
|
2019-10-09 12:13:10 +00:00
|
|
|
|
2011-11-29 07:34:53 +00:00
|
|
|
int qemuMonitorJSONBlockResize(qemuMonitorPtr mon,
|
2018-08-07 07:31:04 +00:00
|
|
|
const char *device,
|
|
|
|
|
const char *nodename,
|
2011-11-29 07:34:53 +00:00
|
|
|
unsigned long long size);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2011-01-10 11:12:32 +00:00
|
|
|
int qemuMonitorJSONSetPassword(qemuMonitorPtr mon,
|
|
|
|
|
const char *protocol,
|
|
|
|
|
const char *password,
|
|
|
|
|
const char *action_if_connected);
|
|
|
|
|
int qemuMonitorJSONExpirePassword(qemuMonitorPtr mon,
|
|
|
|
|
const char *protocol,
|
|
|
|
|
const char *expire_time);
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONSetBalloon(qemuMonitorPtr mon,
|
2015-05-27 12:03:17 +00:00
|
|
|
unsigned long long newmem);
|
2013-05-27 13:35:35 +00:00
|
|
|
int qemuMonitorJSONSetCPU(qemuMonitorPtr mon, int cpu, bool online);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONEjectMedia(qemuMonitorPtr mon,
|
2011-09-16 12:05:58 +00:00
|
|
|
const char *dev_name,
|
2010-11-08 17:52:48 +00:00
|
|
|
bool force);
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONChangeMedia(qemuMonitorPtr mon,
|
2011-09-16 12:05:58 +00:00
|
|
|
const char *dev_name,
|
2009-11-03 18:59:18 +00:00
|
|
|
const char *newmedia,
|
|
|
|
|
const char *format);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONSaveVirtualMemory(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long long offset,
|
2019-09-27 11:29:53 +00:00
|
|
|
unsigned long long length,
|
2009-11-03 18:59:18 +00:00
|
|
|
const char *path);
|
|
|
|
|
int qemuMonitorJSONSavePhysicalMemory(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long long offset,
|
2019-09-27 11:29:53 +00:00
|
|
|
unsigned long long length,
|
2009-11-03 18:59:18 +00:00
|
|
|
const char *path);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONSetMigrationSpeed(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long bandwidth);
|
|
|
|
|
|
2010-03-17 15:53:14 +00:00
|
|
|
int qemuMonitorJSONSetMigrationDowntime(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long long downtime);
|
|
|
|
|
|
2013-02-18 20:54:58 +00:00
|
|
|
int qemuMonitorJSONGetMigrationCacheSize(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long long *cacheSize);
|
|
|
|
|
int qemuMonitorJSONSetMigrationCacheSize(qemuMonitorPtr mon,
|
|
|
|
|
unsigned long long cacheSize);
|
|
|
|
|
|
2016-06-20 13:47:46 +00:00
|
|
|
int qemuMonitorJSONGetMigrationParams(qemuMonitorPtr mon,
|
2018-03-15 17:06:01 +00:00
|
|
|
virJSONValuePtr *params);
|
2016-06-20 13:47:46 +00:00
|
|
|
int qemuMonitorJSONSetMigrationParams(qemuMonitorPtr mon,
|
2020-11-30 14:17:34 +00:00
|
|
|
virJSONValuePtr *params);
|
2016-04-14 10:33:49 +00:00
|
|
|
|
2015-11-26 12:23:08 +00:00
|
|
|
int qemuMonitorJSONGetMigrationStats(qemuMonitorPtr mon,
|
2017-10-12 13:19:19 +00:00
|
|
|
qemuMonitorMigrationStatsPtr stats,
|
|
|
|
|
char **error);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2014-09-11 12:11:54 +00:00
|
|
|
int qemuMonitorJSONGetMigrationCapabilities(qemuMonitorPtr mon,
|
|
|
|
|
char ***capabilities);
|
2018-03-01 08:26:07 +00:00
|
|
|
int qemuMonitorJSONSetMigrationCapabilities(qemuMonitorPtr mon,
|
2018-04-05 18:59:07 +00:00
|
|
|
virJSONValuePtr caps);
|
2013-01-14 11:45:20 +00:00
|
|
|
|
2016-03-08 17:24:18 +00:00
|
|
|
int qemuMonitorJSONGetGICCapabilities(qemuMonitorPtr mon,
|
|
|
|
|
virGICCapability **capabilities);
|
|
|
|
|
|
2018-06-08 14:40:51 +00:00
|
|
|
int qemuMonitorJSONGetSEVCapabilities(qemuMonitorPtr mon,
|
|
|
|
|
virSEVCapability **capabilities);
|
|
|
|
|
|
2011-03-04 18:51:48 +00:00
|
|
|
int qemuMonitorJSONMigrate(qemuMonitorPtr mon,
|
|
|
|
|
unsigned int flags,
|
|
|
|
|
const char *uri);
|
2012-09-20 09:15:31 +00:00
|
|
|
int qemuMonitorJSONGetSpiceMigrationStatus(qemuMonitorPtr mon,
|
|
|
|
|
bool *spice_migrated);
|
|
|
|
|
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONMigrateCancel(qemuMonitorPtr mon);
|
|
|
|
|
|
2017-11-20 20:02:59 +00:00
|
|
|
int qemuMonitorJSONQueryDump(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorDumpStatsPtr stats);
|
|
|
|
|
|
2014-03-23 03:51:13 +00:00
|
|
|
int qemuMonitorJSONGetDumpGuestMemoryCapability(qemuMonitorPtr mon,
|
|
|
|
|
const char *capability);
|
|
|
|
|
|
2012-06-12 03:04:51 +00:00
|
|
|
int qemuMonitorJSONDump(qemuMonitorPtr mon,
|
2014-03-23 03:51:14 +00:00
|
|
|
const char *protocol,
|
2017-11-20 20:05:23 +00:00
|
|
|
const char *dumpformat,
|
|
|
|
|
bool detach);
|
2012-06-12 03:04:51 +00:00
|
|
|
|
2011-02-17 13:39:36 +00:00
|
|
|
int qemuMonitorJSONGraphicsRelocate(qemuMonitorPtr mon,
|
|
|
|
|
int type,
|
|
|
|
|
const char *hostname,
|
|
|
|
|
int port,
|
|
|
|
|
int tlsPort,
|
|
|
|
|
const char *tlsSubject);
|
|
|
|
|
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONAddPCIHostDevice(qemuMonitorPtr mon,
|
2016-04-03 18:16:51 +00:00
|
|
|
virPCIDeviceAddress *hostAddr,
|
|
|
|
|
virPCIDeviceAddress *guestAddr);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONAddPCIDisk(qemuMonitorPtr mon,
|
|
|
|
|
const char *path,
|
|
|
|
|
const char *bus,
|
2016-04-03 18:16:51 +00:00
|
|
|
virPCIDeviceAddress *guestAddr);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONAddPCINetwork(qemuMonitorPtr mon,
|
|
|
|
|
const char *nicstr,
|
2016-04-03 18:16:51 +00:00
|
|
|
virPCIDeviceAddress *guestAddr);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONRemovePCIDevice(qemuMonitorPtr mon,
|
2016-04-03 18:16:51 +00:00
|
|
|
virPCIDeviceAddress *guestAddr);
|
2009-11-03 18:59:18 +00:00
|
|
|
|
2020-10-14 17:08:28 +00:00
|
|
|
int qemuMonitorJSONAddFileHandleToSet(qemuMonitorPtr mon,
|
|
|
|
|
int fd,
|
|
|
|
|
int fdset,
|
|
|
|
|
const char *opaque,
|
|
|
|
|
qemuMonitorAddFdInfoPtr info);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONRemoveFdset(qemuMonitorPtr mon,
|
|
|
|
|
int fdset);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONQueryFdsets(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorFdsetsPtr *fdsets);
|
|
|
|
|
|
2009-11-03 18:59:18 +00:00
|
|
|
int qemuMonitorJSONSendFileHandle(qemuMonitorPtr mon,
|
|
|
|
|
const char *fdname,
|
|
|
|
|
int fd);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONCloseFileHandle(qemuMonitorPtr mon,
|
|
|
|
|
const char *fdname);
|
|
|
|
|
|
2010-04-15 13:52:03 +00:00
|
|
|
int qemuMonitorJSONAddNetdev(qemuMonitorPtr mon,
|
2020-05-15 09:36:28 +00:00
|
|
|
virJSONValuePtr *props);
|
2010-04-15 13:52:03 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONRemoveNetdev(qemuMonitorPtr mon,
|
|
|
|
|
const char *alias);
|
|
|
|
|
|
qemu: qemuMonitorQueryRxFilter - retrieve guest netdev rx-filter
This function can be called at any time to get the current status of a
guest's network device rx-filter. In particular it is useful to call
after libvirt recieves a NIC_RX_FILTER_CHANGED event - this event only
tells you that something has changed in the rx-filter, the details are
retrieved with the query-rx-filter monitor command (only available in
the json monitor). The command sent to the qemu monitor looks like this:
{"execute":"query-rx-filter", "arguments": {"name":"net2"} }'
and the results will look something like this:
{
"return": [
{
"promiscuous": false,
"name": "net2",
"main-mac": "52:54:00:98:2d:e3",
"unicast": "normal",
"vlan": "normal",
"vlan-table": [
42,
0
],
"unicast-table": [
],
"multicast": "normal",
"multicast-overflow": false,
"unicast-overflow": false,
"multicast-table": [
"33:33:ff:98:2d:e3",
"01:80:c2:00:00:21",
"01:00:5e:00:00:fb",
"33:33:ff:98:2d:e2",
"01:00:5e:00:00:01",
"33:33:00:00:00:01"
],
"broadcast-allowed": false
}
],
"id": "libvirt-14"
}
This is all parsed from JSON into a virNetDevRxFilter object for
easier consumption. (unicast-table is usually empty, but is also an
array of mac addresses similar to multicast-table).
(NB: LIBNL_CFLAGS was added to tests/Makefile.am because virnetdev.h
now includes util/virnetlink.h, which includes netlink/msg.h when
appropriate. Without LIBNL_CFLAGS, gcc can't find that file (if
libnl/netlink isn't available, LIBNL_CFLAGS will be empty and
virnetlink.h won't try to include netlink/msg.h anyway).)
2014-09-22 16:19:41 +00:00
|
|
|
int qemuMonitorJSONQueryRxFilter(qemuMonitorPtr mon, const char *alias,
|
|
|
|
|
virNetDevRxFilterPtr *filter);
|
|
|
|
|
|
2014-11-13 15:17:21 +00:00
|
|
|
int qemuMonitorJSONGetChardevInfo(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *info);
|
2010-01-22 13:22:53 +00:00
|
|
|
|
2009-12-07 19:28:05 +00:00
|
|
|
int qemuMonitorJSONAttachPCIDiskController(qemuMonitorPtr mon,
|
|
|
|
|
const char *bus,
|
2016-04-03 18:16:51 +00:00
|
|
|
virPCIDeviceAddress *guestAddr);
|
2009-12-07 19:28:05 +00:00
|
|
|
|
2016-07-31 13:26:12 +00:00
|
|
|
int qemuMonitorJSONAddDeviceArgs(qemuMonitorPtr mon,
|
|
|
|
|
virJSONValuePtr args);
|
2010-01-26 15:34:46 +00:00
|
|
|
int qemuMonitorJSONAddDevice(qemuMonitorPtr mon,
|
|
|
|
|
const char *devicestr);
|
|
|
|
|
|
2010-03-02 08:40:51 +00:00
|
|
|
int qemuMonitorJSONDelDevice(qemuMonitorPtr mon,
|
2010-04-14 14:36:42 +00:00
|
|
|
const char *devalias);
|
2010-03-02 08:40:51 +00:00
|
|
|
|
2014-09-23 11:25:25 +00:00
|
|
|
int qemuMonitorJSONAddObject(qemuMonitorPtr mon,
|
|
|
|
|
virJSONValuePtr props);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONDelObject(qemuMonitorPtr mon,
|
2020-03-18 11:24:40 +00:00
|
|
|
const char *objalias,
|
|
|
|
|
bool report_error);
|
2014-09-23 11:25:25 +00:00
|
|
|
|
2018-03-30 10:35:52 +00:00
|
|
|
int qemuMonitorJSONTransaction(qemuMonitorPtr mon, virJSONValuePtr *actions)
|
blockjob: add qemu capabilities related to block jobs
Upstream qemu 1.3 is adding two new monitor commands, 'drive-mirror'
and 'block-job-complete'[1], which can drive live block copy and
storage migration. [Additionally, RHEL 6.3 had backported an earlier
version of most of the same functionality, but under the names
'__com.redhat_drive-mirror' and '__com.redhat_drive-reopen' and with
slightly different JSON arguments, and has been using patches similar
to these upstream patches for several months now.]
The libvirt API virDomainBlockRebase as already committed for 0.9.12
is flexible enough to expose the basics of block copy, but some
additional features in the 'drive-mirror' qemu command, such as
setting error policy, setting granularity, or using a persistent
bitmap, may later require a new libvirt API virDomainBlockCopy. I
will wait to add that API until we know more about what qemu 1.3
will finally provide.
This patch caters only to the upstream qemu 1.3 interface, although
I have proven that the changes for RHEL 6.3 can be isolated to
just qemu_monitor_json.c, and the rest of this series will
gracefully handle either interface once the JSON differences are
papered over in a downstream patch.
For consistency with other block job commands, libvirt must handle
the bandwidth argument as MiB/sec from the user, even though qemu
exposes the speed argument as bytes/sec; then again, qemu rounds
up to cluster size internally, so using MiB hides the worst effects
of that rounding if you pass small numbers.
[1]https://lists.gnu.org/archive/html/qemu-devel/2012-10/msg04123.html
* src/qemu/qemu_capabilities.h (QEMU_CAPS_DRIVE_MIRROR)
(QEMU_CAPS_DRIVE_REOPEN): New bits.
* src/qemu/qemu_capabilities.c (qemuCaps): Name them.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONCheckCommands): Set
them.
(qemuMonitorJSONDriveMirror, qemuMonitorDrivePivot): New functions.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDriveMirror)
(qemuMonitorDrivePivot): Declare them.
* src/qemu/qemu_monitor.c (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): New passthroughs.
* src/qemu/qemu_monitor.h (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): Declare them.
2012-09-28 23:29:53 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
int qemuMonitorJSONDriveMirror(qemuMonitorPtr mon,
|
|
|
|
|
const char *device,
|
|
|
|
|
const char *file,
|
|
|
|
|
const char *format,
|
|
|
|
|
unsigned long long speed,
|
blockcopy: add qemu implementation of new tunables
Upstream qemu 1.4 added some drive-mirror tunables not present
when it was first introduced in 1.3. Management apps may want
to set these in some cases (for example, without tuning
granularity down to sector size, a copy may end up occupying
more bytes than the original because an entire cluster is
copied even when only a sector within the cluster is dirty,
although tuning it down results in more CPU time to do the
copy). I haven't personally needed to use the parameters, but
since they exist, and since the new API supports virTypedParams,
we might as well expose them.
Since the tuning parameters aren't often used, and omitted from
the QMP command when unspecified, I think it is safe to rely on
qemu 1.3 to issue an error about them being unsupported, rather
than trying to create a new capability bit in libvirt.
Meanwhile, all versions of qemu from 1.4 to 2.1 have a bug where
a bad granularity (such as non-power-of-2) gives a poor message:
error: internal error: unable to execute QEMU command 'drive-mirror': Invalid parameter 'drive-virtio-disk0'
because of abuse of QERR_INVALID_PARAMETER (which is supposed to
name the parameter that was given a bad value, rather than the
value passed to some other parameter). I don't see that a
capability check will help, so we'll just live with it (and it
has since been improved in upstream qemu).
* src/qemu/qemu_monitor.h (qemuMonitorDriveMirror): Add
parameters.
* src/qemu/qemu_monitor.c (qemuMonitorDriveMirror): Likewise.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDriveMirror):
Likewise.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONDriveMirror):
Likewise.
* src/qemu/qemu_driver.c (qemuDomainBlockCopyCommon): Likewise.
(qemuDomainBlockRebase, qemuDomainBlockCopy): Adjust callers.
* src/qemu/qemu_migration.c (qemuMigrationDriveMirror): Likewise.
* tests/qemumonitorjsontest.c (qemuMonitorJSONDriveMirror): Likewise.
Signed-off-by: Eric Blake <eblake@redhat.com>
2014-09-08 20:53:12 +00:00
|
|
|
unsigned int granularity,
|
|
|
|
|
unsigned long long buf_size,
|
2019-05-17 16:13:53 +00:00
|
|
|
bool shallow,
|
|
|
|
|
bool reuse)
|
blockjob: add qemu capabilities related to block jobs
Upstream qemu 1.3 is adding two new monitor commands, 'drive-mirror'
and 'block-job-complete'[1], which can drive live block copy and
storage migration. [Additionally, RHEL 6.3 had backported an earlier
version of most of the same functionality, but under the names
'__com.redhat_drive-mirror' and '__com.redhat_drive-reopen' and with
slightly different JSON arguments, and has been using patches similar
to these upstream patches for several months now.]
The libvirt API virDomainBlockRebase as already committed for 0.9.12
is flexible enough to expose the basics of block copy, but some
additional features in the 'drive-mirror' qemu command, such as
setting error policy, setting granularity, or using a persistent
bitmap, may later require a new libvirt API virDomainBlockCopy. I
will wait to add that API until we know more about what qemu 1.3
will finally provide.
This patch caters only to the upstream qemu 1.3 interface, although
I have proven that the changes for RHEL 6.3 can be isolated to
just qemu_monitor_json.c, and the rest of this series will
gracefully handle either interface once the JSON differences are
papered over in a downstream patch.
For consistency with other block job commands, libvirt must handle
the bandwidth argument as MiB/sec from the user, even though qemu
exposes the speed argument as bytes/sec; then again, qemu rounds
up to cluster size internally, so using MiB hides the worst effects
of that rounding if you pass small numbers.
[1]https://lists.gnu.org/archive/html/qemu-devel/2012-10/msg04123.html
* src/qemu/qemu_capabilities.h (QEMU_CAPS_DRIVE_MIRROR)
(QEMU_CAPS_DRIVE_REOPEN): New bits.
* src/qemu/qemu_capabilities.c (qemuCaps): Name them.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONCheckCommands): Set
them.
(qemuMonitorJSONDriveMirror, qemuMonitorDrivePivot): New functions.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDriveMirror)
(qemuMonitorDrivePivot): Declare them.
* src/qemu/qemu_monitor.c (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): New passthroughs.
* src/qemu/qemu_monitor.h (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): Declare them.
2012-09-28 23:29:53 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
2016-03-01 13:55:34 +00:00
|
|
|
int qemuMonitorJSONBlockdevMirror(qemuMonitorPtr mon,
|
|
|
|
|
const char *jobname,
|
2018-08-16 16:47:20 +00:00
|
|
|
bool persistjob,
|
2016-03-01 13:55:34 +00:00
|
|
|
const char *device,
|
|
|
|
|
const char *target,
|
|
|
|
|
unsigned long long speed,
|
|
|
|
|
unsigned int granularity,
|
|
|
|
|
unsigned long long buf_size,
|
2019-05-17 16:13:53 +00:00
|
|
|
bool shallow)
|
2018-08-16 16:47:20 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(4) ATTRIBUTE_NONNULL(5);
|
blockjob: add qemu capabilities related to block jobs
Upstream qemu 1.3 is adding two new monitor commands, 'drive-mirror'
and 'block-job-complete'[1], which can drive live block copy and
storage migration. [Additionally, RHEL 6.3 had backported an earlier
version of most of the same functionality, but under the names
'__com.redhat_drive-mirror' and '__com.redhat_drive-reopen' and with
slightly different JSON arguments, and has been using patches similar
to these upstream patches for several months now.]
The libvirt API virDomainBlockRebase as already committed for 0.9.12
is flexible enough to expose the basics of block copy, but some
additional features in the 'drive-mirror' qemu command, such as
setting error policy, setting granularity, or using a persistent
bitmap, may later require a new libvirt API virDomainBlockCopy. I
will wait to add that API until we know more about what qemu 1.3
will finally provide.
This patch caters only to the upstream qemu 1.3 interface, although
I have proven that the changes for RHEL 6.3 can be isolated to
just qemu_monitor_json.c, and the rest of this series will
gracefully handle either interface once the JSON differences are
papered over in a downstream patch.
For consistency with other block job commands, libvirt must handle
the bandwidth argument as MiB/sec from the user, even though qemu
exposes the speed argument as bytes/sec; then again, qemu rounds
up to cluster size internally, so using MiB hides the worst effects
of that rounding if you pass small numbers.
[1]https://lists.gnu.org/archive/html/qemu-devel/2012-10/msg04123.html
* src/qemu/qemu_capabilities.h (QEMU_CAPS_DRIVE_MIRROR)
(QEMU_CAPS_DRIVE_REOPEN): New bits.
* src/qemu/qemu_capabilities.c (qemuCaps): Name them.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONCheckCommands): Set
them.
(qemuMonitorJSONDriveMirror, qemuMonitorDrivePivot): New functions.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDriveMirror)
(qemuMonitorDrivePivot): Declare them.
* src/qemu/qemu_monitor.c (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): New passthroughs.
* src/qemu/qemu_monitor.h (qemuMonitorDriveMirror)
(qemuMonitorDrivePivot): Declare them.
2012-09-28 23:29:53 +00:00
|
|
|
int qemuMonitorJSONDrivePivot(qemuMonitorPtr mon,
|
2018-08-14 11:11:05 +00:00
|
|
|
const char *jobname)
|
2013-10-17 13:21:46 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
2011-08-15 23:25:54 +00:00
|
|
|
|
2018-08-14 13:52:01 +00:00
|
|
|
bool qemuMonitorJSONSupportsActiveCommit(qemuMonitorPtr mon)
|
|
|
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
|
|
2012-10-03 21:13:21 +00:00
|
|
|
int qemuMonitorJSONBlockCommit(qemuMonitorPtr mon,
|
|
|
|
|
const char *device,
|
2018-08-16 16:20:25 +00:00
|
|
|
const char *jobname,
|
|
|
|
|
bool persistjob,
|
2012-10-03 21:13:21 +00:00
|
|
|
const char *top,
|
2018-08-16 16:20:25 +00:00
|
|
|
const char *topNode,
|
2012-10-03 21:13:21 +00:00
|
|
|
const char *base,
|
2018-08-16 16:20:25 +00:00
|
|
|
const char *baseNode,
|
2014-05-13 15:41:33 +00:00
|
|
|
const char *backingName,
|
2012-10-03 21:13:21 +00:00
|
|
|
unsigned long long bandwidth)
|
blockjob: allow omitted arguments to QMP block-commit
We are about to turn on support for active block commit. Although
qemu 2.0 was the first version to mostly support it, that version
mis-handles 0-length files, and doesn't have anything available for
easy probing. But qemu 2.1 fixed bugs, and made life simpler by
letting the 'top' argument be optional. Unless someone begs for
active commit with qemu 2.0, for now we are just going to enable
it only by probing for qemu 2.1 behavior (anyone backporting active
commit can also backport the optional argument behavior). This
requires qemu.git commit 7676e2c597000eff3a7233b40cca768b358f9bc9.
Although all our actual uses of block-commit supply arguments for
both base and top, we can omit both arguments and use a bogus
device string to trigger an interesting behavior in qemu. All QMP
commands first do argument validation, failing with GenericError
if a mandatory argument is missing. Once that passes, the code
in the specific command gets to do further checking, and the qemu
developers made sure that if device is the only supplied argument,
then the block-commit code will look up the device first, with a
failure of DeviceNotFound, before attempting any further argument
validation (most other validations fail with GenericError). Thus,
the category of error class can reliably be used to decipher
whether the top argument was optional, which in turn implies a
working active commit. Since we expect our bogus device string to
trigger an error either way, the code is written to return a
distinct return value without spamming the logs.
* src/qemu/qemu_monitor.h (qemuMonitorSupportsActiveCommit): New
prototype.
* src/qemu/qemu_monitor.c (qemuMonitorSupportsActiveCommit):
Implement it.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONBlockCommit):
Allow NULL for top and base, for probing purposes.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONBlockCommit):
Likewise, implementing the probe.
* tests/qemumonitorjsontest.c (mymain): Enable...
(testQemuMonitorJSONqemuMonitorSupportsActiveCommit): ...a new test.
Signed-off-by: Eric Blake <eblake@redhat.com>
2014-06-17 03:42:49 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
2012-10-03 21:13:21 +00:00
|
|
|
|
qemu: read backing chain names from qemu
https://bugzilla.redhat.com/show_bug.cgi?id=1199182 documents that
after a series of disk snapshots into existing destination images,
followed by active commits of the top image, it is possible for
qemu 2.2 and earlier to end up tracking a different name for the
image than what it would have had when opening the chain afresh.
That is, when starting with the chain 'a <- b <- c', the name
associated with 'b' is how it was spelled in the metadata of 'c',
but when starting with 'a', taking two snapshots into 'a <- b <- c',
then committing 'c' back into 'b', the name associated with 'b' is
now the name used when taking the first snapshot.
Sadly, older qemu doesn't know how to treat different spellings of
the same filename as identical files (it uses strcmp() instead of
checking for the same inode), which means libvirt's attempt to
commit an image using solely the names learned from qcow2 metadata
fails with a cryptic:
error: internal error: unable to execute QEMU command 'block-commit': Top image file /tmp/images/c/../b/b not found
even though the file exists. Trying to teach libvirt the rules on
which name qemu will expect is not worth the effort (besides, we'd
have to remember it across libvirtd restarts, and track whether a
file was opened via metadata or via snapshot creation for a given
qemu process); it is easier to just always directly ask qemu what
string it expects to see in the first place.
As a safety valve, we validate that any name returned by qemu
still maps to the same local file as we have tracked it, so that
a compromised qemu cannot accidentally cause us to act on an
incorrect file.
* src/qemu/qemu_monitor.h (qemuMonitorDiskNameLookup): New
prototype.
* src/qemu/qemu_monitor_json.h (qemuMonitorJSONDiskNameLookup):
Likewise.
* src/qemu/qemu_monitor.c (qemuMonitorDiskNameLookup): New function.
* src/qemu/qemu_monitor_json.c (qemuMonitorJSONDiskNameLookup)
(qemuMonitorJSONDiskNameLookupOne): Likewise.
* src/qemu/qemu_driver.c (qemuDomainBlockCommit)
(qemuDomainBlockJobImpl): Use it.
Signed-off-by: Eric Blake <eblake@redhat.com>
2015-03-11 20:37:04 +00:00
|
|
|
char *qemuMonitorJSONDiskNameLookup(qemuMonitorPtr mon,
|
|
|
|
|
const char *device,
|
|
|
|
|
virStorageSourcePtr top,
|
|
|
|
|
virStorageSourcePtr target)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3)
|
|
|
|
|
ATTRIBUTE_NONNULL(4);
|
|
|
|
|
|
2010-04-17 02:12:45 +00:00
|
|
|
int qemuMonitorJSONArbitraryCommand(qemuMonitorPtr mon,
|
|
|
|
|
const char *cmd_str,
|
2019-09-19 15:53:45 +00:00
|
|
|
char **reply_str);
|
2010-04-17 02:12:45 +00:00
|
|
|
|
2011-05-10 08:26:06 +00:00
|
|
|
int qemuMonitorJSONInjectNMI(qemuMonitorPtr mon);
|
2011-04-01 06:23:58 +00:00
|
|
|
|
2011-07-21 07:55:56 +00:00
|
|
|
int qemuMonitorJSONSendKey(qemuMonitorPtr mon,
|
|
|
|
|
unsigned int holdtime,
|
|
|
|
|
unsigned int *keycodes,
|
|
|
|
|
unsigned int nkeycodes);
|
|
|
|
|
|
2011-04-01 06:23:58 +00:00
|
|
|
int qemuMonitorJSONScreendump(qemuMonitorPtr mon,
|
2018-05-17 11:53:34 +00:00
|
|
|
const char *device,
|
|
|
|
|
unsigned int head,
|
2011-04-01 06:23:58 +00:00
|
|
|
const char *file);
|
|
|
|
|
|
2015-04-01 09:45:35 +00:00
|
|
|
int qemuMonitorJSONBlockStream(qemuMonitorPtr mon,
|
|
|
|
|
const char *device,
|
2018-08-15 11:13:53 +00:00
|
|
|
const char *jobname,
|
|
|
|
|
bool persistjob,
|
2015-04-01 09:45:35 +00:00
|
|
|
const char *base,
|
2018-08-15 11:13:53 +00:00
|
|
|
const char *baseNode,
|
2015-04-01 09:45:35 +00:00
|
|
|
const char *backingName,
|
2017-09-13 13:40:46 +00:00
|
|
|
unsigned long long speed)
|
2012-04-11 21:40:16 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
2011-04-01 06:23:58 +00:00
|
|
|
|
2015-04-01 08:40:06 +00:00
|
|
|
int qemuMonitorJSONBlockJobCancel(qemuMonitorPtr mon,
|
2018-08-14 11:11:05 +00:00
|
|
|
const char *jobname)
|
2015-04-01 08:40:06 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2018-12-04 16:58:38 +00:00
|
|
|
int
|
|
|
|
|
qemuMonitorJSONGetJobInfo(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorJobInfoPtr **jobs,
|
|
|
|
|
size_t *njobs);
|
|
|
|
|
|
|
|
|
|
|
2015-04-01 07:47:04 +00:00
|
|
|
int qemuMonitorJSONBlockJobSetSpeed(qemuMonitorPtr mon,
|
2018-08-14 11:11:05 +00:00
|
|
|
const char *jobname,
|
2017-09-13 13:40:46 +00:00
|
|
|
unsigned long long speed)
|
2015-04-01 07:47:04 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *qemuMonitorJSONGetAllBlockJobInfo(qemuMonitorPtr mon,
|
2019-06-11 14:42:53 +00:00
|
|
|
bool rawjobname)
|
2015-05-22 11:33:49 +00:00
|
|
|
ATTRIBUTE_NONNULL(1);
|
2014-08-27 19:29:14 +00:00
|
|
|
|
2018-08-16 09:48:41 +00:00
|
|
|
int qemuMonitorJSONJobDismiss(qemuMonitorPtr mon,
|
|
|
|
|
const char *jobname)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2018-08-16 09:48:41 +00:00
|
|
|
int qemuMonitorJSONJobCancel(qemuMonitorPtr mon,
|
|
|
|
|
const char *jobname,
|
|
|
|
|
bool quiet)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2018-08-16 09:48:41 +00:00
|
|
|
int qemuMonitorJSONJobComplete(qemuMonitorPtr mon,
|
|
|
|
|
const char *jobname)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2011-09-06 08:18:57 +00:00
|
|
|
int qemuMonitorJSONSetLink(qemuMonitorPtr mon,
|
|
|
|
|
const char *name,
|
2014-06-01 00:22:30 +00:00
|
|
|
virDomainNetInterfaceLinkState state);
|
2011-09-06 08:18:57 +00:00
|
|
|
|
2011-10-21 08:00:13 +00:00
|
|
|
int qemuMonitorJSONOpenGraphics(qemuMonitorPtr mon,
|
|
|
|
|
const char *protocol,
|
|
|
|
|
const char *fdname,
|
|
|
|
|
bool skipauth);
|
|
|
|
|
|
2011-11-15 09:02:45 +00:00
|
|
|
int qemuMonitorJSONSetBlockIoThrottle(qemuMonitorPtr mon,
|
2018-07-25 13:14:43 +00:00
|
|
|
const char *drivealias,
|
|
|
|
|
const char *qomid,
|
2014-11-10 15:19:09 +00:00
|
|
|
virDomainBlockIoTuneInfoPtr info,
|
2016-09-18 16:02:50 +00:00
|
|
|
bool supportMaxOptions,
|
2016-10-31 21:22:59 +00:00
|
|
|
bool supportGroupNameOption,
|
2016-09-18 16:02:50 +00:00
|
|
|
bool supportMaxLengthOptions);
|
2011-11-15 09:02:45 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetBlockIoThrottle(qemuMonitorPtr mon,
|
2018-07-25 13:14:43 +00:00
|
|
|
const char *drivealias,
|
|
|
|
|
const char *qdevid,
|
2016-05-20 06:30:45 +00:00
|
|
|
virDomainBlockIoTuneInfoPtr reply);
|
2011-11-15 09:02:45 +00:00
|
|
|
|
2012-02-10 12:33:52 +00:00
|
|
|
int qemuMonitorJSONSystemWakeup(qemuMonitorPtr mon);
|
|
|
|
|
|
2018-06-08 14:41:01 +00:00
|
|
|
char *qemuMonitorJSONGetSEVMeasurement(qemuMonitorPtr mon);
|
|
|
|
|
|
2012-08-15 14:04:09 +00:00
|
|
|
int qemuMonitorJSONGetVersion(qemuMonitorPtr mon,
|
|
|
|
|
int *major,
|
|
|
|
|
int *minor,
|
|
|
|
|
int *micro,
|
|
|
|
|
char **package)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
|
|
|
|
|
|
2012-08-15 15:18:41 +00:00
|
|
|
int qemuMonitorJSONGetMachines(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorMachineInfoPtr **machines)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2012-08-20 14:58:20 +00:00
|
|
|
int qemuMonitorJSONGetCPUDefinitions(qemuMonitorPtr mon,
|
2019-09-24 11:42:00 +00:00
|
|
|
qemuMonitorCPUDefsPtr *cpuDefs)
|
2012-08-20 14:58:20 +00:00
|
|
|
ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2016-12-18 19:22:26 +00:00
|
|
|
int qemuMonitorJSONGetCPUModelExpansion(qemuMonitorPtr mon,
|
2017-01-31 12:44:00 +00:00
|
|
|
qemuMonitorCPUModelExpansionType type,
|
2019-09-19 20:24:54 +00:00
|
|
|
virCPUDefPtr cpu,
|
2017-03-29 08:58:41 +00:00
|
|
|
bool migratable,
|
2019-09-19 20:24:56 +00:00
|
|
|
bool fail_no_props,
|
2016-12-18 19:22:26 +00:00
|
|
|
qemuMonitorCPUModelInfoPtr *model_info)
|
2019-09-19 20:24:56 +00:00
|
|
|
ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(6);
|
2016-12-18 19:22:26 +00:00
|
|
|
|
2019-09-19 20:24:58 +00:00
|
|
|
int qemuMonitorJSONGetCPUModelBaseline(qemuMonitorPtr mon,
|
|
|
|
|
virCPUDefPtr cpu_a,
|
|
|
|
|
virCPUDefPtr cpu_b,
|
|
|
|
|
qemuMonitorCPUModelInfoPtr *baseline)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
|
|
|
|
|
|
2019-09-19 20:25:02 +00:00
|
|
|
int qemuMonitorJSONGetCPUModelComparison(qemuMonitorPtr mon,
|
|
|
|
|
virCPUDefPtr cpu_a,
|
|
|
|
|
virCPUDefPtr cpu_b,
|
|
|
|
|
char **result)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
|
|
|
|
|
2012-08-22 09:25:20 +00:00
|
|
|
int qemuMonitorJSONGetCommands(qemuMonitorPtr mon,
|
|
|
|
|
char ***commands)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
2012-08-22 09:48:41 +00:00
|
|
|
int qemuMonitorJSONGetEvents(qemuMonitorPtr mon,
|
|
|
|
|
char ***events)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
2020-11-30 16:54:25 +00:00
|
|
|
GHashTable *qemuMonitorJSONGetCommandLineOptions(qemuMonitorPtr mon);
|
2012-08-22 09:25:20 +00:00
|
|
|
|
Make non-KVM machines work with QMP probing
When there is no 'qemu-kvm' binary and the emulator used for a machine
is, for example, 'qemu-system-x86_64' that, by default, runs without
kvm enabled, libvirt still supplies '-no-kvm' option to this process,
even though it does not recognize such option (making the start of a
domain fail in that case).
This patch fixes building a command-line for QEMU machines without KVM
acceleration and is based on following assumptions:
- QEMU_CAPS_KVM flag means that QEMU is running KVM accelerated
machines by default (without explicitly requesting that using a
command-line option). It is the closest to the truth according to
the code with the only exception being the comment next to the
flag, so it's fixed in this patch as well.
- QEMU_CAPS_ENABLE_KVM flag means that QEMU is, by default, running
without KVM acceleration and in case we need KVM acceleration it
needs to be explicitly instructed to do so. This is partially
true for the past (this option essentially means that QEMU
recognizes the '-enable-kvm' option, even though it's almost the
same).
2012-10-31 07:31:49 +00:00
|
|
|
int qemuMonitorJSONGetKVMState(qemuMonitorPtr mon,
|
|
|
|
|
bool *enabled,
|
|
|
|
|
bool *present)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
|
|
|
|
|
2012-08-22 09:48:41 +00:00
|
|
|
int qemuMonitorJSONGetObjectTypes(qemuMonitorPtr mon,
|
|
|
|
|
char ***types)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
2013-06-24 17:51:56 +00:00
|
|
|
|
|
|
|
|
/* ListPath structures and API's are public only for qemumonitorjsontest */
|
|
|
|
|
typedef struct _qemuMonitorJSONListPath qemuMonitorJSONListPath;
|
|
|
|
|
typedef qemuMonitorJSONListPath *qemuMonitorJSONListPathPtr;
|
|
|
|
|
|
|
|
|
|
struct _qemuMonitorJSONListPath {
|
|
|
|
|
char *name;
|
|
|
|
|
char *type;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetObjectListPaths(qemuMonitorPtr mon,
|
|
|
|
|
const char *path,
|
|
|
|
|
qemuMonitorJSONListPathPtr **paths)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
|
|
|
|
|
|
|
|
|
void qemuMonitorJSONListPathFree(qemuMonitorJSONListPathPtr paths);
|
|
|
|
|
|
2013-07-03 18:42:40 +00:00
|
|
|
/* ObjectProperty structures and Get/Set API's are public only
|
|
|
|
|
* for qemumonitorjsontest
|
|
|
|
|
*/
|
2013-07-03 18:15:07 +00:00
|
|
|
/* Flags for the 'type' field in _qemuMonitorJSONObjectProperty */
|
|
|
|
|
typedef enum {
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_BOOLEAN=1,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_INT,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_LONG,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_UINT,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_ULONG,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_DOUBLE,
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_STRING,
|
|
|
|
|
|
|
|
|
|
QEMU_MONITOR_OBJECT_PROPERTY_LAST
|
|
|
|
|
} qemuMonitorJSONObjectPropertyType;
|
|
|
|
|
|
|
|
|
|
typedef struct _qemuMonitorJSONObjectProperty qemuMonitorJSONObjectProperty;
|
|
|
|
|
typedef qemuMonitorJSONObjectProperty *qemuMonitorJSONObjectPropertyPtr;
|
|
|
|
|
struct _qemuMonitorJSONObjectProperty {
|
|
|
|
|
int type; /* qemuMonitorJSONObjectPropertyType */
|
|
|
|
|
union {
|
|
|
|
|
bool b;
|
|
|
|
|
int iv;
|
|
|
|
|
long long l;
|
|
|
|
|
unsigned int ui;
|
|
|
|
|
unsigned long long ul;
|
|
|
|
|
double d;
|
|
|
|
|
char *str;
|
|
|
|
|
} val;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetObjectProperty(qemuMonitorPtr mon,
|
|
|
|
|
const char *path,
|
|
|
|
|
const char *property,
|
|
|
|
|
qemuMonitorJSONObjectPropertyPtr prop)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
|
|
|
|
|
|
2013-07-03 18:42:40 +00:00
|
|
|
int qemuMonitorJSONSetObjectProperty(qemuMonitorPtr mon,
|
|
|
|
|
const char *path,
|
|
|
|
|
const char *property,
|
|
|
|
|
qemuMonitorJSONObjectPropertyPtr prop)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
|
|
|
|
|
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *qemuMonitorJSONGetDeviceProps(qemuMonitorPtr mon,
|
2020-05-06 17:53:43 +00:00
|
|
|
const char *device)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
2018-04-12 13:04:07 +00:00
|
|
|
int qemuMonitorJSONGetObjectProps(qemuMonitorPtr mon,
|
|
|
|
|
const char *object,
|
|
|
|
|
char ***props)
|
|
|
|
|
ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
2012-08-22 09:48:41 +00:00
|
|
|
char *qemuMonitorJSONGetTargetArch(qemuMonitorPtr mon);
|
2012-08-22 09:48:41 +00:00
|
|
|
|
2012-11-22 15:08:52 +00:00
|
|
|
int qemuMonitorJSONNBDServerStart(qemuMonitorPtr mon,
|
2019-04-09 21:21:38 +00:00
|
|
|
const virStorageNetHostDef *server,
|
2018-02-21 13:18:15 +00:00
|
|
|
const char *tls_alias);
|
2012-11-22 15:17:13 +00:00
|
|
|
int qemuMonitorJSONNBDServerAdd(qemuMonitorPtr mon,
|
|
|
|
|
const char *deviceID,
|
2019-06-06 02:25:05 +00:00
|
|
|
const char *export,
|
|
|
|
|
bool writable,
|
|
|
|
|
const char *bitmap);
|
2013-01-31 13:47:49 +00:00
|
|
|
int qemuMonitorJSONNBDServerStop(qemuMonitorPtr mon);
|
2020-10-14 09:33:06 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONBlockExportAdd(qemuMonitorPtr mon,
|
|
|
|
|
virJSONValuePtr *props);
|
|
|
|
|
|
2013-04-12 20:55:45 +00:00
|
|
|
int qemuMonitorJSONGetTPMModels(qemuMonitorPtr mon,
|
|
|
|
|
char ***tpmmodels)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetTPMTypes(qemuMonitorPtr mon,
|
|
|
|
|
char ***tpmtypes)
|
|
|
|
|
ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2013-03-12 18:48:04 +00:00
|
|
|
int qemuMonitorJSONAttachCharDev(qemuMonitorPtr mon,
|
|
|
|
|
const char *chrID,
|
|
|
|
|
virDomainChrSourceDefPtr chr);
|
2013-03-12 18:57:48 +00:00
|
|
|
int qemuMonitorJSONDetachCharDev(qemuMonitorPtr mon,
|
|
|
|
|
const char *chrID);
|
2013-07-19 13:01:38 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetDeviceAliases(qemuMonitorPtr mon,
|
|
|
|
|
char ***aliases);
|
|
|
|
|
|
2016-06-03 14:59:59 +00:00
|
|
|
int qemuMonitorJSONGetCPUx86Data(qemuMonitorPtr mon,
|
|
|
|
|
const char *property,
|
|
|
|
|
virCPUDataPtr *cpudata);
|
|
|
|
|
|
2019-06-17 14:56:32 +00:00
|
|
|
int qemuMonitorJSONGetGuestCPUx86(qemuMonitorPtr mon,
|
|
|
|
|
virCPUDataPtr *data,
|
|
|
|
|
virCPUDataPtr *disabled);
|
2014-08-13 12:28:24 +00:00
|
|
|
|
2019-06-17 21:36:53 +00:00
|
|
|
int qemuMonitorJSONGetGuestCPU(qemuMonitorPtr mon,
|
|
|
|
|
virArch arch,
|
|
|
|
|
qemuMonitorCPUFeatureTranslationCallback translate,
|
|
|
|
|
void *opaque,
|
|
|
|
|
virCPUDataPtr *enabled,
|
|
|
|
|
virCPUDataPtr *disabled);
|
|
|
|
|
|
2014-08-13 12:28:24 +00:00
|
|
|
int qemuMonitorJSONRTCResetReinjection(qemuMonitorPtr mon);
|
2014-08-29 20:23:11 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetIOThreads(qemuMonitorPtr mon,
|
2020-12-02 17:34:24 +00:00
|
|
|
qemuMonitorIOThreadInfoPtr **iothreads,
|
|
|
|
|
int *niothreads)
|
2014-08-29 20:23:11 +00:00
|
|
|
ATTRIBUTE_NONNULL(2);
|
2015-01-19 12:21:09 +00:00
|
|
|
|
2018-10-03 22:13:14 +00:00
|
|
|
int qemuMonitorJSONSetIOThread(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorIOThreadInfoPtr iothreadInfo)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2015-01-19 12:21:09 +00:00
|
|
|
int qemuMonitorJSONGetMemoryDeviceInfo(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *info)
|
2015-01-19 12:21:09 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2015-06-03 10:40:08 +00:00
|
|
|
int qemuMonitorJSONFindLinkPath(qemuMonitorPtr mon,
|
|
|
|
|
const char *name,
|
2016-07-25 08:47:00 +00:00
|
|
|
const char *alias,
|
2015-06-03 10:40:08 +00:00
|
|
|
char **path)
|
2016-07-25 08:47:00 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(4);
|
2015-10-20 20:51:48 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONMigrateIncoming(qemuMonitorPtr mon,
|
|
|
|
|
const char *uri)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2014-12-01 15:59:54 +00:00
|
|
|
int qemuMonitorJSONMigrateStartPostCopy(qemuMonitorPtr mon)
|
|
|
|
|
ATTRIBUTE_NONNULL(1);
|
2017-10-20 07:17:09 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONMigrateContinue(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorMigrationStatus status)
|
|
|
|
|
ATTRIBUTE_NONNULL(1);
|
2014-12-01 15:59:54 +00:00
|
|
|
|
2016-04-29 14:01:47 +00:00
|
|
|
int qemuMonitorJSONGetRTCTime(qemuMonitorPtr mon,
|
|
|
|
|
struct tm *tm)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
2016-07-08 11:52:11 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONGetHotpluggableCPUs(qemuMonitorPtr mon,
|
|
|
|
|
struct qemuMonitorQueryHotpluggableCpusEntry **entries,
|
|
|
|
|
size_t *nentries)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
2016-10-17 12:20:42 +00:00
|
|
|
|
2018-03-20 08:29:30 +00:00
|
|
|
virJSONValuePtr qemuMonitorJSONQueryQMPSchema(qemuMonitorPtr mon)
|
2016-10-17 12:20:42 +00:00
|
|
|
ATTRIBUTE_NONNULL(1);
|
2017-02-23 12:50:24 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONSetBlockThreshold(qemuMonitorPtr mon,
|
|
|
|
|
const char *nodename,
|
|
|
|
|
unsigned long long threshold)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2020-01-21 15:42:49 +00:00
|
|
|
virJSONValuePtr qemuMonitorJSONQueryNamedBlockNodes(qemuMonitorPtr mon,
|
|
|
|
|
bool flat)
|
2017-02-24 13:59:40 +00:00
|
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
|
|
2017-09-01 11:39:15 +00:00
|
|
|
int qemuMonitorJSONSetWatchdogAction(qemuMonitorPtr mon,
|
|
|
|
|
const char *action)
|
|
|
|
|
ATTRIBUTE_NONNULL(1);
|
2018-02-20 17:04:47 +00:00
|
|
|
|
2018-09-03 12:45:16 +00:00
|
|
|
int qemuMonitorJSONBlockdevCreate(qemuMonitorPtr mon,
|
|
|
|
|
const char *jobname,
|
|
|
|
|
virJSONValuePtr props)
|
|
|
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
|
|
2018-02-20 17:04:47 +00:00
|
|
|
int qemuMonitorJSONBlockdevAdd(qemuMonitorPtr mon,
|
2020-02-06 12:13:32 +00:00
|
|
|
virJSONValuePtr *props)
|
2018-02-20 17:04:47 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2020-02-13 08:00:37 +00:00
|
|
|
int qemuMonitorJSONBlockdevReopen(qemuMonitorPtr mon,
|
|
|
|
|
virJSONValuePtr *props)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2018-02-20 17:04:47 +00:00
|
|
|
int qemuMonitorJSONBlockdevDel(qemuMonitorPtr mon,
|
|
|
|
|
const char *nodename)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2018-07-12 10:11:31 +00:00
|
|
|
int qemuMonitorJSONBlockdevTrayOpen(qemuMonitorPtr mon,
|
|
|
|
|
const char *id,
|
|
|
|
|
bool force)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONBlockdevTrayClose(qemuMonitorPtr mon,
|
|
|
|
|
const char *id)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONBlockdevMediumRemove(qemuMonitorPtr mon,
|
|
|
|
|
const char *id)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
|
|
|
|
int qemuMonitorJSONBlockdevMediumInsert(qemuMonitorPtr mon,
|
|
|
|
|
const char *id,
|
|
|
|
|
const char *nodename)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
|
|
|
|
|
2018-07-03 10:07:30 +00:00
|
|
|
int qemuMonitorJSONGetPRManagerInfo(qemuMonitorPtr mon,
|
2020-10-22 17:04:18 +00:00
|
|
|
GHashTable *info)
|
2018-07-03 10:07:30 +00:00
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
|
2019-04-24 21:16:28 +00:00
|
|
|
int
|
|
|
|
|
qemuMonitorJSONGetCurrentMachineInfo(qemuMonitorPtr mon,
|
|
|
|
|
qemuMonitorCurrentMachineInfoPtr info)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
2019-09-26 13:53:39 +00:00
|
|
|
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapAdd(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *name,
|
|
|
|
|
bool persistent,
|
2019-11-28 15:03:16 +00:00
|
|
|
bool disabled,
|
|
|
|
|
unsigned long long granularity);
|
2019-09-26 13:53:39 +00:00
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapRemove(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *name);
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapEnable(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *name);
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapDisable(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *name);
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapMerge(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *target,
|
|
|
|
|
virJSONValuePtr *sources);
|
2019-09-26 14:03:46 +00:00
|
|
|
|
2019-10-07 14:19:34 +00:00
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBitmapMergeSourceAddBitmap(virJSONValuePtr sources,
|
|
|
|
|
const char *sourcenode,
|
|
|
|
|
const char *sourcebitmap);
|
|
|
|
|
|
2019-09-26 14:03:46 +00:00
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionSnapshotLegacy(virJSONValuePtr actions,
|
|
|
|
|
const char *device,
|
|
|
|
|
const char *path,
|
|
|
|
|
const char *format,
|
|
|
|
|
bool existing);
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionSnapshotBlockdev(virJSONValuePtr actions,
|
|
|
|
|
const char *node,
|
|
|
|
|
const char *overlay);
|
2019-09-27 15:28:48 +00:00
|
|
|
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONTransactionBackup(virJSONValuePtr actions,
|
|
|
|
|
const char *device,
|
|
|
|
|
const char *jobname,
|
|
|
|
|
const char *target,
|
|
|
|
|
const char *bitmap,
|
|
|
|
|
qemuMonitorTransactionBackupSyncMode syncmode);
|
2020-02-25 09:55:11 +00:00
|
|
|
|
|
|
|
|
int qemuMonitorJSONSetDBusVMStateIdList(qemuMonitorPtr mon,
|
|
|
|
|
const char *vmstatepath,
|
|
|
|
|
const char **list)
|
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
|
2020-07-15 20:33:07 +00:00
|
|
|
|
|
|
|
|
int
|
|
|
|
|
qemuMonitorJSONGetCPUMigratable(qemuMonitorPtr mon,
|
|
|
|
|
bool *migratable);
|
