domain_conf.h 100.4 KB
Newer Older
1 2 3
/*
 * domain_conf.h: domain XML processing
 *
4
 * Copyright (C) 2006-2016 Red Hat, Inc.
5
 * Copyright (C) 2006-2008 Daniel P. Berrange
6
 * Copyright (c) 2015 SUSE LINUX Products GmbH, Nuernberg, Germany.
7 8 9 10 11 12 13 14 15 16 17 18
 *
 * 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
19
 * License along with this library.  If not, see
O
Osier Yang 已提交
20
 * <http://www.gnu.org/licenses/>.
21 22 23 24 25
 *
 * Author: Daniel P. Berrange <berrange@redhat.com>
 */

#ifndef __DOMAIN_CONF_H
26
# define __DOMAIN_CONF_H
27

28 29 30
# include <libxml/parser.h>
# include <libxml/tree.h>
# include <libxml/xpath.h>
31

32 33
# include "internal.h"
# include "capabilities.h"
34
# include "virstorageencryption.h"
35
# include "cpu_conf.h"
36
# include "virthread.h"
37
# include "virhash.h"
38
# include "virsocketaddr.h"
39
# include "networkcommon_conf.h"
40
# include "nwfilter_params.h"
41
# include "numa_conf.h"
42
# include "virnetdevmacvlan.h"
43
# include "virsysinfo.h"
44
# include "virnetdevip.h"
45 46
# include "virnetdevvportprofile.h"
# include "virnetdevbandwidth.h"
47
# include "virnetdevvlan.h"
48
# include "virobject.h"
49
# include "device_conf.h"
50
# include "virbitmap.h"
51
# include "virstoragefile.h"
52
# include "virseclabel.h"
53
# include "virprocess.h"
54
# include "virgic.h"
Q
Qiaowei Ren 已提交
55
# include "virperf.h"
56
# include "virtypedparam.h"
57

58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
/* forward declarations of all device types, required by
 * virDomainDeviceDef
 */
typedef struct _virDomainDiskDef virDomainDiskDef;
typedef virDomainDiskDef *virDomainDiskDefPtr;

typedef struct _virDomainControllerDef virDomainControllerDef;
typedef virDomainControllerDef *virDomainControllerDefPtr;

typedef struct _virDomainLeaseDef virDomainLeaseDef;
typedef virDomainLeaseDef *virDomainLeaseDefPtr;

typedef struct _virDomainFSDef virDomainFSDef;
typedef virDomainFSDef *virDomainFSDefPtr;

typedef struct _virDomainNetDef virDomainNetDef;
typedef virDomainNetDef *virDomainNetDefPtr;

typedef struct _virDomainInputDef virDomainInputDef;
typedef virDomainInputDef *virDomainInputDefPtr;

79 80 81
typedef struct _virDomainSoundCodecDef virDomainSoundCodecDef;
typedef virDomainSoundCodecDef *virDomainSoundCodecDefPtr;

82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
typedef struct _virDomainSoundDef virDomainSoundDef;
typedef virDomainSoundDef *virDomainSoundDefPtr;

typedef struct _virDomainVideoDef virDomainVideoDef;
typedef virDomainVideoDef *virDomainVideoDefPtr;

typedef struct _virDomainHostdevDef virDomainHostdevDef;
typedef virDomainHostdevDef *virDomainHostdevDefPtr;

typedef struct _virDomainWatchdogDef virDomainWatchdogDef;
typedef virDomainWatchdogDef *virDomainWatchdogDefPtr;

typedef struct _virDomainGraphicsDef virDomainGraphicsDef;
typedef virDomainGraphicsDef *virDomainGraphicsDefPtr;

typedef struct _virDomainHubDef virDomainHubDef;
typedef virDomainHubDef *virDomainHubDefPtr;

typedef struct _virDomainRedirdevDef virDomainRedirdevDef;
typedef virDomainRedirdevDef *virDomainRedirdevDefPtr;

103 104
typedef struct _virDomainRedirFilterUSBDevDef virDomainRedirFilterUSBDevDef;
typedef virDomainRedirFilterUSBDevDef *virDomainRedirFilterUSBDevDefPtr;
105 106 107 108

typedef struct _virDomainRedirFilterDef virDomainRedirFilterDef;
typedef virDomainRedirFilterDef *virDomainRedirFilterDefPtr;

109 110 111 112 113 114 115 116 117
typedef struct _virDomainSmartcardDef virDomainSmartcardDef;
typedef virDomainSmartcardDef *virDomainSmartcardDefPtr;

typedef struct _virDomainChrDef virDomainChrDef;
typedef virDomainChrDef *virDomainChrDefPtr;

typedef struct _virDomainMemballoonDef virDomainMemballoonDef;
typedef virDomainMemballoonDef *virDomainMemballoonDefPtr;

L
Li Zhang 已提交
118 119 120
typedef struct _virDomainNVRAMDef virDomainNVRAMDef;
typedef virDomainNVRAMDef *virDomainNVRAMDefPtr;

121 122 123 124 125 126
typedef struct _virDomainSnapshotObj virDomainSnapshotObj;
typedef virDomainSnapshotObj *virDomainSnapshotObjPtr;

typedef struct _virDomainSnapshotObjList virDomainSnapshotObjList;
typedef virDomainSnapshotObjList *virDomainSnapshotObjListPtr;

127 128 129
typedef struct _virDomainRNGDef virDomainRNGDef;
typedef virDomainRNGDef *virDomainRNGDefPtr;

130 131 132 133 134 135
typedef struct _virDomainIdMapEntry virDomainIdMapEntry;
typedef virDomainIdMapEntry *virDomainIdMapEntryPtr;

typedef struct _virDomainIdMapDef virDomainIdMapDef;
typedef virDomainIdMapDef *virDomainIdMapDefPtr;

H
Hu Tao 已提交
136 137 138
typedef struct _virDomainPanicDef virDomainPanicDef;
typedef virDomainPanicDef *virDomainPanicDefPtr;

139 140 141
typedef struct _virDomainMemoryDef virDomainMemoryDef;
typedef virDomainMemoryDef *virDomainMemoryDefPtr;

M
Michele Paolino 已提交
142 143 144 145 146 147
/* forward declarations virDomainChrSourceDef, required by
 * virDomainNetDef
 */
typedef struct _virDomainChrSourceDef virDomainChrSourceDef;
typedef virDomainChrSourceDef *virDomainChrSourceDefPtr;

148 149 150
typedef struct _virDomainShmemDef virDomainShmemDef;
typedef virDomainShmemDef *virDomainShmemDefPtr;

151 152 153
typedef struct _virDomainTPMDef virDomainTPMDef;
typedef virDomainTPMDef *virDomainTPMDefPtr;

154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172
/* Flags for the 'type' field in virDomainDeviceDef */
typedef enum {
    VIR_DOMAIN_DEVICE_NONE = 0,
    VIR_DOMAIN_DEVICE_DISK,
    VIR_DOMAIN_DEVICE_LEASE,
    VIR_DOMAIN_DEVICE_FS,
    VIR_DOMAIN_DEVICE_NET,
    VIR_DOMAIN_DEVICE_INPUT,
    VIR_DOMAIN_DEVICE_SOUND,
    VIR_DOMAIN_DEVICE_VIDEO,
    VIR_DOMAIN_DEVICE_HOSTDEV,
    VIR_DOMAIN_DEVICE_WATCHDOG,
    VIR_DOMAIN_DEVICE_CONTROLLER,
    VIR_DOMAIN_DEVICE_GRAPHICS,
    VIR_DOMAIN_DEVICE_HUB,
    VIR_DOMAIN_DEVICE_REDIRDEV,
    VIR_DOMAIN_DEVICE_SMARTCARD,
    VIR_DOMAIN_DEVICE_CHR,
    VIR_DOMAIN_DEVICE_MEMBALLOON,
L
Li Zhang 已提交
173
    VIR_DOMAIN_DEVICE_NVRAM,
174
    VIR_DOMAIN_DEVICE_RNG,
175
    VIR_DOMAIN_DEVICE_SHMEM,
176
    VIR_DOMAIN_DEVICE_TPM,
177
    VIR_DOMAIN_DEVICE_PANIC,
178
    VIR_DOMAIN_DEVICE_MEMORY,
179

180
    VIR_DOMAIN_DEVICE_LAST
181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203
} virDomainDeviceType;

typedef struct _virDomainDeviceDef virDomainDeviceDef;
typedef virDomainDeviceDef *virDomainDeviceDefPtr;
struct _virDomainDeviceDef {
    int type; /* enum virDomainDeviceType */
    union {
        virDomainDiskDefPtr disk;
        virDomainControllerDefPtr controller;
        virDomainLeaseDefPtr lease;
        virDomainFSDefPtr fs;
        virDomainNetDefPtr net;
        virDomainInputDefPtr input;
        virDomainSoundDefPtr sound;
        virDomainVideoDefPtr video;
        virDomainHostdevDefPtr hostdev;
        virDomainWatchdogDefPtr watchdog;
        virDomainGraphicsDefPtr graphics;
        virDomainHubDefPtr hub;
        virDomainRedirdevDefPtr redirdev;
        virDomainSmartcardDefPtr smartcard;
        virDomainChrDefPtr chr;
        virDomainMemballoonDefPtr memballoon;
L
Li Zhang 已提交
204
        virDomainNVRAMDefPtr nvram;
205
        virDomainRNGDefPtr rng;
206
        virDomainShmemDefPtr shmem;
207
        virDomainTPMDefPtr tpm;
208
        virDomainPanicDefPtr panic;
209
        virDomainMemoryDefPtr memory;
210 211 212
    } data;
};

213 214
/* Different types of hypervisor */
/* NB: Keep in sync with virDomainVirtTypeToString impl */
215
typedef enum {
216
    VIR_DOMAIN_VIRT_NONE = 0,
217 218 219 220 221 222 223 224 225 226
    VIR_DOMAIN_VIRT_QEMU,
    VIR_DOMAIN_VIRT_KQEMU,
    VIR_DOMAIN_VIRT_KVM,
    VIR_DOMAIN_VIRT_XEN,
    VIR_DOMAIN_VIRT_LXC,
    VIR_DOMAIN_VIRT_UML,
    VIR_DOMAIN_VIRT_OPENVZ,
    VIR_DOMAIN_VIRT_TEST,
    VIR_DOMAIN_VIRT_VMWARE,
    VIR_DOMAIN_VIRT_HYPERV,
227
    VIR_DOMAIN_VIRT_VBOX,
228
    VIR_DOMAIN_VIRT_PHYP,
D
Dmitry Guryanov 已提交
229
    VIR_DOMAIN_VIRT_PARALLELS,
R
Roman Bogorodskiy 已提交
230
    VIR_DOMAIN_VIRT_BHYVE,
231
    VIR_DOMAIN_VIRT_VZ,
232

233
    VIR_DOMAIN_VIRT_LAST
234
} virDomainVirtType;
235

236 237 238 239 240 241 242 243 244 245 246 247
typedef enum {
    VIR_DOMAIN_OSTYPE_HVM,
    VIR_DOMAIN_OSTYPE_XEN,
    VIR_DOMAIN_OSTYPE_LINUX,
    VIR_DOMAIN_OSTYPE_EXE,
    VIR_DOMAIN_OSTYPE_UML,

    VIR_DOMAIN_OSTYPE_LAST
} virDomainOSType;
VIR_ENUM_DECL(virDomainOS)


248 249 250 251 252 253 254 255
typedef struct _virDomainHostdevOrigStates virDomainHostdevOrigStates;
typedef virDomainHostdevOrigStates *virDomainHostdevOrigStatesPtr;
struct _virDomainHostdevOrigStates {
    union {
        struct {
            /* Does the device need to unbind from stub when
             * reattaching to host?
             */
256
            bool unbind_from_stub;
257 258 259 260

            /* Does it need to use remove_slot when reattaching
             * the device to host?
             */
261
            bool remove_slot;
262 263 264 265

            /* Does it need to reprobe driver for the device when
             * reattaching to host?
             */
266
            bool reprobe;
267 268 269 270 271 272
        } pci;

        /* Perhaps 'usb' in future */
    } states;
};

273 274 275 276 277 278 279
struct _virDomainLeaseDef {
    char *lockspace;
    char *key;
    char *path;
    unsigned long long offset;
};

280

281
typedef enum {
282 283 284
    VIR_DOMAIN_HOSTDEV_MODE_SUBSYS,
    VIR_DOMAIN_HOSTDEV_MODE_CAPABILITIES,

285
    VIR_DOMAIN_HOSTDEV_MODE_LAST
286
} virDomainHostdevMode;
287

288
typedef enum {
289 290
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_USB,
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_PCI,
H
Han Cheng 已提交
291
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_SCSI,
292 293

    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_LAST
294
} virDomainHostdevSubsysType;
295

296 297
/* the backend driver used for PCI hostdev devices */
typedef enum {
298
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_DEFAULT, /* detect automaticaly, prefer VFIO */
299 300
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_KVM,    /* force legacy kvm style */
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_VFIO,   /* force vfio */
301
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_XEN,    /* force legacy xen style, use pciback */
302 303

    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_TYPE_LAST
304
} virDomainHostdevSubsysPCIBackendType;
305

306
VIR_ENUM_DECL(virDomainHostdevSubsysPCIBackend)
307

308 309 310 311 312 313 314 315 316
typedef enum {
    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_NONE,
    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_ISCSI,

    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_LAST,
} virDomainHostdevSCSIProtocolType;

VIR_ENUM_DECL(virDomainHostdevSubsysSCSIProtocol)

317 318 319 320 321 322 323 324 325 326 327 328
typedef struct _virDomainHostdevSubsysUSB virDomainHostdevSubsysUSB;
typedef virDomainHostdevSubsysUSB *virDomainHostdevSubsysUSBPtr;
struct _virDomainHostdevSubsysUSB {
    bool autoAddress; /* bus/device were filled automatically based
                         on vendor/product */
    unsigned bus;
    unsigned device;

    unsigned vendor;
    unsigned product;
};

329 330 331
typedef struct _virDomainHostdevSubsysPCI virDomainHostdevSubsysPCI;
typedef virDomainHostdevSubsysPCI *virDomainHostdevSubsysPCIPtr;
struct _virDomainHostdevSubsysPCI {
332
    virPCIDeviceAddress addr; /* host address */
333 334 335
    int backend; /* enum virDomainHostdevSubsysPCIBackendType */
};

336 337 338
typedef struct _virDomainHostdevSubsysSCSIHost virDomainHostdevSubsysSCSIHost;
typedef virDomainHostdevSubsysSCSIHost *virDomainHostdevSubsysSCSIHostPtr;
struct _virDomainHostdevSubsysSCSIHost {
339 340 341
    char *adapter;
    unsigned bus;
    unsigned target;
342
    unsigned long long unit;
343 344
};

345 346 347 348 349 350 351 352 353
typedef struct _virDomainHostdevSubsysSCSIiSCSI virDomainHostdevSubsysSCSIiSCSI;
typedef virDomainHostdevSubsysSCSIiSCSI *virDomainHostdevSubsysSCSIiSCSIPtr;
struct _virDomainHostdevSubsysSCSIiSCSI {
    char *path;
    size_t nhosts;
    virStorageNetHostDefPtr hosts;
    virStorageAuthDefPtr auth;
};

354 355 356
typedef struct _virDomainHostdevSubsysSCSI virDomainHostdevSubsysSCSI;
typedef virDomainHostdevSubsysSCSI *virDomainHostdevSubsysSCSIPtr;
struct _virDomainHostdevSubsysSCSI {
357
    int protocol; /* enum virDomainHostdevSCSIProtocolType */
358
    int sgio; /* enum virDomainDeviceSGIO */
359
    int rawio; /* enum virTristateBool */
360 361
    union {
        virDomainHostdevSubsysSCSIHost host;
362
        virDomainHostdevSubsysSCSIiSCSI iscsi;
363
    } u;
364 365
};

366 367 368
typedef struct _virDomainHostdevSubsys virDomainHostdevSubsys;
typedef virDomainHostdevSubsys *virDomainHostdevSubsysPtr;
struct _virDomainHostdevSubsys {
369
    int type; /* enum virDomainHostdevSubsysType */
370
    union {
371
        virDomainHostdevSubsysUSB usb;
372
        virDomainHostdevSubsysPCI pci;
373
        virDomainHostdevSubsysSCSI scsi;
374 375 376
    } u;
};

377

378
typedef enum {
379 380
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_STORAGE,
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_MISC,
381
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_NET,
382 383

    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_LAST
384
} virDomainHostdevCapsType;
385 386 387 388 389 390 391 392 393 394 395 396

typedef struct _virDomainHostdevCaps virDomainHostdevCaps;
typedef virDomainHostdevCaps *virDomainHostdevCapsPtr;
struct _virDomainHostdevCaps {
    int type; /* enum virDOmainHostdevCapsType */
    union {
        struct {
            char *block;
        } storage;
        struct {
            char *chardev;
        } misc;
397
        struct {
398 399
            char *ifname;
            virNetDevIPInfo ip;
400
        } net;
401 402 403 404
    } u;
};


405 406
/* basic device for direct passthrough */
struct _virDomainHostdevDef {
407
    virDomainDeviceDef parent; /* higher level Def containing this */
408 409
    virObjectPtr privateData;

410
    int mode; /* enum virDomainHostdevMode */
411
    int startupPolicy; /* enum virDomainStartupPolicy */
412
    bool managed;
413
    bool missing;
O
Osier Yang 已提交
414
    bool readonly;
415
    bool shareable;
416
    union {
417
        virDomainHostdevSubsys subsys;
418
        virDomainHostdevCaps caps;
419 420
    } source;
    virDomainHostdevOrigStates origstates;
421
    virDomainDeviceInfoPtr info; /* Guest address */
422 423
};

424

E
Eric Blake 已提交
425 426
/* Types of disk frontend (guest view).  For backends (host view), see
 * virStorageType in util/virstoragefile.h */
427
typedef enum {
428 429 430
    VIR_DOMAIN_DISK_DEVICE_DISK,
    VIR_DOMAIN_DISK_DEVICE_CDROM,
    VIR_DOMAIN_DISK_DEVICE_FLOPPY,
431
    VIR_DOMAIN_DISK_DEVICE_LUN,
432 433

    VIR_DOMAIN_DISK_DEVICE_LAST
434
} virDomainDiskDevice;
435

