qemu_monitor.h 52.2 KB
Newer Older
1 2 3
/*
 * qemu_monitor.h: interaction with QEMU monitor console
 *
4
 * Copyright (C) 2006-2015 Red Hat, Inc.
5 6 7 8 9 10 11 12 13 14 15 16 17
 * 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
18
 * License along with this library.  If not, see
O
Osier Yang 已提交
19
 * <http://www.gnu.org/licenses/>.
20 21
 */

22
#pragma once
23

24
#include "internal.h"
25

26 27 28 29 30 31 32 33 34
#include "domain_conf.h"
#include "virbitmap.h"
#include "virhash.h"
#include "virjson.h"
#include "virnetdev.h"
#include "device_conf.h"
#include "cpu/cpu.h"
#include "util/virgic.h"
#include "virenum.h"
35

36 37
typedef struct _qemuMonitor qemuMonitor;
typedef qemuMonitor *qemuMonitorPtr;
38

39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
typedef struct _qemuMonitorMessage qemuMonitorMessage;
typedef qemuMonitorMessage *qemuMonitorMessagePtr;

typedef int (*qemuMonitorPasswordHandler)(qemuMonitorPtr mon,
                                          qemuMonitorMessagePtr msg,
                                          const char *data,
                                          size_t len,
                                          void *opaque);

struct _qemuMonitorMessage {
    int txFD;

    char *txBuffer;
    int txOffset;
    int txLength;

55
    /* Used by the text monitor reply / error */
56 57
    char *rxBuffer;
    int rxLength;
58 59
    /* Used by the JSON monitor to hold reply / error */
    void *rxObject;
60

61 62 63 64
    /* True if rxBuffer / rxObject are ready, or a
     * fatal error occurred on the monitor channel
     */
    bool finished;
65 66 67 68 69

    qemuMonitorPasswordHandler passwordHandler;
    void *passwordOpaque;
};

70 71 72
typedef enum {
    QEMU_MONITOR_EVENT_PANIC_INFO_TYPE_NONE = 0,
    QEMU_MONITOR_EVENT_PANIC_INFO_TYPE_HYPERV,
73
    QEMU_MONITOR_EVENT_PANIC_INFO_TYPE_S390,
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88

    QEMU_MONITOR_EVENT_PANIC_INFO_TYPE_LAST
} qemuMonitorEventPanicInfoType;

typedef struct _qemuMonitorEventPanicInfoHyperv qemuMonitorEventPanicInfoHyperv;
typedef qemuMonitorEventPanicInfoHyperv *qemuMonitorEventPanicInfoHypervPtr;
struct _qemuMonitorEventPanicInfoHyperv {
    /* Hyper-V specific guest panic information (HV crash MSRs) */
    unsigned long long arg1;
    unsigned long long arg2;
    unsigned long long arg3;
    unsigned long long arg4;
    unsigned long long arg5;
};

89 90 91 92 93 94 95 96 97 98
typedef struct _qemuMonitorEventPanicInfoS390 qemuMonitorEventPanicInfoS390;
typedef qemuMonitorEventPanicInfoS390 *qemuMonitorEventPanicInfoS390Ptr;
struct _qemuMonitorEventPanicInfoS390 {
    /* S390 specific guest panic information */
    int core;
    unsigned long long psw_mask;
    unsigned long long psw_addr;
    char *reason;
};

99 100 101 102 103 104
typedef struct _qemuMonitorEventPanicInfo qemuMonitorEventPanicInfo;
typedef qemuMonitorEventPanicInfo *qemuMonitorEventPanicInfoPtr;
struct _qemuMonitorEventPanicInfo {
    qemuMonitorEventPanicInfoType type;
    union {
        qemuMonitorEventPanicInfoHyperv hyperv;
105
        qemuMonitorEventPanicInfoS390 s390;
106 107 108
    } data;
};

109 110 111 112 113 114 115 116 117 118 119

typedef struct _qemuMonitorRdmaGidStatus qemuMonitorRdmaGidStatus;
typedef qemuMonitorRdmaGidStatus *qemuMonitorRdmaGidStatusPtr;
struct _qemuMonitorRdmaGidStatus {
    char *netdev;
    bool gid_status;
    unsigned long long subnet_prefix;
    unsigned long long interface_id;
};


120
char *qemuMonitorGuestPanicEventInfoFormatMsg(qemuMonitorEventPanicInfoPtr info);
121
void qemuMonitorEventPanicInfoFree(qemuMonitorEventPanicInfoPtr info);
122
void qemuMonitorEventRdmaGidStatusFree(qemuMonitorRdmaGidStatusPtr info);
J
Jiri Denemark 已提交
123 124

typedef void (*qemuMonitorDestroyCallback)(qemuMonitorPtr mon,
125 126
                                           virDomainObjPtr vm,
                                           void *opaque);
J
Jiri Denemark 已提交
127
typedef void (*qemuMonitorEofNotifyCallback)(qemuMonitorPtr mon,
128 129
                                             virDomainObjPtr vm,
                                             void *opaque);
J
Jiri Denemark 已提交
130
typedef void (*qemuMonitorErrorNotifyCallback)(qemuMonitorPtr mon,
131 132
                                               virDomainObjPtr vm,
                                               void *opaque);
133 134 135 136 137 138 139
typedef int (*qemuMonitorDomainEventCallback)(qemuMonitorPtr mon,
                                              virDomainObjPtr vm,
                                              const char *event,
                                              long long seconds,
                                              unsigned int micros,
                                              const char *details,
                                              void *opaque);
J
Jiri Denemark 已提交
140
typedef int (*qemuMonitorDomainShutdownCallback)(qemuMonitorPtr mon,
141
                                                 virDomainObjPtr vm,
142
                                                 virTristateBool guest,
143
                                                 void *opaque);
J
Jiri Denemark 已提交
144
typedef int (*qemuMonitorDomainResetCallback)(qemuMonitorPtr mon,
145 146
                                              virDomainObjPtr vm,
                                              void *opaque);
J
Jiri Denemark 已提交
147
typedef int (*qemuMonitorDomainPowerdownCallback)(qemuMonitorPtr mon,
148 149
                                                  virDomainObjPtr vm,
                                                  void *opaque);
J
Jiri Denemark 已提交
150
typedef int (*qemuMonitorDomainStopCallback)(qemuMonitorPtr mon,
151 152
                                             virDomainObjPtr vm,
                                             void *opaque);
J
Jiri Denemark 已提交
153
typedef int (*qemuMonitorDomainResumeCallback)(qemuMonitorPtr mon,
154 155
                                               virDomainObjPtr vm,
                                               void *opaque);
J
Jiri Denemark 已提交
156 157
typedef int (*qemuMonitorDomainRTCChangeCallback)(qemuMonitorPtr mon,
                                                  virDomainObjPtr vm,
158 159
                                                  long long offset,
                                                  void *opaque);
J
Jiri Denemark 已提交
160 161
typedef int (*qemuMonitorDomainWatchdogCallback)(qemuMonitorPtr mon,
                                                 virDomainObjPtr vm,
162 163
                                                 int action,
                                                 void *opaque);
J
Jiri Denemark 已提交
164 165 166
typedef int (*qemuMonitorDomainIOErrorCallback)(qemuMonitorPtr mon,
                                                virDomainObjPtr vm,
                                                const char *diskAlias,
167
                                                const char *nodename,
J
Jiri Denemark 已提交
168
                                                int action,
169 170
                                                const char *reason,
                                                void *opaque);
