domain_conf.h 84.6 KB
Newer Older
1 2 3
/*
 * domain_conf.h: domain XML processing
 *
4
 * Copyright (C) 2006-2013 Red Hat, Inc.
5 6 7 8 9 10 11 12 13 14 15 16 17
 * Copyright (C) 2006-2008 Daniel P. Berrange
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
18
 * License along with this library.  If not, see
O
Osier Yang 已提交
19
 * <http://www.gnu.org/licenses/>.
20 21 22 23 24
 *
 * Author: Daniel P. Berrange <berrange@redhat.com>
 */

#ifndef __DOMAIN_CONF_H
25
# define __DOMAIN_CONF_H
26

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

31 32 33 34
# include "internal.h"
# include "capabilities.h"
# include "storage_encryption_conf.h"
# include "cpu_conf.h"
35
# include "virthread.h"
36
# include "virhash.h"
37
# include "virsocketaddr.h"
38
# include "nwfilter_params.h"
39
# include "virnetdevmacvlan.h"
40
# include "virsysinfo.h"
41
# include "virnetdevvportprofile.h"
A
Ansis Atteka 已提交
42
# include "virnetdevopenvswitch.h"
43
# include "virnetdevbandwidth.h"
44
# include "virnetdevvlan.h"
45
# include "virobject.h"
46
# include "device_conf.h"
47
# include "virbitmap.h"
48
# include "virstoragefile.h"
G
Gao feng 已提交
49
# include "virnuma.h"
50

51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
/* 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;

72 73 74
typedef struct _virDomainSoundCodecDef virDomainSoundCodecDef;
typedef virDomainSoundCodecDef *virDomainSoundCodecDefPtr;

75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
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;

96 97 98 99 100 101
typedef struct _virDomainRedirFilterUsbDevDef virDomainRedirFilterUsbDevDef;
typedef virDomainRedirFilterUsbDevDef *virDomainRedirFilterUsbDevDefPtr;

typedef struct _virDomainRedirFilterDef virDomainRedirFilterDef;
typedef virDomainRedirFilterDef *virDomainRedirFilterDefPtr;

102 103 104 105 106 107 108 109 110
typedef struct _virDomainSmartcardDef virDomainSmartcardDef;
typedef virDomainSmartcardDef *virDomainSmartcardDefPtr;

typedef struct _virDomainChrDef virDomainChrDef;
typedef virDomainChrDef *virDomainChrDefPtr;

typedef struct _virDomainMemballoonDef virDomainMemballoonDef;
typedef virDomainMemballoonDef *virDomainMemballoonDefPtr;

L
Li Zhang 已提交
111 112 113
typedef struct _virDomainNVRAMDef virDomainNVRAMDef;
typedef virDomainNVRAMDef *virDomainNVRAMDefPtr;

114 115 116 117 118 119
typedef struct _virDomainSnapshotObj virDomainSnapshotObj;
typedef virDomainSnapshotObj *virDomainSnapshotObjPtr;

typedef struct _virDomainSnapshotObjList virDomainSnapshotObjList;
typedef virDomainSnapshotObjList *virDomainSnapshotObjListPtr;

120 121 122
typedef struct _virDomainRNGDef virDomainRNGDef;
typedef virDomainRNGDef *virDomainRNGDefPtr;

123 124 125 126 127 128
typedef struct _virDomainIdMapEntry virDomainIdMapEntry;
typedef virDomainIdMapEntry *virDomainIdMapEntryPtr;

typedef struct _virDomainIdMapDef virDomainIdMapDef;
typedef virDomainIdMapDef *virDomainIdMapDefPtr;

129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
/* 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 已提交
148
    VIR_DOMAIN_DEVICE_NVRAM,
149
    VIR_DOMAIN_DEVICE_RNG,
150

151
    VIR_DOMAIN_DEVICE_LAST
152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174
} 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 已提交
175
        virDomainNVRAMDefPtr nvram;
176
        virDomainRNGDefPtr rng;
177 178 179
    } data;
};

180 181 182 183 184 185 186 187 188 189 190 191 192
/* Different types of hypervisor */
/* NB: Keep in sync with virDomainVirtTypeToString impl */
enum virDomainVirtType {
    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,
193
    VIR_DOMAIN_VIRT_VBOX,
194
    VIR_DOMAIN_VIRT_PHYP,
D
Dmitry Guryanov 已提交
195
    VIR_DOMAIN_VIRT_PARALLELS,
196

197
    VIR_DOMAIN_VIRT_LAST
198 199
};

200 201 202
enum virDomainDeviceAddressType {
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_NONE,
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_PCI,
203
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_DRIVE,
204
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_SERIAL,
E
Eric Blake 已提交
205
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_CCID,
206
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_USB,
207
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_SPAPRVIO,
208
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_S390,
209
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_CCW,
210
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_MMIO,
211 212 213 214

    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_LAST
};

215 216 217 218 219 220 221 222
enum virDomainPciRombarMode {
    VIR_DOMAIN_PCI_ROMBAR_DEFAULT = 0,
    VIR_DOMAIN_PCI_ROMBAR_ON,
    VIR_DOMAIN_PCI_ROMBAR_OFF,

    VIR_DOMAIN_PCI_ROMBAR_LAST
};

223 224 225 226 227
typedef struct _virDomainDeviceDriveAddress virDomainDeviceDriveAddress;
typedef virDomainDeviceDriveAddress *virDomainDeviceDriveAddressPtr;
struct _virDomainDeviceDriveAddress {
    unsigned int controller;
    unsigned int bus;
228
    unsigned int target;
229 230 231
    unsigned int unit;
};

232 233 234 235 236
typedef struct _virDomainDeviceVirtioSerialAddress virDomainDeviceVirtioSerialAddress;
typedef virDomainDeviceVirtioSerialAddress *virDomainDeviceVirtioSerialAddressPtr;
struct _virDomainDeviceVirtioSerialAddress {
    unsigned int controller;
    unsigned int bus;
237
    unsigned int port;
238 239
};

240 241 242 243 244 245 246 247 248 249 250 251 252
# define VIR_DOMAIN_DEVICE_CCW_MAX_CSSID    254
# define VIR_DOMAIN_DEVICE_CCW_MAX_SSID       3
# define VIR_DOMAIN_DEVICE_CCW_MAX_DEVNO  65535

typedef struct _virDomainDeviceCCWAddress virDomainDeviceCCWAddress;
typedef virDomainDeviceCCWAddress *virDomainDeviceCCWAddressPtr;
struct _virDomainDeviceCCWAddress {
    unsigned int cssid;
    unsigned int ssid;
    unsigned int devno;
    bool         assigned;
};

E
Eric Blake 已提交
253 254 255 256 257 258 259
typedef struct _virDomainDeviceCcidAddress virDomainDeviceCcidAddress;
typedef virDomainDeviceCcidAddress *virDomainDeviceCcidAddressPtr;
struct _virDomainDeviceCcidAddress {
    unsigned int controller;
    unsigned int slot;
};

260 261 262 263
typedef struct _virDomainDeviceUSBAddress virDomainDeviceUSBAddress;
typedef virDomainDeviceUSBAddress *virDomainDeviceUSBAddressPtr;
struct _virDomainDeviceUSBAddress {
    unsigned int bus;
264
    char *port;
265 266
};

267 268 269 270 271 272 273
typedef struct _virDomainDeviceSpaprVioAddress virDomainDeviceSpaprVioAddress;
typedef virDomainDeviceSpaprVioAddress *virDomainDeviceSpaprVioAddressPtr;
struct _virDomainDeviceSpaprVioAddress {
    unsigned long long reg;
    bool has_reg;
};

274 275 276 277 278 279 280 281 282 283 284 285 286
enum virDomainControllerMaster {
    VIR_DOMAIN_CONTROLLER_MASTER_NONE,
    VIR_DOMAIN_CONTROLLER_MASTER_USB,

    VIR_DOMAIN_CONTROLLER_MASTER_LAST
};

typedef struct _virDomainDeviceUSBMaster virDomainDeviceUSBMaster;
typedef virDomainDeviceUSBMaster *virDomainDeviceUSBMasterPtr;
struct _virDomainDeviceUSBMaster {
    unsigned int startport;
};

287 288 289
typedef struct _virDomainDeviceInfo virDomainDeviceInfo;
typedef virDomainDeviceInfo *virDomainDeviceInfoPtr;
struct _virDomainDeviceInfo {
290 291 292 293
    /* If adding to this struct, ensure that
     * virDomainDeviceInfoIsSet() is updated
     * to consider the new fields
     */
D
Daniel P. Berrange 已提交
294
    char *alias;
295 296
    int type;
    union {
297
        virDevicePCIAddress pci;
298
        virDomainDeviceDriveAddress drive;
299
        virDomainDeviceVirtioSerialAddress vioserial;
E
Eric Blake 已提交
300
        virDomainDeviceCcidAddress ccid;
301
        virDomainDeviceUSBAddress usb;
302
        virDomainDeviceSpaprVioAddress spaprvio;
303
        virDomainDeviceCCWAddress ccw;
304
    } addr;
305 306 307 308
    int mastertype;
    union {
        virDomainDeviceUSBMaster usb;
    } master;
309 310
    /* rombar and romfile are only used for pci hostdev and network
     * devices. */
311
    int rombar;         /* enum virDomainPciRombarMode */
312
    char *romfile;
313 314
    /* bootIndex is only used for disk, network interface, hostdev
     * and redirdev devices */
315
    int bootIndex;
316 317
};

E
Eric Blake 已提交
318
enum virDomainSeclabelType {
319 320
    VIR_DOMAIN_SECLABEL_DEFAULT,
    VIR_DOMAIN_SECLABEL_NONE,
E
Eric Blake 已提交
321 322 323
    VIR_DOMAIN_SECLABEL_DYNAMIC,
    VIR_DOMAIN_SECLABEL_STATIC,

324
    VIR_DOMAIN_SECLABEL_LAST
E
Eric Blake 已提交
325 326 327 328 329 330 331 332 333 334 335 336
};

/* Security configuration for domain */
typedef struct _virSecurityLabelDef virSecurityLabelDef;
typedef virSecurityLabelDef *virSecurityLabelDefPtr;
struct _virSecurityLabelDef {
    char *model;        /* name of security model */
    char *label;        /* security label string */
    char *imagelabel;   /* security image label string */
    char *baselabel;    /* base name of label string */
    int type;           /* virDomainSeclabelType */
    bool norelabel;
337
    bool implicit;      /* true if seclabel is auto-added */
E
Eric Blake 已提交
338 339
};

340 341 342 343 344

/* Security configuration for domain */
typedef struct _virSecurityDeviceLabelDef virSecurityDeviceLabelDef;
typedef virSecurityDeviceLabelDef *virSecurityDeviceLabelDefPtr;
struct _virSecurityDeviceLabelDef {
345
    char *model;
346
    char *label;        /* image label string */
347 348
    bool norelabel;     /* true to skip label attempts */
    bool labelskip;     /* live-only; true if skipping failed label attempt */
349 350 351
};


352 353 354 355 356 357 358 359
typedef struct _virDomainHostdevOrigStates virDomainHostdevOrigStates;
typedef virDomainHostdevOrigStates *virDomainHostdevOrigStatesPtr;
struct _virDomainHostdevOrigStates {
    union {
        struct {
            /* Does the device need to unbind from stub when
             * reattaching to host?
             */
360
            bool unbind_from_stub;
361 362 363 364

            /* Does it need to use remove_slot when reattaching
             * the device to host?
             */
365
            bool remove_slot;
366 367 368 369

            /* Does it need to reprobe driver for the device when
             * reattaching to host?
             */
370
            bool reprobe;
371 372 373 374 375 376
        } pci;

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

377 378 379 380 381 382 383
struct _virDomainLeaseDef {
    char *lockspace;
    char *key;
    char *path;
    unsigned long long offset;
};

384

385 386 387 388
enum virDomainHostdevMode {
    VIR_DOMAIN_HOSTDEV_MODE_SUBSYS,
    VIR_DOMAIN_HOSTDEV_MODE_CAPABILITIES,

389
    VIR_DOMAIN_HOSTDEV_MODE_LAST
390 391 392 393 394
};

enum virDomainHostdevSubsysType {
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_USB,
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_PCI,
H
Han Cheng 已提交
395
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_SCSI,
396 397 398 399

    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_LAST
};

400 401
/* the backend driver used for PCI hostdev devices */
typedef enum {
402 403 404
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_DEFAULT, /* currently kvm, could change */
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_KVM,    /* force legacy kvm style */
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_VFIO,   /* force vfio */
405 406 407 408 409

    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_TYPE_LAST
} virDomainHostdevSubsysPciBackendType;

VIR_ENUM_DECL(virDomainHostdevSubsysPciBackend)
410 411 412 413

typedef struct _virDomainHostdevSubsys virDomainHostdevSubsys;
typedef virDomainHostdevSubsys *virDomainHostdevSubsysPtr;
struct _virDomainHostdevSubsys {
414
    int type; /* enum virDomainHostdevSubsysType */
415 416
    union {
        struct {
417 418
            bool autoAddress; /* bus/device were filled automatically based
                                 on vedor/product */
419 420 421 422 423 424
            unsigned bus;
            unsigned device;