436
typedef enum {
437 438 439 440 441
    VIR_DOMAIN_DISK_BUS_IDE,
    VIR_DOMAIN_DISK_BUS_FDC,
    VIR_DOMAIN_DISK_BUS_SCSI,
    VIR_DOMAIN_DISK_BUS_VIRTIO,
    VIR_DOMAIN_DISK_BUS_XEN,
442
    VIR_DOMAIN_DISK_BUS_USB,
443
    VIR_DOMAIN_DISK_BUS_UML,
444
    VIR_DOMAIN_DISK_BUS_SATA,
445
    VIR_DOMAIN_DISK_BUS_SD,
446 447

    VIR_DOMAIN_DISK_BUS_LAST
448
} virDomainDiskBus;
449

450
typedef enum {
451 452 453 454
    VIR_DOMAIN_DISK_CACHE_DEFAULT,
    VIR_DOMAIN_DISK_CACHE_DISABLE,
    VIR_DOMAIN_DISK_CACHE_WRITETHRU,
    VIR_DOMAIN_DISK_CACHE_WRITEBACK,
455
    VIR_DOMAIN_DISK_CACHE_DIRECTSYNC,
456
    VIR_DOMAIN_DISK_CACHE_UNSAFE,
457 458

    VIR_DOMAIN_DISK_CACHE_LAST
459
} virDomainDiskCache;
460

461
typedef enum {
462 463
    VIR_DOMAIN_DISK_ERROR_POLICY_DEFAULT,
    VIR_DOMAIN_DISK_ERROR_POLICY_STOP,
464
    VIR_DOMAIN_DISK_ERROR_POLICY_REPORT,
465
    VIR_DOMAIN_DISK_ERROR_POLICY_IGNORE,
466
    VIR_DOMAIN_DISK_ERROR_POLICY_ENOSPACE,
467 468

    VIR_DOMAIN_DISK_ERROR_POLICY_LAST
469
} virDomainDiskErrorPolicy;
470

M
MORITA Kazutaka 已提交
471

472
typedef enum {
473
    VIR_DOMAIN_DISK_TRAY_CLOSED = 0,
474 475 476
    VIR_DOMAIN_DISK_TRAY_OPEN,

    VIR_DOMAIN_DISK_TRAY_LAST
477
} virDomainDiskTray;
478

479
typedef enum {
J
J.B. Joret 已提交
480 481 482 483 484 485
    VIR_DOMAIN_DISK_TRANS_DEFAULT = 0,
    VIR_DOMAIN_DISK_TRANS_NONE,
    VIR_DOMAIN_DISK_TRANS_AUTO,
    VIR_DOMAIN_DISK_TRANS_LBA,

    VIR_DOMAIN_DISK_TRANS_LAST
486
} virDomainDiskGeometryTrans;
J
J.B. Joret 已提交
487

488
typedef enum {
489
    VIR_DOMAIN_DISK_IO_DEFAULT = 0,
M
Matthias Dahl 已提交
490 491 492 493
    VIR_DOMAIN_DISK_IO_NATIVE,
    VIR_DOMAIN_DISK_IO_THREADS,

    VIR_DOMAIN_DISK_IO_LAST
494
} virDomainDiskIo;
M
Matthias Dahl 已提交
495

496
typedef enum {
497 498 499 500 501 502
    VIR_DOMAIN_STARTUP_POLICY_DEFAULT = 0,
    VIR_DOMAIN_STARTUP_POLICY_MANDATORY,
    VIR_DOMAIN_STARTUP_POLICY_REQUISITE,
    VIR_DOMAIN_STARTUP_POLICY_OPTIONAL,

    VIR_DOMAIN_STARTUP_POLICY_LAST
503
} virDomainStartupPolicy;
504

505

506
typedef enum {
507 508 509
    VIR_DOMAIN_DEVICE_SGIO_DEFAULT = 0,
    VIR_DOMAIN_DEVICE_SGIO_FILTERED,
    VIR_DOMAIN_DEVICE_SGIO_UNFILTERED,
O
Osier Yang 已提交
510

511
    VIR_DOMAIN_DEVICE_SGIO_LAST
512
} virDomainDeviceSGIO;
O
Osier Yang 已提交
513

514
typedef enum {
O
Osier Yang 已提交
515
    VIR_DOMAIN_DISK_DISCARD_DEFAULT = 0,
O
Osier Yang 已提交
516 517
    VIR_DOMAIN_DISK_DISCARD_UNMAP,
    VIR_DOMAIN_DISK_DISCARD_IGNORE,
O
Osier Yang 已提交
518 519

    VIR_DOMAIN_DISK_DISCARD_LAST
520
} virDomainDiskDiscard;
O
Osier Yang 已提交
521

522 523 524 525 526 527 528 529 530
typedef enum {
    VIR_DOMAIN_DISK_DETECT_ZEROES_DEFAULT = 0,
    VIR_DOMAIN_DISK_DETECT_ZEROES_OFF,
    VIR_DOMAIN_DISK_DETECT_ZEROES_ON,
    VIR_DOMAIN_DISK_DETECT_ZEROES_UNMAP,

    VIR_DOMAIN_DISK_DETECT_ZEROES_LAST
} virDomainDiskDetectZeroes;

L
Lei Li 已提交
531 532 533 534 535 536 537 538
typedef struct _virDomainBlockIoTuneInfo virDomainBlockIoTuneInfo;
struct _virDomainBlockIoTuneInfo {
    unsigned long long total_bytes_sec;
    unsigned long long read_bytes_sec;
    unsigned long long write_bytes_sec;
    unsigned long long total_iops_sec;
    unsigned long long read_iops_sec;
    unsigned long long write_iops_sec;
539 540 541 542 543 544 545
    unsigned long long total_bytes_sec_max;
    unsigned long long read_bytes_sec_max;
    unsigned long long write_bytes_sec_max;
    unsigned long long total_iops_sec_max;
    unsigned long long read_iops_sec_max;
    unsigned long long write_iops_sec_max;
    unsigned long long size_iops_sec;
L
Lei Li 已提交
546 547 548
};
typedef virDomainBlockIoTuneInfo *virDomainBlockIoTuneInfoPtr;

549

550 551 552 553 554 555 556 557 558 559
typedef enum {
    VIR_DOMAIN_DISK_MIRROR_STATE_NONE = 0, /* No job, or job still not synced */
    VIR_DOMAIN_DISK_MIRROR_STATE_READY, /* Job in second phase */
    VIR_DOMAIN_DISK_MIRROR_STATE_ABORT, /* Job aborted, waiting for event */
    VIR_DOMAIN_DISK_MIRROR_STATE_PIVOT, /* Job pivoted, waiting for event */

    VIR_DOMAIN_DISK_MIRROR_STATE_LAST
} virDomainDiskMirrorState;


560 561
/* Stores the virtual disk configuration */
struct _virDomainDiskDef {
562
    virStorageSourcePtr src; /* non-NULL.  XXX Allow NULL for empty cdrom? */
563

564 565
    virObjectPtr privateData;

566 567 568 569
    int device; /* enum virDomainDiskDevice */
    int bus; /* enum virDomainDiskBus */
    char *dst;
    int tray_status; /* enum virDomainDiskTray */
J
Ján Tomko 已提交
570
    int removable; /* enum virTristateSwitch */
L
Lei Li 已提交
571

572
    virStorageSourcePtr mirror;
573
    int mirrorState; /* enum virDomainDiskMirrorState */
E
Eric Blake 已提交
574
    int mirrorJob; /* virDomainBlockJobType */
575

J
J.B. Joret 已提交
576 577 578 579
    struct {
        unsigned int cylinders;
        unsigned int heads;
        unsigned int sectors;
580
        int trans; /* enum virDomainDiskGeometryTrans */
J
J.B. Joret 已提交
581 582
    } geometry;

583 584 585
    struct {
        unsigned int logical_block_size;
        unsigned int physical_block_size;
V
Viktor Mihajlovski 已提交
586
    } blockio;
587

L
Lei Li 已提交
588 589
    virDomainBlockIoTuneInfo blkdeviotune;

590
    char *serial;
O
Osier Yang 已提交
591
    char *wwn;
592 593
    char *vendor;
    char *product;
594
    int cachemode; /* enum virDomainDiskCache */
595 596
    int error_policy;  /* enum virDomainDiskErrorPolicy */
    int rerror_policy; /* enum virDomainDiskErrorPolicy */
597
    int iomode; /* enum virDomainDiskIo */
J
Ján Tomko 已提交
598 599 600
    int ioeventfd; /* enum virTristateSwitch */
    int event_idx; /* enum virTristateSwitch */
    int copy_on_read; /* enum virTristateSwitch */
601
    int snapshot; /* virDomainSnapshotLocation, snapshot_conf.h */
602
    int startupPolicy; /* enum virDomainStartupPolicy */
603
    bool transient;
604
    virDomainDeviceInfo info;
605
    int rawio; /* enum virTristateBool */
606
    int sgio; /* enum virDomainDeviceSGIO */
O
Osier Yang 已提交
607
    int discard; /* enum virDomainDiskDiscard */
608
    unsigned int iothread; /* unused = 0, > 0 specific thread # */
609
    int detect_zeroes; /* enum virDomainDiskDetectZeroes */
610
    char *domain_name; /* backend domain name */
611 612 613
};


614
typedef enum {
615 616 617 618
    VIR_DOMAIN_CONTROLLER_TYPE_IDE,
    VIR_DOMAIN_CONTROLLER_TYPE_FDC,
    VIR_DOMAIN_CONTROLLER_TYPE_SCSI,
    VIR_DOMAIN_CONTROLLER_TYPE_SATA,
619
    VIR_DOMAIN_CONTROLLER_TYPE_VIRTIO_SERIAL,
E
Eric Blake 已提交
620
    VIR_DOMAIN_CONTROLLER_TYPE_CCID,
621
    VIR_DOMAIN_CONTROLLER_TYPE_USB,
J
Ján Tomko 已提交
622
    VIR_DOMAIN_CONTROLLER_TYPE_PCI,
623 624

    VIR_DOMAIN_CONTROLLER_TYPE_LAST
625
} virDomainControllerType;
626

627

628
typedef enum {
J
Ján Tomko 已提交
629
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_ROOT,
L
Laine Stump 已提交
630
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_ROOT,
J
Ján Tomko 已提交
631
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_BRIDGE,
632
    VIR_DOMAIN_CONTROLLER_MODEL_DMI_TO_PCI_BRIDGE,
633
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_ROOT_PORT,
634
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_SWITCH_UPSTREAM_PORT,
635
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_SWITCH_DOWNSTREAM_PORT,
636
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_EXPANDER_BUS,
637
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_EXPANDER_BUS,
J
Ján Tomko 已提交
638 639

    VIR_DOMAIN_CONTROLLER_MODEL_PCI_LAST
640
} virDomainControllerModelPCI;
J
Ján Tomko 已提交
641

642 643 644 645
typedef enum {
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_NONE,
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_PCI_BRIDGE,
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_I82801B11_BRIDGE,
646
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_IOH3420,
647
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_X3130_UPSTREAM,
648
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_XIO3130_DOWNSTREAM,
649
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_PXB,
650
    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_PXB_PCIE,
651 652 653 654

    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_LAST
} virDomainControllerPCIModelName;

655
typedef enum {
656 657 658 659 660
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_AUTO,
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_BUSLOGIC,
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LSILOGIC,
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LSISAS1068,
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_VMPVSCSI,
661
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_IBMVSCSI,
662
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_VIRTIO_SCSI,
663
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LSISAS1078,
664

665
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LAST
666
} virDomainControllerModelSCSI;
667

668
typedef enum {
M
Marc-André Lureau 已提交
669 670 671 672 673 674 675 676 677
    VIR_DOMAIN_CONTROLLER_MODEL_USB_PIIX3_UHCI,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_PIIX4_UHCI,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_EHCI,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_EHCI1,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI1,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI2,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI3,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_VT82C686B_UHCI,
    VIR_DOMAIN_CONTROLLER_MODEL_USB_PCI_OHCI,
G
Gerd Hoffmann 已提交
678
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NEC_XHCI,
679
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NONE,
M
Marc-André Lureau 已提交
680 681

    VIR_DOMAIN_CONTROLLER_MODEL_USB_LAST
682
} virDomainControllerModelUSB;
M
Marc-André Lureau 已提交
683

684 685 686 687 688 689 690
# define IS_USB2_CONTROLLER(ctrl) \
    (((ctrl)->type == VIR_DOMAIN_CONTROLLER_TYPE_USB) && \
     ((ctrl)->model == VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_EHCI1 || \
      (ctrl)->model == VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI1 || \
      (ctrl)->model == VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI2 || \
      (ctrl)->model == VIR_DOMAIN_CONTROLLER_MODEL_USB_ICH9_UHCI3))

691 692 693 694 695 696 697
typedef struct _virDomainVirtioSerialOpts virDomainVirtioSerialOpts;
typedef virDomainVirtioSerialOpts *virDomainVirtioSerialOptsPtr;
struct _virDomainVirtioSerialOpts {
    int ports;   /* -1 == undef */
    int vectors; /* -1 == undef */
};

698 699 700
typedef struct _virDomainPCIControllerOpts virDomainPCIControllerOpts;
typedef virDomainPCIControllerOpts *virDomainPCIControllerOptsPtr;
struct _virDomainPCIControllerOpts {
701 702
    bool pcihole64;
    unsigned long pcihole64size;
703 704 705 706 707 708 709

    /* the exact controller name is in the "model" subelement, e.g.:
     * <controller type='pci' model='pcie-root-port'>
     *   <model name='ioh3420''/>
     *   ...
     */
    int modelName; /* the exact name of the device in hypervisor */
710 711 712 713 714 715 716 717

    /* the following items are attributes of the "target" subelement
     * of controller type='pci'. They are bits of configuration that
     * are specified on the qemu commandline and are visible to the
     * guest OS, so they must be preserved to ensure ABI
     * compatibility.
     */
    int chassisNr; /* used by pci-bridge, -1 == unspecified */
718 719 720 721
    /* chassis & port used by
     * pcie-root-port/pcie-switch-downstream-port, -1 = unspecified */
    int chassis;
    int port;
722 723 724 725 726
    int busNr; /* used by pci-expander-bus, -1 == unspecified */
    /* numaNode is a *subelement* of target (to match existing
     * item in memory target config) -1 == unspecified
     */
    int numaNode;
727
};
728

729 730 731 732 733 734
typedef struct _virDomainUSBControllerOpts virDomainUSBControllerOpts;
typedef virDomainUSBControllerOpts *virDomainUSBControllerOptsPtr;
struct _virDomainUSBControllerOpts {
    int ports;   /* -1 == undef */
};

735 736 737
/* Stores the virtual disk controller configuration */
struct _virDomainControllerDef {
    int type;
738
    int idx;
739
    int model; /* -1 == undef */
740
    unsigned int queues;
741 742
    unsigned int cmd_per_lun;
    unsigned int max_sectors;
743
    int ioeventfd; /* enum virTristateSwitch */
744
    unsigned int iothread; /* unused = 0, > 0 specific thread # */
745 746
    union {
        virDomainVirtioSerialOpts vioserial;
747
        virDomainPCIControllerOpts pciopts;
748
        virDomainUSBControllerOpts usbopts;
749
    } opts;
750 751 752 753
    virDomainDeviceInfo info;
};


G
Giuseppe Scrivano 已提交
754
/* Types of disk backends */
755
typedef enum {
756 757 758 759 760 761
    VIR_DOMAIN_FS_TYPE_MOUNT, /* Mounts (binds) a host dir on a guest dir */
    VIR_DOMAIN_FS_TYPE_BLOCK, /* Mounts a host block dev on a guest dir */
    VIR_DOMAIN_FS_TYPE_FILE,  /* Loopback mounts a host file on a guest dir */
    VIR_DOMAIN_FS_TYPE_TEMPLATE, /* Expands a OS template to a guest dir */
    VIR_DOMAIN_FS_TYPE_RAM,   /* Mount a RAM filesystem on a guest dir */
    VIR_DOMAIN_FS_TYPE_BIND,  /* Binds a guest dir to another guest dir */
762 763

    VIR_DOMAIN_FS_TYPE_LAST
764
} virDomainFSType;
765

766
/* Filesystem driver type */
767
typedef enum {
768 769 770
    VIR_DOMAIN_FS_DRIVER_TYPE_DEFAULT = 0,
    VIR_DOMAIN_FS_DRIVER_TYPE_PATH,
    VIR_DOMAIN_FS_DRIVER_TYPE_HANDLE,
771
    VIR_DOMAIN_FS_DRIVER_TYPE_LOOP,
772
    VIR_DOMAIN_FS_DRIVER_TYPE_NBD,
D
Dmitry Guryanov 已提交
773
    VIR_DOMAIN_FS_DRIVER_TYPE_PLOOP,
774 775

    VIR_DOMAIN_FS_DRIVER_TYPE_LAST
776
} virDomainFSDriverType;
777

778
/* Filesystem mount access mode  */
779
typedef enum {
780 781 782 783 784
    VIR_DOMAIN_FS_ACCESSMODE_PASSTHROUGH,
    VIR_DOMAIN_FS_ACCESSMODE_MAPPED,
    VIR_DOMAIN_FS_ACCESSMODE_SQUASH,

    VIR_DOMAIN_FS_ACCESSMODE_LAST
785
} virDomainFSAccessMode;
786

787
/* Filesystem Write policy */
788
typedef enum {
789 790 791 792
    VIR_DOMAIN_FS_WRPOLICY_DEFAULT = 0,
    VIR_DOMAIN_FS_WRPOLICY_IMMEDIATE,

    VIR_DOMAIN_FS_WRPOLICY_LAST
793
} virDomainFSWrpolicy;
794

795 796 797
/* Allow 2 MB ram usage */
# define VIR_DOMAIN_FS_RAM_DEFAULT_USAGE (1024 * 2)

798 799
struct _virDomainFSDef {
    int type;
800 801
    int fsdriver; /* enum virDomainFSDriverType */
    int accessmode; /* enum virDomainFSAccessMode */
802
    int wrpolicy; /* enum virDomainFSWrpolicy */
803
    int format; /* virStorageFileFormat */
804
    unsigned long long usage; /* in bytes */
805 806
    char *src;
    char *dst;
807
    bool readonly;
808
    virDomainDeviceInfo info;
809 810
    unsigned long long space_hard_limit; /* in bytes */
    unsigned long long space_soft_limit; /* in bytes */
811
    bool symlinksResolved;
812 813 814
};