J
Jiri Denemark 已提交
171 172 173 174 175 176 177 178 179 180 181
typedef int (*qemuMonitorDomainGraphicsCallback)(qemuMonitorPtr mon,
                                                 virDomainObjPtr vm,
                                                 int phase,
                                                 int localFamily,
                                                 const char *localNode,
                                                 const char *localService,
                                                 int remoteFamily,
                                                 const char *remoteNode,
                                                 const char *remoteService,
                                                 const char *authScheme,
                                                 const char *x509dname,
182 183
                                                 const char *saslUsername,
                                                 void *opaque);
J
Jiri Denemark 已提交
184 185 186 187
typedef int (*qemuMonitorDomainBlockJobCallback)(qemuMonitorPtr mon,
                                                 virDomainObjPtr vm,
                                                 const char *diskAlias,
                                                 int type,
188
                                                 int status,
189
                                                 const char *error,
190
                                                 void *opaque);
J
Jiri Denemark 已提交
191 192 193
typedef int (*qemuMonitorDomainTrayChangeCallback)(qemuMonitorPtr mon,
                                                   virDomainObjPtr vm,
                                                   const char *devAlias,
194
                                                   const char *devid,
195 196
                                                   int reason,
                                                   void *opaque);
J
Jiri Denemark 已提交
197
typedef int (*qemuMonitorDomainPMWakeupCallback)(qemuMonitorPtr mon,
198 199
                                                 virDomainObjPtr vm,
                                                 void *opaque);
J
Jiri Denemark 已提交
200
typedef int (*qemuMonitorDomainPMSuspendCallback)(qemuMonitorPtr mon,
201 202
                                                  virDomainObjPtr vm,
                                                  void *opaque);
J
Jiri Denemark 已提交
203 204
typedef int (*qemuMonitorDomainBalloonChangeCallback)(qemuMonitorPtr mon,
                                                      virDomainObjPtr vm,
205 206
                                                      unsigned long long actual,
                                                      void *opaque);
J
Jiri Denemark 已提交
207
typedef int (*qemuMonitorDomainPMSuspendDiskCallback)(qemuMonitorPtr mon,
208 209
                                                      virDomainObjPtr vm,
                                                      void *opaque);
J
Jiri Denemark 已提交
210
typedef int (*qemuMonitorDomainGuestPanicCallback)(qemuMonitorPtr mon,
211
                                                   virDomainObjPtr vm,
212
                                                   qemuMonitorEventPanicInfoPtr info,
213
                                                   void *opaque);
J
Jiri Denemark 已提交
214 215
typedef int (*qemuMonitorDomainDeviceDeletedCallback)(qemuMonitorPtr mon,
                                                      virDomainObjPtr vm,
216 217
                                                      const char *devAlias,
                                                      void *opaque);
218 219 220 221
typedef int (*qemuMonitorDomainNicRxFilterChangedCallback)(qemuMonitorPtr mon,
                                                           virDomainObjPtr vm,
                                                           const char *devAlias,
                                                           void *opaque);
J
Jiri Denemark 已提交
222

223 224 225 226 227 228
typedef int (*qemuMonitorDomainSerialChangeCallback)(qemuMonitorPtr mon,
                                                     virDomainObjPtr vm,
                                                     const char *devAlias,
                                                     bool connected,
                                                     void *opaque);

229 230 231 232
typedef int (*qemuMonitorDomainSpiceMigratedCallback)(qemuMonitorPtr mon,
                                                      virDomainObjPtr vm,
                                                      void *opaque);

233 234 235 236 237
typedef int (*qemuMonitorDomainMigrationStatusCallback)(qemuMonitorPtr mon,
                                                        virDomainObjPtr vm,
                                                        int status,
                                                        void *opaque);

238 239 240 241 242
typedef int (*qemuMonitorDomainMigrationPassCallback)(qemuMonitorPtr mon,
                                                      virDomainObjPtr vm,
                                                      int pass,
                                                      void *opaque);

243 244 245 246 247 248 249 250 251 252
typedef int (*qemuMonitorDomainAcpiOstInfoCallback)(qemuMonitorPtr mon,
                                                    virDomainObjPtr vm,
                                                    const char *alias,
                                                    const char *slotType,
                                                    const char *slot,
                                                    unsigned int source,
                                                    unsigned int status,
                                                    void *opaque);


253 254 255 256 257 258 259 260
typedef int (*qemuMonitorDomainBlockThresholdCallback)(qemuMonitorPtr mon,
                                                       virDomainObjPtr vm,
                                                       const char *nodename,
                                                       unsigned long long threshold,
                                                       unsigned long long excess,
                                                       void *opaque);


261 262 263 264 265 266 267 268 269
typedef enum {
    QEMU_MONITOR_DUMP_STATUS_NONE,
    QEMU_MONITOR_DUMP_STATUS_ACTIVE,
    QEMU_MONITOR_DUMP_STATUS_COMPLETED,
    QEMU_MONITOR_DUMP_STATUS_FAILED,

    QEMU_MONITOR_DUMP_STATUS_LAST,
} qemuMonitorDumpStatus;

270
VIR_ENUM_DECL(qemuMonitorDumpStatus);
271 272 273 274 275 276 277 278 279

typedef struct _qemuMonitorDumpStats qemuMonitorDumpStats;
typedef qemuMonitorDumpStats *qemuMonitorDumpStatsPtr;
struct _qemuMonitorDumpStats {
    int status; /* qemuMonitorDumpStatus */
    unsigned long long completed; /* bytes written */
    unsigned long long total; /* total bytes to be written */
};

280 281 282 283 284 285 286
typedef int (*qemuMonitorDomainDumpCompletedCallback)(qemuMonitorPtr mon,
                                                      virDomainObjPtr vm,
                                                      int status,
                                                      qemuMonitorDumpStatsPtr stats,
                                                      const char *error,
                                                      void *opaque);

287 288 289 290 291 292
typedef int (*qemuMonitorDomainPRManagerStatusChangedCallback)(qemuMonitorPtr mon,
                                                               virDomainObjPtr vm,
                                                               const char *prManager,
                                                               bool connected,
                                                               void *opaque);

293 294 295 296
typedef int (*qemuMonitorDomainRdmaGidStatusChangedCallback)(qemuMonitorPtr mon,
                                                             virDomainObjPtr vm,
                                                             const char *netdev,
                                                             bool gid_status,
297 298
                                                             unsigned long long subnet_prefix,
                                                             unsigned long long interface_id,
299 300
                                                             void *opaque);