            unsigned vendor;
            unsigned product;
        } usb;
425 426
        struct {
            virDevicePCIAddress addr; /* host address */
427
            int backend; /* enum virDomainHostdevSubsysPciBackendType */
428
        } pci;
H
Han Cheng 已提交
429 430 431 432 433
        struct {
            char *adapter;
            unsigned bus;
            unsigned target;
            unsigned unit;
O
Osier Yang 已提交
434
            int sgio; /* enum virDomainDeviceSGIO */
H
Han Cheng 已提交
435
        } scsi;
436 437 438
    } u;
};

439 440 441 442

enum virDomainHostdevCapsType {
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_STORAGE,
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_MISC,
443
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_NET,
444 445 446 447 448 449 450 451 452 453 454 455 456 457 458

    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_LAST
};

typedef struct _virDomainHostdevCaps virDomainHostdevCaps;
typedef virDomainHostdevCaps *virDomainHostdevCapsPtr;
struct _virDomainHostdevCaps {
    int type; /* enum virDOmainHostdevCapsType */
    union {
        struct {
            char *block;
        } storage;
        struct {
            char *chardev;
        } misc;
459 460 461
        struct {
            char *iface;
        } net;
462 463 464 465
    } u;
};


466 467
/* basic device for direct passthrough */
struct _virDomainHostdevDef {
468
    virDomainDeviceDef parent; /* higher level Def containing this */
469
    int mode; /* enum virDomainHostdevMode */
470
    int startupPolicy; /* enum virDomainStartupPolicy */
471
    bool managed;
472
    bool missing;
O
Osier Yang 已提交
473
    bool readonly;
474
    bool shareable;
475
    union {
476
        virDomainHostdevSubsys subsys;
477
        virDomainHostdevCaps caps;
478 479
    } source;
    virDomainHostdevOrigStates origstates;
480
    virDomainDeviceInfoPtr info; /* Guest address */
481 482
};

483 484 485 486
/* Two types of disk backends */
enum virDomainDiskType {
    VIR_DOMAIN_DISK_TYPE_BLOCK,
    VIR_DOMAIN_DISK_TYPE_FILE,
487
    VIR_DOMAIN_DISK_TYPE_DIR,
M
MORITA Kazutaka 已提交
488
    VIR_DOMAIN_DISK_TYPE_NETWORK,
489
    VIR_DOMAIN_DISK_TYPE_VOLUME,
490 491 492 493 494 495 496 497 498

    VIR_DOMAIN_DISK_TYPE_LAST
};

/* Three types of disk frontend */
enum virDomainDiskDevice {
    VIR_DOMAIN_DISK_DEVICE_DISK,
    VIR_DOMAIN_DISK_DEVICE_CDROM,
    VIR_DOMAIN_DISK_DEVICE_FLOPPY,
499
    VIR_DOMAIN_DISK_DEVICE_LUN,
500 501 502 503 504 505 506 507 508 509

    VIR_DOMAIN_DISK_DEVICE_LAST
};

enum virDomainDiskBus {
    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,
510
    VIR_DOMAIN_DISK_BUS_USB,
511
    VIR_DOMAIN_DISK_BUS_UML,
512
    VIR_DOMAIN_DISK_BUS_SATA,
513
    VIR_DOMAIN_DISK_BUS_SD,
514 515 516 517

    VIR_DOMAIN_DISK_BUS_LAST
};

518 519 520 521 522
enum  virDomainDiskCache {
    VIR_DOMAIN_DISK_CACHE_DEFAULT,
    VIR_DOMAIN_DISK_CACHE_DISABLE,
    VIR_DOMAIN_DISK_CACHE_WRITETHRU,
    VIR_DOMAIN_DISK_CACHE_WRITEBACK,
523
    VIR_DOMAIN_DISK_CACHE_DIRECTSYNC,
524
    VIR_DOMAIN_DISK_CACHE_UNSAFE,
525 526 527 528

    VIR_DOMAIN_DISK_CACHE_LAST
};

529 530 531
enum  virDomainDiskErrorPolicy {
    VIR_DOMAIN_DISK_ERROR_POLICY_DEFAULT,
    VIR_DOMAIN_DISK_ERROR_POLICY_STOP,
532
    VIR_DOMAIN_DISK_ERROR_POLICY_REPORT,
533
    VIR_DOMAIN_DISK_ERROR_POLICY_IGNORE,
534
    VIR_DOMAIN_DISK_ERROR_POLICY_ENOSPACE,
535 536 537 538

    VIR_DOMAIN_DISK_ERROR_POLICY_LAST
};

M
MORITA Kazutaka 已提交
539 540 541 542
enum virDomainDiskProtocol {
    VIR_DOMAIN_DISK_PROTOCOL_NBD,
    VIR_DOMAIN_DISK_PROTOCOL_RBD,
    VIR_DOMAIN_DISK_PROTOCOL_SHEEPDOG,
543
    VIR_DOMAIN_DISK_PROTOCOL_GLUSTER,
544
    VIR_DOMAIN_DISK_PROTOCOL_ISCSI,
545
    VIR_DOMAIN_DISK_PROTOCOL_HTTP,
546
    VIR_DOMAIN_DISK_PROTOCOL_HTTPS,
547
    VIR_DOMAIN_DISK_PROTOCOL_FTP,
548
    VIR_DOMAIN_DISK_PROTOCOL_FTPS,
M
MORITA Kazutaka 已提交
549 550 551 552

    VIR_DOMAIN_DISK_PROTOCOL_LAST
};

553 554 555 556 557 558 559 560
enum virDomainDiskProtocolTransport {
    VIR_DOMAIN_DISK_PROTO_TRANS_TCP,
    VIR_DOMAIN_DISK_PROTO_TRANS_UNIX,
    VIR_DOMAIN_DISK_PROTO_TRANS_RDMA,

    VIR_DOMAIN_DISK_PROTO_TRANS_LAST
};

561 562 563 564 565 566 567
enum virDomainDiskTray {
    VIR_DOMAIN_DISK_TRAY_CLOSED,
    VIR_DOMAIN_DISK_TRAY_OPEN,

    VIR_DOMAIN_DISK_TRAY_LAST
};

J
J.B. Joret 已提交
568 569 570 571 572 573 574 575 576
enum  virDomainDiskGeometryTrans {
    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
};

M
MORITA Kazutaka 已提交
577 578 579 580 581
typedef struct _virDomainDiskHostDef virDomainDiskHostDef;
typedef virDomainDiskHostDef *virDomainDiskHostDefPtr;
struct _virDomainDiskHostDef {
    char *name;
    char *port;
582 583
    int transport; /* enum virDomainDiskProtocolTransport */
    char *socket;  /* path to unix socket */
M
MORITA Kazutaka 已提交
584 585
};

M
Matthias Dahl 已提交
586 587 588 589 590 591 592 593
enum  virDomainDiskIo {
    VIR_DOMAIN_DISK_IO_DEFAULT,
    VIR_DOMAIN_DISK_IO_NATIVE,
    VIR_DOMAIN_DISK_IO_THREADS,

    VIR_DOMAIN_DISK_IO_LAST
};

594 595 596 597 598 599 600 601
enum virDomainIoEventFd {
    VIR_DOMAIN_IO_EVENT_FD_DEFAULT = 0,
    VIR_DOMAIN_IO_EVENT_FD_ON,
    VIR_DOMAIN_IO_EVENT_FD_OFF,

    VIR_DOMAIN_IO_EVENT_FD_LAST
};

602 603 604 605 606 607 608 609
enum virDomainVirtioEventIdx {
    VIR_DOMAIN_VIRTIO_EVENT_IDX_DEFAULT = 0,
    VIR_DOMAIN_VIRTIO_EVENT_IDX_ON,
    VIR_DOMAIN_VIRTIO_EVENT_IDX_OFF,

    VIR_DOMAIN_VIRTIO_EVENT_IDX_LAST
};

O
Osier Yang 已提交
610 611 612 613 614 615 616 617
enum virDomainDiskCopyOnRead {
    VIR_DOMAIN_DISK_COPY_ON_READ_DEFAULT = 0,
    VIR_DOMAIN_DISK_COPY_ON_READ_ON,
    VIR_DOMAIN_DISK_COPY_ON_READ_OFF,

    VIR_DOMAIN_DISK_COPY_ON_READ_LAST
};

618 619 620 621 622 623 624 625 626
enum virDomainStartupPolicy {
    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
};

627 628 629 630 631 632 633 634
enum virDomainDiskSecretType {
    VIR_DOMAIN_DISK_SECRET_TYPE_NONE,
    VIR_DOMAIN_DISK_SECRET_TYPE_UUID,
    VIR_DOMAIN_DISK_SECRET_TYPE_USAGE,

    VIR_DOMAIN_DISK_SECRET_TYPE_LAST
};

635 636 637 638
enum virDomainDeviceSGIO {
    VIR_DOMAIN_DEVICE_SGIO_DEFAULT = 0,
    VIR_DOMAIN_DEVICE_SGIO_FILTERED,
    VIR_DOMAIN_DEVICE_SGIO_UNFILTERED,
O
Osier Yang 已提交
639

640
    VIR_DOMAIN_DEVICE_SGIO_LAST
O
Osier Yang 已提交
641 642
};

O
Osier Yang 已提交
643 644
enum virDomainDiskDiscard {
    VIR_DOMAIN_DISK_DISCARD_DEFAULT = 0,
O
Osier Yang 已提交
645 646
    VIR_DOMAIN_DISK_DISCARD_UNMAP,
    VIR_DOMAIN_DISK_DISCARD_IGNORE,
O
Osier Yang 已提交
647 648 649 650

    VIR_DOMAIN_DISK_DISCARD_LAST
};

L
Lei Li 已提交
651 652 653 654 655 656 657 658 659 660 661
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;
};
typedef virDomainBlockIoTuneInfo *virDomainBlockIoTuneInfoPtr;

662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681
/*
 * Used for volume "type" disk to indicate how to represent
 * the disk source if the specified "pool" is of iscsi type.
 */
enum virDomainDiskSourcePoolMode {
    VIR_DOMAIN_DISK_SOURCE_POOL_MODE_DEFAULT = 0,

    /* Use the path as it shows up on host, e.g.
     * /dev/disk/by-path/ip-$ip-iscsi-$iqn:iscsi.iscsi-pool0-lun-1
     */
    VIR_DOMAIN_DISK_SOURCE_POOL_MODE_HOST,

    /* Use the URI from the storage pool source element host attribute. E.g.
     * file=iscsi://demo.org:6000/iqn.1992-01.com.example/1.
     */
    VIR_DOMAIN_DISK_SOURCE_POOL_MODE_DIRECT,

    VIR_DOMAIN_DISK_SOURCE_POOL_MODE_LAST
};

682 683 684 685
typedef struct _virDomainDiskSourcePoolDef virDomainDiskSourcePoolDef;
struct _virDomainDiskSourcePoolDef {
    char *pool; /* pool name */
    char *volume; /* volume name */
686
    int voltype; /* enum virStorageVolType, internal only */
687
    int pooltype; /* enum virStoragePoolType, internal only */
688
    int mode; /* enum virDomainDiskSourcePoolMode */
689 690 691
};
typedef virDomainDiskSourcePoolDef *virDomainDiskSourcePoolDefPtr;

692 693 694 695 696 697 698
/* Stores the virtual disk configuration */
struct _virDomainDiskDef {
    int type;
    int device;
    int bus;
    char *src;
    char *dst;
699
    int tray_status;
700
    int removable;
M
MORITA Kazutaka 已提交
701
    int protocol;
702
    size_t nhosts;
M
MORITA Kazutaka 已提交
703
    virDomainDiskHostDefPtr hosts;
704
    virDomainDiskSourcePoolDefPtr srcpool;
705 706 707 708 709 710 711 712
    struct {
        char *username;
        int secretType; /* enum virDomainDiskSecretType */
        union {
            unsigned char uuid[VIR_UUID_BUFLEN];
            char *usage;
        } secret;
    } auth;
713
    char *driverName;
714
    int format; /* enum virStorageFileFormat */
715
    virStorageFileMetadataPtr backingChain;
L
Lei Li 已提交
716

717
    char *mirror;
718
    int mirrorFormat; /* enum virStorageFileFormat */
719 720
    bool mirroring;

J
J.B. Joret 已提交
721 722 723 724 725 726 727
    struct {
        unsigned int cylinders;
        unsigned int heads;
        unsigned int sectors;
        int trans;
    } geometry;

728 729 730
    struct {
        unsigned int logical_block_size;
        unsigned int physical_block_size;
V
Viktor Mihajlovski 已提交
731
    } blockio;
732

L
Lei Li 已提交
733 734
    virDomainBlockIoTuneInfo blkdeviotune;

735
    char *serial;
O
Osier Yang 已提交
736
    char *wwn;
737 738
    char *vendor;
    char *product;
739
    int cachemode;
740 741
    int error_policy;  /* enum virDomainDiskErrorPolicy */
    int rerror_policy; /* enum virDomainDiskErrorPolicy */
M
Matthias Dahl 已提交
742
    int iomode;
743
    int ioeventfd;
744
    int event_idx;
O
Osier Yang 已提交
745
    int copy_on_read;
E
Eric Blake 已提交
746
    int snapshot; /* enum virDomainSnapshotLocation, snapshot_conf.h */
747
    int startupPolicy; /* enum virDomainStartupPolicy */
748
    bool readonly;
749
    bool shared;
750
    bool transient;
751
    virDomainDeviceInfo info;
752
    virStorageEncryptionPtr encryption;
753 754
    bool rawio_specified;
    int rawio; /* no = 0, yes = 1 */
755
    int sgio; /* enum virDomainDeviceSGIO */
O
Osier Yang 已提交
756
    int discard; /* enum virDomainDiskDiscard */
757 758 759