815
/* network config types */
816
typedef enum {
817 818
    VIR_DOMAIN_NET_TYPE_USER,
    VIR_DOMAIN_NET_TYPE_ETHERNET,
M
Michele Paolino 已提交
819
    VIR_DOMAIN_NET_TYPE_VHOSTUSER,
820 821 822 823 824
    VIR_DOMAIN_NET_TYPE_SERVER,
    VIR_DOMAIN_NET_TYPE_CLIENT,
    VIR_DOMAIN_NET_TYPE_MCAST,
    VIR_DOMAIN_NET_TYPE_NETWORK,
    VIR_DOMAIN_NET_TYPE_BRIDGE,
D
Daniel Veillard 已提交
825
    VIR_DOMAIN_NET_TYPE_INTERNAL,
826
    VIR_DOMAIN_NET_TYPE_DIRECT,
827
    VIR_DOMAIN_NET_TYPE_HOSTDEV,
828
    VIR_DOMAIN_NET_TYPE_UDP,
829

830
    VIR_DOMAIN_NET_TYPE_LAST
831
} virDomainNetType;
832

833
/* the backend driver used for virtio interfaces */
834
typedef enum {
835 836 837 838
    VIR_DOMAIN_NET_BACKEND_TYPE_DEFAULT, /* prefer kernel, fall back to user */
    VIR_DOMAIN_NET_BACKEND_TYPE_QEMU,    /* userland */
    VIR_DOMAIN_NET_BACKEND_TYPE_VHOST,   /* kernel */

839
    VIR_DOMAIN_NET_BACKEND_TYPE_LAST
840
} virDomainNetBackendType;
841

842
/* the TX algorithm used for virtio interfaces */
843
typedef enum {
844 845 846 847
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_DEFAULT, /* default for this version of qemu */
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_IOTHREAD,
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_TIMER,

848
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_LAST
849
} virDomainNetVirtioTxModeType;
850

851
/* link interface states */
852
typedef enum {
853 854 855 856 857
        VIR_DOMAIN_NET_INTERFACE_LINK_STATE_DEFAULT = 0, /* Default link state (up) */
        VIR_DOMAIN_NET_INTERFACE_LINK_STATE_UP,          /* Link is up. ("cable" connected) */
        VIR_DOMAIN_NET_INTERFACE_LINK_STATE_DOWN ,       /* Link is down. ("cable" disconnected) */

        VIR_DOMAIN_NET_INTERFACE_LINK_STATE_LAST
858
} virDomainNetInterfaceLinkState;
859

860 861 862 863 864 865 866 867 868 869 870 871
/* Config that was actually used to bring up interface, after
 * resolving network reference. This is private data, only used within
 * libvirt, but still must maintain backward compatibility, because
 * different versions of libvirt may read the same data file.
 */
typedef struct _virDomainActualNetDef virDomainActualNetDef;
typedef virDomainActualNetDef *virDomainActualNetDefPtr;
struct _virDomainActualNetDef {
    int type; /* enum virDomainNetType */
    union {
        struct {
            char *brname;
872
            int macTableManager; /* enum virNetworkBridgeMACTableManagerType */
873 874 875 876 877
        } bridge;
        struct {
            char *linkdev;
            int mode; /* enum virMacvtapMode from util/macvtap.h */
        } direct;
878 879 880
        struct {
            virDomainHostdevDef def;
        } hostdev;
881
    } data;
882
    virNetDevVPortProfilePtr virtPortProfile;
883
    virNetDevBandwidthPtr bandwidth;
884
    virNetDevVlan vlan;
885
    int trustGuestRxFilters; /* enum virTristateBool */
886
    unsigned int class_id; /* class ID for bandwidth 'floor' */
887 888
};

889 890
/* Stores the virtual network interface configuration */
struct _virDomainNetDef {
891
    virDomainNetType type;
892
    virMacAddr mac;
893
    char *model;
894 895
    union {
        struct {
896 897
            virDomainNetBackendType name; /* which driver backend to use */
            virDomainNetVirtioTxModeType txmode;
J
Ján Tomko 已提交
898 899
            virTristateSwitch ioeventfd;
            virTristateSwitch event_idx;
900
            unsigned int queues; /* Multiqueue virtio-net */
901 902 903 904 905 906 907
            struct {
                virTristateSwitch csum;
                virTristateSwitch gso;
                virTristateSwitch tso4;
                virTristateSwitch tso6;
                virTristateSwitch ecn;
                virTristateSwitch ufo;
908
                virTristateSwitch mrg_rxbuf;
909 910 911 912 913 914 915 916
            } host;
            struct {
                virTristateSwitch csum;
                virTristateSwitch tso4;
                virTristateSwitch tso6;
                virTristateSwitch ecn;
                virTristateSwitch ufo;
            } guest;
917 918
        } virtio;
    } driver;
919 920 921 922
    struct {
        char *tap;
        char *vhost;
    } backend;
923
    union {
M
Michele Paolino 已提交
924
        virDomainChrSourceDefPtr vhostuser;
925 926 927
        struct {
            char *address;
            int port;
928 929
            char *localaddr;
            int localport;
930 931 932
        } socket; /* any of NET_CLIENT or NET_SERVER or NET_MCAST */
        struct {
            char *name;
933 934 935 936 937 938 939 940 941 942
            char *portgroup;
            /* actual has info about the currently used physical
             * device (if the network is of type
             * bridge/private/vepa/passthrough). This is saved in the
             * domain state, but never written to persistent config,
             * since it needs to be re-allocated whenever the domain
             * is restarted. It is also never shown to the user, and
             * the user cannot specify it in XML documents.
             */
            virDomainActualNetDefPtr actual;
943 944 945 946
        } network;
        struct {
            char *brname;
        } bridge;
D
Daniel Veillard 已提交
947 948 949
        struct {
            char *name;
        } internal;
950 951
        struct {
            char *linkdev;
952
            int mode; /* enum virMacvtapMode from util/macvtap.h */
953
        } direct;
954 955 956
        struct {
            virDomainHostdevDef def;
        } hostdev;
957
    } data;
958 959
    /* virtPortProfile is used by network/bridge/direct/hostdev */
    virNetDevVPortProfilePtr virtPortProfile;
960 961 962 963
    struct {
        bool sndbuf_specified;
        unsigned long sndbuf;
    } tune;
964
    char *script;
965
    char *domain_name; /* backend domain name */
966
    char *ifname;
967
    char *ifname_guest_actual;
968 969
    char *ifname_guest;
    virNetDevIPInfo guestIP;
970
    virDomainDeviceInfo info;
971 972
    char *filter;
    virNWFilterHashTablePtr filterparams;
973
    virNetDevBandwidthPtr bandwidth;
974
    virNetDevVlan vlan;
975
    int trustGuestRxFilters; /* enum virTristateBool */
976
    int linkstate;
977 978
};

E
Eric Blake 已提交
979 980 981 982
/* Used for prefix of ifname of any network name generated dynamically
 * by libvirt, and cannot be used for a persistent network name.  */
# define VIR_NET_GENERATED_PREFIX "vnet"

983 984 985 986 987 988 989 990 991 992
typedef enum {
    VIR_DOMAIN_CHR_DEVICE_STATE_DEFAULT = 0,
    VIR_DOMAIN_CHR_DEVICE_STATE_CONNECTED,
    VIR_DOMAIN_CHR_DEVICE_STATE_DISCONNECTED,

    VIR_DOMAIN_CHR_DEVICE_STATE_LAST
} virDomainChrDeviceState;

VIR_ENUM_DECL(virDomainChrDeviceState)

993
typedef enum {
994
    VIR_DOMAIN_CHR_DEVICE_TYPE_PARALLEL = 0,
995 996
    VIR_DOMAIN_CHR_DEVICE_TYPE_SERIAL,
    VIR_DOMAIN_CHR_DEVICE_TYPE_CONSOLE,
997
    VIR_DOMAIN_CHR_DEVICE_TYPE_CHANNEL,
998

999
    VIR_DOMAIN_CHR_DEVICE_TYPE_LAST
1000
} virDomainChrDeviceType;
1001

1002
typedef enum {
G
Guannan Ren 已提交
1003 1004
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_ISA = 0,
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_USB,
M
Michal Privoznik 已提交
1005
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_PCI,
G
Guannan Ren 已提交
1006 1007

    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_LAST
1008
} virDomainChrSerialTargetType;
G
Guannan Ren 已提交
1009

1010
typedef enum {
1011 1012
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_NONE = 0,
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_GUESTFWD,
1013 1014
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_VIRTIO,

1015
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_LAST
1016
} virDomainChrChannelTargetType;
1017

1018
typedef enum {
1019 1020
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_NONE  = 0,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SERIAL,
1021 1022
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_XEN,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_UML,
C
Cole Robinson 已提交
1023
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_VIRTIO,
1024 1025
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LXC,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_OPENVZ,
1026 1027
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLP,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLPLM,
1028

1029
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LAST
1030
} virDomainChrConsoleTargetType;
1031

1032
typedef enum {
1033 1034 1035 1036 1037 1038 1039 1040 1041 1042
    VIR_DOMAIN_CHR_TYPE_NULL,
    VIR_DOMAIN_CHR_TYPE_VC,
    VIR_DOMAIN_CHR_TYPE_PTY,
    VIR_DOMAIN_CHR_TYPE_DEV,
    VIR_DOMAIN_CHR_TYPE_FILE,
    VIR_DOMAIN_CHR_TYPE_PIPE,
    VIR_DOMAIN_CHR_TYPE_STDIO,
    VIR_DOMAIN_CHR_TYPE_UDP,
    VIR_DOMAIN_CHR_TYPE_TCP,
    VIR_DOMAIN_CHR_TYPE_UNIX,
1043
    VIR_DOMAIN_CHR_TYPE_SPICEVMC,
1044
    VIR_DOMAIN_CHR_TYPE_SPICEPORT,
1045
    VIR_DOMAIN_CHR_TYPE_NMDM,
1046

1047
    VIR_DOMAIN_CHR_TYPE_LAST
1048
} virDomainChrType;
1049

1050
typedef enum {
1051 1052
    VIR_DOMAIN_CHR_TCP_PROTOCOL_RAW,
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNET,
1053 1054
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNETS, /* secure telnet */
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TLS,
1055

1056
    VIR_DOMAIN_CHR_TCP_PROTOCOL_LAST
1057
} virDomainChrTcpProtocol;
1058

1059
typedef enum {
E
Eric Blake 已提交
1060 1061
    VIR_DOMAIN_CHR_SPICEVMC_VDAGENT,
    VIR_DOMAIN_CHR_SPICEVMC_SMARTCARD,
1062
    VIR_DOMAIN_CHR_SPICEVMC_USBREDIR,
E
Eric Blake 已提交
1063

1064
    VIR_DOMAIN_CHR_SPICEVMC_LAST
1065
} virDomainChrSpicevmcName;
E
Eric Blake 已提交
1066

1067 1068 1069
/* The host side information for a character device.  */
struct _virDomainChrSourceDef {
    int type; /* virDomainChrType */
1070
    union {
E
Eric Blake 已提交
1071
        /* no <source> for null, vc, stdio */
1072 1073
        struct {
            char *path;
1074
            int append; /* enum virTristateSwitch */
1075
        } file; /* pty, file, pipe, or device */
1076 1077 1078 1079
        struct {
            char *master;
            char *slave;
        } nmdm;
1080 1081 1082
        struct {
            char *host;
            char *service;
1083
            bool listen;
1084 1085 1086 1087 1088 1089 1090 1091 1092 1093
            int protocol;
        } tcp;
        struct {
            char *bindHost;
            char *bindService;
            char *connectHost;
            char *connectService;
        } udp;
        struct {
            char *path;
1094
            bool listen;
1095
        } nix;
E
Eric Blake 已提交
1096
        int spicevmc;
1097 1098 1099
        struct {
            char *channel;
        } spiceport;
1100
    } data;
1101 1102
    char *logfile;
    int logappend;
1103 1104 1105 1106
};

/* A complete character device, both host and domain views.  */
struct _virDomainChrDef {
1107
    int deviceType; /* enum virDomainChrDeviceType */
G
Guannan Ren 已提交
1108 1109

    bool targetTypeAttr;
1110 1111 1112 1113
    int targetType; /* enum virDomainChrConsoleTargetType ||
                       enum virDomainChrChannelTargetType ||
                       enum virDomainChrSerialTargetType according to deviceType */

1114 1115 1116 1117 1118 1119
    union {
        int port; /* parallel, serial, console */
        virSocketAddrPtr addr; /* guestfwd */
        char *name; /* virtio */
    } target;

1120 1121
    virDomainChrDeviceState state;

1122
    virDomainChrSourceDef source;
1123 1124

    virDomainDeviceInfo info;
1125 1126 1127

    size_t nseclabels;
    virSecurityDeviceLabelDefPtr *seclabels;
1128 1129
};

1130
typedef enum {
E
Eric Blake 已提交
1131 1132 1133 1134
    VIR_DOMAIN_SMARTCARD_TYPE_HOST,
    VIR_DOMAIN_SMARTCARD_TYPE_HOST_CERTIFICATES,
    VIR_DOMAIN_SMARTCARD_TYPE_PASSTHROUGH,

1135
    VIR_DOMAIN_SMARTCARD_TYPE_LAST
1136
} virDomainSmartcardType;
E
Eric Blake 已提交
1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154

# define VIR_DOMAIN_SMARTCARD_NUM_CERTIFICATES 3
# define VIR_DOMAIN_SMARTCARD_DEFAULT_DATABASE "/etc/pki/nssdb"

struct _virDomainSmartcardDef {
    int type; /* virDomainSmartcardType */
    union {
        /* no extra data for 'host' */
        struct {
            char *file[VIR_DOMAIN_SMARTCARD_NUM_CERTIFICATES];
            char *database;
        } cert; /* 'host-certificates' */
        virDomainChrSourceDef passthru; /* 'passthrough' */
    } data;

    virDomainDeviceInfo info;
};

M
Marc-André Lureau 已提交
1155 1156 1157 1158 1159
struct _virDomainHubDef {
    int type;
    virDomainDeviceInfo info;
};

1160
typedef enum {
1161 1162 1163
    VIR_DOMAIN_TPM_MODEL_TIS,

    VIR_DOMAIN_TPM_MODEL_LAST
1164
} virDomainTPMModel;
1165

1166
typedef enum {
1167 1168 1169
    VIR_DOMAIN_TPM_TYPE_PASSTHROUGH,

    VIR_DOMAIN_TPM_TYPE_LAST
1170
} virDomainTPMBackendType;
1171 1172 1173 1174

# define VIR_DOMAIN_TPM_DEFAULT_DEVICE "/dev/tpm0"

struct _virDomainTPMDef {
1175
    virDomainTPMBackendType type;
1176
    virDomainDeviceInfo info;
1177
    virDomainTPMModel model;
1178 1179 1180 1181 1182 1183 1184
    union {
        struct {
            virDomainChrSourceDef source;
        } passthrough;
    } data;
};

1185
typedef enum {
1186 1187
    VIR_DOMAIN_INPUT_TYPE_MOUSE,
    VIR_DOMAIN_INPUT_TYPE_TABLET,
L
Li Zhang 已提交
1188
    VIR_DOMAIN_INPUT_TYPE_KBD,
1189
    VIR_DOMAIN_INPUT_TYPE_PASSTHROUGH,
1190

1191
    VIR_DOMAIN_INPUT_TYPE_LAST
1192
} virDomainInputType;
1193

1194
typedef enum {
1195 1196 1197
    VIR_DOMAIN_INPUT_BUS_PS2,
    VIR_DOMAIN_INPUT_BUS_USB,
    VIR_DOMAIN_INPUT_BUS_XEN,
1198
    VIR_DOMAIN_INPUT_BUS_PARALLELS, /* pseudo device for VNC in containers */
1199
    VIR_DOMAIN_INPUT_BUS_VIRTIO,
1200 1201

    VIR_DOMAIN_INPUT_BUS_LAST
1202
} virDomainInputBus;
1203 1204 1205 1206

struct _virDomainInputDef {
    int type;
    int bus;
1207 1208 1209
    struct {
        char *evdev;
    } source;
1210
    virDomainDeviceInfo info;
1211 1212
};

1213
typedef enum {
1214 1215 1216 1217
    VIR_DOMAIN_SOUND_CODEC_TYPE_DUPLEX,
    VIR_DOMAIN_SOUND_CODEC_TYPE_MICRO,

    VIR_DOMAIN_SOUND_CODEC_TYPE_LAST
1218
} virDomainSoundCodecType;
1219

1220
typedef enum {
1221 1222 1223
    VIR_DOMAIN_SOUND_MODEL_SB16,
    VIR_DOMAIN_SOUND_MODEL_ES1370,
    VIR_DOMAIN_SOUND_MODEL_PCSPK,
D
Daniel P. Berrange 已提交
1224
    VIR_DOMAIN_SOUND_MODEL_AC97,
1225
    VIR_DOMAIN_SOUND_MODEL_ICH6,
1226
    VIR_DOMAIN_SOUND_MODEL_ICH9,
1227
    VIR_DOMAIN_SOUND_MODEL_USB,
1228 1229

    VIR_DOMAIN_SOUND_MODEL_LAST
1230
} virDomainSoundModel;
1231

1232 1233 1234 1235 1236
struct _virDomainSoundCodecDef {
    int type;
    int cad;
};

1237 1238
struct _virDomainSoundDef {
    int model;
1239
    virDomainDeviceInfo info;
1240

1241
    size_t ncodecs;
1242
    virDomainSoundCodecDefPtr *codecs;
1243 1244
};

1245
typedef enum {
R
Richard Jones 已提交
1246 1247
    VIR_DOMAIN_WATCHDOG_MODEL_I6300ESB,
    VIR_DOMAIN_WATCHDOG_MODEL_IB700,
1248
    VIR_DOMAIN_WATCHDOG_MODEL_DIAG288,
R
Richard Jones 已提交
1249 1250

    VIR_DOMAIN_WATCHDOG_MODEL_LAST
1251
} virDomainWatchdogModel;
R
Richard Jones 已提交
1252