301 302 303
typedef struct _qemuMonitorCallbacks qemuMonitorCallbacks;
typedef qemuMonitorCallbacks *qemuMonitorCallbacksPtr;
struct _qemuMonitorCallbacks {
J
Jiri Denemark 已提交
304 305 306
    qemuMonitorDestroyCallback destroy;
    qemuMonitorEofNotifyCallback eofNotify;
    qemuMonitorErrorNotifyCallback errorNotify;
307
    qemuMonitorDomainEventCallback domainEvent;
J
Jiri Denemark 已提交
308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
    qemuMonitorDomainShutdownCallback domainShutdown;
    qemuMonitorDomainResetCallback domainReset;
    qemuMonitorDomainPowerdownCallback domainPowerdown;
    qemuMonitorDomainStopCallback domainStop;
    qemuMonitorDomainResumeCallback domainResume;
    qemuMonitorDomainRTCChangeCallback domainRTCChange;
    qemuMonitorDomainWatchdogCallback domainWatchdog;
    qemuMonitorDomainIOErrorCallback domainIOError;
    qemuMonitorDomainGraphicsCallback domainGraphics;
    qemuMonitorDomainBlockJobCallback domainBlockJob;
    qemuMonitorDomainTrayChangeCallback domainTrayChange;
    qemuMonitorDomainPMWakeupCallback domainPMWakeup;
    qemuMonitorDomainPMSuspendCallback domainPMSuspend;
    qemuMonitorDomainBalloonChangeCallback domainBalloonChange;
    qemuMonitorDomainPMSuspendDiskCallback domainPMSuspendDisk;
    qemuMonitorDomainGuestPanicCallback domainGuestPanic;
    qemuMonitorDomainDeviceDeletedCallback domainDeviceDeleted;
325
    qemuMonitorDomainNicRxFilterChangedCallback domainNicRxFilterChanged;
326
    qemuMonitorDomainSerialChangeCallback domainSerialChange;
327
    qemuMonitorDomainSpiceMigratedCallback domainSpiceMigrated;
328
    qemuMonitorDomainMigrationStatusCallback domainMigrationStatus;
329
    qemuMonitorDomainMigrationPassCallback domainMigrationPass;
330
    qemuMonitorDomainAcpiOstInfoCallback domainAcpiOstInfo;
331
    qemuMonitorDomainBlockThresholdCallback domainBlockThreshold;
332
    qemuMonitorDomainDumpCompletedCallback domainDumpCompleted;
333
    qemuMonitorDomainPRManagerStatusChangedCallback domainPRManagerStatusChanged;
334
    qemuMonitorDomainRdmaGidStatusChangedCallback domainRdmaGidStatusChanged;
335 336
};

337
char *qemuMonitorEscapeArg(const char *in);
338
char *qemuMonitorUnescapeArg(const char *in);
339

340
qemuMonitorPtr qemuMonitorOpen(virDomainObjPtr vm,
341
                               virDomainChrSourceDefPtr config,
342
                               bool retry,
343
                               unsigned long long timeout,
344 345
                               qemuMonitorCallbacksPtr cb,
                               void *opaque)
J
John Ferlan 已提交
346
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(5);
347 348
qemuMonitorPtr qemuMonitorOpenFD(virDomainObjPtr vm,
                                 int sockfd,
349 350
                                 qemuMonitorCallbacksPtr cb,
                                 void *opaque)
351
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(4);
352

353 354
bool qemuMonitorRegister(qemuMonitorPtr mon)
    ATTRIBUTE_NONNULL(1);
355 356
void qemuMonitorUnregister(qemuMonitorPtr mon)
    ATTRIBUTE_NONNULL(1);
357
void qemuMonitorClose(qemuMonitorPtr mon);
358

359 360
virErrorPtr qemuMonitorLastError(qemuMonitorPtr mon);

361
int qemuMonitorSetCapabilities(qemuMonitorPtr mon);
362

363 364
int qemuMonitorSetLink(qemuMonitorPtr mon,
                       const char *name,
365 366
                       virDomainNetInterfaceLinkState state)
    ATTRIBUTE_NONNULL(2);
367

368
/* These APIs are for use by the internal Text/JSON monitor impl code only */
369
char *qemuMonitorNextCommandID(qemuMonitorPtr mon);
370 371
int qemuMonitorSend(qemuMonitorPtr mon,
                    qemuMonitorMessagePtr msg);
372 373 374 375
virJSONValuePtr qemuMonitorGetOptions(qemuMonitorPtr mon)
    ATTRIBUTE_NONNULL(1);
void qemuMonitorSetOptions(qemuMonitorPtr mon, virJSONValuePtr options)
    ATTRIBUTE_NONNULL(1);
376 377
int qemuMonitorUpdateVideoMemorySize(qemuMonitorPtr mon,
                                     virDomainVideoDefPtr video,
C
Cao jin 已提交
378
                                     const char *videoName)
379
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
380 381 382
int qemuMonitorUpdateVideoVram64Size(qemuMonitorPtr mon,
                                     virDomainVideoDefPtr video,
                                     const char *videoName)
383
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
384 385 386 387
int qemuMonitorHMPCommandWithFd(qemuMonitorPtr mon,
                                const char *cmd,
                                int scm_fd,
                                char **reply);
388
#define qemuMonitorHMPCommand(mon, cmd, reply) \
389
    qemuMonitorHMPCommandWithFd(mon, cmd, -1, reply)
390

391 392 393
int qemuMonitorEmitEvent(qemuMonitorPtr mon, const char *event,
                         long long seconds, unsigned int micros,
                         const char *details);
394
int qemuMonitorEmitShutdown(qemuMonitorPtr mon, virTristateBool guest);
395 396 397
int qemuMonitorEmitReset(qemuMonitorPtr mon);
int qemuMonitorEmitPowerdown(qemuMonitorPtr mon);
int qemuMonitorEmitStop(qemuMonitorPtr mon);
398
int qemuMonitorEmitResume(qemuMonitorPtr mon);
399
int qemuMonitorEmitRTCChange(qemuMonitorPtr mon, long long offset);
400
int qemuMonitorEmitWatchdog(qemuMonitorPtr mon, int action);
401 402
int qemuMonitorEmitIOError(qemuMonitorPtr mon,
                           const char *diskAlias,
403
                           const char *nodename,
404 405
                           int action,
                           const char *reason);
406 407 408 409 410 411 412 413 414 415 416
int qemuMonitorEmitGraphics(qemuMonitorPtr mon,
                            int phase,
                            int localFamily,
                            const char *localNode,
                            const char *localService,
                            int remoteFamily,
                            const char *remoteNode,
                            const char *remoteService,
                            const char *authScheme,
                            const char *x509dname,
                            const char *saslUsername);
417 418
int qemuMonitorEmitTrayChange(qemuMonitorPtr mon,
                              const char *devAlias,
419
                              const char *devid,
420
                              int reason);
O
Osier Yang 已提交
421
int qemuMonitorEmitPMWakeup(qemuMonitorPtr mon);
O
Osier Yang 已提交
422
int qemuMonitorEmitPMSuspend(qemuMonitorPtr mon);
423 424 425
int qemuMonitorEmitBlockJob(qemuMonitorPtr mon,
                            const char *diskAlias,
                            int type,
426 427
                            int status,
                            const char *error);
428 429
int qemuMonitorEmitBalloonChange(qemuMonitorPtr mon,
                                 unsigned long long actual);
430
int qemuMonitorEmitPMSuspendDisk(qemuMonitorPtr mon);
431 432
int qemuMonitorEmitGuestPanic(qemuMonitorPtr mon,
                              qemuMonitorEventPanicInfoPtr info);
433 434
int qemuMonitorEmitDeviceDeleted(qemuMonitorPtr mon,
                                 const char *devAlias);
435 436
int qemuMonitorEmitNicRxFilterChanged(qemuMonitorPtr mon,
                                      const char *devAlias);
437 438 439
int qemuMonitorEmitSerialChange(qemuMonitorPtr mon,
                                const char *devAlias,
                                bool connected);
440
int qemuMonitorEmitSpiceMigrated(qemuMonitorPtr mon);
441 442
int qemuMonitorEmitMigrationStatus(qemuMonitorPtr mon,
                                   int status);