    size_t nseclabels;
    virSecurityDeviceLabelDefPtr *seclabels;
760 761 762
};


763 764 765 766 767
enum virDomainControllerType {
    VIR_DOMAIN_CONTROLLER_TYPE_IDE,
    VIR_DOMAIN_CONTROLLER_TYPE_FDC,
    VIR_DOMAIN_CONTROLLER_TYPE_SCSI,
    VIR_DOMAIN_CONTROLLER_TYPE_SATA,
768
    VIR_DOMAIN_CONTROLLER_TYPE_VIRTIO_SERIAL,
E
Eric Blake 已提交
769
    VIR_DOMAIN_CONTROLLER_TYPE_CCID,
770
    VIR_DOMAIN_CONTROLLER_TYPE_USB,
J
Ján Tomko 已提交
771
    VIR_DOMAIN_CONTROLLER_TYPE_PCI,
772 773 774 775

    VIR_DOMAIN_CONTROLLER_TYPE_LAST
};

776

777
typedef enum {
J
Ján Tomko 已提交
778
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_ROOT,
L
Laine Stump 已提交
779
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_ROOT,
J
Ján Tomko 已提交
780
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_BRIDGE,
781
    VIR_DOMAIN_CONTROLLER_MODEL_DMI_TO_PCI_BRIDGE,
J
Ján Tomko 已提交
782 783

    VIR_DOMAIN_CONTROLLER_MODEL_PCI_LAST
784
} virDomainControllerModelPCI;
J
Ján Tomko 已提交
785

786 787 788 789 790 791
enum virDomainControllerModelSCSI {
    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,
792
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_IBMVSCSI,
793
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_VIRTIO_SCSI,
794
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LSISAS1078,
795

796
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LAST
797 798
};

M
Marc-André Lureau 已提交
799 800 801 802 803 804 805 806 807 808
enum virDomainControllerModelUSB {
    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 已提交
809
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NEC_XHCI,
810
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NONE,
M
Marc-André Lureau 已提交
811 812 813 814

    VIR_DOMAIN_CONTROLLER_MODEL_USB_LAST
};

815 816 817 818 819 820 821
typedef struct _virDomainVirtioSerialOpts virDomainVirtioSerialOpts;
typedef virDomainVirtioSerialOpts *virDomainVirtioSerialOptsPtr;
struct _virDomainVirtioSerialOpts {
    int ports;   /* -1 == undef */
    int vectors; /* -1 == undef */
};

822 823 824 825 826 827 828
typedef struct _virDomainPciControllerOpts virDomainPciControllerOpts;
typedef virDomainPciControllerOpts *virDomainPciControllerOptsPtr;
struct _virDomainPciControllerOpts {
    bool pcihole64;
    unsigned long pcihole64size;
};

829 830 831
/* Stores the virtual disk controller configuration */
struct _virDomainControllerDef {
    int type;
832
    unsigned int idx;
833
    int model; /* -1 == undef */
834
    unsigned int queues;
835 836
    union {
        virDomainVirtioSerialOpts vioserial;
837
        virDomainPciControllerOpts pciopts;
838
    } opts;
839 840 841 842
    virDomainDeviceInfo info;
};


843 844
/* Two types of disk backends */
enum virDomainFSType {
845 846 847 848 849 850
    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 */
851 852 853 854

    VIR_DOMAIN_FS_TYPE_LAST
};

855 856 857 858 859
/* Filesystem driver type */
enum virDomainFSDriverType {
    VIR_DOMAIN_FS_DRIVER_TYPE_DEFAULT = 0,
    VIR_DOMAIN_FS_DRIVER_TYPE_PATH,
    VIR_DOMAIN_FS_DRIVER_TYPE_HANDLE,
860
    VIR_DOMAIN_FS_DRIVER_TYPE_LOOP,
861
    VIR_DOMAIN_FS_DRIVER_TYPE_NBD,
862 863 864 865

    VIR_DOMAIN_FS_DRIVER_TYPE_LAST
};

866 867 868 869 870 871 872 873 874
/* Filesystem mount access mode  */
enum virDomainFSAccessMode {
    VIR_DOMAIN_FS_ACCESSMODE_PASSTHROUGH,
    VIR_DOMAIN_FS_ACCESSMODE_MAPPED,
    VIR_DOMAIN_FS_ACCESSMODE_SQUASH,

    VIR_DOMAIN_FS_ACCESSMODE_LAST
};

875 876 877 878 879 880 881 882
/* Filesystem Write policy */
enum virDomainFSWrpolicy {
    VIR_DOMAIN_FS_WRPOLICY_DEFAULT = 0,
    VIR_DOMAIN_FS_WRPOLICY_IMMEDIATE,

    VIR_DOMAIN_FS_WRPOLICY_LAST
};

883 884 885
/* Allow 2 MB ram usage */
# define VIR_DOMAIN_FS_RAM_DEFAULT_USAGE (1024 * 2)

886 887
struct _virDomainFSDef {
    int type;
888 889
    int fsdriver; /* enum virDomainFSDriverType */
    int accessmode; /* enum virDomainFSAccessMode */
890
    int wrpolicy; /* enum virDomainFSWrpolicy */
891
    int format; /* enum virStorageFileFormat */
892
    unsigned long long usage;
893 894
    char *src;
    char *dst;
895
    bool readonly;
896
    virDomainDeviceInfo info;
897 898
    unsigned long long space_hard_limit; /* in bytes */
    unsigned long long space_soft_limit; /* in bytes */
899 900 901
};


902
/* network config types */
903 904 905 906 907 908 909 910
enum virDomainNetType {
    VIR_DOMAIN_NET_TYPE_USER,
    VIR_DOMAIN_NET_TYPE_ETHERNET,
    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 已提交
911
    VIR_DOMAIN_NET_TYPE_INTERNAL,
912
    VIR_DOMAIN_NET_TYPE_DIRECT,
913
    VIR_DOMAIN_NET_TYPE_HOSTDEV,
914

915
    VIR_DOMAIN_NET_TYPE_LAST
916 917
};

918 919 920 921 922 923
/* the backend driver used for virtio interfaces */
enum virDomainNetBackendType {
    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 */

924
    VIR_DOMAIN_NET_BACKEND_TYPE_LAST
925
};
926

927 928 929 930 931 932
/* the TX algorithm used for virtio interfaces */
enum virDomainNetVirtioTxModeType {
    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,

933
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_LAST
934 935
};

936 937 938 939 940 941 942 943 944
/* link interface states */
enum virDomainNetInterfaceLinkState {
        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
};

945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961
/* 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;
        } bridge;
        struct {
            char *linkdev;
            int mode; /* enum virMacvtapMode from util/macvtap.h */
        } direct;
962 963 964
        struct {
            virDomainHostdevDef def;
        } hostdev;
965
    } data;
966
    virNetDevVPortProfilePtr virtPortProfile;
967
    virNetDevBandwidthPtr bandwidth;
968
    virNetDevVlan vlan;
969
    unsigned int class_id; /* class ID for bandwidth 'floor' */
970 971
};

972 973
/* Stores the virtual network interface configuration */
struct _virDomainNetDef {
S
Stefan Berger 已提交
974
    enum virDomainNetType type;
975
    virMacAddr mac;
976
    char *model;
977 978 979
    union {
        struct {
            enum virDomainNetBackendType name; /* which driver backend to use */
980
            enum virDomainNetVirtioTxModeType txmode;
981
            enum virDomainIoEventFd ioeventfd;
982
            enum virDomainVirtioEventIdx event_idx;
983
            unsigned int queues; /* Multiqueue virtio-net */
984 985
        } virtio;
    } driver;
986 987 988 989 990 991 992 993 994 995 996
    union {
        struct {
            char *dev;
            char *ipaddr;
        } ethernet;
        struct {
            char *address;
            int port;
        } socket; /* any of NET_CLIENT or NET_SERVER or NET_MCAST */
        struct {
            char *name;
997 998 999 1000 1001 1002 1003 1004 1005 1006
            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;
1007 1008 1009
        } network;
        struct {
            char *brname;
1010
            char *ipaddr;
1011
        } bridge;
D
Daniel Veillard 已提交
1012 1013 1014
        struct {
            char *name;
        } internal;
1015 1016
        struct {
            char *linkdev;
1017
            int mode; /* enum virMacvtapMode from util/macvtap.h */
1018
        } direct;
1019 1020 1021
        struct {
            virDomainHostdevDef def;
        } hostdev;
1022
    } data;
1023 1024
    /* virtPortProfile is used by network/bridge/direct/hostdev */
    virNetDevVPortProfilePtr virtPortProfile;
1025 1026 1027 1028
    struct {
        bool sndbuf_specified;
        unsigned long sndbuf;
    } tune;
1029
    char *script;
1030
    char *ifname;
1031
    virDomainDeviceInfo info;
1032 1033
    char *filter;
    virNWFilterHashTablePtr filterparams;
1034
    virNetDevBandwidthPtr bandwidth;
1035
    virNetDevVlan vlan;
1036
    int linkstate;
1037 1038
};

E
Eric Blake 已提交
1039 1040 1041 1042
/* 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"

1043
enum virDomainChrDeviceType {
1044
    VIR_DOMAIN_CHR_DEVICE_TYPE_PARALLEL = 0,
1045 1046
    VIR_DOMAIN_CHR_DEVICE_TYPE_SERIAL,
    VIR_DOMAIN_CHR_DEVICE_TYPE_CONSOLE,
1047
    VIR_DOMAIN_CHR_DEVICE_TYPE_CHANNEL,
1048

1049
    VIR_DOMAIN_CHR_DEVICE_TYPE_LAST
1050 1051
};

G
Guannan Ren 已提交
1052 1053 1054 1055 1056 1057 1058
enum virDomainChrSerialTargetType {
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_ISA = 0,
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_USB,

    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_LAST
};

1059
enum virDomainChrChannelTargetType {
1060 1061
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_NONE = 0,
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_GUESTFWD,
1062 1063
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_VIRTIO,

1064
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_LAST
1065 1066
};

1067
enum virDomainChrConsoleTargetType {
1068 1069
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_NONE  = 0,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SERIAL,
1070 1071
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_XEN,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_UML,
C
Cole Robinson 已提交
1072
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_VIRTIO,
1073 1074
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LXC,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_OPENVZ,
1075 1076
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLP,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLPLM,
1077

1078
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LAST
1079 1080
};

1081
enum virDomainChrType {
1082 1083 1084 1085 1086 1087 1088 1089 1090 1091
    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,
1092
    VIR_DOMAIN_CHR_TYPE_SPICEVMC,
1093

1094
    VIR_DOMAIN_CHR_TYPE_LAST
1095 1096 1097 1098 1099
};

enum virDomainChrTcpProtocol {
    VIR_DOMAIN_CHR_TCP_PROTOCOL_RAW,
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNET,
1100 1101
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNETS, /* secure telnet */
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TLS,
1102

1103
    VIR_DOMAIN_CHR_TCP_PROTOCOL_LAST
1104 1105
};

E
Eric Blake 已提交
1106 1107 1108
enum virDomainChrSpicevmcName {
    VIR_DOMAIN_CHR_SPICEVMC_VDAGENT,
    VIR_DOMAIN_CHR_SPICEVMC_SMARTCARD,
1109
    VIR_DOMAIN_CHR_SPICEVMC_USBREDIR,
E
Eric Blake 已提交
1110

1111
    VIR_DOMAIN_CHR_SPICEVMC_LAST
E
Eric Blake 已提交
1112 1113
};

1114 1115 1116 1117 1118
/* The host side information for a character device.  */
typedef struct _virDomainChrSourceDef virDomainChrSourceDef;
typedef virDomainChrSourceDef *virDomainChrSourceDefPtr;
struct _virDomainChrSourceDef {
    int type; /* virDomainChrType */
1119
    union {
E
Eric Blake 已提交
1120
        /* no <source> for null, vc, stdio */
1121 1122 1123 1124 1125 1126
        struct {
            char *path;
        } file; /* pty, file, pipe, or device */
        struct {
            char *host;
            char *service;
1127
            bool listen;
1128 1129 1130 1131 1132 1133 1134 1135 1136 1137
            int protocol;
        } tcp;
        struct {
            char *bindHost;
            char *bindService;
            char *connectHost;
            char *connectService;
        } udp;
        struct {
            char *path;
1138
            bool listen;
1139
        } nix;
E
Eric Blake 已提交
1140
        int spicevmc;
1141
    } data;
1142 1143 1144 1145 1146
};

/* A complete character device, both host and domain views.  */
struct _virDomainChrDef {
    int deviceType;
G
Guannan Ren 已提交
1147 1148

    bool targetTypeAttr;
1149 1150 1151 1152 1153 1154 1155 1156
    int targetType;
    union {
        int port; /* parallel, serial, console */
        virSocketAddrPtr addr; /* guestfwd */
        char *name; /* virtio */
    } target;

    virDomainChrSourceDef source;
1157 1158

    virDomainDeviceInfo info;
1159 1160 1161

    size_t nseclabels;
    virSecurityDeviceLabelDefPtr *seclabels;
1162 1163
};