1253
typedef enum {
R
Richard Jones 已提交
1254 1255 1256 1257
    VIR_DOMAIN_WATCHDOG_ACTION_RESET,
    VIR_DOMAIN_WATCHDOG_ACTION_SHUTDOWN,
    VIR_DOMAIN_WATCHDOG_ACTION_POWEROFF,
    VIR_DOMAIN_WATCHDOG_ACTION_PAUSE,
H
Hu Tao 已提交
1258
    VIR_DOMAIN_WATCHDOG_ACTION_DUMP,
R
Richard Jones 已提交
1259
    VIR_DOMAIN_WATCHDOG_ACTION_NONE,
1260
    VIR_DOMAIN_WATCHDOG_ACTION_INJECTNMI,
R
Richard Jones 已提交
1261 1262

    VIR_DOMAIN_WATCHDOG_ACTION_LAST
1263
} virDomainWatchdogAction;
R
Richard Jones 已提交
1264 1265 1266 1267

struct _virDomainWatchdogDef {
    int model;
    int action;
1268
    virDomainDeviceInfo info;
R
Richard Jones 已提交
1269 1270
};

1271

1272
typedef enum {
1273 1274 1275 1276 1277
    VIR_DOMAIN_VIDEO_TYPE_VGA,
    VIR_DOMAIN_VIDEO_TYPE_CIRRUS,
    VIR_DOMAIN_VIDEO_TYPE_VMVGA,
    VIR_DOMAIN_VIDEO_TYPE_XEN,
    VIR_DOMAIN_VIDEO_TYPE_VBOX,
1278
    VIR_DOMAIN_VIDEO_TYPE_QXL,
1279
    VIR_DOMAIN_VIDEO_TYPE_PARALLELS, /* pseudo device for VNC in containers */
M
Marc-André Lureau 已提交
1280
    VIR_DOMAIN_VIDEO_TYPE_VIRTIO,
1281 1282

    VIR_DOMAIN_VIDEO_TYPE_LAST
1283
} virDomainVideoType;
1284 1285


1286 1287 1288
typedef struct _virDomainVideoAccelDef virDomainVideoAccelDef;
typedef virDomainVideoAccelDef *virDomainVideoAccelDefPtr;
struct _virDomainVideoAccelDef {
1289 1290
    int accel2d; /* enum virTristateBool */
    int accel3d; /* enum virTristateBool */
1291 1292 1293
};


1294 1295
struct _virDomainVideoDef {
    int type;
1296 1297
    unsigned int ram;  /* kibibytes (multiples of 1024) */
    unsigned int vram; /* kibibytes (multiples of 1024) */
1298
    unsigned int vram64; /* kibibytes (multiples of 1024) */
1299
    unsigned int vgamem; /* kibibytes (multiples of 1024) */
1300
    unsigned int heads;
1301
    bool primary;
1302
    virDomainVideoAccelDefPtr accel;
1303
    virDomainDeviceInfo info;
1304 1305
};

1306
/* graphics console modes */
1307
typedef enum {
1308 1309
    VIR_DOMAIN_GRAPHICS_TYPE_SDL,
    VIR_DOMAIN_GRAPHICS_TYPE_VNC,
1310 1311
    VIR_DOMAIN_GRAPHICS_TYPE_RDP,
    VIR_DOMAIN_GRAPHICS_TYPE_DESKTOP,
1312
    VIR_DOMAIN_GRAPHICS_TYPE_SPICE,
1313

1314
    VIR_DOMAIN_GRAPHICS_TYPE_LAST
1315
} virDomainGraphicsType;
1316

1317
typedef enum {
1318 1319 1320 1321 1322 1323
    VIR_DOMAIN_GRAPHICS_VNC_SHARE_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_VNC_SHARE_ALLOW_EXCLUSIVE,
    VIR_DOMAIN_GRAPHICS_VNC_SHARE_FORCE_SHARED,
    VIR_DOMAIN_GRAPHICS_VNC_SHARE_IGNORE,

    VIR_DOMAIN_GRAPHICS_VNC_SHARE_LAST
1324
} virDomainGraphicsVNCSharePolicy;
1325

1326
typedef enum {
1327 1328 1329 1330 1331 1332
    VIR_DOMAIN_GRAPHICS_AUTH_CONNECTED_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_AUTH_CONNECTED_FAIL,
    VIR_DOMAIN_GRAPHICS_AUTH_CONNECTED_DISCONNECT,
    VIR_DOMAIN_GRAPHICS_AUTH_CONNECTED_KEEP,

    VIR_DOMAIN_GRAPHICS_AUTH_CONNECTED_LAST
1333
} virDomainGraphicsAuthConnectedType;
1334

1335 1336 1337 1338
typedef struct _virDomainGraphicsAuthDef virDomainGraphicsAuthDef;
typedef virDomainGraphicsAuthDef *virDomainGraphicsAuthDefPtr;
struct _virDomainGraphicsAuthDef {
    char *passwd;
1339
    bool expires; /* Whether there is an expiry time set */
1340
    time_t validTo;  /* seconds since epoch */
1341
    int connected; /* action if connected */
1342 1343
};

1344
typedef enum {
1345 1346 1347 1348 1349 1350
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_MAIN,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_DISPLAY,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_INPUT,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_CURSOR,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_PLAYBACK,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_RECORD,
E
Eric Blake 已提交
1351
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_SMARTCARD,
1352
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_USBREDIR,
1353 1354

    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST
1355
} virDomainGraphicsSpiceChannelName;
1356

1357
typedef enum {
1358 1359 1360 1361 1362
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_MODE_ANY,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_MODE_SECURE,
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_MODE_INSECURE,

    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_MODE_LAST
1363
} virDomainGraphicsSpiceChannelMode;
1364

1365
typedef enum {
1366 1367 1368 1369 1370 1371 1372 1373 1374
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_AUTO_GLZ,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_AUTO_LZ,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_QUIC,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_GLZ,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_LZ,
    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_OFF,

    VIR_DOMAIN_GRAPHICS_SPICE_IMAGE_COMPRESSION_LAST
1375
} virDomainGraphicsSpiceImageCompression;
1376

1377
typedef enum {
1378 1379 1380 1381 1382 1383
    VIR_DOMAIN_GRAPHICS_SPICE_JPEG_COMPRESSION_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_JPEG_COMPRESSION_AUTO,
    VIR_DOMAIN_GRAPHICS_SPICE_JPEG_COMPRESSION_NEVER,
    VIR_DOMAIN_GRAPHICS_SPICE_JPEG_COMPRESSION_ALWAYS,

    VIR_DOMAIN_GRAPHICS_SPICE_JPEG_COMPRESSION_LAST
1384
} virDomainGraphicsSpiceJpegCompression;
1385

1386
typedef enum {
1387 1388 1389 1390 1391 1392
    VIR_DOMAIN_GRAPHICS_SPICE_ZLIB_COMPRESSION_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_ZLIB_COMPRESSION_AUTO,
    VIR_DOMAIN_GRAPHICS_SPICE_ZLIB_COMPRESSION_NEVER,
    VIR_DOMAIN_GRAPHICS_SPICE_ZLIB_COMPRESSION_ALWAYS,

    VIR_DOMAIN_GRAPHICS_SPICE_ZLIB_COMPRESSION_LAST
1393
} virDomainGraphicsSpiceZlibCompression;
1394

1395
typedef enum {
P
Peng Zhou 已提交
1396 1397 1398 1399 1400
    VIR_DOMAIN_GRAPHICS_SPICE_MOUSE_MODE_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_MOUSE_MODE_SERVER,
    VIR_DOMAIN_GRAPHICS_SPICE_MOUSE_MODE_CLIENT,

    VIR_DOMAIN_GRAPHICS_SPICE_MOUSE_MODE_LAST
1401
} virDomainGraphicsSpiceMouseMode;
P
Peng Zhou 已提交
1402

1403
typedef enum {
1404 1405 1406 1407 1408 1409
    VIR_DOMAIN_GRAPHICS_SPICE_STREAMING_MODE_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_STREAMING_MODE_FILTER,
    VIR_DOMAIN_GRAPHICS_SPICE_STREAMING_MODE_ALL,
    VIR_DOMAIN_GRAPHICS_SPICE_STREAMING_MODE_OFF,

    VIR_DOMAIN_GRAPHICS_SPICE_STREAMING_MODE_LAST
1410
} virDomainGraphicsSpiceStreamingMode;
1411

1412
typedef enum {
1413 1414 1415
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NONE = 0,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_ADDRESS,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NETWORK,
1416
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_SOCKET,
1417

1418
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_LAST
1419
} virDomainGraphicsListenType;
1420

1421
typedef enum {
M
Marc-André Lureau 已提交
1422 1423
    VIR_DOMAIN_HUB_TYPE_USB,

1424
    VIR_DOMAIN_HUB_TYPE_LAST
1425
} virDomainHubType;
M
Marc-André Lureau 已提交
1426

1427 1428 1429
typedef struct _virDomainGraphicsListenDef virDomainGraphicsListenDef;
typedef virDomainGraphicsListenDef *virDomainGraphicsListenDefPtr;
struct _virDomainGraphicsListenDef {
1430
    virDomainGraphicsListenType type;
1431 1432
    char *address;
    char *network;
1433
    char *socket;
1434
    bool fromConfig;    /* true if the @address is config file originated */
1435
    bool autoGenerated;
1436 1437
};

1438
struct _virDomainGraphicsDef {
M
Michal Privoznik 已提交
1439 1440 1441 1442 1443
    /* Port value discipline:
     * Value -1 is legacy syntax indicating that it should be auto-allocated.
     * Value 0 means port wasn't specified in XML at all.
     * Positive value is actual port number given in XML.
     */
1444
    virDomainGraphicsType type;
1445 1446 1447
    union {
        struct {
            int port;
1448
            bool portReserved;
M
Martin Kletzander 已提交
1449
            int websocket;
1450
            bool autoport;
1451
            char *keymap;
1452
            virDomainGraphicsAuthDef auth;
1453
            int sharePolicy;
1454 1455 1456 1457
        } vnc;
        struct {
            char *display;
            char *xauth;
1458
            bool fullscreen;
1459
        } sdl;
1460 1461
        struct {
            int port;
1462 1463 1464
            bool autoport;
            bool replaceUser;
            bool multiUser;
1465 1466 1467
        } rdp;
        struct {
            char *display;
1468
            bool fullscreen;
1469
        } desktop;
1470 1471 1472
        struct {
            int port;
            int tlsPort;
1473 1474
            bool portReserved;
            bool tlsPortReserved;
1475
            virDomainGraphicsSpiceMouseMode mousemode;
1476
            char *keymap;
1477
            virDomainGraphicsAuthDef auth;
1478
            bool autoport;
1479
            int channels[VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST];
1480
            virDomainGraphicsSpiceChannelMode defaultMode;
1481 1482 1483 1484
            int image;
            int jpeg;
            int zlib;
            int playback;
1485
            int streaming;
1486 1487 1488
            virTristateBool copypaste;
            virTristateBool filetransfer;
            virTristateBool gl;
1489
        } spice;
1490
    } data;
1491 1492 1493 1494 1495
    /* nListens, listens, and *port are only useful if type is vnc,
     * rdp, or spice. They've been extracted from the union only to
     * simplify parsing code.*/
    size_t nListens;
    virDomainGraphicsListenDefPtr listens;
1496 1497
};

1498
typedef enum {
1499 1500 1501
    VIR_DOMAIN_REDIRDEV_BUS_USB,

    VIR_DOMAIN_REDIRDEV_BUS_LAST
1502
} virDomainRedirdevBus;
1503 1504 1505 1506 1507 1508 1509 1510 1511 1512

struct _virDomainRedirdevDef {
    int bus; /* enum virDomainRedirdevBus */

    union {
        virDomainChrSourceDef chr;
    } source;

    virDomainDeviceInfo info; /* Guest address */
};
1513

1514
struct _virDomainRedirFilterUSBDevDef {
1515 1516 1517 1518
    int usbClass;
    int vendor;
    int product;
    int version;
1519
    bool allow;
1520 1521 1522 1523
};

struct _virDomainRedirFilterDef {
    size_t nusbdevs;
1524
    virDomainRedirFilterUSBDevDefPtr *usbdevs;
1525 1526
};

1527 1528 1529
enum {
    VIR_DOMAIN_MEMBALLOON_MODEL_VIRTIO,
    VIR_DOMAIN_MEMBALLOON_MODEL_XEN,
1530
    VIR_DOMAIN_MEMBALLOON_MODEL_NONE,
1531 1532 1533 1534 1535 1536 1537

    VIR_DOMAIN_MEMBALLOON_MODEL_LAST
};

struct _virDomainMemballoonDef {
    int model;
    virDomainDeviceInfo info;
1538
    int period; /* seconds between collections */
1539
    int autodeflate; /* enum virTristateSwitch */
1540 1541
};

L
Li Zhang 已提交
1542 1543 1544
struct _virDomainNVRAMDef {
    virDomainDeviceInfo info;
};
1545

1546 1547 1548 1549 1550
struct _virDomainShmemDef {
    char *name;
    unsigned long long size;
    struct {
        bool enabled;
1551
        virDomainChrSourceDef chr;
1552 1553 1554 1555 1556 1557 1558 1559 1560
    } server;
    struct {
        bool enabled;
        unsigned vectors;
        virTristateSwitch ioeventfd;
    } msi;
    virDomainDeviceInfo info;
};

1561
typedef enum {
1562
    VIR_DOMAIN_SMBIOS_NONE = 0,
1563 1564 1565 1566 1567
    VIR_DOMAIN_SMBIOS_EMULATE,
    VIR_DOMAIN_SMBIOS_HOST,
    VIR_DOMAIN_SMBIOS_SYSINFO,

    VIR_DOMAIN_SMBIOS_LAST
1568
} virDomainSmbiosMode;
1569

1570

1571
# define VIR_DOMAIN_MAX_BOOT_DEVS 4
1572

1573
typedef enum {
1574 1575 1576 1577 1578
    VIR_DOMAIN_BOOT_FLOPPY,
    VIR_DOMAIN_BOOT_CDROM,
    VIR_DOMAIN_BOOT_DISK,
    VIR_DOMAIN_BOOT_NET,

1579
    VIR_DOMAIN_BOOT_LAST
1580
} virDomainBootOrder;
1581

1582
typedef enum {
1583 1584 1585
    VIR_DOMAIN_FEATURE_ACPI,
    VIR_DOMAIN_FEATURE_APIC,
    VIR_DOMAIN_FEATURE_PAE,
J
Jim Fehlig 已提交
1586
    VIR_DOMAIN_FEATURE_HAP,
1587
    VIR_DOMAIN_FEATURE_VIRIDIAN,
1588
    VIR_DOMAIN_FEATURE_PRIVNET,
1589
    VIR_DOMAIN_FEATURE_HYPERV,
1590
    VIR_DOMAIN_FEATURE_KVM,
1591
    VIR_DOMAIN_FEATURE_PVSPINLOCK,
1592
    VIR_DOMAIN_FEATURE_CAPABILITIES,
1593
    VIR_DOMAIN_FEATURE_PMU,
1594
    VIR_DOMAIN_FEATURE_VMPORT,
M
Michal Privoznik 已提交
1595
    VIR_DOMAIN_FEATURE_GIC,
1596 1597

    VIR_DOMAIN_FEATURE_LAST
1598
} virDomainFeature;
1599

1600 1601
# define VIR_DOMAIN_HYPERV_VENDOR_ID_MAX 12

1602
typedef enum {
1603
    VIR_DOMAIN_HYPERV_RELAXED = 0,
1604 1605
    VIR_DOMAIN_HYPERV_VAPIC,
    VIR_DOMAIN_HYPERV_SPINLOCKS,
1606 1607 1608 1609 1610 1611
    VIR_DOMAIN_HYPERV_VPINDEX,
    VIR_DOMAIN_HYPERV_RUNTIME,
    VIR_DOMAIN_HYPERV_SYNIC,
    VIR_DOMAIN_HYPERV_STIMER,
    VIR_DOMAIN_HYPERV_RESET,
    VIR_DOMAIN_HYPERV_VENDOR_ID,
1612 1613

    VIR_DOMAIN_HYPERV_LAST
1614
} virDomainHyperv;
1615

1616 1617 1618 1619 1620 1621
typedef enum {
    VIR_DOMAIN_KVM_HIDDEN = 0,

    VIR_DOMAIN_KVM_LAST
} virDomainKVM;

1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671
typedef enum {
    VIR_DOMAIN_CAPABILITIES_POLICY_DEFAULT = 0,
    VIR_DOMAIN_CAPABILITIES_POLICY_ALLOW,
    VIR_DOMAIN_CAPABILITIES_POLICY_DENY,

    VIR_DOMAIN_CAPABILITIES_POLICY_LAST
} virDomainCapabilitiesPolicy;