443 444
int qemuMonitorEmitMigrationPass(qemuMonitorPtr mon,
                                 int pass);
445

446 447 448 449 450 451 452
int qemuMonitorEmitAcpiOstInfo(qemuMonitorPtr mon,
                               const char *alias,
                               const char *slotType,
                               const char *slot,
                               unsigned int source,
                               unsigned int status);

453 454 455 456 457
int qemuMonitorEmitBlockThreshold(qemuMonitorPtr mon,
                                  const char *nodename,
                                  unsigned long long threshold,
                                  unsigned long long excess);

458 459 460 461 462
int qemuMonitorEmitDumpCompleted(qemuMonitorPtr mon,
                                 int status,
                                 qemuMonitorDumpStatsPtr stats,
                                 const char *error);

463 464 465 466
int qemuMonitorEmitPRManagerStatusChanged(qemuMonitorPtr mon,
                                          const char *prManager,
                                          bool connected);

467 468 469 470 471
int qemuMonitorEmitRdmaGidStatusChanged(qemuMonitorPtr mon,
                                        const char *netdev,
                                        bool gid_status,
                                        unsigned long long subnet_prefix,
                                        unsigned long long interface_id);
472

473
int qemuMonitorStartCPUs(qemuMonitorPtr mon);
474
int qemuMonitorStopCPUs(qemuMonitorPtr mon);
475 476 477 478 479 480 481 482 483 484 485 486 487 488 489

typedef enum {
    QEMU_MONITOR_VM_STATUS_DEBUG,
    QEMU_MONITOR_VM_STATUS_INMIGRATE,
    QEMU_MONITOR_VM_STATUS_INTERNAL_ERROR,
    QEMU_MONITOR_VM_STATUS_IO_ERROR,
    QEMU_MONITOR_VM_STATUS_PAUSED,
    QEMU_MONITOR_VM_STATUS_POSTMIGRATE,
    QEMU_MONITOR_VM_STATUS_PRELAUNCH,
    QEMU_MONITOR_VM_STATUS_FINISH_MIGRATE,
    QEMU_MONITOR_VM_STATUS_RESTORE_VM,
    QEMU_MONITOR_VM_STATUS_RUNNING,
    QEMU_MONITOR_VM_STATUS_SAVE_VM,
    QEMU_MONITOR_VM_STATUS_SHUTDOWN,
    QEMU_MONITOR_VM_STATUS_WATCHDOG,
490
    QEMU_MONITOR_VM_STATUS_GUEST_PANICKED,
491 492 493

    QEMU_MONITOR_VM_STATUS_LAST
} qemuMonitorVMStatus;
494
VIR_ENUM_DECL(qemuMonitorVMStatus);
495 496
int qemuMonitorVMStatusToPausedReason(const char *status);

497
int qemuMonitorCheck(qemuMonitorPtr mon);
498 499
int qemuMonitorGetStatus(qemuMonitorPtr mon,
                         bool *running,
500 501
                         virDomainPausedReason *reason)
    ATTRIBUTE_NONNULL(2);
502

503
int qemuMonitorSystemReset(qemuMonitorPtr mon);
504 505
int qemuMonitorSystemPowerdown(qemuMonitorPtr mon);

506
struct qemuMonitorQueryCpusEntry {
507
    int qemu_id; /* id of the cpu as reported by qemu */
508
    pid_t tid;
509
    char *qom_path;
510
    bool halted;
511 512 513 514
};
void qemuMonitorQueryCpusFree(struct qemuMonitorQueryCpusEntry *entries,
                              size_t nentries);

515

516 517 518 519 520 521 522 523 524 525 526
struct qemuMonitorQueryHotpluggableCpusEntry {
    char *type; /* name of the cpu to use with device_add */
    unsigned int vcpus; /* count of virtual cpus in the guest this entry adds */
    char *qom_path; /* full device qom path only present for online cpus */
    char *alias; /* device alias, may be NULL for non-hotpluggable entities */

    /* topology information -1 if qemu didn't report given parameter */
    int node_id;
    int socket_id;
    int core_id;
    int thread_id;
527 528 529

    /* internal data */
    int enable_id;
530 531 532 533 534
};
void qemuMonitorQueryHotpluggableCpusFree(struct qemuMonitorQueryHotpluggableCpusEntry *entries,
                                          size_t nentries);


535 536
struct _qemuMonitorCPUInfo {
    pid_t tid;
537
    int id; /* order of enabling of the given cpu */
538
    int qemu_id; /* identifier of the cpu as reported by query-cpus */
539

540 541 542 543
    /* state data */
    bool online;
    bool hotpluggable;

544 545 546 547 548
    /* topology info for hotplug purposes. Hotplug of given vcpu impossible if
     * all entries are -1 */
    int socket_id;
    int core_id;
    int thread_id;
549
    int node_id;
550 551 552 553 554 555 556 557 558 559
    unsigned int vcpus; /* number of vcpus added if given entry is hotplugged */

    /* name of the qemu type to add in case of hotplug */
    char *type;

    /* alias of an hotpluggable entry. Entries with alias can be hot-unplugged */
    char *alias;

    /* internal for use in the matching code */
    char *qom_path;
560 561

    bool halted;
562 563 564 565 566 567
};
typedef struct _qemuMonitorCPUInfo qemuMonitorCPUInfo;
typedef qemuMonitorCPUInfo *qemuMonitorCPUInfoPtr;

void qemuMonitorCPUInfoFree(qemuMonitorCPUInfoPtr list,
                            size_t nitems);
568
int qemuMonitorGetCPUInfo(qemuMonitorPtr mon,
569
                          qemuMonitorCPUInfoPtr *vcpus,
570
                          size_t maxvcpus,
571 572 573 574 575
                          bool hotplug,
                          bool fast);
virBitmapPtr qemuMonitorGetCpuHalted(qemuMonitorPtr mon,
                                     size_t maxvcpus,
                                     bool fast);
576

577
int qemuMonitorGetVirtType(qemuMonitorPtr mon,
578
                           virDomainVirtType *virtType);
579
int qemuMonitorGetBalloonInfo(qemuMonitorPtr mon,
580
                              unsigned long long *currmem);
581
int qemuMonitorGetMemoryStats(qemuMonitorPtr mon,
582
                              virDomainMemballoonDefPtr balloon,
583 584
                              virDomainMemoryStatPtr stats,
                              unsigned int nr_stats);
585
int qemuMonitorSetMemoryStatsPeriod(qemuMonitorPtr mon,
586
                                    virDomainMemballoonDefPtr balloon,
587
                                    int period);
588

589
int qemuMonitorBlockIOStatusToError(const char *status);
590 591
virHashTablePtr qemuMonitorGetBlockInfo(qemuMonitorPtr mon);

592
virJSONValuePtr qemuMonitorQueryBlockstats(qemuMonitorPtr mon);
593

594 595 596 597 598 599 600 601 602 603 604
typedef struct _qemuBlockStats qemuBlockStats;
typedef qemuBlockStats *qemuBlockStatsPtr;
struct _qemuBlockStats {
    long long rd_req;
    long long rd_bytes;
    long long wr_req;
    long long wr_bytes;
    long long rd_total_times;
    long long wr_total_times;
    long long flush_req;
    long long flush_total_times;
605 606
    unsigned long long capacity;
    unsigned long long physical;
607 608 609