E
Eric Blake 已提交
1164 1165 1166 1167 1168
enum virDomainSmartcardType {
    VIR_DOMAIN_SMARTCARD_TYPE_HOST,
    VIR_DOMAIN_SMARTCARD_TYPE_HOST_CERTIFICATES,
    VIR_DOMAIN_SMARTCARD_TYPE_PASSTHROUGH,

1169
    VIR_DOMAIN_SMARTCARD_TYPE_LAST
E
Eric Blake 已提交
1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188
};

# 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 已提交
1189 1190 1191 1192 1193
struct _virDomainHubDef {
    int type;
    virDomainDeviceInfo info;
};

1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220
enum virDomainTPMModel {
    VIR_DOMAIN_TPM_MODEL_TIS,

    VIR_DOMAIN_TPM_MODEL_LAST
};

enum virDomainTPMBackendType {
    VIR_DOMAIN_TPM_TYPE_PASSTHROUGH,

    VIR_DOMAIN_TPM_TYPE_LAST
};

# define VIR_DOMAIN_TPM_DEFAULT_DEVICE "/dev/tpm0"

typedef struct _virDomainTPMDef virDomainTPMDef;
typedef virDomainTPMDef *virDomainTPMDefPtr;
struct _virDomainTPMDef {
    enum virDomainTPMBackendType type;
    virDomainDeviceInfo info;
    enum virDomainTPMModel model;
    union {
        struct {
            virDomainChrSourceDef source;
        } passthrough;
    } data;
};

1221 1222 1223 1224
enum virDomainInputType {
    VIR_DOMAIN_INPUT_TYPE_MOUSE,
    VIR_DOMAIN_INPUT_TYPE_TABLET,

1225
    VIR_DOMAIN_INPUT_TYPE_LAST
1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238
};

enum virDomainInputBus {
    VIR_DOMAIN_INPUT_BUS_PS2,
    VIR_DOMAIN_INPUT_BUS_USB,
    VIR_DOMAIN_INPUT_BUS_XEN,

    VIR_DOMAIN_INPUT_BUS_LAST
};

struct _virDomainInputDef {
    int type;
    int bus;
1239
    virDomainDeviceInfo info;
1240 1241
};

1242 1243 1244 1245 1246 1247 1248
enum virDomainSoundCodecType {
    VIR_DOMAIN_SOUND_CODEC_TYPE_DUPLEX,
    VIR_DOMAIN_SOUND_CODEC_TYPE_MICRO,

    VIR_DOMAIN_SOUND_CODEC_TYPE_LAST
};

1249 1250 1251 1252
enum virDomainSoundModel {
    VIR_DOMAIN_SOUND_MODEL_SB16,
    VIR_DOMAIN_SOUND_MODEL_ES1370,
    VIR_DOMAIN_SOUND_MODEL_PCSPK,
D
Daniel P. Berrange 已提交
1253
    VIR_DOMAIN_SOUND_MODEL_AC97,
1254
    VIR_DOMAIN_SOUND_MODEL_ICH6,
1255 1256 1257 1258

    VIR_DOMAIN_SOUND_MODEL_LAST
};

1259 1260 1261 1262 1263
struct _virDomainSoundCodecDef {
    int type;
    int cad;
};

1264 1265
struct _virDomainSoundDef {
    int model;
1266
    virDomainDeviceInfo info;
1267

1268
    size_t ncodecs;
1269
    virDomainSoundCodecDefPtr *codecs;
1270 1271
};

R
Richard Jones 已提交
1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283
enum virDomainWatchdogModel {
    VIR_DOMAIN_WATCHDOG_MODEL_I6300ESB,
    VIR_DOMAIN_WATCHDOG_MODEL_IB700,

    VIR_DOMAIN_WATCHDOG_MODEL_LAST
};

enum virDomainWatchdogAction {
    VIR_DOMAIN_WATCHDOG_ACTION_RESET,
    VIR_DOMAIN_WATCHDOG_ACTION_SHUTDOWN,
    VIR_DOMAIN_WATCHDOG_ACTION_POWEROFF,
    VIR_DOMAIN_WATCHDOG_ACTION_PAUSE,
H
Hu Tao 已提交
1284
    VIR_DOMAIN_WATCHDOG_ACTION_DUMP,
R
Richard Jones 已提交
1285 1286 1287 1288 1289 1290 1291 1292
    VIR_DOMAIN_WATCHDOG_ACTION_NONE,

    VIR_DOMAIN_WATCHDOG_ACTION_LAST
};

struct _virDomainWatchdogDef {
    int model;
    int action;
1293
    virDomainDeviceInfo info;
R
Richard Jones 已提交
1294 1295
};

1296 1297 1298 1299 1300 1301 1302

enum virDomainVideoType {
    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,
1303
    VIR_DOMAIN_VIDEO_TYPE_QXL,
1304 1305 1306 1307 1308

    VIR_DOMAIN_VIDEO_TYPE_LAST
};


1309 1310 1311
typedef struct _virDomainVideoAccelDef virDomainVideoAccelDef;
typedef virDomainVideoAccelDef *virDomainVideoAccelDefPtr;
struct _virDomainVideoAccelDef {
1312 1313
    bool support3d;
    bool support2d;
1314 1315 1316
};


1317 1318
struct _virDomainVideoDef {
    int type;
1319 1320
    unsigned int ram;  /* kibibytes (multiples of 1024) */
    unsigned int vram; /* kibibytes (multiples of 1024) */
1321
    unsigned int heads;
1322
    bool primary;
1323
    virDomainVideoAccelDefPtr accel;
1324
    virDomainDeviceInfo info;
1325 1326
};

1327
/* graphics console modes */
1328 1329 1330
enum virDomainGraphicsType {
    VIR_DOMAIN_GRAPHICS_TYPE_SDL,
    VIR_DOMAIN_GRAPHICS_TYPE_VNC,
1331 1332
    VIR_DOMAIN_GRAPHICS_TYPE_RDP,
    VIR_DOMAIN_GRAPHICS_TYPE_DESKTOP,
1333
    VIR_DOMAIN_GRAPHICS_TYPE_SPICE,
1334

1335
    VIR_DOMAIN_GRAPHICS_TYPE_LAST
1336 1337
};

1338 1339 1340 1341 1342 1343 1344 1345 1346
enum virDomainGraphicsVNCSharePolicy {
    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
};

1347 1348 1349 1350 1351 1352 1353 1354 1355
enum virDomainGraphicsAuthConnectedType {
    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
};

1356 1357 1358 1359
typedef struct _virDomainGraphicsAuthDef virDomainGraphicsAuthDef;
typedef virDomainGraphicsAuthDef *virDomainGraphicsAuthDefPtr;
struct _virDomainGraphicsAuthDef {
    char *passwd;
1360
    bool expires; /* Whether there is an expiry time set */
1361
    time_t validTo;  /* seconds since epoch */
1362
    int connected; /* action if connected */
1363 1364
};

1365 1366 1367 1368 1369 1370 1371
enum virDomainGraphicsSpiceChannelName {
    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 已提交
1372
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_SMARTCARD,
1373
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_USBREDIR,
1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384

    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST
};

enum virDomainGraphicsSpiceChannelMode {
    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
};
1385

1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423
enum virDomainGraphicsSpiceImageCompression {
    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
};

enum virDomainGraphicsSpiceJpegCompression {
    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
};

enum virDomainGraphicsSpiceZlibCompression {
    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
};

enum virDomainGraphicsSpicePlaybackCompression {
    VIR_DOMAIN_GRAPHICS_SPICE_PLAYBACK_COMPRESSION_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_PLAYBACK_COMPRESSION_ON,
    VIR_DOMAIN_GRAPHICS_SPICE_PLAYBACK_COMPRESSION_OFF,

    VIR_DOMAIN_GRAPHICS_SPICE_PLAYBACK_COMPRESSION_LAST
};

P
Peng Zhou 已提交
1424 1425 1426 1427 1428 1429 1430 1431
enum virDomainGraphicsSpiceMouseMode {
    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
};

1432 1433 1434 1435 1436 1437 1438 1439 1440
enum virDomainGraphicsSpiceStreamingMode {
    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
};

1441 1442 1443 1444 1445 1446 1447 1448
enum virDomainGraphicsSpiceClipboardCopypaste {
    VIR_DOMAIN_GRAPHICS_SPICE_CLIPBOARD_COPYPASTE_DEFAULT = 0,
    VIR_DOMAIN_GRAPHICS_SPICE_CLIPBOARD_COPYPASTE_YES,
    VIR_DOMAIN_GRAPHICS_SPICE_CLIPBOARD_COPYPASTE_NO,

    VIR_DOMAIN_GRAPHICS_SPICE_CLIPBOARD_COPYPASTE_LAST
};

1449 1450 1451 1452 1453
enum virDomainGraphicsListenType {
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NONE = 0,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_ADDRESS,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NETWORK,

1454
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_LAST
1455 1456
};

M
Marc-André Lureau 已提交
1457 1458 1459
enum virDomainHubType {
    VIR_DOMAIN_HUB_TYPE_USB,

1460
    VIR_DOMAIN_HUB_TYPE_LAST
M
Marc-André Lureau 已提交
1461 1462
};

1463 1464 1465 1466 1467 1468
typedef struct _virDomainGraphicsListenDef virDomainGraphicsListenDef;
typedef virDomainGraphicsListenDef *virDomainGraphicsListenDefPtr;
struct _virDomainGraphicsListenDef {
    int type;   /* enum virDomainGraphicsListenType */
    char *address;
    char *network;
1469
    bool fromConfig;    /* true if the @address is config file originated */
1470 1471
};

1472
struct _virDomainGraphicsDef {
M
Michal Privoznik 已提交
1473 1474 1475 1476 1477
    /* 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.
     */
1478 1479 1480 1481
    int type;
    union {
        struct {
            int port;
M
Martin Kletzander 已提交
1482
            int websocket;
1483
            bool autoport;
1484
            char *keymap;
1485
            char *socket;
1486
            virDomainGraphicsAuthDef auth;
1487
            int sharePolicy;
1488 1489 1490 1491
        } vnc;
        struct {
            char *display;
            char *xauth;
1492
            bool fullscreen;
1493
        } sdl;
1494 1495
        struct {
            int port;
1496 1497 1498
            bool autoport;
            bool replaceUser;
            bool multiUser;
1499 1500 1501
        } rdp;
        struct {
            char *display;
1502
            bool fullscreen;
1503
        } desktop;
1504 1505 1506
        struct {
            int port;
            int tlsPort;
P
Peng Zhou 已提交
1507
            int mousemode;
1508
            char *keymap;
1509
            virDomainGraphicsAuthDef auth;
1510
            bool autoport;
1511
            int channels[VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST];
1512
            int defaultMode; /* enum virDomainGraphicsSpiceChannelMode */
1513 1514 1515 1516
            int image;
            int jpeg;
            int zlib;
            int playback;
1517
            int streaming;
1518
            int copypaste;
1519
        } spice;
1520
    } data;
1521 1522 1523 1524 1525
    /* 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;
1526 1527
};

1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542
enum virDomainRedirdevBus {
    VIR_DOMAIN_REDIRDEV_BUS_USB,

    VIR_DOMAIN_REDIRDEV_BUS_LAST
};

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

    union {
        virDomainChrSourceDef chr;
    } source;

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

1544 1545 1546 1547 1548
struct _virDomainRedirFilterUsbDevDef {
    int usbClass;
    int vendor;
    int product;
    int version;
1549
    bool allow;
1550 1551 1552 1553 1554 1555 1556
};

struct _virDomainRedirFilterDef {
    size_t nusbdevs;
    virDomainRedirFilterUsbDevDefPtr *usbdevs;
};

1557 1558 1559 1560 1561 1562 1563 1564
enum virDomainMemDump {
    VIR_DOMAIN_MEM_DUMP_DEFAULT = 0,
    VIR_DOMAIN_MEM_DUMP_ON,
    VIR_DOMAIN_MEM_DUMP_OFF,

    VIR_DOMAIN_MEM_DUMP_LAST,
};

1565 1566 1567
enum {
    VIR_DOMAIN_MEMBALLOON_MODEL_VIRTIO,
    VIR_DOMAIN_MEMBALLOON_MODEL_XEN,
1568
    VIR_DOMAIN_MEMBALLOON_MODEL_NONE,
1569 1570 1571 1572 1573 1574 1575

    VIR_DOMAIN_MEMBALLOON_MODEL_LAST
};

struct _virDomainMemballoonDef {
    int model;
    virDomainDeviceInfo info;
1576
    unsigned int period; /* seconds between collections */
1577 1578
};

L
Li Zhang 已提交
1579 1580 1581
struct _virDomainNVRAMDef {
    virDomainDeviceInfo info;
};
1582

1583
enum virDomainSmbiosMode {
1584
    VIR_DOMAIN_SMBIOS_NONE = 0,
1585 1586 1587 1588 1589 1590 1591
    VIR_DOMAIN_SMBIOS_EMULATE,
    VIR_DOMAIN_SMBIOS_HOST,
    VIR_DOMAIN_SMBIOS_SYSINFO,

    VIR_DOMAIN_SMBIOS_LAST
};

1592

1593
# define VIR_DOMAIN_MAX_BOOT_DEVS 4
1594 1595 1596 1597 1598 1599 1600

enum virDomainBootOrder {
    VIR_DOMAIN_BOOT_FLOPPY,
    VIR_DOMAIN_BOOT_CDROM,
    VIR_DOMAIN_BOOT_DISK,
    VIR_DOMAIN_BOOT_NET,

1601
    VIR_DOMAIN_BOOT_LAST
1602 1603
};