/* The capabilities are ordered alphabetically to help check for new ones */
typedef enum {
    VIR_DOMAIN_CAPS_FEATURE_AUDIT_CONTROL = 0,
    VIR_DOMAIN_CAPS_FEATURE_AUDIT_WRITE,
    VIR_DOMAIN_CAPS_FEATURE_BLOCK_SUSPEND,
    VIR_DOMAIN_CAPS_FEATURE_CHOWN,
    VIR_DOMAIN_CAPS_FEATURE_DAC_OVERRIDE,
    VIR_DOMAIN_CAPS_FEATURE_DAC_READ_SEARCH,
    VIR_DOMAIN_CAPS_FEATURE_FOWNER,
    VIR_DOMAIN_CAPS_FEATURE_FSETID,
    VIR_DOMAIN_CAPS_FEATURE_IPC_LOCK,
    VIR_DOMAIN_CAPS_FEATURE_IPC_OWNER,
    VIR_DOMAIN_CAPS_FEATURE_KILL,
    VIR_DOMAIN_CAPS_FEATURE_LEASE,
    VIR_DOMAIN_CAPS_FEATURE_LINUX_IMMUTABLE,
    VIR_DOMAIN_CAPS_FEATURE_MAC_ADMIN,
    VIR_DOMAIN_CAPS_FEATURE_MAC_OVERRIDE,
    VIR_DOMAIN_CAPS_FEATURE_MKNOD,
    VIR_DOMAIN_CAPS_FEATURE_NET_ADMIN,
    VIR_DOMAIN_CAPS_FEATURE_NET_BIND_SERVICE,
    VIR_DOMAIN_CAPS_FEATURE_NET_BROADCAST,
    VIR_DOMAIN_CAPS_FEATURE_NET_RAW,
    VIR_DOMAIN_CAPS_FEATURE_SETGID,
    VIR_DOMAIN_CAPS_FEATURE_SETFCAP,
    VIR_DOMAIN_CAPS_FEATURE_SETPCAP,
    VIR_DOMAIN_CAPS_FEATURE_SETUID,
    VIR_DOMAIN_CAPS_FEATURE_SYS_ADMIN,
    VIR_DOMAIN_CAPS_FEATURE_SYS_BOOT,
    VIR_DOMAIN_CAPS_FEATURE_SYS_CHROOT,
    VIR_DOMAIN_CAPS_FEATURE_SYS_MODULE,
    VIR_DOMAIN_CAPS_FEATURE_SYS_NICE,
    VIR_DOMAIN_CAPS_FEATURE_SYS_PACCT,
    VIR_DOMAIN_CAPS_FEATURE_SYS_PTRACE,
    VIR_DOMAIN_CAPS_FEATURE_SYS_RAWIO,
    VIR_DOMAIN_CAPS_FEATURE_SYS_RESOURCE,
    VIR_DOMAIN_CAPS_FEATURE_SYS_TIME,
    VIR_DOMAIN_CAPS_FEATURE_SYS_TTY_CONFIG,
    VIR_DOMAIN_CAPS_FEATURE_SYSLOG,
    VIR_DOMAIN_CAPS_FEATURE_WAKE_ALARM,
    VIR_DOMAIN_CAPS_FEATURE_LAST
} virDomainCapsFeature;

1672
typedef enum {
1673 1674 1675 1676 1677 1678
    VIR_DOMAIN_LIFECYCLE_DESTROY,
    VIR_DOMAIN_LIFECYCLE_RESTART,
    VIR_DOMAIN_LIFECYCLE_RESTART_RENAME,
    VIR_DOMAIN_LIFECYCLE_PRESERVE,

    VIR_DOMAIN_LIFECYCLE_LAST
1679
} virDomainLifecycleAction;
1680

1681
typedef enum {
1682 1683 1684 1685 1686 1687 1688 1689
    VIR_DOMAIN_LIFECYCLE_CRASH_DESTROY,
    VIR_DOMAIN_LIFECYCLE_CRASH_RESTART,
    VIR_DOMAIN_LIFECYCLE_CRASH_RESTART_RENAME,
    VIR_DOMAIN_LIFECYCLE_CRASH_PRESERVE,
    VIR_DOMAIN_LIFECYCLE_CRASH_COREDUMP_DESTROY,
    VIR_DOMAIN_LIFECYCLE_CRASH_COREDUMP_RESTART,

    VIR_DOMAIN_LIFECYCLE_CRASH_LAST
1690
} virDomainLifecycleCrashAction;
1691

1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703
typedef enum {
    VIR_DOMAIN_LOCK_FAILURE_DEFAULT,
    VIR_DOMAIN_LOCK_FAILURE_POWEROFF,
    VIR_DOMAIN_LOCK_FAILURE_RESTART,
    VIR_DOMAIN_LOCK_FAILURE_PAUSE,
    VIR_DOMAIN_LOCK_FAILURE_IGNORE,

    VIR_DOMAIN_LOCK_FAILURE_LAST
} virDomainLockFailureAction;

VIR_ENUM_DECL(virDomainLockFailure)

M
Michal Privoznik 已提交
1704 1705 1706
typedef struct _virDomainBIOSDef virDomainBIOSDef;
typedef virDomainBIOSDef *virDomainBIOSDefPtr;
struct _virDomainBIOSDef {
J
Ján Tomko 已提交
1707
    int useserial; /* enum virTristateBool */
1708 1709 1710
    /* reboot-timeout parameters */
    bool rt_set;
    int rt_delay;
M
Michal Privoznik 已提交
1711 1712
};

1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728
typedef enum {
    VIR_DOMAIN_LOADER_TYPE_ROM = 0,
    VIR_DOMAIN_LOADER_TYPE_PFLASH,

    VIR_DOMAIN_LOADER_TYPE_LAST
} virDomainLoader;

VIR_ENUM_DECL(virDomainLoader)

typedef struct _virDomainLoaderDef virDomainLoaderDef;
typedef virDomainLoaderDef *virDomainLoaderDefPtr;
struct _virDomainLoaderDef {
    char *path;
    int readonly;   /* enum virTristateBool */
    virDomainLoader type;
    char *nvram;    /* path to non-volatile RAM */
1729
    char *templt;   /* user override of path to master nvram */
1730 1731 1732 1733
};

void virDomainLoaderDefFree(virDomainLoaderDefPtr loader);

1734 1735 1736 1737
/* Operating system configuration data & machine / arch */
typedef struct _virDomainOSDef virDomainOSDef;
typedef virDomainOSDef *virDomainOSDefPtr;
struct _virDomainOSDef {
1738
    int type;
1739
    virArch arch;
1740
    char *machine;
1741
    size_t nBootDevs;
1742
    int bootDevs[VIR_DOMAIN_BOOT_LAST];
J
Ján Tomko 已提交
1743
    int bootmenu; /* enum virTristateBool */
1744 1745
    unsigned int bm_timeout;
    bool bm_timeout_set;
1746
    char *init;
1747
    char **initargv;
1748 1749 1750
    char *kernel;
    char *initrd;
    char *cmdline;
1751
    char *dtb;
1752
    char *root;
J
Ján Tomko 已提交
1753
    char *slic_table;
1754
    virDomainLoaderDefPtr loader;
1755 1756
    char *bootloader;
    char *bootloaderArgs;
1757
    int smbios_mode;
1758

M
Michal Privoznik 已提交
1759
    virDomainBIOSDef bios;
1760 1761
};

1762
typedef enum {
1763 1764 1765 1766 1767
    VIR_DOMAIN_TIMER_NAME_PLATFORM = 0,
    VIR_DOMAIN_TIMER_NAME_PIT,
    VIR_DOMAIN_TIMER_NAME_RTC,
    VIR_DOMAIN_TIMER_NAME_HPET,
    VIR_DOMAIN_TIMER_NAME_TSC,
P
Paolo Bonzini 已提交
1768
    VIR_DOMAIN_TIMER_NAME_KVMCLOCK,
1769
    VIR_DOMAIN_TIMER_NAME_HYPERVCLOCK,
1770

1771
    VIR_DOMAIN_TIMER_NAME_LAST
1772
} virDomainTimerNameType;
1773

1774
typedef enum {
1775 1776 1777
    VIR_DOMAIN_TIMER_TRACK_BOOT = 0,
    VIR_DOMAIN_TIMER_TRACK_GUEST,
    VIR_DOMAIN_TIMER_TRACK_WALL,
1778

1779
    VIR_DOMAIN_TIMER_TRACK_LAST
1780
} virDomainTimerTrackType;
1781

1782
typedef enum {
1783 1784 1785 1786 1787
    VIR_DOMAIN_TIMER_TICKPOLICY_DELAY = 0,
    VIR_DOMAIN_TIMER_TICKPOLICY_CATCHUP,
    VIR_DOMAIN_TIMER_TICKPOLICY_MERGE,
    VIR_DOMAIN_TIMER_TICKPOLICY_DISCARD,

1788
    VIR_DOMAIN_TIMER_TICKPOLICY_LAST
1789
} virDomainTimerTickpolicyType;
1790

1791
typedef enum {
1792 1793 1794 1795
    VIR_DOMAIN_TIMER_MODE_AUTO = 0,
    VIR_DOMAIN_TIMER_MODE_NATIVE,
    VIR_DOMAIN_TIMER_MODE_EMULATE,
    VIR_DOMAIN_TIMER_MODE_PARAVIRT,
1796
    VIR_DOMAIN_TIMER_MODE_SMPSAFE,
1797

1798
    VIR_DOMAIN_TIMER_MODE_LAST
1799
} virDomainTimerModeType;
1800

1801
typedef enum {
1802
    VIR_DOMAIN_CPU_PLACEMENT_MODE_STATIC = 0,
O
Osier Yang 已提交
1803 1804
    VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO,

1805
    VIR_DOMAIN_CPU_PLACEMENT_MODE_LAST
1806
} virDomainCpuPlacementMode;
O
Osier Yang 已提交
1807

1808 1809 1810
typedef struct _virDomainThreadSchedParam virDomainThreadSchedParam;
typedef virDomainThreadSchedParam *virDomainThreadSchedParamPtr;
struct _virDomainThreadSchedParam {
1811
    virProcessSchedPolicy policy;
1812 1813 1814
    int priority;
};

1815 1816 1817 1818 1819 1820 1821 1822
typedef struct _virDomainTimerCatchupDef virDomainTimerCatchupDef;
typedef virDomainTimerCatchupDef *virDomainTimerCatchupDefPtr;
struct _virDomainTimerCatchupDef {
    unsigned long threshold;
    unsigned long slew;
    unsigned long limit;
};

1823 1824 1825 1826 1827 1828 1829
typedef struct _virDomainTimerDef virDomainTimerDef;
typedef virDomainTimerDef *virDomainTimerDefPtr;
struct _virDomainTimerDef {
    int name;
    int present;    /* unspecified = -1, no = 0, yes = 1 */
    int tickpolicy; /* none|catchup|merge|discard */

1830 1831 1832 1833
    virDomainTimerCatchupDef catchup;

    /* track is only valid for name='platform|rtc' */
    int track;  /* host|guest */
1834 1835 1836 1837 1838 1839

    /* frequency & mode are only valid for name='tsc' */
    unsigned long frequency; /* in Hz, unspecified = 0 */
    int mode;       /* auto|native|emulate|paravirt */
};

1840
typedef enum {
1841 1842
    VIR_DOMAIN_CLOCK_OFFSET_UTC = 0,
    VIR_DOMAIN_CLOCK_OFFSET_LOCALTIME = 1,
1843
    VIR_DOMAIN_CLOCK_OFFSET_VARIABLE = 2,
1844
    VIR_DOMAIN_CLOCK_OFFSET_TIMEZONE = 3,
1845

1846
    VIR_DOMAIN_CLOCK_OFFSET_LAST
1847
} virDomainClockOffsetType;
1848

1849
typedef enum {
1850 1851 1852
    VIR_DOMAIN_CLOCK_BASIS_UTC = 0,
    VIR_DOMAIN_CLOCK_BASIS_LOCALTIME = 1,

1853
    VIR_DOMAIN_CLOCK_BASIS_LAST
1854
} virDomainClockBasis;
1855

1856 1857 1858 1859
typedef struct _virDomainClockDef virDomainClockDef;
typedef virDomainClockDef *virDomainClockDefPtr;
struct _virDomainClockDef {
    int offset;
1860

1861
    union {
1862 1863 1864
        /* Bug-compatibility-mode for Xen utc|localtime */
        int utc_reset;
        /* Adjustment in seconds, relative to UTC or LOCALTIME, when
1865
         * offset == VIR_DOMAIN_CLOCK_OFFSET_VARIABLE */
1866 1867 1868
        struct {
            long long adjustment;
            int basis;
1869 1870 1871 1872 1873 1874 1875

            /* domain start-time adjustment. This is a
             * private/internal read-only value that only exists when
             * a domain is running, and only if the clock
             * offset='variable'
             */
            long long adjustment0;
1876
        } variable;
1877 1878 1879 1880 1881

        /* Timezone name, when
         * offset == VIR_DOMAIN_CLOCK_OFFSET_LOCALTIME */
        char *timezone;
    } data;
1882

1883
    size_t ntimers;
1884
    virDomainTimerDefPtr *timers;
1885 1886
};

1887

1888 1889 1890
typedef struct _virBlkioDevice virBlkioDevice;
typedef virBlkioDevice *virBlkioDevicePtr;
struct _virBlkioDevice {
1891 1892
    char *path;
    unsigned int weight;
1893 1894 1895 1896
    unsigned int riops;
    unsigned int wiops;
    unsigned long long rbps;
    unsigned long long wbps;
1897 1898
};

1899
typedef enum {
1900 1901 1902
    VIR_DOMAIN_RNG_MODEL_VIRTIO,

    VIR_DOMAIN_RNG_MODEL_LAST
1903
} virDomainRNGModel;
1904

1905
typedef enum {
1906 1907 1908 1909 1910
    VIR_DOMAIN_RNG_BACKEND_RANDOM,
    VIR_DOMAIN_RNG_BACKEND_EGD,
    /* VIR_DOMAIN_RNG_BACKEND_POOL, */

    VIR_DOMAIN_RNG_BACKEND_LAST
1911
} virDomainRNGBackend;
1912 1913 1914 1915

struct _virDomainRNGDef {
    int model;
    int backend;
1916 1917
    unsigned int rate; /* bytes per period */
    unsigned int period; /* milliseconds */
1918 1919 1920 1921 1922 1923 1924 1925 1926 1927

    union {
        char *file; /* file name for 'random' source */
        virDomainChrSourceDefPtr chardev; /* a char backend for
                                             the EGD source */
    } source;

    virDomainDeviceInfo info;
};

1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941
typedef enum {
    VIR_DOMAIN_MEMORY_MODEL_NONE,
    VIR_DOMAIN_MEMORY_MODEL_DIMM, /* dimm hotpluggable memory device */

    VIR_DOMAIN_MEMORY_MODEL_LAST
} virDomainMemoryModel;

struct _virDomainMemoryDef {
    /* source */
    virBitmapPtr sourceNodes;
    unsigned long long pagesize; /* kibibytes */

    /* target */
    int model; /* virDomainMemoryModel */
1942
    int targetNode;
1943 1944 1945 1946 1947 1948 1949
    unsigned long long size; /* kibibytes */

    virDomainDeviceInfo info;
};

void virDomainMemoryDefFree(virDomainMemoryDefPtr def);

1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964
struct _virDomainIdMapEntry {
    unsigned int start;
    unsigned int target;
    unsigned int count;
};

struct _virDomainIdMapDef {
    size_t nuidmap;
    virDomainIdMapEntryPtr uidmap;

    size_t ngidmap;
    virDomainIdMapEntryPtr gidmap;
};


1965 1966 1967 1968 1969
typedef enum {
    VIR_DOMAIN_PANIC_MODEL_DEFAULT,
    VIR_DOMAIN_PANIC_MODEL_ISA,
    VIR_DOMAIN_PANIC_MODEL_PSERIES,
    VIR_DOMAIN_PANIC_MODEL_HYPERV,
1970
    VIR_DOMAIN_PANIC_MODEL_S390,
1971 1972 1973 1974

    VIR_DOMAIN_PANIC_MODEL_LAST
} virDomainPanicModel;

H
Hu Tao 已提交
1975
struct _virDomainPanicDef {
1976
    int model; /* virDomainPanicModel */
H
Hu Tao 已提交
1977 1978 1979 1980
    virDomainDeviceInfo info;
};


1981
void virBlkioDeviceArrayClear(virBlkioDevicePtr deviceWeights,
1982
                              int ndevices);
1983

1984 1985 1986 1987 1988
typedef struct _virDomainResourceDef virDomainResourceDef;
typedef virDomainResourceDef *virDomainResourceDefPtr;
struct _virDomainResourceDef {
    char *partition;
};
1989

1990
typedef struct _virDomainHugePage virDomainHugePage;
1991 1992
typedef virDomainHugePage *virDomainHugePagePtr;

1993
struct _virDomainHugePage {
1994 1995 1996 1997
    virBitmapPtr nodemask;      /* guest's NUMA node mask */
    unsigned long long size;    /* hugepage size in KiB */
};

1998 1999
# define VIR_DOMAIN_CPUMASK_LEN 1024

2000 2001 2002 2003 2004 2005
typedef struct _virDomainIOThreadIDDef virDomainIOThreadIDDef;
typedef virDomainIOThreadIDDef *virDomainIOThreadIDDefPtr;

struct _virDomainIOThreadIDDef {
    bool autofill;
    unsigned int iothread_id;
2006
    int thread_id;
2007
    virBitmapPtr cpumask;
2008 2009

    virDomainThreadSchedParam sched;
2010 2011 2012 2013
};

void virDomainIOThreadIDDefFree(virDomainIOThreadIDDefPtr def);

2014

2015 2016 2017 2018
typedef struct _virDomainCputune virDomainCputune;
typedef virDomainCputune *virDomainCputunePtr;

struct _virDomainCputune {
2019
    unsigned long long shares;
2020 2021 2022
    bool sharesSpecified;
    unsigned long long period;
    long long quota;
2023
    unsigned long long global_period;
2024
    long long global_quota;
2025 2026
    unsigned long long emulator_period;
    long long emulator_quota;
2027
    virBitmapPtr emulatorpin;
2028 2029
};

2030 2031 2032 2033 2034 2035

typedef struct _virDomainVcpuInfo virDomainVcpuInfo;
typedef virDomainVcpuInfo *virDomainVcpuInfoPtr;

struct _virDomainVcpuInfo {
    bool online;
2036
    virBitmapPtr cpumask;
2037 2038

    virDomainThreadSchedParam sched;
2039 2040
};

2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054
typedef struct _virDomainBlkiotune virDomainBlkiotune;
typedef virDomainBlkiotune *virDomainBlkiotunePtr;

struct _virDomainBlkiotune {
    unsigned int weight;

    size_t ndevices;
    virBlkioDevicePtr devices;
};

typedef struct _virDomainMemtune virDomainMemtune;
typedef virDomainMemtune *virDomainMemtunePtr;

struct _virDomainMemtune {
2055 2056 2057
    /* total memory size including memory modules in kibibytes, this field
     * should be accessed only via accessors */
    unsigned long long total_memory;
2058 2059
    unsigned long long cur_balloon; /* in kibibytes, capped at ulong thanks
                                       to virDomainGetInfo */
2060 2061 2062 2063