    /* value of wr_highest_offset is valid if it's non 0 or
     * if wr_highest_offset_valid is true */
610
    unsigned long long wr_highest_offset;
611
    bool wr_highest_offset_valid;
612 613 614

    /* write_threshold is valid only if it's non-zero, conforming to qemu semantics */
    unsigned long long write_threshold;
615 616 617
};

int qemuMonitorGetAllBlockStatsInfo(qemuMonitorPtr mon,
618 619
                                    virHashTablePtr *ret_stats,
                                    bool backingChain)
620
    ATTRIBUTE_NONNULL(2);
621

622
int qemuMonitorBlockStatsUpdateCapacity(qemuMonitorPtr mon,
623 624
                                        virHashTablePtr stats,
                                        bool backingChain)
625
    ATTRIBUTE_NONNULL(2);
626

627 628 629 630
int qemuMonitorBlockStatsUpdateCapacityBlockdev(qemuMonitorPtr mon,
                                                virHashTablePtr stats)
    ATTRIBUTE_NONNULL(2);

631
int qemuMonitorBlockResize(qemuMonitorPtr mon,
632 633
                           const char *device,
                           const char *nodename,
634
                           unsigned long long size);
635 636 637 638 639 640 641
int qemuMonitorSetPassword(qemuMonitorPtr mon,
                           int type,
                           const char *password,
                           const char *action_if_connected);
int qemuMonitorExpirePassword(qemuMonitorPtr mon,
                              int type,
                              const char *expire_time);
642
int qemuMonitorSetBalloon(qemuMonitorPtr mon,
643
                          unsigned long long newmem);
644
int qemuMonitorSetCPU(qemuMonitorPtr mon, int cpu, bool online);
645

E
Eric Blake 已提交
646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664
int qemuMonitorAddBitmap(qemuMonitorPtr mon,
                         const char *node,
                         const char *bitmap,
                         bool persistent)
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
int qemuMonitorEnableBitmap(qemuMonitorPtr mon,
                            const char *node,
                            const char *bitmap)
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
int qemuMonitorMergeBitmaps(qemuMonitorPtr mon,
                            const char *node,
                            const char *dst,
                            virJSONValuePtr *src)
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
int qemuMonitorDeleteBitmap(qemuMonitorPtr mon,
                            const char *node,
                            const char *bitmap)
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);

665 666

/* XXX should we pass the virDomainDiskDefPtr instead
667
 * and hide dev_name details inside monitor. Reconsider
668 669 670
 * this when doing the QMP implementation
 */
int qemuMonitorEjectMedia(qemuMonitorPtr mon,
671
                          const char *dev_name,
672
                          bool force);
673
int qemuMonitorChangeMedia(qemuMonitorPtr mon,
674
                           const char *dev_name,
675 676
                           const char *newmedia,
                           const char *format);
677 678 679 680 681 682 683 684 685 686 687 688 689 690


int qemuMonitorSaveVirtualMemory(qemuMonitorPtr mon,
                                 unsigned long long offset,
                                 size_t length,
                                 const char *path);
int qemuMonitorSavePhysicalMemory(qemuMonitorPtr mon,
                                  unsigned long long offset,
                                  size_t length,
                                  const char *path);

int qemuMonitorSetMigrationSpeed(qemuMonitorPtr mon,
                                 unsigned long bandwidth);

691 692 693
int qemuMonitorSetMigrationDowntime(qemuMonitorPtr mon,
                                    unsigned long long downtime);

694 695 696 697 698
int qemuMonitorGetMigrationCacheSize(qemuMonitorPtr mon,
                                     unsigned long long *cacheSize);
int qemuMonitorSetMigrationCacheSize(qemuMonitorPtr mon,
                                     unsigned long long cacheSize);

699
int qemuMonitorGetMigrationParams(qemuMonitorPtr mon,
700
                                  virJSONValuePtr *params);
701
int qemuMonitorSetMigrationParams(qemuMonitorPtr mon,
702
                                  virJSONValuePtr params);
703

704
typedef enum {
705
    QEMU_MONITOR_MIGRATION_STATUS_INACTIVE,
706
    QEMU_MONITOR_MIGRATION_STATUS_SETUP,
707
    QEMU_MONITOR_MIGRATION_STATUS_ACTIVE,
708 709
    QEMU_MONITOR_MIGRATION_STATUS_PRE_SWITCHOVER,
    QEMU_MONITOR_MIGRATION_STATUS_DEVICE,
710
    QEMU_MONITOR_MIGRATION_STATUS_POSTCOPY,
711 712
    QEMU_MONITOR_MIGRATION_STATUS_COMPLETED,
    QEMU_MONITOR_MIGRATION_STATUS_ERROR,
713
    QEMU_MONITOR_MIGRATION_STATUS_CANCELLING,
714 715 716
    QEMU_MONITOR_MIGRATION_STATUS_CANCELLED,

    QEMU_MONITOR_MIGRATION_STATUS_LAST
717
} qemuMonitorMigrationStatus;
718

719
VIR_ENUM_DECL(qemuMonitorMigrationStatus);
720

721 722 723
typedef struct _qemuMonitorMigrationStats qemuMonitorMigrationStats;
typedef qemuMonitorMigrationStats *qemuMonitorMigrationStatsPtr;
struct _qemuMonitorMigrationStats {
724
    int status; /* qemuMonitorMigrationStatus */
725 726 727 728
    unsigned long long total_time;
    /* total or expected depending on status */
    bool downtime_set;
    unsigned long long downtime;
729 730 731 732 733 734 735
    /*
     * Duration of the QEMU 'setup' state.
     * for RDMA, this may be on the order of several seconds
     * if pinning support is requested before the migration begins.
     */
    bool setup_time_set;
    unsigned long long setup_time;
736 737 738 739

    unsigned long long ram_transferred;
    unsigned long long ram_remaining;
    unsigned long long ram_total;
740
    unsigned long long ram_bps;
741 742 743 744
    bool ram_duplicate_set;
    unsigned long long ram_duplicate;
    unsigned long long ram_normal;
    unsigned long long ram_normal_bytes;
745
    unsigned long long ram_dirty_rate;
746
    unsigned long long ram_page_size;
747
    unsigned long long ram_iteration;
748
    unsigned long long ram_postcopy_reqs;
749 750 751 752

    unsigned long long disk_transferred;
    unsigned long long disk_remaining;
    unsigned long long disk_total;
753
    unsigned long long disk_bps;
754 755 756 757 758 759 760

    bool xbzrle_set;
    unsigned long long xbzrle_cache_size;
    unsigned long long xbzrle_bytes;
    unsigned long long xbzrle_pages;
    unsigned long long xbzrle_cache_miss;
    unsigned long long xbzrle_overflow;
761 762

    int cpu_throttle_percentage;
763 764
};

765
int qemuMonitorGetMigrationStats(qemuMonitorPtr mon,
766 767
                                 qemuMonitorMigrationStatsPtr stats,
                                 char **error);
768

769 770
int qemuMonitorGetMigrationCapabilities(qemuMonitorPtr mon,
                                        char ***capabilities);
771
int qemuMonitorSetMigrationCapabilities(qemuMonitorPtr mon,
772
                                        virJSONValuePtr caps);
773

A
Andrea Bolognani 已提交
774 775 776
int qemuMonitorGetGICCapabilities(qemuMonitorPtr mon,
                                  virGICCapability **capabilities);