1604 1605 1606 1607
enum virDomainBootMenu {
    VIR_DOMAIN_BOOT_MENU_DEFAULT = 0,
    VIR_DOMAIN_BOOT_MENU_ENABLED,
    VIR_DOMAIN_BOOT_MENU_DISABLED,
1608 1609

    VIR_DOMAIN_BOOT_MENU_LAST
1610 1611
};

1612 1613 1614 1615
enum virDomainFeature {
    VIR_DOMAIN_FEATURE_ACPI,
    VIR_DOMAIN_FEATURE_APIC,
    VIR_DOMAIN_FEATURE_PAE,
J
Jim Fehlig 已提交
1616
    VIR_DOMAIN_FEATURE_HAP,
1617
    VIR_DOMAIN_FEATURE_VIRIDIAN,
1618
    VIR_DOMAIN_FEATURE_PRIVNET,
1619
    VIR_DOMAIN_FEATURE_HYPERV,
1620 1621 1622 1623

    VIR_DOMAIN_FEATURE_LAST
};

1624 1625 1626 1627
enum virDomainFeatureState {
    VIR_DOMAIN_FEATURE_STATE_DEFAULT = 0,
    VIR_DOMAIN_FEATURE_STATE_ON,
    VIR_DOMAIN_FEATURE_STATE_OFF,
1628

1629
    VIR_DOMAIN_FEATURE_STATE_LAST
1630 1631
};

1632 1633
enum virDomainHyperv {
    VIR_DOMAIN_HYPERV_RELAXED = 0,
1634 1635
    VIR_DOMAIN_HYPERV_VAPIC,
    VIR_DOMAIN_HYPERV_SPINLOCKS,
1636 1637 1638 1639

    VIR_DOMAIN_HYPERV_LAST
};

1640 1641 1642 1643 1644 1645 1646 1647 1648
enum virDomainLifecycleAction {
    VIR_DOMAIN_LIFECYCLE_DESTROY,
    VIR_DOMAIN_LIFECYCLE_RESTART,
    VIR_DOMAIN_LIFECYCLE_RESTART_RENAME,
    VIR_DOMAIN_LIFECYCLE_PRESERVE,

    VIR_DOMAIN_LIFECYCLE_LAST
};

1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659
enum virDomainLifecycleCrashAction {
    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
};

1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671
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)

1672 1673 1674 1675 1676
enum virDomainPMState {
    VIR_DOMAIN_PM_STATE_DEFAULT = 0,
    VIR_DOMAIN_PM_STATE_ENABLED,
    VIR_DOMAIN_PM_STATE_DISABLED,

1677
    VIR_DOMAIN_PM_STATE_LAST
1678 1679
};

M
Michal Privoznik 已提交
1680 1681 1682 1683 1684 1685 1686 1687 1688 1689
enum virDomainBIOSUseserial {
    VIR_DOMAIN_BIOS_USESERIAL_DEFAULT = 0,
    VIR_DOMAIN_BIOS_USESERIAL_YES,
    VIR_DOMAIN_BIOS_USESERIAL_NO
};

typedef struct _virDomainBIOSDef virDomainBIOSDef;
typedef virDomainBIOSDef *virDomainBIOSDefPtr;
struct _virDomainBIOSDef {
    int useserial;
1690 1691 1692
    /* reboot-timeout parameters */
    bool rt_set;
    int rt_delay;
M
Michal Privoznik 已提交
1693 1694
};

1695 1696 1697 1698 1699
/* Operating system configuration data & machine / arch */
typedef struct _virDomainOSDef virDomainOSDef;
typedef virDomainOSDef *virDomainOSDefPtr;
struct _virDomainOSDef {
    char *type;
1700
    virArch arch;
1701
    char *machine;
1702
    size_t nBootDevs;
1703
    int bootDevs[VIR_DOMAIN_BOOT_LAST];
1704
    /* enum virDomainBootMenu */
1705
    int bootmenu;
1706
    char *init;
1707
    char **initargv;
1708 1709 1710
    char *kernel;
    char *initrd;
    char *cmdline;
1711
    char *dtb;
1712 1713 1714 1715
    char *root;
    char *loader;
    char *bootloader;
    char *bootloaderArgs;
1716
    int smbios_mode;
1717

M
Michal Privoznik 已提交
1718
    virDomainBIOSDef bios;
1719 1720
};

1721 1722 1723 1724 1725 1726
enum virDomainTimerNameType {
    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 已提交
1727
    VIR_DOMAIN_TIMER_NAME_KVMCLOCK,
1728

1729
    VIR_DOMAIN_TIMER_NAME_LAST
1730 1731
};

1732 1733 1734 1735
enum virDomainTimerTrackType {
    VIR_DOMAIN_TIMER_TRACK_BOOT = 0,
    VIR_DOMAIN_TIMER_TRACK_GUEST,
    VIR_DOMAIN_TIMER_TRACK_WALL,
1736

1737
    VIR_DOMAIN_TIMER_TRACK_LAST
1738 1739 1740 1741 1742 1743 1744 1745
};

enum virDomainTimerTickpolicyType {
    VIR_DOMAIN_TIMER_TICKPOLICY_DELAY = 0,
    VIR_DOMAIN_TIMER_TICKPOLICY_CATCHUP,
    VIR_DOMAIN_TIMER_TICKPOLICY_MERGE,
    VIR_DOMAIN_TIMER_TICKPOLICY_DISCARD,

1746
    VIR_DOMAIN_TIMER_TICKPOLICY_LAST
1747 1748 1749 1750 1751 1752 1753
};

enum virDomainTimerModeType {
    VIR_DOMAIN_TIMER_MODE_AUTO = 0,
    VIR_DOMAIN_TIMER_MODE_NATIVE,
    VIR_DOMAIN_TIMER_MODE_EMULATE,
    VIR_DOMAIN_TIMER_MODE_PARAVIRT,
1754
    VIR_DOMAIN_TIMER_MODE_SMPSAFE,
1755

1756
    VIR_DOMAIN_TIMER_MODE_LAST
1757 1758
};

O
Osier Yang 已提交
1759
enum virDomainCpuPlacementMode {
1760
    VIR_DOMAIN_CPU_PLACEMENT_MODE_STATIC = 0,
O
Osier Yang 已提交
1761 1762
    VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO,

1763
    VIR_DOMAIN_CPU_PLACEMENT_MODE_LAST
O
Osier Yang 已提交
1764 1765
};

1766 1767 1768 1769 1770 1771 1772 1773
typedef struct _virDomainTimerCatchupDef virDomainTimerCatchupDef;
typedef virDomainTimerCatchupDef *virDomainTimerCatchupDefPtr;
struct _virDomainTimerCatchupDef {
    unsigned long threshold;
    unsigned long slew;
    unsigned long limit;
};

1774 1775 1776 1777 1778 1779 1780
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 */

1781 1782 1783 1784
    virDomainTimerCatchupDef catchup;

    /* track is only valid for name='platform|rtc' */
    int track;  /* host|guest */
1785 1786 1787 1788 1789 1790

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

1791 1792 1793
enum virDomainClockOffsetType {
    VIR_DOMAIN_CLOCK_OFFSET_UTC = 0,
    VIR_DOMAIN_CLOCK_OFFSET_LOCALTIME = 1,
1794
    VIR_DOMAIN_CLOCK_OFFSET_VARIABLE = 2,
1795
    VIR_DOMAIN_CLOCK_OFFSET_TIMEZONE = 3,
1796

1797
    VIR_DOMAIN_CLOCK_OFFSET_LAST
1798 1799
};

1800 1801 1802 1803
enum virDomainClockBasis {
    VIR_DOMAIN_CLOCK_BASIS_UTC = 0,
    VIR_DOMAIN_CLOCK_BASIS_LOCALTIME = 1,

1804
    VIR_DOMAIN_CLOCK_BASIS_LAST
1805 1806
};

1807 1808 1809 1810
typedef struct _virDomainClockDef virDomainClockDef;
typedef virDomainClockDef *virDomainClockDefPtr;
struct _virDomainClockDef {
    int offset;
1811

1812
    union {
1813 1814 1815
        /* Bug-compatibility-mode for Xen utc|localtime */
        int utc_reset;
        /* Adjustment in seconds, relative to UTC or LOCALTIME, when
1816
         * offset == VIR_DOMAIN_CLOCK_OFFSET_VARIABLE */
1817 1818 1819
        struct {
            long long adjustment;
            int basis;
1820 1821 1822 1823 1824

            /* Store the base date (-rtc base=$date, in seconds
             * since the Epoch) of guest process, internal only
             */
            unsigned long long basedate;
1825
        } variable;
1826 1827 1828 1829 1830

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

1832
    size_t ntimers;
1833
    virDomainTimerDefPtr *timers;
1834 1835
};

1836
# define VIR_DOMAIN_CPUMASK_LEN 1024
1837

E
Eric Blake 已提交
1838 1839 1840
typedef struct _virDomainVcpuPinDef virDomainVcpuPinDef;
typedef virDomainVcpuPinDef *virDomainVcpuPinDefPtr;
struct _virDomainVcpuPinDef {
1841
    int vcpuid;
H
Hu Tao 已提交
1842
    virBitmapPtr cpumask;
1843 1844
};

H
Hu Tao 已提交
1845 1846
void virDomainVcpuPinDefFree(virDomainVcpuPinDefPtr def);
void virDomainVcpuPinDefArrayFree(virDomainVcpuPinDefPtr *def, int nvcpupin);
1847 1848 1849 1850

virDomainVcpuPinDefPtr *virDomainVcpuPinDefCopy(virDomainVcpuPinDefPtr *src,
                                                int nvcpupin);

E
Eric Blake 已提交
1851
int virDomainVcpuPinIsDuplicate(virDomainVcpuPinDefPtr *def,
1852 1853 1854
                                int nvcpupin,
                                int vcpu);

E
Eric Blake 已提交
1855
virDomainVcpuPinDefPtr virDomainVcpuPinFindByVcpu(virDomainVcpuPinDefPtr *def,
1856 1857 1858
                                                  int nvcpupin,
                                                  int vcpu);

1859 1860 1861 1862 1863 1864 1865
typedef struct _virBlkioDeviceWeight virBlkioDeviceWeight;
typedef virBlkioDeviceWeight *virBlkioDeviceWeightPtr;
struct _virBlkioDeviceWeight {
    char *path;
    unsigned int weight;
};

1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882
enum virDomainRNGModel {
    VIR_DOMAIN_RNG_MODEL_VIRTIO,

    VIR_DOMAIN_RNG_MODEL_LAST
};

enum virDomainRNGBackend {
    VIR_DOMAIN_RNG_BACKEND_RANDOM,
    VIR_DOMAIN_RNG_BACKEND_EGD,
    /* VIR_DOMAIN_RNG_BACKEND_POOL, */

    VIR_DOMAIN_RNG_BACKEND_LAST
};

struct _virDomainRNGDef {
    int model;
    int backend;
1883 1884
    unsigned int rate; /* bytes per period */
    unsigned int period; /* milliseconds */
1885 1886 1887 1888 1889 1890 1891 1892 1893 1894

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

    virDomainDeviceInfo info;
};

1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909
struct _virDomainIdMapEntry {
    unsigned int start;
    unsigned int target;
    unsigned int count;
};

struct _virDomainIdMapDef {
    size_t nuidmap;
    virDomainIdMapEntryPtr uidmap;

    size_t ngidmap;
    virDomainIdMapEntryPtr gidmap;
};


1910 1911 1912
void virBlkioDeviceWeightArrayClear(virBlkioDeviceWeightPtr deviceWeights,
                                    int ndevices);

1913 1914 1915 1916 1917
typedef struct _virDomainResourceDef virDomainResourceDef;
typedef virDomainResourceDef *virDomainResourceDefPtr;
struct _virDomainResourceDef {
    char *partition;
};
1918

1919 1920 1921 1922 1923 1924
/*
 * Guest VM main configuration
 *
 * NB: if adding to this struct, virDomainDefCheckABIStability
 * may well need an update
 */
1925 1926 1927 1928 1929 1930 1931
typedef struct _virDomainDef virDomainDef;
typedef virDomainDef *virDomainDefPtr;
struct _virDomainDef {
    int virtType;
    int id;
    unsigned char uuid[VIR_UUID_BUFLEN];
    char *name;
1932
    char *title;
1933
    char *description;
1934

1935 1936
    struct {
        unsigned int weight;
1937 1938 1939