    virDomainHugePagePtr hugepages;
    size_t nhugepages;

2064 2065 2066 2067
    /* maximum supported memory for a guest, for hotplugging */
    unsigned long long max_memory; /* in kibibytes */
    unsigned int memory_slots; /* maximum count of RAM memory slots */

2068 2069 2070
    bool nosharepages;
    bool locked;
    int dump_core; /* enum virTristateSwitch */
2071 2072 2073 2074
    unsigned long long hard_limit; /* in kibibytes, limit at off_t bytes */
    unsigned long long soft_limit; /* in kibibytes, limit at off_t bytes */
    unsigned long long min_guarantee; /* in kibibytes, limit at off_t bytes */
    unsigned long long swap_hard_limit; /* in kibibytes, limit at off_t bytes */
2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085
};

typedef struct _virDomainPowerManagement virDomainPowerManagement;
typedef virDomainPowerManagement *virDomainPowerManagementPtr;

struct _virDomainPowerManagement {
    /* These options are of type enum virTristateBool */
    int s3;
    int s4;
};

Q
Qiaowei Ren 已提交
2086 2087 2088 2089 2090 2091 2092
typedef struct _virDomainPerfDef virDomainPerfDef;
typedef virDomainPerfDef *virDomainPerfDefPtr;
struct _virDomainPerfDef {
    /* These options are of type enum virTristateBool */
    int events[VIR_PERF_EVENT_LAST];
};

2093 2094 2095 2096 2097 2098 2099
typedef struct _virDomainKeyWrapDef virDomainKeyWrapDef;
typedef virDomainKeyWrapDef *virDomainKeyWrapDefPtr;
struct _virDomainKeyWrapDef {
    int aes; /* enum virTristateSwitch */
    int dea; /* enum virTristateSwitch */
};

2100 2101 2102 2103 2104 2105
/*
 * Guest VM main configuration
 *
 * NB: if adding to this struct, virDomainDefCheckABIStability
 * may well need an update
 */
2106 2107
typedef struct _virDomainDef virDomainDef;
typedef virDomainDef *virDomainDefPtr;
2108
struct _virDomainDef {
2109
    virDomainVirtType virtType;
2110 2111 2112
    int id;
    unsigned char uuid[VIR_UUID_BUFLEN];
    char *name;
2113
    char *title;
2114
    char *description;
2115

2116 2117
    virDomainBlkiotune blkio;
    virDomainMemtune mem;
2118

2119
    virDomainVcpuInfoPtr vcpus;
2120
    size_t maxvcpus;
O
Osier Yang 已提交
2121
    int placement_mode;
H
Hu Tao 已提交
2122
    virBitmapPtr cpumask;
2123

2124
    unsigned int iothreads;
2125 2126
    size_t niothreadids;
    virDomainIOThreadIDDefPtr *iothreadids;
2127

2128
    virDomainCputune cputune;
2129

2130
    virDomainNumaPtr numa;
2131
    virDomainResourceDefPtr resource;
2132
    virDomainIdMapDef idmap;
2133

2134 2135 2136 2137 2138
    /* These 3 are based on virDomainLifeCycleAction enum flags */
    int onReboot;
    int onPoweroff;
    int onCrash;

2139 2140
    int onLockFailure; /* enum virDomainLockFailureAction */

2141
    virDomainPowerManagement pm;
2142

2143
    virDomainPerfDef perf;
Q
Qiaowei Ren 已提交
2144

2145 2146
    virDomainOSDef os;
    char *emulator;
2147 2148 2149
    /* These three options are of type virTristateSwitch,
     * except VIR_DOMAIN_FEATURE_CAPABILITIES that is of type
     * virDomainCapabilitiesPolicy */
2150
    int features[VIR_DOMAIN_FEATURE_LAST];
2151
    int apic_eoi;
2152
    int hyperv_features[VIR_DOMAIN_HYPERV_LAST];
2153
    int kvm_features[VIR_DOMAIN_KVM_LAST];
2154
    unsigned int hyperv_spinlocks;
2155
    virGICVersion gic_version;
2156
    char *hyperv_vendor_id;
2157

J
Ján Tomko 已提交
2158
    /* These options are of type virTristateSwitch: ON = keep, OFF = drop */
2159 2160
    int caps_features[VIR_DOMAIN_CAPS_FEATURE_LAST];

2161
    virDomainClockDef clock;
2162

2163
    size_t ngraphics;
2164
    virDomainGraphicsDefPtr *graphics;
2165

2166
    size_t ndisks;
2167 2168
    virDomainDiskDefPtr *disks;

2169
    size_t ncontrollers;
2170 2171
    virDomainControllerDefPtr *controllers;

2172
    size_t nfss;
2173 2174
    virDomainFSDefPtr *fss;

2175
    size_t nnets;
2176 2177
    virDomainNetDefPtr *nets;

2178
    size_t ninputs;
2179 2180
    virDomainInputDefPtr *inputs;

2181
    size_t nsounds;
2182 2183
    virDomainSoundDefPtr *sounds;

2184
    size_t nvideos;
2185 2186
    virDomainVideoDefPtr *videos;

2187
    size_t nhostdevs;
2188 2189
    virDomainHostdevDefPtr *hostdevs;

2190
    size_t nredirdevs;
2191 2192
    virDomainRedirdevDefPtr *redirdevs;

2193
    size_t nsmartcards;
E
Eric Blake 已提交
2194 2195
    virDomainSmartcardDefPtr *smartcards;

2196
    size_t nserials;
2197 2198
    virDomainChrDefPtr *serials;

2199
    size_t nparallels;
2200 2201
    virDomainChrDefPtr *parallels;

2202
    size_t nchannels;
2203 2204
    virDomainChrDefPtr *channels;

2205
    size_t nconsoles;
2206 2207
    virDomainChrDefPtr *consoles;

2208
    size_t nleases;
2209 2210
    virDomainLeaseDefPtr *leases;

2211
    size_t nhubs;
M
Marc-André Lureau 已提交
2212 2213
    virDomainHubDefPtr *hubs;

2214 2215 2216
    size_t nseclabels;
    virSecurityLabelDefPtr *seclabels;

2217 2218 2219
    size_t nrngs;
    virDomainRNGDefPtr *rngs;

2220 2221 2222
    size_t nshmems;
    virDomainShmemDefPtr *shmems;

2223 2224 2225
    size_t nmems;
    virDomainMemoryDefPtr *mems;

D
Dmitry Andreev 已提交
2226 2227 2228
    size_t npanics;
    virDomainPanicDefPtr *panics;

2229
    /* Only 1 */
R
Richard Jones 已提交
2230
    virDomainWatchdogDefPtr watchdog;
2231
    virDomainMemballoonDefPtr memballoon;
L
Li Zhang 已提交
2232
    virDomainNVRAMDefPtr nvram;
2233
    virDomainTPMDefPtr tpm;
2234
    virCPUDefPtr cpu;
2235
    virSysinfoDefPtr sysinfo;
2236
    virDomainRedirFilterDefPtr redirfilter;
2237 2238 2239

    void *namespaceData;
    virDomainXMLNamespace ns;
2240

2241 2242
    virDomainKeyWrapDefPtr keywrap;

2243 2244
    /* Application-specific custom metadata */
    xmlNodePtr metadata;
2245 2246
};

2247
int virDomainDefSetVcpusMax(virDomainDefPtr def, unsigned int vcpus);
2248
bool virDomainDefHasVcpusOffline(const virDomainDef *def);
2249
unsigned int virDomainDefGetVcpusMax(const virDomainDef *def);
2250
int virDomainDefSetVcpus(virDomainDefPtr def, unsigned int vcpus);
2251
unsigned int virDomainDefGetVcpus(const virDomainDef *def);
2252
virBitmapPtr virDomainDefGetOnlineVcpumap(const virDomainDef *def);
2253 2254
virDomainVcpuInfoPtr virDomainDefGetVcpu(virDomainDefPtr def, unsigned int vcpu)
    ATTRIBUTE_RETURN_CHECK;
2255

2256
unsigned long long virDomainDefGetMemoryInitial(const virDomainDef *def);
2257
void virDomainDefSetMemoryTotal(virDomainDefPtr def, unsigned long long size);
2258
unsigned long long virDomainDefGetMemoryTotal(const virDomainDef *def);
2259
bool virDomainDefHasMemoryHotplug(const virDomainDef *def);
2260

2261 2262 2263 2264 2265 2266 2267
typedef enum {
    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_AES,
    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_DEA,

    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_LAST
} virDomainKeyWrapCipherName;

2268
typedef enum {
2269 2270 2271 2272 2273
    VIR_DOMAIN_TAINT_CUSTOM_ARGV,      /* Custom ARGV passthrough from XML */
    VIR_DOMAIN_TAINT_CUSTOM_MONITOR,   /* Custom monitor commands issued */
    VIR_DOMAIN_TAINT_HIGH_PRIVILEGES,  /* Running with undesirably high privileges */
    VIR_DOMAIN_TAINT_SHELL_SCRIPTS,    /* Network configuration using opaque shell scripts */
    VIR_DOMAIN_TAINT_DISK_PROBING,     /* Relying on potentially unsafe disk format probing */
2274
    VIR_DOMAIN_TAINT_EXTERNAL_LAUNCH,  /* Externally launched guest domain */
2275
    VIR_DOMAIN_TAINT_HOST_CPU,         /* Host CPU passthrough in use */
2276
    VIR_DOMAIN_TAINT_HOOK,             /* Domain (possibly) changed via hook script */
2277
    VIR_DOMAIN_TAINT_CDROM_PASSTHROUGH,/* CDROM passthrough */
Y
Yuri Chornoivan 已提交
2278
    VIR_DOMAIN_TAINT_CUSTOM_DTB,       /* Custom device tree blob was specified */
2279 2280

    VIR_DOMAIN_TAINT_LAST
2281
} virDomainTaintFlags;
2282

2283
/* Guest VM runtime state */
J
Jiri Denemark 已提交
2284 2285 2286 2287 2288 2289
typedef struct _virDomainStateReason virDomainStateReason;
struct _virDomainStateReason {
    int state;
    int reason;
};

2290 2291 2292
typedef struct _virDomainObj virDomainObj;
typedef virDomainObj *virDomainObjPtr;
struct _virDomainObj {
2293
    virObjectLockable parent;
2294
    virCond cond;
2295

2296
    pid_t pid;
J
Jiri Denemark 已提交
2297
    virDomainStateReason state;
2298 2299 2300

    unsigned int autostart : 1;
    unsigned int persistent : 1;
2301
    unsigned int updated : 1;
2302
    unsigned int removing : 1;
2303 2304 2305

    virDomainDefPtr def; /* The current definition */
    virDomainDefPtr newDef; /* New definition to activate at shutdown */
2306

2307
    virDomainSnapshotObjListPtr snapshots;
C
Chris Lalancette 已提交
2308 2309
    virDomainSnapshotObjPtr current_snapshot;

2310 2311
    bool hasManagedSave;

2312 2313
    void *privateData;
    void (*privateDataFreeFunc)(void *);
2314 2315

    int taint;
2316 2317 2318

    unsigned long long original_memlock; /* Original RLIMIT_MEMLOCK, zero if no
                                          * restore will be required later */
2319 2320
};

2321 2322
typedef bool (*virDomainObjListACLFilter)(virConnectPtr conn,
                                          virDomainDefPtr def);
2323

2324

2325 2326
typedef enum {
    VIR_DOMAIN_DEF_FEATURE_WIDE_SCSI = (1 << 0),
2327
    VIR_DOMAIN_DEF_FEATURE_MEMORY_HOTPLUG = (1 << 1),
2328
    VIR_DOMAIN_DEF_FEATURE_OFFLINE_VCPUPIN = (1 << 2),
2329
    VIR_DOMAIN_DEF_FEATURE_NAME_SLASH = (1 << 3),
2330 2331 2332
} virDomainDefFeatures;


2333 2334
/* This structure holds various callbacks and data needed
 * while parsing and creating domain XMLs */
2335 2336
typedef struct _virDomainXMLOption virDomainXMLOption;
typedef virDomainXMLOption *virDomainXMLOptionPtr;
2337

2338 2339
/* Called once after everything else has been parsed, for adjusting
 * overall domain defaults.  */
2340 2341
typedef int (*virDomainDefPostParseCallback)(virDomainDefPtr def,
                                             virCapsPtr caps,
2342
                                             unsigned int parseFlags,
2343
                                             void *opaque);
2344 2345
/* Called once per device, for adjusting per-device settings while
 * leaving the overall domain otherwise unchanged.  */
2346
typedef int (*virDomainDeviceDefPostParseCallback)(virDomainDeviceDefPtr dev,
2347
                                                   const virDomainDef *def,
2348
                                                   virCapsPtr caps,
2349
                                                   unsigned int parseFlags,
2350
                                                   void *opaque);
2351 2352 2353 2354 2355 2356 2357
/* Drive callback for assigning device addresses, called at the end
 * of parsing, after all defaults and implicit devices have been added.  */
typedef int (*virDomainDefAssignAddressesCallback)(virDomainDef *def,
                                                   virCapsPtr caps,
                                                   unsigned int parseFlags,
                                                   void *opaque);

2358 2359 2360 2361 2362 2363
/* Called in appropriate places where the domain conf parser can return failure
 * for configurations that were previously accepted. This shall not modify the
 * config. */
typedef int (*virDomainDefValidateCallback)(const virDomainDef *def,
                                            virCapsPtr caps,
                                            void *opaque);
2364

2365 2366 2367 2368 2369 2370
/* Called once per device, for adjusting per-device settings while
 * leaving the overall domain otherwise unchanged.  */
typedef int (*virDomainDeviceDefValidateCallback)(const virDomainDeviceDef *dev,
                                                  const virDomainDef *def,
                                                  void *opaque);

2371 2372 2373
typedef struct _virDomainDefParserConfig virDomainDefParserConfig;
typedef virDomainDefParserConfig *virDomainDefParserConfigPtr;
struct _virDomainDefParserConfig {
2374
    /* driver domain definition callbacks */
2375 2376
    virDomainDefPostParseCallback domainPostParseCallback;
    virDomainDeviceDefPostParseCallback devicesPostParseCallback;
2377
    virDomainDefAssignAddressesCallback assignAddressesCallback;
2378

2379 2380
    /* validation callbacks */
    virDomainDefValidateCallback domainValidateCallback;
2381
    virDomainDeviceDefValidateCallback deviceValidateCallback;
2382

2383
    /* private data for the callbacks */
2384 2385
    void *priv;
    virFreeCallback privFree;
2386 2387

    /* data */
2388
    unsigned int features; /* virDomainDefFeatures */
2389
    unsigned char macPrefix[VIR_MAC_PREFIX_BUFLEN];
2390 2391
};

2392 2393 2394 2395 2396 2397 2398 2399 2400
typedef void *(*virDomainXMLPrivateDataAllocFunc)(void);
typedef void (*virDomainXMLPrivateDataFreeFunc)(void *);
typedef virObjectPtr (*virDomainXMLPrivateDataNewFunc)(void);
typedef int (*virDomainXMLPrivateDataFormatFunc)(virBufferPtr,
                                                 virDomainObjPtr);
typedef int (*virDomainXMLPrivateDataParseFunc)(xmlXPathContextPtr,
                                                virDomainObjPtr,
                                                virDomainDefParserConfigPtr);

2401 2402 2403 2404 2405
typedef struct _virDomainXMLPrivateDataCallbacks virDomainXMLPrivateDataCallbacks;
typedef virDomainXMLPrivateDataCallbacks *virDomainXMLPrivateDataCallbacksPtr;
struct _virDomainXMLPrivateDataCallbacks {
    virDomainXMLPrivateDataAllocFunc  alloc;
    virDomainXMLPrivateDataFreeFunc   free;
2406
    virDomainXMLPrivateDataNewFunc    diskNew;
2407
    virDomainXMLPrivateDataNewFunc    hostdevNew;
2408 2409 2410 2411
    virDomainXMLPrivateDataFormatFunc format;
    virDomainXMLPrivateDataParseFunc  parse;
};

2412 2413 2414
virDomainXMLOptionPtr virDomainXMLOptionNew(virDomainDefParserConfigPtr config,
                                            virDomainXMLPrivateDataCallbacksPtr priv,
                                            virDomainXMLNamespacePtr xmlns);
2415

2416 2417
void virDomainNetGenerateMAC(virDomainXMLOptionPtr xmlopt, virMacAddrPtr mac);

2418
virDomainXMLNamespacePtr
2419
virDomainXMLOptionGetNamespace(virDomainXMLOptionPtr xmlopt)
2420 2421
    ATTRIBUTE_NONNULL(1);

2422 2423 2424
int
virDomainDefPostParse(virDomainDefPtr def,
                      virCapsPtr caps,
2425
                      unsigned int parseFlags,
2426 2427
                      virDomainXMLOptionPtr xmlopt);

2428
int virDomainDefValidate(virDomainDefPtr def,
2429 2430 2431 2432
                         virCapsPtr caps,
                         unsigned int parseFlags,
                         virDomainXMLOptionPtr xmlopt);

2433
static inline bool
D
Daniel P. Berrange 已提交
2434
virDomainObjIsActive(virDomainObjPtr dom)
2435 2436 2437 2438
{
    return dom->def->id != -1;
}

2439
virDomainObjPtr virDomainObjNew(virDomainXMLOptionPtr caps)
2440
    ATTRIBUTE_NONNULL(1);
2441

M
Michal Privoznik 已提交
2442 2443
void virDomainObjEndAPI(virDomainObjPtr *vm);

2444
bool virDomainObjTaint(virDomainObjPtr obj,
2445
                       virDomainTaintFlags taint);
2446

2447 2448 2449 2450
void virDomainObjBroadcast(virDomainObjPtr vm);
int virDomainObjWait(virDomainObjPtr vm);
int virDomainObjWaitUntil(virDomainObjPtr vm,
                          unsigned long long whenms);
2451

H
Hu Tao 已提交
2452
void virDomainPanicDefFree(virDomainPanicDefPtr panic);
2453
void virDomainResourceDefFree(virDomainResourceDefPtr resource);
2454 2455
void virDomainGraphicsDefFree(virDomainGraphicsDefPtr def);
void virDomainInputDefFree(virDomainInputDefPtr def);
2456
virDomainDiskDefPtr virDomainDiskDefNew(virDomainXMLOptionPtr xmlopt);
2457
void virDomainDiskDefFree(virDomainDiskDefPtr def);
2458
void virDomainLeaseDefFree(virDomainLeaseDefPtr def);
2459 2460
int virDomainDiskGetType(virDomainDiskDefPtr def);
void virDomainDiskSetType(virDomainDiskDefPtr def, int type);
2461
const char *virDomainDiskGetSource(virDomainDiskDef const *def);
2462 2463 2464 2465 2466 2467 2468
int virDomainDiskSetSource(virDomainDiskDefPtr def, const char *src)
    ATTRIBUTE_RETURN_CHECK;