777 778 779
int qemuMonitorGetSEVCapabilities(qemuMonitorPtr mon,
                                  virSEVCapability **capabilities);

780
typedef enum {
781
  QEMU_MONITOR_MIGRATE_BACKGROUND       = 1 << 0,
782 783 784 785 786
  QEMU_MONITOR_MIGRATE_NON_SHARED_DISK  = 1 << 1, /* migration with non-shared storage with full disk copy */
  QEMU_MONITOR_MIGRATE_NON_SHARED_INC   = 1 << 2, /* migration with non-shared storage with incremental copy */
  QEMU_MONITOR_MIGRATION_FLAGS_LAST
} QEMU_MONITOR_MIGRATE;

E
Eric Blake 已提交
787 788 789 790
int qemuMonitorMigrateToFd(qemuMonitorPtr mon,
                           unsigned int flags,
                           int fd);

791
int qemuMonitorMigrateToHost(qemuMonitorPtr mon,
792
                             unsigned int flags,
793
                             const char *protocol,
794 795 796 797 798
                             const char *hostname,
                             int port);

int qemuMonitorMigrateCancel(qemuMonitorPtr mon);

799 800 801
int qemuMonitorGetDumpGuestMemoryCapability(qemuMonitorPtr mon,
                                            const char *capability);

802 803 804
int qemuMonitorQueryDump(qemuMonitorPtr mon,
                         qemuMonitorDumpStatsPtr stats);

805
int qemuMonitorDumpToFd(qemuMonitorPtr mon,
806
                        int fd,
807 808
                        const char *dumpformat,
                        bool detach);
809

810 811 812 813 814 815
int qemuMonitorGraphicsRelocate(qemuMonitorPtr mon,
                                int type,
                                const char *hostname,
                                int port,
                                int tlsPort,
                                const char *tlsSubject);
816 817 818 819

int qemuMonitorSendFileHandle(qemuMonitorPtr mon,
                              const char *fdname,
                              int fd);
820
int qemuMonitorAddFd(qemuMonitorPtr mon, int fdset, int fd, const char *name);
821

822 823
/* These two functions preserve previous error and only set their own
 * error if no error was set before.
824
 */
825 826
int qemuMonitorCloseFileHandle(qemuMonitorPtr mon,
                               const char *fdname);
827
int qemuMonitorRemoveFd(qemuMonitorPtr mon, int fdset, int fd);
828

829
int qemuMonitorAddNetdev(qemuMonitorPtr mon,
830
                         const char *netdevstr,
831 832
                         int *tapfd, char **tapfdName, int tapfdSize,
                         int *vhostfd, char **vhostfdName, int vhostfdSize);
833 834 835 836

int qemuMonitorRemoveNetdev(qemuMonitorPtr mon,
                            const char *alias);

837 838 839
int qemuMonitorQueryRxFilter(qemuMonitorPtr mon, const char *alias,
                             virNetDevRxFilterPtr *filter);

840 841 842 843 844 845
typedef struct _qemuMonitorChardevInfo qemuMonitorChardevInfo;
typedef qemuMonitorChardevInfo *qemuMonitorChardevInfoPtr;
struct _qemuMonitorChardevInfo {
    char *ptyPath;
    virDomainChrDeviceState state;
};
846
void qemuMonitorChardevInfoFree(void *data, const void *name);
847 848
int qemuMonitorGetChardevInfo(qemuMonitorPtr mon,
                              virHashTablePtr *retinfo);
849

850 851
int qemuMonitorAttachPCIDiskController(qemuMonitorPtr mon,
                                       const char *bus,
852
                                       virPCIDeviceAddress *guestAddr);
853

854 855
int qemuMonitorAddDeviceArgs(qemuMonitorPtr mon,
                             virJSONValuePtr args);
856 857 858
int qemuMonitorAddDevice(qemuMonitorPtr mon,
                         const char *devicestr);

859 860 861 862 863
int qemuMonitorAddDeviceWithFd(qemuMonitorPtr mon,
                               const char *devicestr,
                               int fd,
                               const char *fdname);

864
int qemuMonitorDelDevice(qemuMonitorPtr mon,
865
                         const char *devalias);
866

867 868 869 870 871 872 873 874 875 876 877
virJSONValuePtr qemuMonitorCreateObjectPropsWrap(const char *type,
                                                 const char *alias,
                                                 virJSONValuePtr *props);

int qemuMonitorCreateObjectProps(virJSONValuePtr *propsret,
                                 const char *type,
                                 const char *alias,
                                 ...);

int qemuMonitorAddObject(qemuMonitorPtr mon,
                         virJSONValuePtr *props,
878
                         char **alias)
879
    ATTRIBUTE_NONNULL(2);
880

881 882 883
int qemuMonitorDelObject(qemuMonitorPtr mon,
                         const char *objalias);

884 885 886
int qemuMonitorAddDrive(qemuMonitorPtr mon,
                        const char *drivestr);

887
int qemuMonitorDriveDel(qemuMonitorPtr mon,
888 889
                        const char *drivestr);

C
Chris Lalancette 已提交
890 891 892 893
int qemuMonitorCreateSnapshot(qemuMonitorPtr mon, const char *name);
int qemuMonitorLoadSnapshot(qemuMonitorPtr mon, const char *name);
int qemuMonitorDeleteSnapshot(qemuMonitorPtr mon, const char *name);

894
int qemuMonitorTransaction(qemuMonitorPtr mon, virJSONValuePtr *actions)
895
    ATTRIBUTE_NONNULL(2);
896 897 898 899
int qemuMonitorDriveMirror(qemuMonitorPtr mon,
                           const char *device,
                           const char *file,
                           const char *format,
900
                           unsigned long long bandwidth,
901 902
                           unsigned int granularity,
                           unsigned long long buf_size,
903 904
                           bool shallow,
                           bool reuse)
905
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
906 907
int qemuMonitorBlockdevMirror(qemuMonitorPtr mon,
                              const char *jobname,
908
                              bool persistjob,
909 910 911 912 913
                              const char *device,
                              const char *target,
                              unsigned long long bandwidth,
                              unsigned int granularity,
                              unsigned long long buf_size,
914
                              bool shallow)
915
    ATTRIBUTE_NONNULL(4) ATTRIBUTE_NONNULL(5);
916
int qemuMonitorDrivePivot(qemuMonitorPtr mon,
917
                          const char *jobname)
918
    ATTRIBUTE_NONNULL(2);
919

920 921
int qemuMonitorBlockCommit(qemuMonitorPtr mon,
                           const char *device,
922 923
                           const char *jobname,
                           bool persistjob,
924
                           const char *top,
925
                           const char *topNode,
926
                           const char *base,
927
                           const char *baseNode,
928
                           const char *backingName,
929
                           unsigned long long bandwidth)
930
    ATTRIBUTE_NONNULL(2);
931
bool qemuMonitorSupportsActiveCommit(qemuMonitorPtr mon);
932 933 934 935
char *qemuMonitorDiskNameLookup(qemuMonitorPtr mon,
                                const char *device,
                                virStorageSourcePtr top,
                                virStorageSourcePtr target)
936
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
937

938 939 940 941
int qemuMonitorArbitraryCommand(qemuMonitorPtr mon,
                                const char *cmd,
                                char **reply,
                                bool hmp);
942

943 944
int qemuMonitorInjectNMI(qemuMonitorPtr mon);