        size_t ndevices;
        virBlkioDeviceWeightPtr devices;
1940 1941
    } blkio;

1942
    struct {
1943 1944 1945
        unsigned long long max_balloon; /* in kibibytes */
        unsigned long long cur_balloon; /* in kibibytes */
        bool hugepage_backed;
1946
        bool nosharepages;
1947
        bool locked;
1948
        int dump_core; /* enum virDomainMemDump */
1949 1950 1951 1952
        unsigned long long hard_limit; /* in kibibytes */
        unsigned long long soft_limit; /* in kibibytes */
        unsigned long long min_guarantee; /* in kibibytes */
        unsigned long long swap_hard_limit; /* in kibibytes */
1953
    } mem;
E
Eric Blake 已提交
1954 1955
    unsigned short vcpus;
    unsigned short maxvcpus;
O
Osier Yang 已提交
1956
    int placement_mode;
H
Hu Tao 已提交
1957
    virBitmapPtr cpumask;
1958

1959 1960
    struct {
        unsigned long shares;
1961 1962
        unsigned long long period;
        long long quota;
1963 1964
        unsigned long long emulator_period;
        long long emulator_quota;
1965
        int nvcpupin;
E
Eric Blake 已提交
1966
        virDomainVcpuPinDefPtr *vcpupin;
T
Tang Chen 已提交
1967
        virDomainVcpuPinDefPtr emulatorpin;
1968 1969
    } cputune;

G
Gao feng 已提交
1970
    virNumaTuneDef numatune;
1971
    virDomainResourceDefPtr resource;
1972
    virDomainIdMapDef idmap;
1973

1974 1975 1976 1977 1978
    /* These 3 are based on virDomainLifeCycleAction enum flags */
    int onReboot;
    int onPoweroff;
    int onCrash;

1979 1980
    int onLockFailure; /* enum virDomainLockFailureAction */

1981 1982 1983 1984 1985 1986
    struct {
        /* These options are actually type of enum virDomainPMState */
        int s3;
        int s4;
    } pm;

1987 1988 1989
    virDomainOSDef os;
    char *emulator;
    int features;
1990
    /* enum virDomainFeatureState */
1991
    int apic_eoi;
1992 1993
    /* These options are of type virDomainFeatureState */
    int hyperv_features[VIR_DOMAIN_HYPERV_LAST];
1994
    unsigned int hyperv_spinlocks;
1995

1996
    virDomainClockDef clock;
1997

1998
    size_t ngraphics;
1999
    virDomainGraphicsDefPtr *graphics;
2000

2001
    size_t ndisks;
2002 2003
    virDomainDiskDefPtr *disks;

2004
    size_t ncontrollers;
2005 2006
    virDomainControllerDefPtr *controllers;

2007
    size_t nfss;
2008 2009
    virDomainFSDefPtr *fss;

2010
    size_t nnets;
2011 2012
    virDomainNetDefPtr *nets;

2013
    size_t ninputs;
2014 2015
    virDomainInputDefPtr *inputs;

2016
    size_t nsounds;
2017 2018
    virDomainSoundDefPtr *sounds;

2019
    size_t nvideos;
2020 2021
    virDomainVideoDefPtr *videos;

2022
    size_t nhostdevs;
2023 2024
    virDomainHostdevDefPtr *hostdevs;

2025
    size_t nredirdevs;
2026 2027
    virDomainRedirdevDefPtr *redirdevs;

2028
    size_t nsmartcards;
E
Eric Blake 已提交
2029 2030
    virDomainSmartcardDefPtr *smartcards;

2031
    size_t nserials;
2032 2033
    virDomainChrDefPtr *serials;

2034
    size_t nparallels;
2035 2036
    virDomainChrDefPtr *parallels;

2037
    size_t nchannels;
2038 2039
    virDomainChrDefPtr *channels;

2040
    size_t nconsoles;
2041 2042
    virDomainChrDefPtr *consoles;

2043
    size_t nleases;
2044 2045
    virDomainLeaseDefPtr *leases;

2046
    size_t nhubs;
M
Marc-André Lureau 已提交
2047 2048
    virDomainHubDefPtr *hubs;

2049 2050 2051
    size_t nseclabels;
    virSecurityLabelDefPtr *seclabels;

2052
    /* Only 1 */
R
Richard Jones 已提交
2053
    virDomainWatchdogDefPtr watchdog;
2054
    virDomainMemballoonDefPtr memballoon;
L
Li Zhang 已提交
2055
    virDomainNVRAMDefPtr nvram;
2056
    virDomainTPMDefPtr tpm;
2057
    virCPUDefPtr cpu;
2058
    virSysinfoDefPtr sysinfo;
2059
    virDomainRedirFilterDefPtr redirfilter;
2060
    virDomainRNGDefPtr rng;
2061 2062 2063

    void *namespaceData;
    virDomainXMLNamespace ns;
2064 2065 2066

    /* Application-specific custom metadata */
    xmlNodePtr metadata;
2067 2068
};

2069 2070 2071 2072 2073 2074
enum virDomainTaintFlags {
    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 */
2075
    VIR_DOMAIN_TAINT_EXTERNAL_LAUNCH,  /* Externally launched guest domain */
2076
    VIR_DOMAIN_TAINT_HOST_CPU,         /* Host CPU passthrough in use */
2077 2078 2079 2080

    VIR_DOMAIN_TAINT_LAST
};

2081
/* Guest VM runtime state */
J
Jiri Denemark 已提交
2082 2083 2084 2085 2086 2087
typedef struct _virDomainStateReason virDomainStateReason;
struct _virDomainStateReason {
    int state;
    int reason;
};

2088 2089 2090
typedef struct _virDomainObj virDomainObj;
typedef virDomainObj *virDomainObjPtr;
struct _virDomainObj {
2091
    virObjectLockable parent;
2092

2093
    pid_t pid;
J
Jiri Denemark 已提交
2094
    virDomainStateReason state;
2095 2096 2097

    unsigned int autostart : 1;
    unsigned int persistent : 1;
2098
    unsigned int updated : 1;
2099 2100 2101

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

2103
    virDomainSnapshotObjListPtr snapshots;
C
Chris Lalancette 已提交
2104 2105
    virDomainSnapshotObjPtr current_snapshot;

2106 2107
    bool hasManagedSave;

2108 2109
    void *privateData;
    void (*privateDataFreeFunc)(void *);
2110 2111

    int taint;
2112 2113
};

2114 2115
typedef struct _virDomainObjList virDomainObjList;
typedef virDomainObjList *virDomainObjListPtr;
2116

2117 2118 2119
typedef bool (*virDomainObjListFilter)(virConnectPtr conn,
                                       virDomainDefPtr def);

2120 2121 2122

/* This structure holds various callbacks and data needed
 * while parsing and creating domain XMLs */
2123 2124
typedef struct _virDomainXMLOption virDomainXMLOption;
typedef virDomainXMLOption *virDomainXMLOptionPtr;
2125 2126 2127 2128 2129 2130

typedef void *(*virDomainXMLPrivateDataAllocFunc)(void);
typedef void (*virDomainXMLPrivateDataFreeFunc)(void *);
typedef int (*virDomainXMLPrivateDataFormatFunc)(virBufferPtr, void *);
typedef int (*virDomainXMLPrivateDataParseFunc)(xmlXPathContextPtr, void *);

2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141
typedef int (*virDomainDefPostParseCallback)(virDomainDefPtr def,
                                             virCapsPtr caps,
                                             void *opaque);
typedef int (*virDomainDeviceDefPostParseCallback)(virDomainDeviceDefPtr dev,
                                                   virDomainDefPtr def,
                                                   virCapsPtr caps,
                                                   void *opaque);

typedef struct _virDomainDefParserConfig virDomainDefParserConfig;
typedef virDomainDefParserConfig *virDomainDefParserConfigPtr;
struct _virDomainDefParserConfig {
2142
    /* driver domain definition callbacks */
2143 2144 2145
    virDomainDefPostParseCallback domainPostParseCallback;
    virDomainDeviceDefPostParseCallback devicesPostParseCallback;

2146
    /* private data for the callbacks */
2147 2148
    void *priv;
    virFreeCallback privFree;
2149 2150 2151