const char *virDomainDiskGetDriver(virDomainDiskDefPtr def);
int virDomainDiskSetDriver(virDomainDiskDefPtr def, const char *name)
    ATTRIBUTE_RETURN_CHECK;
int virDomainDiskGetFormat(virDomainDiskDefPtr def);
void virDomainDiskSetFormat(virDomainDiskDefPtr def, int format);
2469
int virDomainDeviceFindControllerModel(const virDomainDef *def,
H
Han Cheng 已提交
2470 2471
                                       virDomainDeviceInfoPtr info,
                                       int controllerType);
2472 2473 2474
virDomainDiskDefPtr virDomainDiskFindByBusAndDst(virDomainDefPtr def,
                                                 int bus,
                                                 char *dst);
2475
void virDomainControllerDefFree(virDomainControllerDefPtr def);
2476 2477
virDomainControllerDefPtr
virDomainControllerDefNew(virDomainControllerType type);
2478
void virDomainFSDefFree(virDomainFSDefPtr def);
2479
void virDomainActualNetDefFree(virDomainActualNetDefPtr def);
2480
void virDomainNetDefClear(virDomainNetDefPtr def);
2481
void virDomainNetDefFree(virDomainNetDefPtr def);
E
Eric Blake 已提交
2482
void virDomainSmartcardDefFree(virDomainSmartcardDefPtr def);
2483
void virDomainChrDefFree(virDomainChrDefPtr def);
2484
void virDomainChrSourceDefFree(virDomainChrSourceDefPtr def);
2485 2486
int virDomainChrSourceDefCopy(virDomainChrSourceDefPtr src,
                              virDomainChrSourceDefPtr dest);
2487
void virDomainSoundCodecDefFree(virDomainSoundCodecDefPtr def);
2488
void virDomainSoundDefFree(virDomainSoundDefPtr def);
2489
void virDomainMemballoonDefFree(virDomainMemballoonDefPtr def);
L
Li Zhang 已提交
2490
void virDomainNVRAMDefFree(virDomainNVRAMDefPtr def);
R
Richard Jones 已提交
2491
void virDomainWatchdogDefFree(virDomainWatchdogDefPtr def);
2492
void virDomainVideoDefFree(virDomainVideoDefPtr def);
2493
virDomainHostdevDefPtr virDomainHostdevDefAlloc(virDomainXMLOptionPtr xmlopt);
2494
void virDomainHostdevDefClear(virDomainHostdevDefPtr def);
2495
void virDomainHostdevDefFree(virDomainHostdevDefPtr def);
M
Marc-André Lureau 已提交
2496
void virDomainHubDefFree(virDomainHubDefPtr def);
2497
void virDomainRedirdevDefFree(virDomainRedirdevDefPtr def);
2498
void virDomainRedirFilterDefFree(virDomainRedirFilterDefPtr def);
2499
void virDomainShmemDefFree(virDomainShmemDefPtr def);
2500
void virDomainDeviceDefFree(virDomainDeviceDefPtr def);
2501
virDomainDeviceDefPtr virDomainDeviceDefCopy(virDomainDeviceDefPtr src,
2502
                                             const virDomainDef *def,
2503 2504
                                             virCapsPtr caps,
                                             virDomainXMLOptionPtr xmlopt);
2505 2506
int virDomainDeviceAddressIsValid(virDomainDeviceInfoPtr info,
                                  int type);
2507
virDomainDeviceInfoPtr virDomainDeviceGetInfo(virDomainDeviceDefPtr device);
2508 2509
int virDomainDeviceInfoCopy(virDomainDeviceInfoPtr dst,
                            virDomainDeviceInfoPtr src);
2510
void virDomainDeviceInfoClear(virDomainDeviceInfoPtr info);
2511
void virDomainDefClearPCIAddresses(virDomainDefPtr def);
2512
void virDomainDefClearCCWAddresses(virDomainDefPtr def);
D
Daniel P. Berrange 已提交
2513
void virDomainDefClearDeviceAliases(virDomainDefPtr def);
2514
void virDomainTPMDefFree(virDomainTPMDefPtr def);
2515

2516
typedef int (*virDomainDeviceInfoCallback)(virDomainDefPtr def,
2517 2518
                                           virDomainDeviceDefPtr dev,
                                           virDomainDeviceInfoPtr info,
2519 2520 2521 2522 2523 2524
                                           void *opaque);

int virDomainDeviceInfoIterate(virDomainDefPtr def,
                               virDomainDeviceInfoCallback cb,
                               void *opaque);

2525 2526 2527 2528
bool virDomainDefHasDeviceAddress(virDomainDefPtr def,
                                  virDomainDeviceInfoPtr info)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;

2529 2530
void virDomainDefFree(virDomainDefPtr vm);

M
Michal Novotny 已提交
2531 2532
virDomainChrDefPtr virDomainChrDefNew(void);

2533 2534 2535 2536
virDomainDefPtr virDomainDefNew(void);
virDomainDefPtr virDomainDefNewFull(const char *name,
                                    const unsigned char *uuid,
                                    int id);
2537

2538
void virDomainObjAssignDef(virDomainObjPtr domain,
2539
                           virDomainDefPtr def,
2540 2541
                           bool live,
                           virDomainDefPtr *oldDef);
2542
int virDomainObjSetDefTransient(virCapsPtr caps,
2543
                                virDomainXMLOptionPtr xmlopt,
2544
                                virDomainObjPtr domain);
2545 2546
virDomainDefPtr
virDomainObjGetPersistentDef(virCapsPtr caps,
2547
                             virDomainXMLOptionPtr xmlopt,
2548
                             virDomainObjPtr domain);
2549 2550 2551 2552 2553 2554 2555 2556

int virDomainObjUpdateModificationImpact(virDomainObjPtr vm,
                                         unsigned int *flags);

int virDomainObjGetDefs(virDomainObjPtr vm,
                        unsigned int flags,
                        virDomainDefPtr *liveDef,
                        virDomainDefPtr *persDef);
2557
virDomainDefPtr virDomainObjGetOneDef(virDomainObjPtr vm, unsigned int flags);
2558 2559 2560

int
virDomainLiveConfigHelperMethod(virCapsPtr caps,
2561
                                virDomainXMLOptionPtr xmlopt,
2562 2563 2564 2565
                                virDomainObjPtr dom,
                                unsigned int *flags,
                                virDomainDefPtr *persistentDef);

2566 2567 2568 2569 2570 2571 2572
virDomainDefPtr virDomainDefCopy(virDomainDefPtr src,
                                 virCapsPtr caps,
                                 virDomainXMLOptionPtr xmlopt,
                                 bool migratable);
virDomainDefPtr virDomainObjCopyPersistentDef(virDomainObjPtr dom,
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt);
2573

2574 2575 2576
typedef enum {
    /* parse internal domain status information */
    VIR_DOMAIN_DEF_PARSE_STATUS          = 1 << 0,
2577 2578 2579 2580
    /* Parse only parts of the XML that would be present in an inactive libvirt
     * XML. Note that the flag does not imply that ABI incompatible
     * transformations can be used, since it's used to strip runtime info when
     * restoring save images/migration. */
2581 2582 2583 2584 2585
    VIR_DOMAIN_DEF_PARSE_INACTIVE        = 1 << 1,
    /* parse <actual> element */
    VIR_DOMAIN_DEF_PARSE_ACTUAL_NET      = 1 << 2,
    /* parse original states of host PCI device */
    VIR_DOMAIN_DEF_PARSE_PCI_ORIG_STATES = 1 << 3,
2586
    /* internal flag passed to device info sub-parser to allow using <rom> */
2587
    VIR_DOMAIN_DEF_PARSE_ALLOW_ROM       = 1 << 4,
2588
    /* internal flag passed to device info sub-parser to allow specifying boot order */
2589 2590
    VIR_DOMAIN_DEF_PARSE_ALLOW_BOOT      = 1 << 5,
    /* parse only source half of <disk> */
2591
    VIR_DOMAIN_DEF_PARSE_DISK_SOURCE     = 1 << 6,
2592
    /* perform RNG schema validation on the passed XML document */
2593
    VIR_DOMAIN_DEF_PARSE_VALIDATE_SCHEMA = 1 << 7,
2594
    /* don't validate os.type and arch against capabilities. Prevents
2595
     * VMs from disappearing when qemu is removed and libvirtd is restarted */
2596
    VIR_DOMAIN_DEF_PARSE_SKIP_OSTYPE_CHECKS = 1 << 8,
2597 2598
    /* allow updates in post parse callback that would break ABI otherwise */
    VIR_DOMAIN_DEF_PARSE_ABI_UPDATE = 1 << 9,
2599 2600
    /* skip definition validation checks meant to be executed on define time only */
    VIR_DOMAIN_DEF_PARSE_SKIP_VALIDATE = 1 << 10,
2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618
} virDomainDefParseFlags;

typedef enum {
    VIR_DOMAIN_DEF_FORMAT_SECURE          = 1 << 0,
    VIR_DOMAIN_DEF_FORMAT_INACTIVE        = 1 << 1,
    VIR_DOMAIN_DEF_FORMAT_UPDATE_CPU      = 1 << 2,
    VIR_DOMAIN_DEF_FORMAT_MIGRATABLE      = 1 << 3,
    /* format internal domain status information */
    VIR_DOMAIN_DEF_FORMAT_STATUS          = 1 << 4,
    /* format <actual> element */
    VIR_DOMAIN_DEF_FORMAT_ACTUAL_NET      = 1 << 5,
    /* format original states of host PCI device */
    VIR_DOMAIN_DEF_FORMAT_PCI_ORIG_STATES = 1 << 6,
    VIR_DOMAIN_DEF_FORMAT_ALLOW_ROM       = 1 << 7,
    VIR_DOMAIN_DEF_FORMAT_ALLOW_BOOT      = 1 << 8,
    VIR_DOMAIN_DEF_FORMAT_CLOCK_ADJUST    = 1 << 9,
} virDomainDefFormatFlags;

2619
virDomainDeviceDefPtr virDomainDeviceDefParse(const char *xmlStr,
2620
                                              const virDomainDef *def,
2621 2622
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2623
                                              unsigned int flags);
2624 2625 2626 2627
virStorageSourcePtr virDomainDiskDefSourceParse(const char *xmlStr,
                                                const virDomainDef *def,
                                                virDomainXMLOptionPtr xmlopt,
                                                unsigned int flags);
2628 2629
virDomainDefPtr virDomainDefParseString(const char *xmlStr,
                                        virCapsPtr caps,
2630
                                        virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2631
                                        unsigned int flags);
2632 2633
virDomainDefPtr virDomainDefParseFile(const char *filename,
                                      virCapsPtr caps,
2634
                                      virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2635
                                      unsigned int flags);
2636
virDomainDefPtr virDomainDefParseNode(xmlDocPtr doc,
2637
                                      xmlNodePtr root,
2638 2639
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2640
                                      unsigned int flags);
2641 2642 2643 2644 2645
virDomainObjPtr virDomainObjParseNode(xmlDocPtr xml,
                                      xmlNodePtr root,
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
                                      unsigned int flags);
2646 2647 2648 2649
virDomainObjPtr virDomainObjParseFile(const char *filename,
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
                                      unsigned int flags);
2650

2651 2652 2653
bool virDomainDefCheckABIStability(virDomainDefPtr src,
                                   virDomainDefPtr dst);

2654
int virDomainDefAddImplicitDevices(virDomainDefPtr def);
2655

2656
virDomainIOThreadIDDefPtr virDomainIOThreadIDFind(const virDomainDef *def,
2657 2658 2659 2660 2661
                                                  unsigned int iothread_id);
virDomainIOThreadIDDefPtr virDomainIOThreadIDAdd(virDomainDefPtr def,
                                                 unsigned int iothread_id);
void virDomainIOThreadIDDel(virDomainDefPtr def, unsigned int iothread_id);

2662 2663
unsigned int virDomainDefFormatConvertXMLFlags(unsigned int flags);

2664
char *virDomainDefFormat(virDomainDefPtr def,
2665
                         virCapsPtr caps,
L
Laine Stump 已提交
2666
                         unsigned int flags);
2667 2668
char *virDomainObjFormat(virDomainXMLOptionPtr xmlopt,
                         virDomainObjPtr obj,
2669
                         virCapsPtr caps,
2670
                         unsigned int flags);
2671
int virDomainDefFormatInternal(virDomainDefPtr def,
2672
                               virCapsPtr caps,
2673 2674
                               unsigned int flags,
                               virBufferPtr buf);
2675

2676 2677 2678 2679
int virDomainDiskSourceFormat(virBufferPtr buf,
                              virStorageSourcePtr src,
                              int policy,
                              unsigned int flags);
2680

2681 2682
int virDomainNetDefFormat(virBufferPtr buf,
                          virDomainNetDefPtr def,
2683
                          char *prefix,
2684 2685
                          unsigned int flags);

2686 2687 2688 2689 2690 2691
typedef enum {
    VIR_DOMAIN_DEVICE_ACTION_ATTACH,
    VIR_DOMAIN_DEVICE_ACTION_DETACH,
    VIR_DOMAIN_DEVICE_ACTION_UPDATE,
} virDomainDeviceAction;

2692
int virDomainDefCompatibleDevice(virDomainDefPtr def,
2693 2694
                                 virDomainDeviceDefPtr dev,
                                 virDomainDeviceAction action);
2695

2696 2697
void virDomainRNGDefFree(virDomainRNGDefPtr def);

2698
int virDomainDiskIndexByAddress(virDomainDefPtr def,
2699
                                virPCIDeviceAddressPtr pci_controller,
2700 2701
                                unsigned int bus, unsigned int target,
                                unsigned int unit);
2702
virDomainDiskDefPtr virDomainDiskByAddress(virDomainDefPtr def,
2703
                                           virPCIDeviceAddressPtr pci_controller,
2704 2705 2706
                                           unsigned int bus,
                                           unsigned int target,
                                           unsigned int unit);
2707 2708
int virDomainDiskIndexByName(virDomainDefPtr def, const char *name,
                             bool allow_ambiguous);
2709 2710 2711
virDomainDiskDefPtr virDomainDiskByName(virDomainDefPtr def,
                                        const char *name,
                                        bool allow_ambiguous);
2712
const char *virDomainDiskPathByName(virDomainDefPtr, const char *name);
2713
int virDomainDiskInsert(virDomainDefPtr def,
2714 2715
                        virDomainDiskDefPtr disk)
    ATTRIBUTE_RETURN_CHECK;
2716 2717
void virDomainDiskInsertPreAlloced(virDomainDefPtr def,
                                   virDomainDiskDefPtr disk);
2718
int virDomainDiskDefAssignAddress(virDomainXMLOptionPtr xmlopt,
2719 2720
                                  virDomainDiskDefPtr def,
                                  const virDomainDef *vmdef);
2721

2722 2723 2724 2725
virDomainDiskDefPtr
virDomainDiskRemove(virDomainDefPtr def, size_t i);
virDomainDiskDefPtr
virDomainDiskRemoveByName(virDomainDefPtr def, const char *name);
2726
int virDomainDiskSourceParse(xmlNodePtr node,
2727
                             xmlXPathContextPtr ctxt,
2728
                             virStorageSourcePtr src);
2729

2730 2731
int virDomainNetFindIdx(virDomainDefPtr def, virDomainNetDefPtr net);
virDomainNetDefPtr virDomainNetFind(virDomainDefPtr def, const char *device);
2732
bool virDomainHasNet(virDomainDefPtr def, virDomainNetDefPtr net);
2733
int virDomainNetInsert(virDomainDefPtr def, virDomainNetDefPtr net);
2734
virDomainNetDefPtr virDomainNetRemove(virDomainDefPtr def, size_t i);
2735
void virDomainNetRemoveHostdev(virDomainDefPtr def, virDomainNetDefPtr net);
2736

L
Laine Stump 已提交
2737
int virDomainHostdevInsert(virDomainDefPtr def, virDomainHostdevDefPtr hostdev);
2738 2739
virDomainHostdevDefPtr
virDomainHostdevRemove(virDomainDefPtr def, size_t i);
L
Laine Stump 已提交
2740 2741 2742
int virDomainHostdevFind(virDomainDefPtr def, virDomainHostdevDefPtr match,
                         virDomainHostdevDefPtr *found);

2743 2744
virDomainGraphicsListenDefPtr
virDomainGraphicsGetListen(virDomainGraphicsDefPtr def, size_t i);
2745 2746
int virDomainGraphicsListenAppendAddress(virDomainGraphicsDefPtr def,
                                         const char *address)
2747
            ATTRIBUTE_NONNULL(1);
2748 2749 2750
int virDomainGraphicsListenAppendSocket(virDomainGraphicsDefPtr def,
                                        const char *socket)
            ATTRIBUTE_NONNULL(1);
2751

2752
int virDomainNetGetActualType(virDomainNetDefPtr iface);
2753
const char *virDomainNetGetActualBridgeName(virDomainNetDefPtr iface);
2754
int virDomainNetGetActualBridgeMACTableManager(virDomainNetDefPtr iface);
2755
const char *virDomainNetGetActualDirectDev(virDomainNetDefPtr iface);
2756
int virDomainNetGetActualDirectMode(virDomainNetDefPtr iface);
2757
virDomainHostdevDefPtr virDomainNetGetActualHostdev(virDomainNetDefPtr iface);
2758
virNetDevVPortProfilePtr
2759
virDomainNetGetActualVirtPortProfile(virDomainNetDefPtr iface);
2760
virNetDevBandwidthPtr
2761
virDomainNetGetActualBandwidth(virDomainNetDefPtr iface);
2762
virNetDevVlanPtr virDomainNetGetActualVlan(virDomainNetDefPtr iface);
2763
bool virDomainNetGetActualTrustGuestRxFilters(virDomainNetDefPtr iface);
2764
int virDomainNetAppendIPAddress(virDomainNetDefPtr def,
2765 2766 2767
                                const char *address,
                                int family,
                                unsigned int prefix);