945
int qemuMonitorScreendump(qemuMonitorPtr mon,
946 947
                          const char *device,
                          unsigned int head,
948 949
                          const char *file);

950 951 952 953 954
int qemuMonitorSendKey(qemuMonitorPtr mon,
                       unsigned int holdtime,
                       unsigned int *keycodes,
                       unsigned int nkeycodes);

955 956
int qemuMonitorBlockStream(qemuMonitorPtr mon,
                           const char *device,
957 958
                           const char *jobname,
                           bool persistjob,
959
                           const char *base,
960
                           const char *baseNode,
961
                           const char *backingName,
962
                           unsigned long long bandwidth)
963
    ATTRIBUTE_NONNULL(2);
964

965
int qemuMonitorBlockJobCancel(qemuMonitorPtr mon,
966
                              const char *jobname)
967
    ATTRIBUTE_NONNULL(2);
968

969
int qemuMonitorBlockJobSetSpeed(qemuMonitorPtr mon,
970
                                const char *jobname,
971
                                unsigned long long bandwidth);
972

973 974 975 976 977 978 979
typedef struct _qemuMonitorBlockJobInfo qemuMonitorBlockJobInfo;
typedef qemuMonitorBlockJobInfo *qemuMonitorBlockJobInfoPtr;
struct _qemuMonitorBlockJobInfo {
    int type; /* virDomainBlockJobType */
    unsigned long long bandwidth; /* in bytes/s */
    virDomainBlockJobCursor cur;
    virDomainBlockJobCursor end;
980
    int ready; /* -1 if unknown, 0 if not ready, 1 if ready */
981 982
};

983 984
virHashTablePtr qemuMonitorGetAllBlockJobInfo(qemuMonitorPtr mon,
                                              bool rawjobname);
985 986 987
int qemuMonitorGetBlockJobInfo(qemuMonitorPtr mon,
                               const char *device,
                               qemuMonitorBlockJobInfoPtr info)
988
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3);
989

990 991 992 993 994 995
int qemuMonitorOpenGraphics(qemuMonitorPtr mon,
                            const char *protocol,
                            int fd,
                            const char *fdname,
                            bool skipauth);

996
int qemuMonitorSetBlockIoThrottle(qemuMonitorPtr mon,
997 998
                                  const char *drivealias,
                                  const char *qomid,
999
                                  virDomainBlockIoTuneInfoPtr info,
1000
                                  bool supportMaxOptions,
1001
                                  bool supportGroupNameOption,
1002
                                  bool supportMaxLengthOptions);
1003 1004

int qemuMonitorGetBlockIoThrottle(qemuMonitorPtr mon,
1005 1006
                                  const char *drivealias,
                                  const char *qdevid,
1007
                                  virDomainBlockIoTuneInfoPtr reply);
1008

1009 1010
int qemuMonitorSystemWakeup(qemuMonitorPtr mon);

1011 1012 1013 1014 1015 1016 1017
int qemuMonitorGetVersion(qemuMonitorPtr mon,
                          int *major,
                          int *minor,
                          int *micro,
                          char **package)
    ATTRIBUTE_NONNULL(2) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);

1018 1019 1020 1021 1022 1023 1024 1025

typedef struct _qemuMonitorMachineInfo qemuMonitorMachineInfo;
typedef qemuMonitorMachineInfo *qemuMonitorMachineInfoPtr;

struct _qemuMonitorMachineInfo {
    char *name;
    bool isDefault;
    char *alias;
1026
    unsigned int maxCpus;
1027
    bool hotplugCpus;
1028 1029 1030 1031 1032 1033 1034
};

int qemuMonitorGetMachines(qemuMonitorPtr mon,
                           qemuMonitorMachineInfoPtr **machines);

void qemuMonitorMachineInfoFree(qemuMonitorMachineInfoPtr machine);

1035 1036 1037 1038
typedef struct _qemuMonitorCPUDefInfo qemuMonitorCPUDefInfo;
typedef qemuMonitorCPUDefInfo *qemuMonitorCPUDefInfoPtr;

struct _qemuMonitorCPUDefInfo {
1039
    virTristateBool usable;
1040
    char *name;
1041
    char **blockers; /* NULL-terminated string list */
1042 1043
};

1044
int qemuMonitorGetCPUDefinitions(qemuMonitorPtr mon,
1045 1046
                                 qemuMonitorCPUDefInfoPtr **cpus);
void qemuMonitorCPUDefInfoFree(qemuMonitorCPUDefInfoPtr cpu);
1047

1048 1049 1050 1051 1052 1053 1054 1055
typedef enum {
    QEMU_MONITOR_CPU_PROPERTY_BOOLEAN,
    QEMU_MONITOR_CPU_PROPERTY_STRING,
    QEMU_MONITOR_CPU_PROPERTY_NUMBER,

    QEMU_MONITOR_CPU_PROPERTY_LAST
} qemuMonitorCPUPropertyType;

1056
VIR_ENUM_DECL(qemuMonitorCPUProperty);
1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067

typedef struct _qemuMonitorCPUProperty qemuMonitorCPUProperty;
typedef qemuMonitorCPUProperty *qemuMonitorCPUPropertyPtr;
struct _qemuMonitorCPUProperty {
    char *name;
    qemuMonitorCPUPropertyType type;
    union {
        bool boolean;
        char *string;
        long long number;
    } value;
1068
    virTristateBool migratable;
1069 1070
};

1071 1072 1073 1074 1075 1076
typedef struct _qemuMonitorCPUModelInfo qemuMonitorCPUModelInfo;
typedef qemuMonitorCPUModelInfo *qemuMonitorCPUModelInfoPtr;

struct _qemuMonitorCPUModelInfo {
    char *name;
    size_t nprops;
1077
    qemuMonitorCPUPropertyPtr props;
1078
    bool migratability;
1079 1080
};

1081 1082
typedef enum {
    QEMU_MONITOR_CPU_MODEL_EXPANSION_STATIC,
1083 1084
    QEMU_MONITOR_CPU_MODEL_EXPANSION_STATIC_FULL,
    QEMU_MONITOR_CPU_MODEL_EXPANSION_FULL,
1085 1086
} qemuMonitorCPUModelExpansionType;

1087
int qemuMonitorGetCPUModelExpansion(qemuMonitorPtr mon,
1088
                                    qemuMonitorCPUModelExpansionType type,
1089
                                    const char *model_name,
1090
                                    bool migratable,
1091 1092 1093 1094 1095 1096 1097
                                    qemuMonitorCPUModelInfoPtr *model_info);

void qemuMonitorCPUModelInfoFree(qemuMonitorCPUModelInfoPtr model_info);

qemuMonitorCPUModelInfoPtr
qemuMonitorCPUModelInfoCopy(const qemuMonitorCPUModelInfo *orig);

1098 1099
int qemuMonitorGetCommands(qemuMonitorPtr mon,
                           char ***commands);
1100 1101
int qemuMonitorGetEvents(qemuMonitorPtr mon,
                         char ***events);
1102 1103
int qemuMonitorGetCommandLineOptionParameters(qemuMonitorPtr mon,
                                              const char *option,
1104 1105
                                              char ***params,
                                              bool *found);
1106

1107 1108 1109 1110
int qemuMonitorGetKVMState(qemuMonitorPtr mon,
                           bool *enabled,
                           bool *present);

1111 1112
int qemuMonitorGetObjectTypes(qemuMonitorPtr mon,
                              char ***types);