    /* data */
    bool hasWideScsiBus;
2152
    unsigned char macPrefix[VIR_MAC_PREFIX_BUFLEN];
2153 2154
};

2155 2156 2157 2158 2159 2160 2161 2162 2163
typedef struct _virDomainXMLPrivateDataCallbacks virDomainXMLPrivateDataCallbacks;
typedef virDomainXMLPrivateDataCallbacks *virDomainXMLPrivateDataCallbacksPtr;
struct _virDomainXMLPrivateDataCallbacks {
    virDomainXMLPrivateDataAllocFunc  alloc;
    virDomainXMLPrivateDataFreeFunc   free;
    virDomainXMLPrivateDataFormatFunc format;
    virDomainXMLPrivateDataParseFunc  parse;
};

2164 2165 2166
virDomainXMLOptionPtr virDomainXMLOptionNew(virDomainDefParserConfigPtr config,
                                            virDomainXMLPrivateDataCallbacksPtr priv,
                                            virDomainXMLNamespacePtr xmlns);
2167

2168 2169
void virDomainNetGenerateMAC(virDomainXMLOptionPtr xmlopt, virMacAddrPtr mac);

2170
virDomainXMLNamespacePtr
2171
virDomainXMLOptionGetNamespace(virDomainXMLOptionPtr xmlopt)
2172 2173
    ATTRIBUTE_NONNULL(1);

2174 2175 2176 2177 2178
int
virDomainDefPostParse(virDomainDefPtr def,
                      virCapsPtr caps,
                      virDomainXMLOptionPtr xmlopt);

2179
static inline bool
D
Daniel P. Berrange 已提交
2180
virDomainObjIsActive(virDomainObjPtr dom)
2181 2182 2183 2184
{
    return dom->def->id != -1;
}

2185
virDomainObjPtr virDomainObjNew(virDomainXMLOptionPtr caps)
2186
    ATTRIBUTE_NONNULL(1);
2187

2188
virDomainObjListPtr virDomainObjListNew(void);
2189

2190 2191 2192 2193 2194 2195
virDomainObjPtr virDomainObjListFindByID(const virDomainObjListPtr doms,
                                         int id);
virDomainObjPtr virDomainObjListFindByUUID(const virDomainObjListPtr doms,
                                           const unsigned char *uuid);
virDomainObjPtr virDomainObjListFindByName(const virDomainObjListPtr doms,
                                           const char *name);
2196

2197 2198
bool virDomainObjTaint(virDomainObjPtr obj,
                       enum virDomainTaintFlags taint);
2199

2200
void virDomainResourceDefFree(virDomainResourceDefPtr resource);
2201 2202 2203
void virDomainGraphicsDefFree(virDomainGraphicsDefPtr def);
void virDomainInputDefFree(virDomainInputDefPtr def);
void virDomainDiskDefFree(virDomainDiskDefPtr def);
2204
void virDomainLeaseDefFree(virDomainLeaseDefPtr def);
2205
void virDomainDiskHostDefFree(virDomainDiskHostDefPtr def);
H
Han Cheng 已提交
2206 2207 2208
int virDomainDeviceFindControllerModel(virDomainDefPtr def,
                                       virDomainDeviceInfoPtr info,
                                       int controllerType);
2209 2210 2211
virDomainDiskDefPtr virDomainDiskFindByBusAndDst(virDomainDefPtr def,
                                                 int bus,
                                                 char *dst);
2212
void virDomainControllerDefFree(virDomainControllerDefPtr def);
2213
void virDomainFSDefFree(virDomainFSDefPtr def);
2214
void virDomainActualNetDefFree(virDomainActualNetDefPtr def);
2215
void virDomainNetDefFree(virDomainNetDefPtr def);
E
Eric Blake 已提交
2216
void virDomainSmartcardDefFree(virDomainSmartcardDefPtr def);
2217
void virDomainChrDefFree(virDomainChrDefPtr def);
2218
void virDomainChrSourceDefFree(virDomainChrSourceDefPtr def);
2219 2220
int virDomainChrSourceDefCopy(virDomainChrSourceDefPtr src,
                              virDomainChrSourceDefPtr dest);
2221
void virDomainSoundCodecDefFree(virDomainSoundCodecDefPtr def);
2222
void virDomainSoundDefFree(virDomainSoundDefPtr def);
2223
void virDomainMemballoonDefFree(virDomainMemballoonDefPtr def);
L
Li Zhang 已提交
2224
void virDomainNVRAMDefFree(virDomainNVRAMDefPtr def);
R
Richard Jones 已提交
2225
void virDomainWatchdogDefFree(virDomainWatchdogDefPtr def);
2226
void virDomainVideoDefFree(virDomainVideoDefPtr def);
2227 2228
virDomainHostdevDefPtr virDomainHostdevDefAlloc(void);
void virDomainHostdevDefClear(virDomainHostdevDefPtr def);
2229
void virDomainHostdevDefFree(virDomainHostdevDefPtr def);
M
Marc-André Lureau 已提交
2230
void virDomainHubDefFree(virDomainHubDefPtr def);
2231
void virDomainRedirdevDefFree(virDomainRedirdevDefPtr def);
2232
void virDomainRedirFilterDefFree(virDomainRedirFilterDefPtr def);
2233
void virDomainDeviceDefFree(virDomainDeviceDefPtr def);
2234
virDomainDeviceDefPtr virDomainDeviceDefCopy(virDomainDeviceDefPtr src,
2235
                                             const virDomainDefPtr def,
2236 2237
                                             virCapsPtr caps,
                                             virDomainXMLOptionPtr xmlopt);
2238 2239
int virDomainDeviceAddressIsValid(virDomainDeviceInfoPtr info,
                                  int type);
2240 2241
int virDomainDeviceInfoCopy(virDomainDeviceInfoPtr dst,
                            virDomainDeviceInfoPtr src);
2242
void virDomainDeviceInfoClear(virDomainDeviceInfoPtr info);
2243
void virDomainDefClearPCIAddresses(virDomainDefPtr def);
2244
void virDomainDefClearCCWAddresses(virDomainDefPtr def);
D
Daniel P. Berrange 已提交
2245
void virDomainDefClearDeviceAliases(virDomainDefPtr def);
2246
void virDomainTPMDefFree(virDomainTPMDefPtr def);
2247

2248
typedef int (*virDomainDeviceInfoCallback)(virDomainDefPtr def,
2249 2250
                                           virDomainDeviceDefPtr dev,
                                           virDomainDeviceInfoPtr info,
2251 2252 2253 2254 2255 2256
                                           void *opaque);

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

2257 2258
void virDomainDefFree(virDomainDefPtr vm);

M
Michal Novotny 已提交
2259 2260
virDomainChrDefPtr virDomainChrDefNew(void);

2261 2262 2263 2264
virDomainDefPtr virDomainDefNew(const char *name,
                                const unsigned char *uuid,
                                int id);

2265 2266 2267 2268
enum {
    VIR_DOMAIN_OBJ_LIST_ADD_LIVE = (1 << 0),
    VIR_DOMAIN_OBJ_LIST_ADD_CHECK_LIVE = (1 << 1),
};
2269 2270
virDomainObjPtr virDomainObjListAdd(virDomainObjListPtr doms,
                                    const virDomainDefPtr def,
2271
                                    virDomainXMLOptionPtr xmlopt,
2272 2273
                                    unsigned int flags,
                                    virDomainDefPtr *oldDef);
2274 2275
void virDomainObjAssignDef(virDomainObjPtr domain,
                           const virDomainDefPtr def,
2276 2277
                           bool live,
                           virDomainDefPtr *oldDef);
2278
int virDomainObjSetDefTransient(virCapsPtr caps,
2279
                                virDomainXMLOptionPtr xmlopt,
2280 2281
                                virDomainObjPtr domain,
                                bool live);
2282 2283
virDomainDefPtr
virDomainObjGetPersistentDef(virCapsPtr caps,
2284
                             virDomainXMLOptionPtr xmlopt,
2285
                             virDomainObjPtr domain);
2286 2287 2288

int
virDomainLiveConfigHelperMethod(virCapsPtr caps,
2289
                                virDomainXMLOptionPtr xmlopt,
2290 2291 2292 2293
                                virDomainObjPtr dom,
                                unsigned int *flags,
                                virDomainDefPtr *persistentDef);

2294 2295 2296 2297 2298 2299 2300
virDomainDefPtr virDomainDefCopy(virDomainDefPtr src,
                                 virCapsPtr caps,
                                 virDomainXMLOptionPtr xmlopt,
                                 bool migratable);
virDomainDefPtr virDomainObjCopyPersistentDef(virDomainObjPtr dom,
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt);
2301

2302 2303
void virDomainObjListRemove(virDomainObjListPtr doms,
                            virDomainObjPtr dom);
2304 2305
void virDomainObjListRemoveLocked(virDomainObjListPtr doms,
                                  virDomainObjPtr dom);
2306

2307
virDomainDeviceDefPtr virDomainDeviceDefParse(const char *xmlStr,
2308
                                              virDomainDefPtr def,
2309 2310
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2311
                                              unsigned int flags);
2312 2313
virDomainDefPtr virDomainDefParseString(const char *xmlStr,
                                        virCapsPtr caps,
2314
                                        virDomainXMLOptionPtr xmlopt,
M
Matthias Bolte 已提交
2315
                                        unsigned int expectedVirtTypes,
L
Laine Stump 已提交
2316
                                        unsigned int flags);
2317 2318
virDomainDefPtr virDomainDefParseFile(const char *filename,
                                      virCapsPtr caps,
2319
                                      virDomainXMLOptionPtr xmlopt,
M
Matthias Bolte 已提交
2320
                                      unsigned int expectedVirtTypes,
L
Laine Stump 已提交
2321
                                      unsigned int flags);
2322
virDomainDefPtr virDomainDefParseNode(xmlDocPtr doc,
2323
                                      xmlNodePtr root,
2324 2325
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
M
Matthias Bolte 已提交
2326
                                      unsigned int expectedVirtTypes,
L
Laine Stump 已提交
2327
                                      unsigned int flags);
2328

2329 2330 2331
bool virDomainDefCheckABIStability(virDomainDefPtr src,
                                   virDomainDefPtr dst);

2332
int virDomainDefAddImplicitControllers(virDomainDefPtr def);
2333

2334
char *virDomainDefFormat(virDomainDefPtr def,
L
Laine Stump 已提交
2335
                         unsigned int flags);
2336 2337 2338
int virDomainDefFormatInternal(virDomainDefPtr def,
                               unsigned int flags,
                               virBufferPtr buf);
2339

2340 2341 2342
int virDomainDefCompatibleDevice(virDomainDefPtr def,
                                 virDomainDeviceDefPtr dev);

2343
int virDomainVcpuPinAdd(virDomainVcpuPinDefPtr **vcpupin_list,
H
Hu Tao 已提交
2344
                        int *nvcpupin,
2345 2346 2347 2348
                        unsigned char *cpumap,
                        int maplen,
                        int vcpu);

E
Eric Blake 已提交
2349
int virDomainVcpuPinDel(virDomainDefPtr def, int vcpu);
2350

2351 2352 2353 2354 2355 2356
int virDomainEmulatorPinAdd(virDomainDefPtr def,
                              unsigned char *cpumap,
                              int maplen);

int virDomainEmulatorPinDel(virDomainDefPtr def);

2357 2358
void virDomainRNGDefFree(virDomainRNGDefPtr def);

2359 2360 2361
int virDomainDiskIndexByName(virDomainDefPtr def, const char *name,
                             bool allow_ambiguous);
const char *virDomainDiskPathByName(virDomainDefPtr, const char *name);
2362 2363 2364 2365
int virDomainDiskInsert(virDomainDefPtr def,
                        virDomainDiskDefPtr disk);
void virDomainDiskInsertPreAlloced(virDomainDefPtr def,
                                   virDomainDiskDefPtr disk);
2366 2367
int virDomainDiskDefAssignAddress(virDomainXMLOptionPtr xmlopt,
                                  virDomainDiskDefPtr def);
2368

2369 2370 2371 2372
virDomainDiskDefPtr
virDomainDiskRemove(virDomainDefPtr def, size_t i);
virDomainDiskDefPtr
virDomainDiskRemoveByName(virDomainDefPtr def, const char *name);
E
Eric Blake 已提交
2373
bool virDomainHasDiskMirror(virDomainObjPtr vm);
2374

2375 2376
int virDomainNetFindIdx(virDomainDefPtr def, virDomainNetDefPtr net);
virDomainNetDefPtr virDomainNetFind(virDomainDefPtr def, const char *device);
2377
int virDomainNetInsert(virDomainDefPtr def, virDomainNetDefPtr net);
2378
virDomainNetDefPtr virDomainNetRemove(virDomainDefPtr def, size_t i);
2379
void virDomainNetRemoveHostdev(virDomainDefPtr def, virDomainNetDefPtr net);
2380

L
Laine Stump 已提交
2381
int virDomainHostdevInsert(virDomainDefPtr def, virDomainHostdevDefPtr hostdev);
2382 2383
virDomainHostdevDefPtr
virDomainHostdevRemove(virDomainDefPtr def, size_t i);
L
Laine Stump 已提交
2384 2385 2386
int virDomainHostdevFind(virDomainDefPtr def, virDomainHostdevDefPtr match,
                         virDomainHostdevDefPtr *found);

2387
int virDomainGraphicsListenGetType(virDomainGraphicsDefPtr def, size_t i)
2388
            ATTRIBUTE_NONNULL(1);
2389
int virDomainGraphicsListenSetType(virDomainGraphicsDefPtr def, size_t i, int val)
2390 2391
            ATTRIBUTE_NONNULL(1);
const char *virDomainGraphicsListenGetAddress(virDomainGraphicsDefPtr def,
2392
                                              size_t i)
2393 2394
            ATTRIBUTE_NONNULL(1);
int virDomainGraphicsListenSetAddress(virDomainGraphicsDefPtr def,
2395
                                      size_t i, const char *address,
2396 2397 2398
                                      int len, bool setType)
            ATTRIBUTE_NONNULL(1);
const char *virDomainGraphicsListenGetNetwork(virDomainGraphicsDefPtr def,
2399
                                              size_t i)
2400 2401
            ATTRIBUTE_NONNULL(1);
int virDomainGraphicsListenSetNetwork(virDomainGraphicsDefPtr def,
2402
                                      size_t i, const char *network, int len)
2403 2404
            ATTRIBUTE_NONNULL(1);

2405
int virDomainNetGetActualType(virDomainNetDefPtr iface);
2406 2407
const char *virDomainNetGetActualBridgeName(virDomainNetDefPtr iface);
const char *virDomainNetGetActualDirectDev(virDomainNetDefPtr iface);
2408
int virDomainNetGetActualDirectMode(virDomainNetDefPtr iface);
2409
virDomainHostdevDefPtr virDomainNetGetActualHostdev(virDomainNetDefPtr iface);
2410
virNetDevVPortProfilePtr
2411
virDomainNetGetActualVirtPortProfile(virDomainNetDefPtr iface);
2412
virNetDevBandwidthPtr
2413
virDomainNetGetActualBandwidth(virDomainNetDefPtr iface);
2414
virNetDevVlanPtr virDomainNetGetActualVlan(virDomainNetDefPtr iface);
2415

2416 2417 2418 2419
int virDomainControllerInsert(virDomainDefPtr def,
                              virDomainControllerDefPtr controller);
void virDomainControllerInsertPreAlloced(virDomainDefPtr def,
                                         virDomainControllerDefPtr controller);
2420 2421
int virDomainControllerFind(virDomainDefPtr def, int type, int idx);
virDomainControllerDefPtr virDomainControllerRemove(virDomainDefPtr def, size_t i);
2422 2423 2424 2425 2426 2427 2428 2429

int virDomainLeaseIndex(virDomainDefPtr def,
                        virDomainLeaseDefPtr lease);
int virDomainLeaseInsert(virDomainDefPtr def,
                         virDomainLeaseDefPtr lease);
int virDomainLeaseInsertPreAlloc(virDomainDefPtr def);
void virDomainLeaseInsertPreAlloced(virDomainDefPtr def,
                                    virDomainLeaseDefPtr lease);
2430 2431 2432 2433 2434
virDomainLeaseDefPtr
virDomainLeaseRemoveAt(virDomainDefPtr def, size_t i);
virDomainLeaseDefPtr
virDomainLeaseRemove(virDomainDefPtr def,
                     virDomainLeaseDefPtr lease);
2435

2436 2437 2438 2439 2440 2441 2442 2443
void
virDomainChrGetDomainPtrs(virDomainDefPtr vmdef,
                          virDomainChrDefPtr chr,
                          virDomainChrDefPtr ***arrPtr,
                          size_t **cntPtr);
virDomainChrDefPtr
virDomainChrFind(virDomainDefPtr def,
                 virDomainChrDefPtr target);
2444 2445 2446
bool
virDomainChrEquals(virDomainChrDefPtr src,
                   virDomainChrDefPtr tgt);
2447 2448 2449 2450 2451 2452 2453
int
virDomainChrInsert(virDomainDefPtr vmdef,
                   virDomainChrDefPtr chr);
virDomainChrDefPtr
virDomainChrRemove(virDomainDefPtr vmdef,
                   virDomainChrDefPtr chr);

2454
int virDomainSaveXML(const char *configDir,
2455 2456 2457
                     virDomainDefPtr def,
                     const char *xml);

2458
int virDomainSaveConfig(const char *configDir,
2459
                        virDomainDefPtr def);
2460
int virDomainSaveStatus(virDomainXMLOptionPtr xmlopt,
2461
                        const char *statusDir,
2462
                        virDomainObjPtr obj) ATTRIBUTE_RETURN_CHECK;
2463

2464 2465 2466 2467
typedef void (*virDomainLoadConfigNotify)(virDomainObjPtr dom,
                                          int newDomain,
                                          void *opaque);

2468 2469 2470 2471
int virDomainObjListLoadAllConfigs(virDomainObjListPtr doms,
                                   const char *configDir,
                                   const char *autostartDir,
                                   int liveStatus,
2472 2473
                                   virCapsPtr caps,
                                   virDomainXMLOptionPtr xmlopt,
2474 2475 2476
                                   unsigned int expectedVirtTypes,
                                   virDomainLoadConfigNotify notify,
                                   void *opaque);
2477

2478
int virDomainDeleteConfig(const char *configDir,
2479
                          const char *autostartDir,
2480 2481
                          virDomainObjPtr dom);

2482
char *virDomainConfigFile(const char *dir,
2483 2484
                          const char *name);

2485 2486 2487 2488
int virDiskNameToBusDeviceIndex(virDomainDiskDefPtr disk,
                                int *busIdx,
                                int *devIdx);

2489
virDomainFSDefPtr virDomainGetRootFilesystem(virDomainDefPtr def);
2490
int virDomainFSIndexByName(virDomainDefPtr def, const char *name);
2491 2492
int virDomainVideoDefaultType(virDomainDefPtr def);
int virDomainVideoDefaultRAM(virDomainDefPtr def, int type);
2493

2494 2495 2496 2497
int virDomainObjListNumOfDomains(virDomainObjListPtr doms,
                                 bool active,
                                 virDomainObjListFilter filter,
                                 virConnectPtr conn);
2498 2499 2500

int virDomainObjListGetActiveIDs(virDomainObjListPtr doms,
                                 int *ids,
2501 2502 2503
                                 int maxids,
                                 virDomainObjListFilter filter,
                                 virConnectPtr conn);
2504 2505
int virDomainObjListGetInactiveNames(virDomainObjListPtr doms,
                                     char **const names,
2506 2507 2508
                                     int maxnames,
                                     virDomainObjListFilter filter,
                                     virConnectPtr conn);
2509

2510 2511 2512 2513 2514 2515 2516
typedef int (*virDomainObjListIterator)(virDomainObjPtr dom,
                                        void *opaque);

int virDomainObjListForEach(virDomainObjListPtr doms,
                            virDomainObjListIterator callback,
                            void *opaque);

E
Eric Blake 已提交
2517 2518 2519 2520 2521 2522 2523 2524 2525
typedef int (*virDomainSmartcardDefIterator)(virDomainDefPtr def,
                                             virDomainSmartcardDefPtr dev,
                                             void *opaque);

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

2526 2527 2528 2529 2530 2531 2532 2533 2534
typedef int (*virDomainChrDefIterator)(virDomainDefPtr def,
                                       virDomainChrDefPtr dev,
                                       void *opaque);

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

2535 2536 2537 2538 2539 2540 2541 2542 2543 2544
typedef int (*virDomainDiskDefPathIterator)(virDomainDiskDefPtr disk,
                                            const char *path,
                                            size_t depth,
                                            void *opaque);

int virDomainDiskDefForeachPath(virDomainDiskDefPtr disk,
                                bool ignoreOpenFailure,
                                virDomainDiskDefPathIterator iter,
                                void *opaque);

J
Jiri Denemark 已提交
2545 2546 2547 2548 2549 2550 2551
void
virDomainObjSetState(virDomainObjPtr obj, virDomainState state, int reason)
        ATTRIBUTE_NONNULL(1);
virDomainState
virDomainObjGetState(virDomainObjPtr obj, int *reason)
        ATTRIBUTE_NONNULL(1);

2552 2553 2554 2555 2556 2557
virSecurityLabelDefPtr
virDomainDefGetSecurityLabelDef(virDomainDefPtr def, const char *model);

virSecurityDeviceLabelDefPtr
virDomainDiskDefGetSecurityLabelDef(virDomainDiskDefPtr def, const char *model);

2558 2559 2560
virSecurityDeviceLabelDefPtr
virDomainChrDefGetSecurityLabelDef(virDomainChrDefPtr def, const char *model);

2561
virSecurityLabelDefPtr
2562
virDomainDefGenSecurityLabelDef(const char *model);
2563

2564
virSecurityDeviceLabelDefPtr
2565 2566 2567 2568
virDomainDiskDefGenSecurityLabelDef(const char *model);

void virSecurityLabelDefFree(virSecurityLabelDefPtr def);
void virSecurityDeviceLabelDefFree(virSecurityDeviceLabelDefPtr def);
2569

2570 2571
typedef const char* (*virEventActionToStringFunc)(int type);
typedef int (*virEventActionFromStringFunc)(const char *type);
2572

2573 2574
VIR_ENUM_DECL(virDomainTaint)

2575 2576
VIR_ENUM_DECL(virDomainVirt)
VIR_ENUM_DECL(virDomainBoot)
2577
VIR_ENUM_DECL(virDomainBootMenu)
2578
VIR_ENUM_DECL(virDomainFeature)
2579
VIR_ENUM_DECL(virDomainFeatureState)
2580
VIR_ENUM_DECL(virDomainLifecycle)
2581
VIR_ENUM_DECL(virDomainLifecycleCrash)
2582
VIR_ENUM_DECL(virDomainPMState)
2583
VIR_ENUM_DECL(virDomainDevice)
2584
VIR_ENUM_DECL(virDomainDeviceAddress)
2585 2586
VIR_ENUM_DECL(virDomainDisk)
VIR_ENUM_DECL(virDomainDiskDevice)
J
J.B. Joret 已提交
2587
VIR_ENUM_DECL(virDomainDiskGeometryTrans)
2588
VIR_ENUM_DECL(virDomainDiskBus)
2589
VIR_ENUM_DECL(virDomainDiskCache)
2590
VIR_ENUM_DECL(virDomainDiskErrorPolicy)
M
MORITA Kazutaka 已提交
2591
VIR_ENUM_DECL(virDomainDiskProtocol)
2592
VIR_ENUM_DECL(virDomainDiskProtocolTransport)
M
Matthias Dahl 已提交
2593
VIR_ENUM_DECL(virDomainDiskIo)
2594
VIR_ENUM_DECL(virDomainDiskSecretType)
2595
VIR_ENUM_DECL(virDomainDeviceSGIO)
2596
VIR_ENUM_DECL(virDomainDiskTray)
O
Osier Yang 已提交
2597
VIR_ENUM_DECL(virDomainDiskDiscard)
2598
VIR_ENUM_DECL(virDomainDiskSourcePoolMode)
2599
VIR_ENUM_DECL(virDomainIoEventFd)
2600
VIR_ENUM_DECL(virDomainVirtioEventIdx)
O
Osier Yang 已提交
2601
VIR_ENUM_DECL(virDomainDiskCopyOnRead)
2602
VIR_ENUM_DECL(virDomainController)
J
Ján Tomko 已提交
2603
VIR_ENUM_DECL(virDomainControllerModelPCI)
2604
VIR_ENUM_DECL(virDomainControllerModelSCSI)
M
Marc-André Lureau 已提交
2605
VIR_ENUM_DECL(virDomainControllerModelUSB)
2606
VIR_ENUM_DECL(virDomainFS)
2607
VIR_ENUM_DECL(virDomainFSDriverType)
2608
VIR_ENUM_DECL(virDomainFSAccessMode)
2609
VIR_ENUM_DECL(virDomainFSWrpolicy)
2610
VIR_ENUM_DECL(virDomainNet)
2611
VIR_ENUM_DECL(virDomainNetBackend)
2612
VIR_ENUM_DECL(virDomainNetVirtioTxMode)
2613
VIR_ENUM_DECL(virDomainNetInterfaceLinkState)
2614
VIR_ENUM_DECL(virDomainChrDevice)
2615
VIR_ENUM_DECL(virDomainChrChannelTarget)
2616
VIR_ENUM_DECL(virDomainChrConsoleTarget)
G
Guannan Ren 已提交
2617
VIR_ENUM_DECL(virDomainChrSerialTarget)
E
Eric Blake 已提交
2618
VIR_ENUM_DECL(virDomainSmartcard)
2619
VIR_ENUM_DECL(virDomainChr)
2620
VIR_ENUM_DECL(virDomainChrTcpProtocol)
E
Eric Blake 已提交
2621
VIR_ENUM_DECL(virDomainChrSpicevmc)
2622
VIR_ENUM_DECL(virDomainSoundCodec)
2623
VIR_ENUM_DECL(virDomainSoundModel)
2624
VIR_ENUM_DECL(virDomainMemDump)
2625
VIR_ENUM_DECL(virDomainMemballoonModel)
2626
VIR_ENUM_DECL(virDomainSmbiosMode)
R
Richard Jones 已提交
2627 2628
VIR_ENUM_DECL(virDomainWatchdogModel)
VIR_ENUM_DECL(virDomainWatchdogAction)
2629
VIR_ENUM_DECL(virDomainVideo)
2630 2631
VIR_ENUM_DECL(virDomainHostdevMode)
VIR_ENUM_DECL(virDomainHostdevSubsys)
2632
VIR_ENUM_DECL(virDomainHostdevCaps)
2633
VIR_ENUM_DECL(virDomainPciRombarMode)
M
Marc-André Lureau 已提交
2634
VIR_ENUM_DECL(virDomainHub)
2635
VIR_ENUM_DECL(virDomainRedirdevBus)
2636 2637 2638
VIR_ENUM_DECL(virDomainInput)
VIR_ENUM_DECL(virDomainInputBus)
VIR_ENUM_DECL(virDomainGraphics)
2639
VIR_ENUM_DECL(virDomainGraphicsListen)
2640
VIR_ENUM_DECL(virDomainGraphicsAuthConnected)
2641 2642
VIR_ENUM_DECL(virDomainGraphicsSpiceChannelName)
VIR_ENUM_DECL(virDomainGraphicsSpiceChannelMode)
2643 2644 2645 2646
VIR_ENUM_DECL(virDomainGraphicsSpiceImageCompression)
VIR_ENUM_DECL(virDomainGraphicsSpiceJpegCompression)
VIR_ENUM_DECL(virDomainGraphicsSpiceZlibCompression)
VIR_ENUM_DECL(virDomainGraphicsSpicePlaybackCompression)
2647
VIR_ENUM_DECL(virDomainGraphicsSpiceStreamingMode)
2648
VIR_ENUM_DECL(virDomainGraphicsSpiceClipboardCopypaste)
P
Peng Zhou 已提交
2649
VIR_ENUM_DECL(virDomainGraphicsSpiceMouseMode)
2650
VIR_ENUM_DECL(virDomainGraphicsVNCSharePolicy)
2651
VIR_ENUM_DECL(virDomainHyperv)
2652 2653
VIR_ENUM_DECL(virDomainRNGModel)
VIR_ENUM_DECL(virDomainRNGBackend)
2654 2655
VIR_ENUM_DECL(virDomainTPMModel)
VIR_ENUM_DECL(virDomainTPMBackend)
2656 2657
/* from libvirt.h */
VIR_ENUM_DECL(virDomainState)
J
Jiri Denemark 已提交
2658 2659 2660 2661 2662 2663 2664
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)
2665
VIR_ENUM_DECL(virDomainPMSuspendedReason)
J
Jiri Denemark 已提交
2666 2667 2668 2669

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