2768

2769
int virDomainControllerInsert(virDomainDefPtr def,
2770 2771
                              virDomainControllerDefPtr controller)
    ATTRIBUTE_RETURN_CHECK;
2772 2773
void virDomainControllerInsertPreAlloced(virDomainDefPtr def,
                                         virDomainControllerDefPtr controller);
2774
int virDomainControllerFind(const virDomainDef *def, int type, int idx);
2775
int virDomainControllerFindByType(virDomainDefPtr def, int type);
2776
int virDomainControllerFindByPCIAddress(virDomainDefPtr def,
2777
                                        virPCIDeviceAddressPtr addr);
2778
int virDomainControllerFindUnusedIndex(virDomainDef const *def, int type);
2779
virDomainControllerDefPtr virDomainControllerRemove(virDomainDefPtr def, size_t i);
2780
const char *virDomainControllerAliasFind(const virDomainDef *def,
2781 2782
                                         int type, int idx)
    ATTRIBUTE_NONNULL(1);
2783 2784 2785 2786 2787

int virDomainLeaseIndex(virDomainDefPtr def,
                        virDomainLeaseDefPtr lease);
int virDomainLeaseInsert(virDomainDefPtr def,
                         virDomainLeaseDefPtr lease);
2788 2789
int virDomainLeaseInsertPreAlloc(virDomainDefPtr def)
    ATTRIBUTE_RETURN_CHECK;
2790 2791
void virDomainLeaseInsertPreAlloced(virDomainDefPtr def,
                                    virDomainLeaseDefPtr lease);
2792 2793 2794 2795 2796
virDomainLeaseDefPtr
virDomainLeaseRemoveAt(virDomainDefPtr def, size_t i);
virDomainLeaseDefPtr
virDomainLeaseRemove(virDomainDefPtr def,
                     virDomainLeaseDefPtr lease);
2797

2798
void
2799
virDomainChrGetDomainPtrs(const virDomainDef *vmdef,
2800
                          virDomainChrDeviceType type,
2801 2802 2803
                          const virDomainChrDef ***arrPtr,
                          size_t *cntPtr)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(3) ATTRIBUTE_NONNULL(4);
2804 2805 2806
virDomainChrDefPtr
virDomainChrFind(virDomainDefPtr def,
                 virDomainChrDefPtr target);
2807 2808 2809
bool
virDomainChrEquals(virDomainChrDefPtr src,
                   virDomainChrDefPtr tgt);
2810
int
2811 2812 2813 2814 2815
virDomainChrPreAlloc(virDomainDefPtr vmdef,
                     virDomainChrDefPtr chr);
void
virDomainChrInsertPreAlloced(virDomainDefPtr vmdef,
                             virDomainChrDefPtr chr);
2816 2817 2818 2819
virDomainChrDefPtr
virDomainChrRemove(virDomainDefPtr vmdef,
                   virDomainChrDefPtr chr);

2820 2821 2822
ssize_t virDomainRNGFind(virDomainDefPtr def, virDomainRNGDefPtr rng);
virDomainRNGDefPtr virDomainRNGRemove(virDomainDefPtr def, size_t idx);

2823 2824 2825 2826
ssize_t virDomainRedirdevDefFind(virDomainDefPtr def,
                                 virDomainRedirdevDefPtr redirdev);
virDomainRedirdevDefPtr virDomainRedirdevDefRemove(virDomainDefPtr def, size_t idx);

2827
int virDomainSaveXML(const char *configDir,
2828 2829 2830
                     virDomainDefPtr def,
                     const char *xml);

2831
int virDomainSaveConfig(const char *configDir,
2832
                        virCapsPtr caps,
2833
                        virDomainDefPtr def);
2834
int virDomainSaveStatus(virDomainXMLOptionPtr xmlopt,
2835
                        const char *statusDir,
2836 2837
                        virDomainObjPtr obj,
                        virCapsPtr caps) ATTRIBUTE_RETURN_CHECK;
2838

2839 2840 2841 2842
typedef void (*virDomainLoadConfigNotify)(virDomainObjPtr dom,
                                          int newDomain,
                                          void *opaque);

2843
int virDomainDeleteConfig(const char *configDir,
2844
                          const char *autostartDir,
2845 2846
                          virDomainObjPtr dom);

2847
char *virDomainConfigFile(const char *dir,
2848 2849
                          const char *name);

2850 2851 2852 2853
int virDiskNameToBusDeviceIndex(virDomainDiskDefPtr disk,
                                int *busIdx,
                                int *devIdx);

2854
virDomainFSDefPtr virDomainGetFilesystemForTarget(virDomainDefPtr def,
2855
                                                  const char *target);
2856
int virDomainFSInsert(virDomainDefPtr def, virDomainFSDefPtr fs);
2857
int virDomainFSIndexByName(virDomainDefPtr def, const char *name);
2858 2859
virDomainFSDefPtr virDomainFSRemove(virDomainDefPtr def, size_t i);

2860
int virDomainVideoDefaultType(const virDomainDef *def);
2861 2862
unsigned int virDomainVideoDefaultRAM(const virDomainDef *def,
                                      const virDomainVideoType type);
2863

E
Eric Blake 已提交
2864 2865 2866 2867 2868 2869 2870 2871 2872
typedef int (*virDomainSmartcardDefIterator)(virDomainDefPtr def,
                                             virDomainSmartcardDefPtr dev,
                                             void *opaque);

int virDomainSmartcardDefForeach(virDomainDefPtr def,
                                 bool abortOnError,
                                 virDomainSmartcardDefIterator iter,
                                 void *opaque);

2873 2874 2875 2876 2877 2878 2879 2880 2881
typedef int (*virDomainChrDefIterator)(virDomainDefPtr def,
                                       virDomainChrDefPtr dev,
                                       void *opaque);

int virDomainChrDefForeach(virDomainDefPtr def,
                           bool abortOnError,
                           virDomainChrDefIterator iter,
                           void *opaque);

2882 2883 2884 2885 2886
typedef int (*virDomainDiskDefPathIterator)(virDomainDiskDefPtr disk,
                                            const char *path,
                                            size_t depth,
                                            void *opaque);

2887 2888 2889 2890 2891 2892 2893
typedef int (*virDomainUSBDeviceDefIterator)(virDomainDeviceInfoPtr info,
                                             void *opaque);
int virDomainUSBDeviceDefForeach(virDomainDefPtr def,
                                 virDomainUSBDeviceDefIterator iter,
                                 void *opaque,
                                 bool skipHubs);

2894 2895 2896 2897 2898
int virDomainDiskDefForeachPath(virDomainDiskDefPtr disk,
                                bool ignoreOpenFailure,
                                virDomainDiskDefPathIterator iter,
                                void *opaque);

J
Jiri Denemark 已提交
2899 2900 2901 2902 2903 2904 2905
void
virDomainObjSetState(virDomainObjPtr obj, virDomainState state, int reason)
        ATTRIBUTE_NONNULL(1);
virDomainState
virDomainObjGetState(virDomainObjPtr obj, int *reason)
        ATTRIBUTE_NONNULL(1);

2906 2907 2908
virSecurityLabelDefPtr
virDomainDefGetSecurityLabelDef(virDomainDefPtr def, const char *model);

2909 2910 2911
virSecurityDeviceLabelDefPtr
virDomainChrDefGetSecurityLabelDef(virDomainChrDefPtr def, const char *model);

2912 2913
typedef const char* (*virEventActionToStringFunc)(int type);
typedef int (*virEventActionFromStringFunc)(const char *type);
2914

2915 2916 2917 2918 2919 2920 2921 2922 2923 2924
int virDomainMemoryInsert(virDomainDefPtr def, virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;
virDomainMemoryDefPtr virDomainMemoryRemove(virDomainDefPtr def, int idx)
    ATTRIBUTE_NONNULL(1);
int virDomainMemoryFindByDef(virDomainDefPtr def, virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;
int virDomainMemoryFindInactiveByDef(virDomainDefPtr def,
                                     virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;

2925
VIR_ENUM_DECL(virDomainTaint)
2926 2927 2928
VIR_ENUM_DECL(virDomainVirt)
VIR_ENUM_DECL(virDomainBoot)
VIR_ENUM_DECL(virDomainFeature)
2929 2930
VIR_ENUM_DECL(virDomainCapabilitiesPolicy)
VIR_ENUM_DECL(virDomainCapsFeature)
2931
VIR_ENUM_DECL(virDomainLifecycle)
2932
VIR_ENUM_DECL(virDomainLifecycleCrash)
2933
VIR_ENUM_DECL(virDomainDevice)
2934
VIR_ENUM_DECL(virDomainDeviceAddress)
2935
VIR_ENUM_DECL(virDomainDiskDevice)
J
J.B. Joret 已提交
2936
VIR_ENUM_DECL(virDomainDiskGeometryTrans)
2937
VIR_ENUM_DECL(virDomainDiskBus)
2938
VIR_ENUM_DECL(virDomainDiskCache)
2939
VIR_ENUM_DECL(virDomainDiskErrorPolicy)
M
Matthias Dahl 已提交
2940
VIR_ENUM_DECL(virDomainDiskIo)
2941
VIR_ENUM_DECL(virDomainDeviceSGIO)
2942
VIR_ENUM_DECL(virDomainDiskTray)
O
Osier Yang 已提交
2943
VIR_ENUM_DECL(virDomainDiskDiscard)
2944
VIR_ENUM_DECL(virDomainDiskDetectZeroes)
2945
VIR_ENUM_DECL(virDomainDiskMirrorState)
2946
VIR_ENUM_DECL(virDomainController)
J
Ján Tomko 已提交
2947
VIR_ENUM_DECL(virDomainControllerModelPCI)
2948
VIR_ENUM_DECL(virDomainControllerPCIModelName)
2949
VIR_ENUM_DECL(virDomainControllerModelSCSI)
M
Marc-André Lureau 已提交
2950
VIR_ENUM_DECL(virDomainControllerModelUSB)
2951
VIR_ENUM_DECL(virDomainFS)
2952
VIR_ENUM_DECL(virDomainFSDriver)
2953
VIR_ENUM_DECL(virDomainFSAccessMode)
2954
VIR_ENUM_DECL(virDomainFSWrpolicy)
2955
VIR_ENUM_DECL(virDomainNet)
2956
VIR_ENUM_DECL(virDomainNetBackend)
2957
VIR_ENUM_DECL(virDomainNetVirtioTxMode)
2958
VIR_ENUM_DECL(virDomainNetInterfaceLinkState)
2959
VIR_ENUM_DECL(virDomainChrDevice)
2960
VIR_ENUM_DECL(virDomainChrChannelTarget)
2961
VIR_ENUM_DECL(virDomainChrConsoleTarget)
G
Guannan Ren 已提交
2962
VIR_ENUM_DECL(virDomainChrSerialTarget)
E
Eric Blake 已提交
2963
VIR_ENUM_DECL(virDomainSmartcard)
2964
VIR_ENUM_DECL(virDomainChr)
2965
VIR_ENUM_DECL(virDomainChrTcpProtocol)
E
Eric Blake 已提交
2966
VIR_ENUM_DECL(virDomainChrSpicevmc)
2967
VIR_ENUM_DECL(virDomainSoundCodec)
2968
VIR_ENUM_DECL(virDomainSoundModel)
2969
VIR_ENUM_DECL(virDomainKeyWrapCipherName)
2970
VIR_ENUM_DECL(virDomainMemballoonModel)
2971
VIR_ENUM_DECL(virDomainSmbiosMode)
R
Richard Jones 已提交
2972 2973
VIR_ENUM_DECL(virDomainWatchdogModel)
VIR_ENUM_DECL(virDomainWatchdogAction)
2974
VIR_ENUM_DECL(virDomainPanicModel)
2975
VIR_ENUM_DECL(virDomainVideo)
2976 2977
VIR_ENUM_DECL(virDomainHostdevMode)
VIR_ENUM_DECL(virDomainHostdevSubsys)
2978
VIR_ENUM_DECL(virDomainHostdevCaps)
M
Marc-André Lureau 已提交
2979
VIR_ENUM_DECL(virDomainHub)
2980
VIR_ENUM_DECL(virDomainRedirdevBus)
2981 2982 2983
VIR_ENUM_DECL(virDomainInput)
VIR_ENUM_DECL(virDomainInputBus)
VIR_ENUM_DECL(virDomainGraphics)
2984
VIR_ENUM_DECL(virDomainGraphicsListen)
2985
VIR_ENUM_DECL(virDomainGraphicsAuthConnected)
2986 2987
VIR_ENUM_DECL(virDomainGraphicsSpiceChannelName)
VIR_ENUM_DECL(virDomainGraphicsSpiceChannelMode)
2988 2989 2990
VIR_ENUM_DECL(virDomainGraphicsSpiceImageCompression)
VIR_ENUM_DECL(virDomainGraphicsSpiceJpegCompression)
VIR_ENUM_DECL(virDomainGraphicsSpiceZlibCompression)
2991
VIR_ENUM_DECL(virDomainGraphicsSpiceStreamingMode)
P
Peng Zhou 已提交
2992
VIR_ENUM_DECL(virDomainGraphicsSpiceMouseMode)
2993
VIR_ENUM_DECL(virDomainGraphicsVNCSharePolicy)
2994
VIR_ENUM_DECL(virDomainHyperv)
2995
VIR_ENUM_DECL(virDomainKVM)
2996 2997
VIR_ENUM_DECL(virDomainRNGModel)
VIR_ENUM_DECL(virDomainRNGBackend)
2998 2999
VIR_ENUM_DECL(virDomainTPMModel)
VIR_ENUM_DECL(virDomainTPMBackend)
3000 3001
VIR_ENUM_DECL(virDomainMemoryModel)
VIR_ENUM_DECL(virDomainMemoryBackingModel)
3002 3003
/* from libvirt.h */
VIR_ENUM_DECL(virDomainState)
J
Jiri Denemark 已提交
3004 3005 3006 3007 3008 3009 3010
VIR_ENUM_DECL(virDomainNostateReason)
VIR_ENUM_DECL(virDomainRunningReason)
VIR_ENUM_DECL(virDomainBlockedReason)
VIR_ENUM_DECL(virDomainPausedReason)
VIR_ENUM_DECL(virDomainShutdownReason)
VIR_ENUM_DECL(virDomainShutoffReason)
VIR_ENUM_DECL(virDomainCrashedReason)
3011
VIR_ENUM_DECL(virDomainPMSuspendedReason)
J
Jiri Denemark 已提交
3012 3013 3014 3015

const char *virDomainStateReasonToString(virDomainState state, int reason);
int virDomainStateReasonFromString(virDomainState state, const char *reason);

3016
VIR_ENUM_DECL(virDomainSeclabel)
3017
VIR_ENUM_DECL(virDomainClockOffset)
3018
VIR_ENUM_DECL(virDomainClockBasis)
3019

3020
VIR_ENUM_DECL(virDomainTimerName)
3021
VIR_ENUM_DECL(virDomainTimerTrack)
3022 3023
VIR_ENUM_DECL(virDomainTimerTickpolicy)
VIR_ENUM_DECL(virDomainTimerMode)
O
Osier Yang 已提交
3024
VIR_ENUM_DECL(virDomainCpuPlacementMode)
3025

3026
VIR_ENUM_DECL(virDomainStartupPolicy)
3027

3028 3029
virDomainControllerDefPtr
virDomainDefAddController(virDomainDefPtr def, int type, int idx, int model);
3030 3031
int
virDomainDefAddUSBController(virDomainDefPtr def, int idx, int model);
3032 3033 3034 3035 3036
int
virDomainDefMaybeAddController(virDomainDefPtr def,
                               int type,
                               int idx,
                               int model);
3037 3038 3039 3040
int
virDomainDefMaybeAddInput(virDomainDefPtr def,
                          int type,
                          int bus);
3041

3042 3043
char *virDomainDefGetDefaultEmulator(virDomainDefPtr def, virCapsPtr caps);

3044 3045
int virDomainDefFindDevice(virDomainDefPtr def,
                           const char *devAlias,
3046 3047
                           virDomainDeviceDefPtr dev,
                           bool reportError);
3048

3049 3050
void virDomainChrSourceDefClear(virDomainChrSourceDefPtr def);

3051 3052 3053 3054 3055 3056 3057
char *virDomainObjGetMetadata(virDomainObjPtr vm,
                              int type,
                              const char *uri,
                              virCapsPtr caps,
                              virDomainXMLOptionPtr xmlopt,
                              unsigned int flags);

3058 3059 3060 3061 3062 3063 3064
int virDomainObjSetMetadata(virDomainObjPtr vm,
                            int type,
                            const char *metadata,
                            const char *key,
                            const char *uri,
                            virCapsPtr caps,
                            virDomainXMLOptionPtr xmlopt,
3065
                            const char *stateDir,
3066 3067 3068
                            const char *configDir,
                            unsigned int flags);

3069 3070 3071 3072 3073 3074 3075 3076
int
virDomainParseMemory(const char *xpath,
                     const char *units_xpath,
                     xmlXPathContextPtr ctxt,
                     unsigned long long *mem,
                     bool required,
                     bool capped);

3077 3078 3079
bool virDomainDefNeedsPlacementAdvice(virDomainDefPtr def)
    ATTRIBUTE_NONNULL(1);

3080 3081
int virDomainDiskDefCheckDuplicateInfo(const virDomainDiskDef *a,
                                       const virDomainDiskDef *b)
3082
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
3083

3084 3085 3086 3087 3088 3089 3090 3091
int virDomainDefGetVcpuPinInfoHelper(virDomainDefPtr def,
                                     int maplen,
                                     int ncpumaps,
                                     unsigned char *cpumaps,
                                     int hostcpus,
                                     virBitmapPtr autoCpuset)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(4) ATTRIBUTE_RETURN_CHECK;

3092 3093
bool virDomainDefHasMemballoon(const virDomainDef *def) ATTRIBUTE_NONNULL(1);

M
Martin Kletzander 已提交
3094 3095
char *virDomainObjGetShortName(virDomainObjPtr vm);

3096 3097 3098 3099 3100
int
virDomainGetBlkioParametersAssignFromDef(virDomainDefPtr def,
                                         virTypedParameterPtr params,
                                         int *nparams,
                                         int maxparams);
3101
#endif /* __DOMAIN_CONF_H */