1113 1114
int qemuMonitorGetDeviceProps(qemuMonitorPtr mon,
                              const char *device,
1115
                              char ***props);
1116 1117 1118
int qemuMonitorGetObjectProps(qemuMonitorPtr mon,
                              const char *object,
                              char ***props);
1119
char *qemuMonitorGetTargetArch(qemuMonitorPtr mon);
1120

1121
int qemuMonitorNBDServerStart(qemuMonitorPtr mon,
1122 1123 1124
                              const virStorageNetHostDef *server,
                              const char *tls_alias)
    ATTRIBUTE_NONNULL(2);
1125 1126
int qemuMonitorNBDServerAdd(qemuMonitorPtr mon,
                            const char *deviceID,
1127 1128 1129
                            const char *export,
                            bool writable,
                            const char *bitmap);
1130
int qemuMonitorNBDServerStop(qemuMonitorPtr);
S
Stefan Berger 已提交
1131 1132 1133 1134 1135 1136
int qemuMonitorGetTPMModels(qemuMonitorPtr mon,
                            char ***tpmmodels);

int qemuMonitorGetTPMTypes(qemuMonitorPtr mon,
                           char ***tpmtypes);

1137 1138 1139
int qemuMonitorAttachCharDev(qemuMonitorPtr mon,
                             const char *chrID,
                             virDomainChrSourceDefPtr chr);
1140 1141
int qemuMonitorDetachCharDev(qemuMonitorPtr mon,
                             const char *chrID);
1142 1143 1144 1145

int qemuMonitorGetDeviceAliases(qemuMonitorPtr mon,
                                char ***aliases);

1146 1147 1148
typedef void (*qemuMonitorReportDomainLogError)(qemuMonitorPtr mon,
                                                const char *msg,
                                                void *opaque);
1149 1150 1151 1152
void qemuMonitorSetDomainLogLocked(qemuMonitorPtr mon,
                                   qemuMonitorReportDomainLogError func,
                                   void *opaque,
                                   virFreeCallback destroy);
1153 1154 1155 1156
void qemuMonitorSetDomainLog(qemuMonitorPtr mon,
                             qemuMonitorReportDomainLogError func,
                             void *opaque,
                             virFreeCallback destroy);
1157

1158 1159 1160
int qemuMonitorGetGuestCPUx86(qemuMonitorPtr mon,
                              virCPUDataPtr *data,
                              virCPUDataPtr *disabled);
1161

1162 1163 1164 1165 1166 1167 1168 1169 1170 1171
typedef const char *(*qemuMonitorCPUFeatureTranslationCallback)(const char *name,
                                                                void *opaque);

int qemuMonitorGetGuestCPU(qemuMonitorPtr mon,
                           virArch arch,
                           qemuMonitorCPUFeatureTranslationCallback translate,
                           void *opaque,
                           virCPUDataPtr *enabled,
                           virCPUDataPtr *disabled);

1172 1173
int qemuMonitorRTCResetReinjection(qemuMonitorPtr mon);

1174 1175
typedef struct _qemuMonitorIOThreadInfo qemuMonitorIOThreadInfo;
typedef qemuMonitorIOThreadInfo *qemuMonitorIOThreadInfoPtr;
1176

1177
struct _qemuMonitorIOThreadInfo {
1178
    unsigned int iothread_id;
1179
    int thread_id;
1180 1181 1182 1183
    bool poll_valid;
    unsigned long long poll_max_ns;
    unsigned int poll_grow;
    unsigned int poll_shrink;
1184 1185 1186
    bool set_poll_max_ns;
    bool set_poll_grow;
    bool set_poll_shrink;
1187 1188
};
int qemuMonitorGetIOThreads(qemuMonitorPtr mon,
1189
                            qemuMonitorIOThreadInfoPtr **iothreads);
1190 1191
int qemuMonitorSetIOThread(qemuMonitorPtr mon,
                           qemuMonitorIOThreadInfoPtr iothreadInfo);
1192

1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206
typedef struct _qemuMonitorMemoryDeviceInfo qemuMonitorMemoryDeviceInfo;
typedef qemuMonitorMemoryDeviceInfo *qemuMonitorMemoryDeviceInfoPtr;

struct _qemuMonitorMemoryDeviceInfo {
    unsigned long long address;
    unsigned int slot;
    bool hotplugged;
    bool hotpluggable;
};

int qemuMonitorGetMemoryDeviceInfo(qemuMonitorPtr mon,
                                   virHashTablePtr *info)
    ATTRIBUTE_NONNULL(2);

1207 1208 1209
int qemuMonitorMigrateIncoming(qemuMonitorPtr mon,
                               const char *uri);

1210 1211
int qemuMonitorMigrateStartPostCopy(qemuMonitorPtr mon);

1212 1213 1214
int qemuMonitorMigrateContinue(qemuMonitorPtr mon,
                               qemuMonitorMigrationStatus status);

1215 1216 1217
int qemuMonitorGetRTCTime(qemuMonitorPtr mon,
                          struct tm *tm);

1218
virJSONValuePtr qemuMonitorQueryQMPSchema(qemuMonitorPtr mon);
1219

1220 1221 1222 1223
int qemuMonitorSetBlockThreshold(qemuMonitorPtr mon,
                                 const char *nodename,
                                 unsigned long long threshold);

1224
virJSONValuePtr qemuMonitorQueryNamedBlockNodes(qemuMonitorPtr mon);
1225

M
Michal Privoznik 已提交
1226 1227
int qemuMonitorSetWatchdogAction(qemuMonitorPtr mon,
                                 const char *action);
1228 1229 1230 1231 1232 1233 1234

int qemuMonitorBlockdevAdd(qemuMonitorPtr mon,
                           virJSONValuePtr props);

int qemuMonitorBlockdevDel(qemuMonitorPtr mon,
                           const char *nodename);

1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248
int qemuMonitorBlockdevTrayOpen(qemuMonitorPtr mon,
                                const char *id,
                                bool force);

int qemuMonitorBlockdevTrayClose(qemuMonitorPtr mon,
                                 const char *id);

int qemuMonitorBlockdevMediumRemove(qemuMonitorPtr mon,
                                    const char *id);

int qemuMonitorBlockdevMediumInsert(qemuMonitorPtr mon,
                                    const char *id,
                                    const char *nodename);

1249 1250 1251
char *
qemuMonitorGetSEVMeasurement(qemuMonitorPtr mon);

1252 1253 1254 1255 1256 1257 1258 1259 1260
typedef struct _qemuMonitorPRManagerInfo qemuMonitorPRManagerInfo;
typedef qemuMonitorPRManagerInfo *qemuMonitorPRManagerInfoPtr;
struct _qemuMonitorPRManagerInfo {
    bool connected;
};

int qemuMonitorGetPRManagerInfo(qemuMonitorPtr mon,
                                virHashTablePtr *retinfo);

1261 1262 1263 1264 1265 1266 1267 1268
typedef struct  _qemuMonitorCurrentMachineInfo qemuMonitorCurrentMachineInfo;
typedef qemuMonitorCurrentMachineInfo *qemuMonitorCurrentMachineInfoPtr;
struct _qemuMonitorCurrentMachineInfo {
    bool wakeupSuspendSupport;
};

int qemuMonitorGetCurrentMachineInfo(qemuMonitorPtr mon,
                                     qemuMonitorCurrentMachineInfoPtr info);