2670
VIR_ENUM_DECL(virDomainSeclabel)
2671
VIR_ENUM_DECL(virDomainClockOffset)
2672
VIR_ENUM_DECL(virDomainClockBasis)
2673

2674
VIR_ENUM_DECL(virDomainTimerName)
2675
VIR_ENUM_DECL(virDomainTimerTrack)
2676 2677
VIR_ENUM_DECL(virDomainTimerTickpolicy)
VIR_ENUM_DECL(virDomainTimerMode)
O
Osier Yang 已提交
2678
VIR_ENUM_DECL(virDomainCpuPlacementMode)
2679

2680
VIR_ENUM_DECL(virDomainStartupPolicy)
2681

O
Osier Yang 已提交
2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715
# define VIR_CONNECT_LIST_DOMAINS_FILTERS_ACTIVE   \
                (VIR_CONNECT_LIST_DOMAINS_ACTIVE | \
                 VIR_CONNECT_LIST_DOMAINS_INACTIVE)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_PERSISTENT   \
                (VIR_CONNECT_LIST_DOMAINS_PERSISTENT | \
                 VIR_CONNECT_LIST_DOMAINS_TRANSIENT)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_STATE     \
                (VIR_CONNECT_LIST_DOMAINS_RUNNING | \
                 VIR_CONNECT_LIST_DOMAINS_PAUSED  | \
                 VIR_CONNECT_LIST_DOMAINS_SHUTOFF | \
                 VIR_CONNECT_LIST_DOMAINS_OTHER)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_MANAGEDSAVE   \
                (VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE | \
                 VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_AUTOSTART   \
                (VIR_CONNECT_LIST_DOMAINS_AUTOSTART | \
                 VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_SNAPSHOT       \
                (VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT | \
                 VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT)

# define VIR_CONNECT_LIST_DOMAINS_FILTERS_ALL                   \
                (VIR_CONNECT_LIST_DOMAINS_FILTERS_ACTIVE      | \
                 VIR_CONNECT_LIST_DOMAINS_FILTERS_PERSISTENT  | \
                 VIR_CONNECT_LIST_DOMAINS_FILTERS_STATE       | \
                 VIR_CONNECT_LIST_DOMAINS_FILTERS_MANAGEDSAVE | \
                 VIR_CONNECT_LIST_DOMAINS_FILTERS_AUTOSTART   | \
                 VIR_CONNECT_LIST_DOMAINS_FILTERS_SNAPSHOT)

2716 2717 2718
int virDomainObjListExport(virDomainObjListPtr doms,
                           virConnectPtr conn,
                           virDomainPtr **domains,
2719
                           virDomainObjListFilter filter,
2720
                           unsigned int flags);
O
Osier Yang 已提交
2721

2722 2723 2724
virDomainVcpuPinDefPtr virDomainLookupVcpuPin(virDomainDefPtr def,
                                              int vcpuid);

2725 2726 2727 2728 2729 2730
int
virDomainDefMaybeAddController(virDomainDefPtr def,
                               int type,
                               int idx,
                               int model);

2731 2732
char *virDomainDefGetDefaultEmulator(virDomainDefPtr def, virCapsPtr caps);

2733 2734
int virDomainDefFindDevice(virDomainDefPtr def,
                           const char *devAlias,
2735 2736
                           virDomainDeviceDefPtr dev,
                           bool reportError);
2737

2738 2739 2740
bool virDomainDiskSourceIsBlockType(virDomainDiskDefPtr def)
    ATTRIBUTE_NONNULL(1);

2741 2742
void virDomainChrSourceDefClear(virDomainChrSourceDefPtr def);

2743 2744 2745 2746 2747 2748 2749
char *virDomainObjGetMetadata(virDomainObjPtr vm,
                              int type,
                              const char *uri,
                              virCapsPtr caps,
                              virDomainXMLOptionPtr xmlopt,
                              unsigned int flags);

2750 2751 2752 2753 2754 2755 2756 2757 2758 2759
int virDomainObjSetMetadata(virDomainObjPtr vm,
                            int type,
                            const char *metadata,
                            const char *key,
                            const char *uri,
                            virCapsPtr caps,
                            virDomainXMLOptionPtr xmlopt,
                            const char *configDir,
                            unsigned int flags);

2760
#endif /* __DOMAIN_CONF_H */