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

#ifndef __DOMAIN_CONF_H
26
# define __DOMAIN_CONF_H
27

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

32 33
# include "internal.h"
# include "capabilities.h"
34
# include "virstorageencryption.h"
35
# include "cpu_conf.h"
36
# include "virthread.h"
37
# include "virhash.h"
38
# include "virsocketaddr.h"
39
# include "networkcommon_conf.h"
40
# include "nwfilter_params.h"
41
# include "numa_conf.h"
42
# include "virnetdevmacvlan.h"
43
# include "virsysinfo.h"
44 45
# include "virnetdevvportprofile.h"
# include "virnetdevbandwidth.h"
46
# include "virnetdevvlan.h"
47
# include "virobject.h"
48
# include "device_conf.h"
49
# include "virbitmap.h"
50
# include "virstoragefile.h"
51
# include "virseclabel.h"
52
# include "virprocess.h"
53

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

75 76 77
typedef struct _virDomainSoundCodecDef virDomainSoundCodecDef;
typedef virDomainSoundCodecDef *virDomainSoundCodecDefPtr;

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

99 100
typedef struct _virDomainRedirFilterUSBDevDef virDomainRedirFilterUSBDevDef;
typedef virDomainRedirFilterUSBDevDef *virDomainRedirFilterUSBDevDefPtr;
101 102 103 104

typedef struct _virDomainRedirFilterDef virDomainRedirFilterDef;
typedef virDomainRedirFilterDef *virDomainRedirFilterDefPtr;

105 106 107 108 109 110 111 112 113
typedef struct _virDomainSmartcardDef virDomainSmartcardDef;
typedef virDomainSmartcardDef *virDomainSmartcardDefPtr;

typedef struct _virDomainChrDef virDomainChrDef;
typedef virDomainChrDef *virDomainChrDefPtr;

typedef struct _virDomainMemballoonDef virDomainMemballoonDef;
typedef virDomainMemballoonDef *virDomainMemballoonDefPtr;

L
Li Zhang 已提交
114 115 116
typedef struct _virDomainNVRAMDef virDomainNVRAMDef;
typedef virDomainNVRAMDef *virDomainNVRAMDefPtr;

117 118 119 120 121 122
typedef struct _virDomainSnapshotObj virDomainSnapshotObj;
typedef virDomainSnapshotObj *virDomainSnapshotObjPtr;

typedef struct _virDomainSnapshotObjList virDomainSnapshotObjList;
typedef virDomainSnapshotObjList *virDomainSnapshotObjListPtr;

123 124 125
typedef struct _virDomainRNGDef virDomainRNGDef;
typedef virDomainRNGDef *virDomainRNGDefPtr;

126 127 128 129 130 131
typedef struct _virDomainIdMapEntry virDomainIdMapEntry;
typedef virDomainIdMapEntry *virDomainIdMapEntryPtr;

typedef struct _virDomainIdMapDef virDomainIdMapDef;
typedef virDomainIdMapDef *virDomainIdMapDefPtr;

H
Hu Tao 已提交
132 133 134
typedef struct _virDomainPanicDef virDomainPanicDef;
typedef virDomainPanicDef *virDomainPanicDefPtr;

135 136 137
typedef struct _virDomainMemoryDef virDomainMemoryDef;
typedef virDomainMemoryDef *virDomainMemoryDefPtr;

M
Michele Paolino 已提交
138 139 140 141 142 143
/* forward declarations virDomainChrSourceDef, required by
 * virDomainNetDef
 */
typedef struct _virDomainChrSourceDef virDomainChrSourceDef;
typedef virDomainChrSourceDef *virDomainChrSourceDefPtr;

144 145 146
typedef struct _virDomainShmemDef virDomainShmemDef;
typedef virDomainShmemDef *virDomainShmemDefPtr;

147 148 149
typedef struct _virDomainTPMDef virDomainTPMDef;
typedef virDomainTPMDef *virDomainTPMDefPtr;

150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168
/* 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 已提交
169
    VIR_DOMAIN_DEVICE_NVRAM,
170
    VIR_DOMAIN_DEVICE_RNG,
171
    VIR_DOMAIN_DEVICE_SHMEM,
172
    VIR_DOMAIN_DEVICE_TPM,
173
    VIR_DOMAIN_DEVICE_PANIC,
174
    VIR_DOMAIN_DEVICE_MEMORY,
175

176
    VIR_DOMAIN_DEVICE_LAST
177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199
} 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 已提交
200
        virDomainNVRAMDefPtr nvram;
201
        virDomainRNGDefPtr rng;
202
        virDomainShmemDefPtr shmem;
203
        virDomainTPMDefPtr tpm;
204
        virDomainPanicDefPtr panic;
205
        virDomainMemoryDefPtr memory;
206 207 208
    } data;
};

209 210
/* Different types of hypervisor */
/* NB: Keep in sync with virDomainVirtTypeToString impl */
211
typedef enum {
212 213 214 215 216 217 218 219 220 221
    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,
222
    VIR_DOMAIN_VIRT_VBOX,
223
    VIR_DOMAIN_VIRT_PHYP,
D
Dmitry Guryanov 已提交
224
    VIR_DOMAIN_VIRT_PARALLELS,
R
Roman Bogorodskiy 已提交
225
    VIR_DOMAIN_VIRT_BHYVE,
226
    VIR_DOMAIN_VIRT_VZ,
227

228
    VIR_DOMAIN_VIRT_LAST
229
} virDomainVirtType;
230

231 232 233 234 235 236 237 238 239 240 241 242
typedef enum {
    VIR_DOMAIN_OSTYPE_HVM,
    VIR_DOMAIN_OSTYPE_XEN,
    VIR_DOMAIN_OSTYPE_LINUX,
    VIR_DOMAIN_OSTYPE_EXE,
    VIR_DOMAIN_OSTYPE_UML,

    VIR_DOMAIN_OSTYPE_LAST
} virDomainOSType;
VIR_ENUM_DECL(virDomainOS)


243
typedef enum {
244 245
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_NONE,
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_PCI,
246
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_DRIVE,
247
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_SERIAL,
E
Eric Blake 已提交
248
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_CCID,
249
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_USB,
250
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_SPAPRVIO,
251
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_S390,
252
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_CCW,
253
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_VIRTIO_MMIO,
H
Hu Tao 已提交
254
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_ISA,
255
    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_DIMM,
256 257

    VIR_DOMAIN_DEVICE_ADDRESS_TYPE_LAST
258
} virDomainDeviceAddressType;
259

260 261 262 263 264
typedef struct _virDomainDeviceDriveAddress virDomainDeviceDriveAddress;
typedef virDomainDeviceDriveAddress *virDomainDeviceDriveAddressPtr;
struct _virDomainDeviceDriveAddress {
    unsigned int controller;
    unsigned int bus;
265
    unsigned int target;
266 267 268
    unsigned int unit;
};

269 270 271 272 273
typedef struct _virDomainDeviceVirtioSerialAddress virDomainDeviceVirtioSerialAddress;
typedef virDomainDeviceVirtioSerialAddress *virDomainDeviceVirtioSerialAddressPtr;
struct _virDomainDeviceVirtioSerialAddress {
    unsigned int controller;
    unsigned int bus;
274
    unsigned int port;
275 276
};

277 278 279 280 281 282 283 284 285 286 287 288 289
# 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 已提交
290 291 292 293 294 295 296
typedef struct _virDomainDeviceCcidAddress virDomainDeviceCcidAddress;
typedef virDomainDeviceCcidAddress *virDomainDeviceCcidAddressPtr;
struct _virDomainDeviceCcidAddress {
    unsigned int controller;
    unsigned int slot;
};

297 298 299 300
typedef struct _virDomainDeviceUSBAddress virDomainDeviceUSBAddress;
typedef virDomainDeviceUSBAddress *virDomainDeviceUSBAddressPtr;
struct _virDomainDeviceUSBAddress {
    unsigned int bus;
301
    char *port;
302 303
};

304 305 306 307 308 309 310
typedef struct _virDomainDeviceSpaprVioAddress virDomainDeviceSpaprVioAddress;
typedef virDomainDeviceSpaprVioAddress *virDomainDeviceSpaprVioAddressPtr;
struct _virDomainDeviceSpaprVioAddress {
    unsigned long long reg;
    bool has_reg;
};

311
typedef enum {
312 313 314 315
    VIR_DOMAIN_CONTROLLER_MASTER_NONE,
    VIR_DOMAIN_CONTROLLER_MASTER_USB,

    VIR_DOMAIN_CONTROLLER_MASTER_LAST
316
} virDomainControllerMaster;
317 318 319 320 321 322 323

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

H
Hu Tao 已提交
324 325 326 327 328 329 330
typedef struct _virDomainDeviceISAAddress virDomainDeviceISAAddress;
typedef virDomainDeviceISAAddress *virDomainDeviceISAAddressPtr;
struct _virDomainDeviceISAAddress {
    unsigned int iobase;
    unsigned int irq;
};

331 332 333 334 335 336 337
typedef struct _virDomainDeviceDimmAddress virDomainDeviceDimmAddress;
typedef virDomainDeviceDimmAddress *virDomainDeviceDimmAddressPtr;
struct _virDomainDeviceDimmAddress {
    unsigned int slot;
    unsigned long long base;
};

338 339 340
typedef struct _virDomainDeviceInfo virDomainDeviceInfo;
typedef virDomainDeviceInfo *virDomainDeviceInfoPtr;
struct _virDomainDeviceInfo {
341 342 343 344
    /* If adding to this struct, ensure that
     * virDomainDeviceInfoIsSet() is updated
     * to consider the new fields
     */
D
Daniel P. Berrange 已提交
345
    char *alias;
346
    int type; /* virDomainDeviceAddressType */
347
    union {
348
        virDevicePCIAddress pci;
349
        virDomainDeviceDriveAddress drive;
350
        virDomainDeviceVirtioSerialAddress vioserial;
E
Eric Blake 已提交
351
        virDomainDeviceCcidAddress ccid;
352
        virDomainDeviceUSBAddress usb;
353
        virDomainDeviceSpaprVioAddress spaprvio;
354
        virDomainDeviceCCWAddress ccw;
H
Hu Tao 已提交
355
        virDomainDeviceISAAddress isa;
356
        virDomainDeviceDimmAddress dimm;
357
    } addr;
358 359 360 361
    int mastertype;
    union {
        virDomainDeviceUSBMaster usb;
    } master;
362 363
    /* rombar and romfile are only used for pci hostdev and network
     * devices. */
J
Ján Tomko 已提交
364
    int rombar;         /* enum virTristateSwitch */
365
    char *romfile;
366 367
    /* bootIndex is only used for disk, network interface, hostdev
     * and redirdev devices */
368
    int bootIndex;
369 370
};

371

372 373 374 375 376 377 378 379
typedef struct _virDomainHostdevOrigStates virDomainHostdevOrigStates;
typedef virDomainHostdevOrigStates *virDomainHostdevOrigStatesPtr;
struct _virDomainHostdevOrigStates {
    union {
        struct {
            /* Does the device need to unbind from stub when
             * reattaching to host?
             */
380
            bool unbind_from_stub;
381 382 383 384

            /* Does it need to use remove_slot when reattaching
             * the device to host?
             */
385
            bool remove_slot;
386 387 388 389

            /* Does it need to reprobe driver for the device when
             * reattaching to host?
             */
390
            bool reprobe;
391 392 393 394 395 396
        } pci;

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

397 398 399 400 401 402 403
struct _virDomainLeaseDef {
    char *lockspace;
    char *key;
    char *path;
    unsigned long long offset;
};

404

405
typedef enum {
406 407 408
    VIR_DOMAIN_HOSTDEV_MODE_SUBSYS,
    VIR_DOMAIN_HOSTDEV_MODE_CAPABILITIES,

409
    VIR_DOMAIN_HOSTDEV_MODE_LAST
410
} virDomainHostdevMode;
411

412
typedef enum {
413 414
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_USB,
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_PCI,
H
Han Cheng 已提交
415
    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_SCSI,
416 417

    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_LAST
418
} virDomainHostdevSubsysType;
419

420 421
/* the backend driver used for PCI hostdev devices */
typedef enum {
422
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_DEFAULT, /* detect automaticaly, prefer VFIO */
423 424
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_KVM,    /* force legacy kvm style */
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_VFIO,   /* force vfio */
425
    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_XEN,    /* force legacy xen style, use pciback */
426 427

    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_TYPE_LAST
428
} virDomainHostdevSubsysPCIBackendType;
429

430
VIR_ENUM_DECL(virDomainHostdevSubsysPCIBackend)
431

432 433 434 435 436 437 438 439 440
typedef enum {
    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_NONE,
    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_ISCSI,

    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_LAST,
} virDomainHostdevSCSIProtocolType;

VIR_ENUM_DECL(virDomainHostdevSubsysSCSIProtocol)

441 442 443 444 445 446 447 448 449 450 451 452
typedef struct _virDomainHostdevSubsysUSB virDomainHostdevSubsysUSB;
typedef virDomainHostdevSubsysUSB *virDomainHostdevSubsysUSBPtr;
struct _virDomainHostdevSubsysUSB {
    bool autoAddress; /* bus/device were filled automatically based
                         on vendor/product */
    unsigned bus;
    unsigned device;

    unsigned vendor;
    unsigned product;
};

453 454 455 456 457 458 459
typedef struct _virDomainHostdevSubsysPCI virDomainHostdevSubsysPCI;
typedef virDomainHostdevSubsysPCI *virDomainHostdevSubsysPCIPtr;
struct _virDomainHostdevSubsysPCI {
    virDevicePCIAddress addr; /* host address */
    int backend; /* enum virDomainHostdevSubsysPCIBackendType */
};

460 461 462
typedef struct _virDomainHostdevSubsysSCSIHost virDomainHostdevSubsysSCSIHost;
typedef virDomainHostdevSubsysSCSIHost *virDomainHostdevSubsysSCSIHostPtr;
struct _virDomainHostdevSubsysSCSIHost {
463 464 465 466
    char *adapter;
    unsigned bus;
    unsigned target;
    unsigned unit;
467 468
};

469 470 471 472 473 474 475 476 477
typedef struct _virDomainHostdevSubsysSCSIiSCSI virDomainHostdevSubsysSCSIiSCSI;
typedef virDomainHostdevSubsysSCSIiSCSI *virDomainHostdevSubsysSCSIiSCSIPtr;
struct _virDomainHostdevSubsysSCSIiSCSI {
    char *path;
    size_t nhosts;
    virStorageNetHostDefPtr hosts;
    virStorageAuthDefPtr auth;
};

478 479 480
typedef struct _virDomainHostdevSubsysSCSI virDomainHostdevSubsysSCSI;
typedef virDomainHostdevSubsysSCSI *virDomainHostdevSubsysSCSIPtr;
struct _virDomainHostdevSubsysSCSI {
481
    int protocol; /* enum virDomainHostdevSCSIProtocolType */
482
    int sgio; /* enum virDomainDeviceSGIO */
483
    int rawio; /* enum virTristateBool */
484 485
    union {
        virDomainHostdevSubsysSCSIHost host;
486
        virDomainHostdevSubsysSCSIiSCSI iscsi;
487
    } u;
488 489
};

490 491 492
typedef struct _virDomainHostdevSubsys virDomainHostdevSubsys;
typedef virDomainHostdevSubsys *virDomainHostdevSubsysPtr;
struct _virDomainHostdevSubsys {
493
    int type; /* enum virDomainHostdevSubsysType */
494
    union {
495
        virDomainHostdevSubsysUSB usb;
496
        virDomainHostdevSubsysPCI pci;
497
        virDomainHostdevSubsysSCSI scsi;
498 499 500
    } u;
};

501

502
typedef enum {
503 504
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_STORAGE,
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_MISC,
505
    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_NET,
506 507

    VIR_DOMAIN_HOSTDEV_CAPS_TYPE_LAST
508
} virDomainHostdevCapsType;
509

510 511 512 513 514 515 516
typedef struct _virDomainNetIpDef virDomainNetIpDef;
typedef virDomainNetIpDef *virDomainNetIpDefPtr;
struct _virDomainNetIpDef {
    virSocketAddr address;       /* ipv4 or ipv6 address */
    unsigned int prefix; /* number of 1 bits in the net mask */
};

517 518 519 520 521 522 523 524 525 526 527
typedef struct _virDomainHostdevCaps virDomainHostdevCaps;
typedef virDomainHostdevCaps *virDomainHostdevCapsPtr;
struct _virDomainHostdevCaps {
    int type; /* enum virDOmainHostdevCapsType */
    union {
        struct {
            char *block;
        } storage;
        struct {
            char *chardev;
        } misc;
528 529
        struct {
            char *iface;
530 531
            size_t nips;
            virDomainNetIpDefPtr *ips;
532
            size_t nroutes;
533
            virNetworkRouteDefPtr *routes;
534
        } net;
535 536 537 538
    } u;
};


539 540
/* basic device for direct passthrough */
struct _virDomainHostdevDef {
541
    virDomainDeviceDef parent; /* higher level Def containing this */
542
    int mode; /* enum virDomainHostdevMode */
543
    int startupPolicy; /* enum virDomainStartupPolicy */
544
    bool managed;
545
    bool missing;
O
Osier Yang 已提交
546
    bool readonly;
547
    bool shareable;
548
    union {
549
        virDomainHostdevSubsys subsys;
550
        virDomainHostdevCaps caps;
551 552
    } source;
    virDomainHostdevOrigStates origstates;
553
    virDomainDeviceInfoPtr info; /* Guest address */
554 555
};

556

E
Eric Blake 已提交
557 558
/* Types of disk frontend (guest view).  For backends (host view), see
 * virStorageType in util/virstoragefile.h */
559
typedef enum {
560 561 562
    VIR_DOMAIN_DISK_DEVICE_DISK,
    VIR_DOMAIN_DISK_DEVICE_CDROM,
    VIR_DOMAIN_DISK_DEVICE_FLOPPY,
563
    VIR_DOMAIN_DISK_DEVICE_LUN,
564 565

    VIR_DOMAIN_DISK_DEVICE_LAST
566
} virDomainDiskDevice;
567

568
typedef enum {
569 570 571 572 573
    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,
574
    VIR_DOMAIN_DISK_BUS_USB,
575
    VIR_DOMAIN_DISK_BUS_UML,
576
    VIR_DOMAIN_DISK_BUS_SATA,
577
    VIR_DOMAIN_DISK_BUS_SD,
578 579

    VIR_DOMAIN_DISK_BUS_LAST
580
} virDomainDiskBus;
581

582
typedef enum {
583 584 585 586
    VIR_DOMAIN_DISK_CACHE_DEFAULT,
    VIR_DOMAIN_DISK_CACHE_DISABLE,
    VIR_DOMAIN_DISK_CACHE_WRITETHRU,
    VIR_DOMAIN_DISK_CACHE_WRITEBACK,
587
    VIR_DOMAIN_DISK_CACHE_DIRECTSYNC,
588
    VIR_DOMAIN_DISK_CACHE_UNSAFE,
589 590

    VIR_DOMAIN_DISK_CACHE_LAST
591
} virDomainDiskCache;
592

593
typedef enum {
594 595
    VIR_DOMAIN_DISK_ERROR_POLICY_DEFAULT,
    VIR_DOMAIN_DISK_ERROR_POLICY_STOP,
596
    VIR_DOMAIN_DISK_ERROR_POLICY_REPORT,
597
    VIR_DOMAIN_DISK_ERROR_POLICY_IGNORE,
598
    VIR_DOMAIN_DISK_ERROR_POLICY_ENOSPACE,
599 600

    VIR_DOMAIN_DISK_ERROR_POLICY_LAST
601
} virDomainDiskErrorPolicy;
602

M
MORITA Kazutaka 已提交
603

604
typedef enum {
605 606 607 608
    VIR_DOMAIN_DISK_TRAY_CLOSED,
    VIR_DOMAIN_DISK_TRAY_OPEN,

    VIR_DOMAIN_DISK_TRAY_LAST
609
} virDomainDiskTray;
610

611
typedef enum {
J
J.B. Joret 已提交
612 613 614 615 616 617
    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
618
} virDomainDiskGeometryTrans;
J
J.B. Joret 已提交
619

620
typedef enum {
M
Matthias Dahl 已提交
621 622 623 624 625
    VIR_DOMAIN_DISK_IO_DEFAULT,
    VIR_DOMAIN_DISK_IO_NATIVE,
    VIR_DOMAIN_DISK_IO_THREADS,

    VIR_DOMAIN_DISK_IO_LAST
626
} virDomainDiskIo;
M
Matthias Dahl 已提交
627

628
typedef enum {
629 630 631 632 633 634
    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
635
} virDomainStartupPolicy;
636

637

638
typedef enum {
639 640 641
    VIR_DOMAIN_DEVICE_SGIO_DEFAULT = 0,
    VIR_DOMAIN_DEVICE_SGIO_FILTERED,
    VIR_DOMAIN_DEVICE_SGIO_UNFILTERED,
O
Osier Yang 已提交
642

643
    VIR_DOMAIN_DEVICE_SGIO_LAST
644
} virDomainDeviceSGIO;
O
Osier Yang 已提交
645

646
typedef enum {
O
Osier Yang 已提交
647
    VIR_DOMAIN_DISK_DISCARD_DEFAULT = 0,
O
Osier Yang 已提交
648 649
    VIR_DOMAIN_DISK_DISCARD_UNMAP,
    VIR_DOMAIN_DISK_DISCARD_IGNORE,
O
Osier Yang 已提交
650 651

    VIR_DOMAIN_DISK_DISCARD_LAST
652
} virDomainDiskDiscard;
O
Osier Yang 已提交
653

L
Lei Li 已提交
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;
662 663 664 665 666 667 668
    unsigned long long total_bytes_sec_max;
    unsigned long long read_bytes_sec_max;
    unsigned long long write_bytes_sec_max;
    unsigned long long total_iops_sec_max;
    unsigned long long read_iops_sec_max;
    unsigned long long write_iops_sec_max;
    unsigned long long size_iops_sec;
L
Lei Li 已提交
669 670 671
};
typedef virDomainBlockIoTuneInfo *virDomainBlockIoTuneInfoPtr;

672

673 674 675 676 677 678 679 680 681 682
typedef enum {
    VIR_DOMAIN_DISK_MIRROR_STATE_NONE = 0, /* No job, or job still not synced */
    VIR_DOMAIN_DISK_MIRROR_STATE_READY, /* Job in second phase */
    VIR_DOMAIN_DISK_MIRROR_STATE_ABORT, /* Job aborted, waiting for event */
    VIR_DOMAIN_DISK_MIRROR_STATE_PIVOT, /* Job pivoted, waiting for event */

    VIR_DOMAIN_DISK_MIRROR_STATE_LAST
} virDomainDiskMirrorState;


683 684
/* Stores the virtual disk configuration */
struct _virDomainDiskDef {
685
    virStorageSourcePtr src; /* non-NULL.  XXX Allow NULL for empty cdrom? */
686

687 688
    virObjectPtr privateData;

689 690 691 692
    int device; /* enum virDomainDiskDevice */
    int bus; /* enum virDomainDiskBus */
    char *dst;
    int tray_status; /* enum virDomainDiskTray */
J
Ján Tomko 已提交
693
    int removable; /* enum virTristateSwitch */
L
Lei Li 已提交
694

695
    virStorageSourcePtr mirror;
696
    int mirrorState; /* enum virDomainDiskMirrorState */
E
Eric Blake 已提交
697
    int mirrorJob; /* virDomainBlockJobType */
698

J
J.B. Joret 已提交
699 700 701 702
    struct {
        unsigned int cylinders;
        unsigned int heads;
        unsigned int sectors;
703
        int trans; /* enum virDomainDiskGeometryTrans */
J
J.B. Joret 已提交
704 705
    } geometry;

706 707 708
    struct {
        unsigned int logical_block_size;
        unsigned int physical_block_size;
V
Viktor Mihajlovski 已提交
709
    } blockio;
710

L
Lei Li 已提交
711 712
    virDomainBlockIoTuneInfo blkdeviotune;

713
    char *serial;
O
Osier Yang 已提交
714
    char *wwn;
715 716
    char *vendor;
    char *product;
717
    int cachemode; /* enum virDomainDiskCache */
718 719
    int error_policy;  /* enum virDomainDiskErrorPolicy */
    int rerror_policy; /* enum virDomainDiskErrorPolicy */
720
    int iomode; /* enum virDomainDiskIo */
J
Ján Tomko 已提交
721 722 723
    int ioeventfd; /* enum virTristateSwitch */
    int event_idx; /* enum virTristateSwitch */
    int copy_on_read; /* enum virTristateSwitch */
724
    int snapshot; /* virDomainSnapshotLocation, snapshot_conf.h */
725
    int startupPolicy; /* enum virDomainStartupPolicy */
726
    bool transient;
727
    virDomainDeviceInfo info;
728
    int rawio; /* enum virTristateBool */
729
    int sgio; /* enum virDomainDeviceSGIO */
O
Osier Yang 已提交
730
    int discard; /* enum virDomainDiskDiscard */
731
    unsigned int iothread; /* unused = 0, > 0 specific thread # */
732
    char *domain_name; /* backend domain name */
733 734 735
};


736
typedef enum {
737 738 739 740
    VIR_DOMAIN_CONTROLLER_TYPE_IDE,
    VIR_DOMAIN_CONTROLLER_TYPE_FDC,
    VIR_DOMAIN_CONTROLLER_TYPE_SCSI,
    VIR_DOMAIN_CONTROLLER_TYPE_SATA,
741
    VIR_DOMAIN_CONTROLLER_TYPE_VIRTIO_SERIAL,
E
Eric Blake 已提交
742
    VIR_DOMAIN_CONTROLLER_TYPE_CCID,
743
    VIR_DOMAIN_CONTROLLER_TYPE_USB,
J
Ján Tomko 已提交
744
    VIR_DOMAIN_CONTROLLER_TYPE_PCI,
745 746

    VIR_DOMAIN_CONTROLLER_TYPE_LAST
747
} virDomainControllerType;
748

749

750
typedef enum {
J
Ján Tomko 已提交
751
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_ROOT,
L
Laine Stump 已提交
752
    VIR_DOMAIN_CONTROLLER_MODEL_PCIE_ROOT,
J
Ján Tomko 已提交
753
    VIR_DOMAIN_CONTROLLER_MODEL_PCI_BRIDGE,
754
    VIR_DOMAIN_CONTROLLER_MODEL_DMI_TO_PCI_BRIDGE,
J
Ján Tomko 已提交
755 756

    VIR_DOMAIN_CONTROLLER_MODEL_PCI_LAST
757
} virDomainControllerModelPCI;
J
Ján Tomko 已提交
758

759
typedef enum {
760 761 762 763 764
    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,
765
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_IBMVSCSI,
766
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_VIRTIO_SCSI,
767
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LSISAS1078,
768

769
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LAST
770
} virDomainControllerModelSCSI;
771

772
typedef enum {
M
Marc-André Lureau 已提交
773 774 775 776 777 778 779 780 781
    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 已提交
782
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NEC_XHCI,
783
    VIR_DOMAIN_CONTROLLER_MODEL_USB_NONE,
M
Marc-André Lureau 已提交
784 785

    VIR_DOMAIN_CONTROLLER_MODEL_USB_LAST
786
} virDomainControllerModelUSB;
M
Marc-André Lureau 已提交
787

788 789 790 791 792 793 794
typedef struct _virDomainVirtioSerialOpts virDomainVirtioSerialOpts;
typedef virDomainVirtioSerialOpts *virDomainVirtioSerialOptsPtr;
struct _virDomainVirtioSerialOpts {
    int ports;   /* -1 == undef */
    int vectors; /* -1 == undef */
};

795 796 797
typedef struct _virDomainPCIControllerOpts virDomainPCIControllerOpts;
typedef virDomainPCIControllerOpts *virDomainPCIControllerOptsPtr;
struct _virDomainPCIControllerOpts {
798 799 800 801
    bool pcihole64;
    unsigned long pcihole64size;
};

802 803 804
/* Stores the virtual disk controller configuration */
struct _virDomainControllerDef {
    int type;
805
    unsigned int idx;
806
    int model; /* -1 == undef */
807
    unsigned int queues;
808 809
    unsigned int cmd_per_lun;
    unsigned int max_sectors;
810 811
    union {
        virDomainVirtioSerialOpts vioserial;
812
        virDomainPCIControllerOpts pciopts;
813
    } opts;
814 815 816 817
    virDomainDeviceInfo info;
};


G
Giuseppe Scrivano 已提交
818
/* Types of disk backends */
819
typedef enum {
820 821 822 823 824 825
    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 */
826 827

    VIR_DOMAIN_FS_TYPE_LAST
828
} virDomainFSType;
829

830
/* Filesystem driver type */
831
typedef enum {
832 833 834
    VIR_DOMAIN_FS_DRIVER_TYPE_DEFAULT = 0,
    VIR_DOMAIN_FS_DRIVER_TYPE_PATH,
    VIR_DOMAIN_FS_DRIVER_TYPE_HANDLE,
835
    VIR_DOMAIN_FS_DRIVER_TYPE_LOOP,
836
    VIR_DOMAIN_FS_DRIVER_TYPE_NBD,
D
Dmitry Guryanov 已提交
837
    VIR_DOMAIN_FS_DRIVER_TYPE_PLOOP,
838 839

    VIR_DOMAIN_FS_DRIVER_TYPE_LAST
840
} virDomainFSDriverType;
841

842
/* Filesystem mount access mode  */
843
typedef enum {
844 845 846 847 848
    VIR_DOMAIN_FS_ACCESSMODE_PASSTHROUGH,
    VIR_DOMAIN_FS_ACCESSMODE_MAPPED,
    VIR_DOMAIN_FS_ACCESSMODE_SQUASH,

    VIR_DOMAIN_FS_ACCESSMODE_LAST
849
} virDomainFSAccessMode;
850

851
/* Filesystem Write policy */
852
typedef enum {
853 854 855 856
    VIR_DOMAIN_FS_WRPOLICY_DEFAULT = 0,
    VIR_DOMAIN_FS_WRPOLICY_IMMEDIATE,

    VIR_DOMAIN_FS_WRPOLICY_LAST
857
} virDomainFSWrpolicy;
858

859 860 861
/* Allow 2 MB ram usage */
# define VIR_DOMAIN_FS_RAM_DEFAULT_USAGE (1024 * 2)

862 863
struct _virDomainFSDef {
    int type;
864 865
    int fsdriver; /* enum virDomainFSDriverType */
    int accessmode; /* enum virDomainFSAccessMode */
866
    int wrpolicy; /* enum virDomainFSWrpolicy */
867
    int format; /* virStorageFileFormat */
868
    unsigned long long usage; /* in bytes */
869 870
    char *src;
    char *dst;
871
    bool readonly;
872
    virDomainDeviceInfo info;
873 874
    unsigned long long space_hard_limit; /* in bytes */
    unsigned long long space_soft_limit; /* in bytes */
875
    bool symlinksResolved;
876 877 878
};


879
/* network config types */
880
typedef enum {
881 882
    VIR_DOMAIN_NET_TYPE_USER,
    VIR_DOMAIN_NET_TYPE_ETHERNET,
M
Michele Paolino 已提交
883
    VIR_DOMAIN_NET_TYPE_VHOSTUSER,
884 885 886 887 888
    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 已提交
889
    VIR_DOMAIN_NET_TYPE_INTERNAL,
890
    VIR_DOMAIN_NET_TYPE_DIRECT,
891
    VIR_DOMAIN_NET_TYPE_HOSTDEV,
892

893
    VIR_DOMAIN_NET_TYPE_LAST
894
} virDomainNetType;
895

896
/* the backend driver used for virtio interfaces */
897
typedef enum {
898 899 900 901
    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 */

902
    VIR_DOMAIN_NET_BACKEND_TYPE_LAST
903
} virDomainNetBackendType;
904

905
/* the TX algorithm used for virtio interfaces */
906
typedef enum {
907 908 909 910
    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,

911
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_LAST
912
} virDomainNetVirtioTxModeType;
913

914
/* link interface states */
915
typedef enum {
916 917 918 919 920
        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
921
} virDomainNetInterfaceLinkState;
922

923 924 925 926 927 928 929 930 931 932 933 934
/* 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;
935
            int macTableManager; /* enum virNetworkBridgeMACTableManagerType */
936 937 938 939 940
        } bridge;
        struct {
            char *linkdev;
            int mode; /* enum virMacvtapMode from util/macvtap.h */
        } direct;
941 942 943
        struct {
            virDomainHostdevDef def;
        } hostdev;
944
    } data;
945
    virNetDevVPortProfilePtr virtPortProfile;
946
    virNetDevBandwidthPtr bandwidth;
947
    virNetDevVlan vlan;
948
    int trustGuestRxFilters; /* enum virTristateBool */
949
    unsigned int class_id; /* class ID for bandwidth 'floor' */
950 951
};

952 953
/* Stores the virtual network interface configuration */
struct _virDomainNetDef {
954
    virDomainNetType type;
955
    virMacAddr mac;
956
    char *model;
957 958
    union {
        struct {
959 960
            virDomainNetBackendType name; /* which driver backend to use */
            virDomainNetVirtioTxModeType txmode;
J
Ján Tomko 已提交
961 962
            virTristateSwitch ioeventfd;
            virTristateSwitch event_idx;
963
            unsigned int queues; /* Multiqueue virtio-net */
964 965 966 967 968 969 970
            struct {
                virTristateSwitch csum;
                virTristateSwitch gso;
                virTristateSwitch tso4;
                virTristateSwitch tso6;
                virTristateSwitch ecn;
                virTristateSwitch ufo;
971
                virTristateSwitch mrg_rxbuf;
972 973 974 975 976 977 978 979
            } host;
            struct {
                virTristateSwitch csum;
                virTristateSwitch tso4;
                virTristateSwitch tso6;
                virTristateSwitch ecn;
                virTristateSwitch ufo;
            } guest;
980 981
        } virtio;
    } driver;
982 983 984 985
    struct {
        char *tap;
        char *vhost;
    } backend;
986 987 988 989
    union {
        struct {
            char *dev;
        } ethernet;
M
Michele Paolino 已提交
990
        virDomainChrSourceDefPtr vhostuser;
991 992 993 994 995 996
        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 1010
        } network;
        struct {
            char *brname;
        } bridge;
D
Daniel Veillard 已提交
1011 1012 1013
        struct {
            char *name;
        } internal;
1014 1015
        struct {
            char *linkdev;
1016
            int mode; /* enum virMacvtapMode from util/macvtap.h */
1017
        } direct;
1018 1019 1020
        struct {
            virDomainHostdevDef def;
        } hostdev;
1021
    } data;
1022 1023
    /* virtPortProfile is used by network/bridge/direct/hostdev */
    virNetDevVPortProfilePtr virtPortProfile;
1024 1025 1026 1027
    struct {
        bool sndbuf_specified;
        unsigned long sndbuf;
    } tune;
1028
    char *script;
1029
    char *domain_name; /* backend domain name */
1030
    char *ifname;
1031 1032
    char *ifname_guest;
    char *ifname_guest_actual;
1033
    virDomainDeviceInfo info;
1034 1035
    char *filter;
    virNWFilterHashTablePtr filterparams;
1036
    virNetDevBandwidthPtr bandwidth;
1037
    virNetDevVlan vlan;
1038
    int trustGuestRxFilters; /* enum virTristateBool */
1039
    int linkstate;
1040 1041
    size_t nips;
    virDomainNetIpDefPtr *ips;
1042
    size_t nroutes;
1043
    virNetworkRouteDefPtr *routes;
1044 1045
};

E
Eric Blake 已提交
1046 1047 1048 1049
/* 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"

1050 1051 1052 1053 1054 1055 1056 1057 1058 1059
typedef enum {
    VIR_DOMAIN_CHR_DEVICE_STATE_DEFAULT = 0,
    VIR_DOMAIN_CHR_DEVICE_STATE_CONNECTED,
    VIR_DOMAIN_CHR_DEVICE_STATE_DISCONNECTED,

    VIR_DOMAIN_CHR_DEVICE_STATE_LAST
} virDomainChrDeviceState;

VIR_ENUM_DECL(virDomainChrDeviceState)

1060
typedef enum {
1061
    VIR_DOMAIN_CHR_DEVICE_TYPE_PARALLEL = 0,
1062 1063
    VIR_DOMAIN_CHR_DEVICE_TYPE_SERIAL,
    VIR_DOMAIN_CHR_DEVICE_TYPE_CONSOLE,
1064
    VIR_DOMAIN_CHR_DEVICE_TYPE_CHANNEL,
1065

1066
    VIR_DOMAIN_CHR_DEVICE_TYPE_LAST
1067
} virDomainChrDeviceType;
1068

1069
typedef enum {
G
Guannan Ren 已提交
1070 1071
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_ISA = 0,
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_USB,
M
Michal Privoznik 已提交
1072
    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_PCI,
G
Guannan Ren 已提交
1073 1074

    VIR_DOMAIN_CHR_SERIAL_TARGET_TYPE_LAST
1075
} virDomainChrSerialTargetType;
G
Guannan Ren 已提交
1076

1077
typedef enum {
1078 1079
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_NONE = 0,
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_GUESTFWD,
1080 1081
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_VIRTIO,

1082
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_LAST
1083
} virDomainChrChannelTargetType;
1084

1085
typedef enum {
1086 1087
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_NONE  = 0,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SERIAL,
1088 1089
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_XEN,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_UML,
C
Cole Robinson 已提交
1090
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_VIRTIO,
1091 1092
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LXC,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_OPENVZ,
1093 1094
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLP,
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_SCLPLM,
1095

1096
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LAST
1097
} virDomainChrConsoleTargetType;
1098

1099
typedef enum {
1100 1101 1102 1103 1104 1105 1106 1107 1108 1109
    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,
1110
    VIR_DOMAIN_CHR_TYPE_SPICEVMC,
1111
    VIR_DOMAIN_CHR_TYPE_SPICEPORT,
1112
    VIR_DOMAIN_CHR_TYPE_NMDM,
1113

1114
    VIR_DOMAIN_CHR_TYPE_LAST
1115
} virDomainChrType;
1116

1117
typedef enum {
1118 1119
    VIR_DOMAIN_CHR_TCP_PROTOCOL_RAW,
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNET,
1120 1121
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TELNETS, /* secure telnet */
    VIR_DOMAIN_CHR_TCP_PROTOCOL_TLS,
1122

1123
    VIR_DOMAIN_CHR_TCP_PROTOCOL_LAST
1124
} virDomainChrTcpProtocol;
1125

1126
typedef enum {
E
Eric Blake 已提交
1127 1128
    VIR_DOMAIN_CHR_SPICEVMC_VDAGENT,
    VIR_DOMAIN_CHR_SPICEVMC_SMARTCARD,
1129
    VIR_DOMAIN_CHR_SPICEVMC_USBREDIR,
E
Eric Blake 已提交
1130

1131
    VIR_DOMAIN_CHR_SPICEVMC_LAST
1132
} virDomainChrSpicevmcName;
E
Eric Blake 已提交
1133

1134 1135 1136
/* The host side information for a character device.  */
struct _virDomainChrSourceDef {
    int type; /* virDomainChrType */
1137
    union {
E
Eric Blake 已提交
1138
        /* no <source> for null, vc, stdio */
1139 1140 1141
        struct {
            char *path;
        } file; /* pty, file, pipe, or device */
1142 1143 1144 1145
        struct {
            char *master;
            char *slave;
        } nmdm;
1146 1147 1148
        struct {
            char *host;
            char *service;
1149
            bool listen;
1150 1151 1152 1153 1154 1155 1156 1157 1158 1159
            int protocol;
        } tcp;
        struct {
            char *bindHost;
            char *bindService;
            char *connectHost;
            char *connectService;
        } udp;
        struct {
            char *path;
1160
            bool listen;
1161
        } nix;
E
Eric Blake 已提交
1162
        int spicevmc;
1163 1164 1165
        struct {
            char *channel;
        } spiceport;
1166
    } data;
1167 1168 1169 1170
};

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

    bool targetTypeAttr;
1174 1175 1176 1177
    int targetType; /* enum virDomainChrConsoleTargetType ||
                       enum virDomainChrChannelTargetType ||
                       enum virDomainChrSerialTargetType according to deviceType */

1178 1179 1180 1181 1182 1183
    union {
        int port; /* parallel, serial, console */
        virSocketAddrPtr addr; /* guestfwd */
        char *name; /* virtio */
    } target;

1184 1185
    virDomainChrDeviceState state;

1186
    virDomainChrSourceDef source;
1187 1188

    virDomainDeviceInfo info;
1189 1190 1191

    size_t nseclabels;
    virSecurityDeviceLabelDefPtr *seclabels;
1192 1193
};

1194
typedef enum {
E
Eric Blake 已提交
1195 1196 1197 1198
    VIR_DOMAIN_SMARTCARD_TYPE_HOST,
    VIR_DOMAIN_SMARTCARD_TYPE_HOST_CERTIFICATES,
    VIR_DOMAIN_SMARTCARD_TYPE_PASSTHROUGH,

1199
    VIR_DOMAIN_SMARTCARD_TYPE_LAST
1200
} virDomainSmartcardType;
E
Eric Blake 已提交
1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218

# 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 已提交
1219 1220 1221 1222 1223
struct _virDomainHubDef {
    int type;
    virDomainDeviceInfo info;
};

1224
typedef enum {
1225 1226 1227
    VIR_DOMAIN_TPM_MODEL_TIS,

    VIR_DOMAIN_TPM_MODEL_LAST
1228
} virDomainTPMModel;
1229

1230
typedef enum {
1231 1232 1233
    VIR_DOMAIN_TPM_TYPE_PASSTHROUGH,

    VIR_DOMAIN_TPM_TYPE_LAST
1234
} virDomainTPMBackendType;
1235 1236 1237 1238

# define VIR_DOMAIN_TPM_DEFAULT_DEVICE "/dev/tpm0"

struct _virDomainTPMDef {
1239
    virDomainTPMBackendType type;
1240
    virDomainDeviceInfo info;
1241
    virDomainTPMModel model;
1242 1243 1244 1245 1246 1247 1248
    union {
        struct {
            virDomainChrSourceDef source;
        } passthrough;
    } data;
};

1249
typedef enum {
1250 1251
    VIR_DOMAIN_INPUT_TYPE_MOUSE,
    VIR_DOMAIN_INPUT_TYPE_TABLET,
L
Li Zhang 已提交
1252
    VIR_DOMAIN_INPUT_TYPE_KBD,
1253

1254
    VIR_DOMAIN_INPUT_TYPE_LAST
1255
} virDomainInputType;
1256

1257
typedef enum {
1258 1259 1260
    VIR_DOMAIN_INPUT_BUS_PS2,
    VIR_DOMAIN_INPUT_BUS_USB,
    VIR_DOMAIN_INPUT_BUS_XEN,
1261
    VIR_DOMAIN_INPUT_BUS_PARALLELS, /* pseudo device for VNC in containers */
1262 1263

    VIR_DOMAIN_INPUT_BUS_LAST
1264
} virDomainInputBus;
1265 1266 1267 1268

struct _virDomainInputDef {
    int type;
    int bus;
1269
    virDomainDeviceInfo info;
1270 1271
};

1272
typedef enum {
1273 1274 1275 1276
    VIR_DOMAIN_SOUND_CODEC_TYPE_DUPLEX,
    VIR_DOMAIN_SOUND_CODEC_TYPE_MICRO,

    VIR_DOMAIN_SOUND_CODEC_TYPE_LAST
1277
} virDomainSoundCodecType;
1278

1279
typedef enum {
1280 1281 1282
    VIR_DOMAIN_SOUND_MODEL_SB16,
    VIR_DOMAIN_SOUND_MODEL_ES1370,
    VIR_DOMAIN_SOUND_MODEL_PCSPK,
D
Daniel P. Berrange 已提交
1283
    VIR_DOMAIN_SOUND_MODEL_AC97,
1284
    VIR_DOMAIN_SOUND_MODEL_ICH6,
1285
    VIR_DOMAIN_SOUND_MODEL_ICH9,
1286
    VIR_DOMAIN_SOUND_MODEL_USB,
1287 1288

    VIR_DOMAIN_SOUND_MODEL_LAST
1289
} virDomainSoundModel;
1290

1291 1292 1293 1294 1295
struct _virDomainSoundCodecDef {
    int type;
    int cad;
};

1296 1297
struct _virDomainSoundDef {
    int model;
1298
    virDomainDeviceInfo info;
1299

1300
    size_t ncodecs;
1301
    virDomainSoundCodecDefPtr *codecs;
1302 1303
};

1304
typedef enum {
R
Richard Jones 已提交
1305 1306 1307 1308
    VIR_DOMAIN_WATCHDOG_MODEL_I6300ESB,
    VIR_DOMAIN_WATCHDOG_MODEL_IB700,

    VIR_DOMAIN_WATCHDOG_MODEL_LAST
1309
} virDomainWatchdogModel;
R
Richard Jones 已提交
1310

1311
typedef enum {
R
Richard Jones 已提交
1312 1313 1314 1315
    VIR_DOMAIN_WATCHDOG_ACTION_RESET,
    VIR_DOMAIN_WATCHDOG_ACTION_SHUTDOWN,
    VIR_DOMAIN_WATCHDOG_ACTION_POWEROFF,
    VIR_DOMAIN_WATCHDOG_ACTION_PAUSE,
H
Hu Tao 已提交
1316
    VIR_DOMAIN_WATCHDOG_ACTION_DUMP,
R
Richard Jones 已提交
1317 1318 1319
    VIR_DOMAIN_WATCHDOG_ACTION_NONE,

    VIR_DOMAIN_WATCHDOG_ACTION_LAST
1320
} virDomainWatchdogAction;
R
Richard Jones 已提交
1321 1322 1323 1324

struct _virDomainWatchdogDef {
    int model;
    int action;
1325
    virDomainDeviceInfo info;
R
Richard Jones 已提交
1326 1327
};

1328

1329
typedef enum {
1330 1331 1332 1333 1334
    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,
1335
    VIR_DOMAIN_VIDEO_TYPE_QXL,
1336
    VIR_DOMAIN_VIDEO_TYPE_PARALLELS, /* pseudo device for VNC in containers */
1337 1338

    VIR_DOMAIN_VIDEO_TYPE_LAST
1339
} virDomainVideoType;
1340 1341


1342 1343 1344
typedef struct _virDomainVideoAccelDef virDomainVideoAccelDef;
typedef virDomainVideoAccelDef *virDomainVideoAccelDefPtr;
struct _virDomainVideoAccelDef {
1345 1346
    bool support3d;
    bool support2d;
1347 1348 1349
};


1350 1351
struct _virDomainVideoDef {
    int type;
1352 1353
    unsigned int ram;  /* kibibytes (multiples of 1024) */
    unsigned int vram; /* kibibytes (multiples of 1024) */
1354
    unsigned int vgamem; /* kibibytes (multiples of 1024) */
1355
    unsigned int heads;
1356
    bool primary;
1357
    virDomainVideoAccelDefPtr accel;
1358
    virDomainDeviceInfo info;
1359 1360
};

1361
/* graphics console modes */
1362
typedef enum {
1363 1364
    VIR_DOMAIN_GRAPHICS_TYPE_SDL,
    VIR_DOMAIN_GRAPHICS_TYPE_VNC,
1365 1366
    VIR_DOMAIN_GRAPHICS_TYPE_RDP,
    VIR_DOMAIN_GRAPHICS_TYPE_DESKTOP,
1367
    VIR_DOMAIN_GRAPHICS_TYPE_SPICE,
1368

1369
    VIR_DOMAIN_GRAPHICS_TYPE_LAST
1370
} virDomainGraphicsType;
1371

1372
typedef enum {
1373 1374 1375 1376 1377 1378
    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
1379
} virDomainGraphicsVNCSharePolicy;
1380

1381
typedef enum {
1382 1383 1384 1385 1386 1387
    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
1388
} virDomainGraphicsAuthConnectedType;
1389

1390 1391 1392 1393
typedef struct _virDomainGraphicsAuthDef virDomainGraphicsAuthDef;
typedef virDomainGraphicsAuthDef *virDomainGraphicsAuthDefPtr;
struct _virDomainGraphicsAuthDef {
    char *passwd;
1394
    bool expires; /* Whether there is an expiry time set */
1395
    time_t validTo;  /* seconds since epoch */
1396
    int connected; /* action if connected */
1397 1398
};

1399
typedef enum {
1400 1401 1402 1403 1404 1405
    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 已提交
1406
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_SMARTCARD,
1407
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_USBREDIR,
1408 1409

    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST
1410
} virDomainGraphicsSpiceChannelName;
1411

1412
typedef enum {
1413 1414 1415 1416 1417
    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
1418
} virDomainGraphicsSpiceChannelMode;
1419

1420
typedef enum {
1421 1422 1423 1424 1425 1426 1427 1428 1429
    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
1430
} virDomainGraphicsSpiceImageCompression;
1431

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

1441
typedef enum {
1442 1443 1444 1445 1446 1447
    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
1448
} virDomainGraphicsSpiceZlibCompression;
1449

1450
typedef enum {
P
Peng Zhou 已提交
1451 1452 1453 1454 1455
    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
1456
} virDomainGraphicsSpiceMouseMode;
P
Peng Zhou 已提交
1457

1458
typedef enum {
1459 1460 1461 1462 1463 1464
    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
1465
} virDomainGraphicsSpiceStreamingMode;
1466

1467
typedef enum {
1468 1469 1470 1471
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NONE = 0,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_ADDRESS,
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_NETWORK,

1472
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_LAST
1473
} virDomainGraphicsListenType;
1474

1475
typedef enum {
M
Marc-André Lureau 已提交
1476 1477
    VIR_DOMAIN_HUB_TYPE_USB,

1478
    VIR_DOMAIN_HUB_TYPE_LAST
1479
} virDomainHubType;
M
Marc-André Lureau 已提交
1480

1481 1482 1483 1484 1485 1486
typedef struct _virDomainGraphicsListenDef virDomainGraphicsListenDef;
typedef virDomainGraphicsListenDef *virDomainGraphicsListenDefPtr;
struct _virDomainGraphicsListenDef {
    int type;   /* enum virDomainGraphicsListenType */
    char *address;
    char *network;
1487
    bool fromConfig;    /* true if the @address is config file originated */
1488 1489
};

1490
struct _virDomainGraphicsDef {
M
Michal Privoznik 已提交
1491 1492 1493 1494 1495
    /* 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.
     */
1496 1497 1498 1499
    int type;
    union {
        struct {
            int port;
1500
            bool portReserved;
M
Martin Kletzander 已提交
1501
            int websocket;
1502
            bool autoport;
1503
            char *keymap;
1504
            char *socket;
1505
            virDomainGraphicsAuthDef auth;
1506
            int sharePolicy;
1507 1508 1509 1510
        } vnc;
        struct {
            char *display;
            char *xauth;
1511
            bool fullscreen;
1512
        } sdl;
1513 1514
        struct {
            int port;
1515 1516 1517
            bool autoport;
            bool replaceUser;
            bool multiUser;
1518 1519 1520
        } rdp;
        struct {
            char *display;
1521
            bool fullscreen;
1522
        } desktop;
1523 1524 1525
        struct {
            int port;
            int tlsPort;
1526 1527
            bool portReserved;
            bool tlsPortReserved;
P
Peng Zhou 已提交
1528
            int mousemode;
1529
            char *keymap;
1530
            virDomainGraphicsAuthDef auth;
1531
            bool autoport;
1532
            int channels[VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST];
1533
            int defaultMode; /* enum virDomainGraphicsSpiceChannelMode */
1534 1535 1536 1537
            int image;
            int jpeg;
            int zlib;
            int playback;
1538
            int streaming;
J
Ján Tomko 已提交
1539 1540
            int copypaste; /* enum virTristateBool */
            int filetransfer; /* enum virTristateBool */
1541
        } spice;
1542
    } data;
1543 1544 1545 1546 1547
    /* 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;
1548 1549
};

1550
typedef enum {
1551 1552 1553
    VIR_DOMAIN_REDIRDEV_BUS_USB,

    VIR_DOMAIN_REDIRDEV_BUS_LAST
1554
} virDomainRedirdevBus;
1555 1556 1557 1558 1559 1560 1561 1562 1563 1564

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

    union {
        virDomainChrSourceDef chr;
    } source;

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

1566
struct _virDomainRedirFilterUSBDevDef {
1567 1568 1569 1570
    int usbClass;
    int vendor;
    int product;
    int version;
1571
    bool allow;
1572 1573 1574 1575
};

struct _virDomainRedirFilterDef {
    size_t nusbdevs;
1576
    virDomainRedirFilterUSBDevDefPtr *usbdevs;
1577 1578
};

1579 1580 1581
enum {
    VIR_DOMAIN_MEMBALLOON_MODEL_VIRTIO,
    VIR_DOMAIN_MEMBALLOON_MODEL_XEN,
1582
    VIR_DOMAIN_MEMBALLOON_MODEL_NONE,
1583 1584 1585 1586 1587 1588 1589

    VIR_DOMAIN_MEMBALLOON_MODEL_LAST
};

struct _virDomainMemballoonDef {
    int model;
    virDomainDeviceInfo info;
1590
    int period; /* seconds between collections */
1591 1592
};

L
Li Zhang 已提交
1593 1594 1595
struct _virDomainNVRAMDef {
    virDomainDeviceInfo info;
};
1596

1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611
struct _virDomainShmemDef {
    char *name;
    unsigned long long size;
    struct {
        bool enabled;
        char *path;
    } server;
    struct {
        bool enabled;
        unsigned vectors;
        virTristateSwitch ioeventfd;
    } msi;
    virDomainDeviceInfo info;
};

1612
typedef enum {
1613
    VIR_DOMAIN_SMBIOS_NONE = 0,
1614 1615 1616 1617 1618
    VIR_DOMAIN_SMBIOS_EMULATE,
    VIR_DOMAIN_SMBIOS_HOST,
    VIR_DOMAIN_SMBIOS_SYSINFO,

    VIR_DOMAIN_SMBIOS_LAST
1619
} virDomainSmbiosMode;
1620

1621

1622
# define VIR_DOMAIN_MAX_BOOT_DEVS 4
1623

1624
typedef enum {
1625 1626 1627 1628 1629
    VIR_DOMAIN_BOOT_FLOPPY,
    VIR_DOMAIN_BOOT_CDROM,
    VIR_DOMAIN_BOOT_DISK,
    VIR_DOMAIN_BOOT_NET,

1630
    VIR_DOMAIN_BOOT_LAST
1631
} virDomainBootOrder;
1632

1633
typedef enum {
1634 1635 1636
    VIR_DOMAIN_FEATURE_ACPI,
    VIR_DOMAIN_FEATURE_APIC,
    VIR_DOMAIN_FEATURE_PAE,
J
Jim Fehlig 已提交
1637
    VIR_DOMAIN_FEATURE_HAP,
1638
    VIR_DOMAIN_FEATURE_VIRIDIAN,
1639
    VIR_DOMAIN_FEATURE_PRIVNET,
1640
    VIR_DOMAIN_FEATURE_HYPERV,
1641
    VIR_DOMAIN_FEATURE_KVM,
1642
    VIR_DOMAIN_FEATURE_PVSPINLOCK,
1643
    VIR_DOMAIN_FEATURE_CAPABILITIES,
1644
    VIR_DOMAIN_FEATURE_PMU,
1645
    VIR_DOMAIN_FEATURE_VMPORT,
M
Michal Privoznik 已提交
1646
    VIR_DOMAIN_FEATURE_GIC,
1647 1648

    VIR_DOMAIN_FEATURE_LAST
1649
} virDomainFeature;
1650

1651
typedef enum {
1652
    VIR_DOMAIN_HYPERV_RELAXED = 0,
1653 1654
    VIR_DOMAIN_HYPERV_VAPIC,
    VIR_DOMAIN_HYPERV_SPINLOCKS,
1655 1656

    VIR_DOMAIN_HYPERV_LAST
1657
} virDomainHyperv;
1658

1659 1660 1661 1662 1663 1664
typedef enum {
    VIR_DOMAIN_KVM_HIDDEN = 0,

    VIR_DOMAIN_KVM_LAST
} virDomainKVM;

1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714
typedef enum {
    VIR_DOMAIN_CAPABILITIES_POLICY_DEFAULT = 0,
    VIR_DOMAIN_CAPABILITIES_POLICY_ALLOW,
    VIR_DOMAIN_CAPABILITIES_POLICY_DENY,

    VIR_DOMAIN_CAPABILITIES_POLICY_LAST
} virDomainCapabilitiesPolicy;

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

1715
typedef enum {
1716 1717 1718 1719 1720 1721
    VIR_DOMAIN_LIFECYCLE_DESTROY,
    VIR_DOMAIN_LIFECYCLE_RESTART,
    VIR_DOMAIN_LIFECYCLE_RESTART_RENAME,
    VIR_DOMAIN_LIFECYCLE_PRESERVE,

    VIR_DOMAIN_LIFECYCLE_LAST
1722
} virDomainLifecycleAction;
1723

1724
typedef enum {
1725 1726 1727 1728 1729 1730 1731 1732
    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
1733
} virDomainLifecycleCrashAction;
1734

1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746
typedef enum {
    VIR_DOMAIN_LOCK_FAILURE_DEFAULT,
    VIR_DOMAIN_LOCK_FAILURE_POWEROFF,
    VIR_DOMAIN_LOCK_FAILURE_RESTART,
    VIR_DOMAIN_LOCK_FAILURE_PAUSE,
    VIR_DOMAIN_LOCK_FAILURE_IGNORE,

    VIR_DOMAIN_LOCK_FAILURE_LAST
} virDomainLockFailureAction;

VIR_ENUM_DECL(virDomainLockFailure)

M
Michal Privoznik 已提交
1747 1748 1749
typedef struct _virDomainBIOSDef virDomainBIOSDef;
typedef virDomainBIOSDef *virDomainBIOSDefPtr;
struct _virDomainBIOSDef {
J
Ján Tomko 已提交
1750
    int useserial; /* enum virTristateBool */
1751 1752 1753
    /* reboot-timeout parameters */
    bool rt_set;
    int rt_delay;
M
Michal Privoznik 已提交
1754 1755
};

1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771
typedef enum {
    VIR_DOMAIN_LOADER_TYPE_ROM = 0,
    VIR_DOMAIN_LOADER_TYPE_PFLASH,

    VIR_DOMAIN_LOADER_TYPE_LAST
} virDomainLoader;

VIR_ENUM_DECL(virDomainLoader)

typedef struct _virDomainLoaderDef virDomainLoaderDef;
typedef virDomainLoaderDef *virDomainLoaderDefPtr;
struct _virDomainLoaderDef {
    char *path;
    int readonly;   /* enum virTristateBool */
    virDomainLoader type;
    char *nvram;    /* path to non-volatile RAM */
1772
    char *templt;   /* user override of path to master nvram */
1773 1774 1775 1776
};

void virDomainLoaderDefFree(virDomainLoaderDefPtr loader);

1777 1778 1779 1780
/* Operating system configuration data & machine / arch */
typedef struct _virDomainOSDef virDomainOSDef;
typedef virDomainOSDef *virDomainOSDefPtr;
struct _virDomainOSDef {
1781
    int type;
1782
    virArch arch;
1783
    char *machine;
1784
    size_t nBootDevs;
1785
    int bootDevs[VIR_DOMAIN_BOOT_LAST];
J
Ján Tomko 已提交
1786
    int bootmenu; /* enum virTristateBool */
1787 1788
    unsigned int bm_timeout;
    bool bm_timeout_set;
1789
    char *init;
1790
    char **initargv;
1791 1792 1793
    char *kernel;
    char *initrd;
    char *cmdline;
1794
    char *dtb;
1795
    char *root;
1796
    virDomainLoaderDefPtr loader;
1797 1798
    char *bootloader;
    char *bootloaderArgs;
1799
    int smbios_mode;
1800

M
Michal Privoznik 已提交
1801
    virDomainBIOSDef bios;
1802 1803
};

1804
typedef enum {
1805 1806 1807 1808 1809
    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 已提交
1810
    VIR_DOMAIN_TIMER_NAME_KVMCLOCK,
1811
    VIR_DOMAIN_TIMER_NAME_HYPERVCLOCK,
1812

1813
    VIR_DOMAIN_TIMER_NAME_LAST
1814
} virDomainTimerNameType;
1815

1816
typedef enum {
1817 1818 1819
    VIR_DOMAIN_TIMER_TRACK_BOOT = 0,
    VIR_DOMAIN_TIMER_TRACK_GUEST,
    VIR_DOMAIN_TIMER_TRACK_WALL,
1820

1821
    VIR_DOMAIN_TIMER_TRACK_LAST
1822
} virDomainTimerTrackType;
1823

1824
typedef enum {
1825 1826 1827 1828 1829
    VIR_DOMAIN_TIMER_TICKPOLICY_DELAY = 0,
    VIR_DOMAIN_TIMER_TICKPOLICY_CATCHUP,
    VIR_DOMAIN_TIMER_TICKPOLICY_MERGE,
    VIR_DOMAIN_TIMER_TICKPOLICY_DISCARD,

1830
    VIR_DOMAIN_TIMER_TICKPOLICY_LAST
1831
} virDomainTimerTickpolicyType;
1832

1833
typedef enum {
1834 1835 1836 1837
    VIR_DOMAIN_TIMER_MODE_AUTO = 0,
    VIR_DOMAIN_TIMER_MODE_NATIVE,
    VIR_DOMAIN_TIMER_MODE_EMULATE,
    VIR_DOMAIN_TIMER_MODE_PARAVIRT,
1838
    VIR_DOMAIN_TIMER_MODE_SMPSAFE,
1839

1840
    VIR_DOMAIN_TIMER_MODE_LAST
1841
} virDomainTimerModeType;
1842

1843
typedef enum {
1844
    VIR_DOMAIN_CPU_PLACEMENT_MODE_STATIC = 0,
O
Osier Yang 已提交
1845 1846
    VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO,

1847
    VIR_DOMAIN_CPU_PLACEMENT_MODE_LAST
1848
} virDomainCpuPlacementMode;
O
Osier Yang 已提交
1849

1850 1851 1852 1853
typedef struct _virDomainThreadSchedParam virDomainThreadSchedParam;
typedef virDomainThreadSchedParam *virDomainThreadSchedParamPtr;
struct _virDomainThreadSchedParam {
    virBitmapPtr ids;
1854
    virProcessSchedPolicy policy;
1855 1856 1857
    int priority;
};

1858 1859 1860 1861 1862 1863 1864 1865
typedef struct _virDomainTimerCatchupDef virDomainTimerCatchupDef;
typedef virDomainTimerCatchupDef *virDomainTimerCatchupDefPtr;
struct _virDomainTimerCatchupDef {
    unsigned long threshold;
    unsigned long slew;
    unsigned long limit;
};

1866 1867 1868 1869 1870 1871 1872
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 */

1873 1874 1875 1876
    virDomainTimerCatchupDef catchup;

    /* track is only valid for name='platform|rtc' */
    int track;  /* host|guest */
1877 1878 1879 1880 1881 1882

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

1883
typedef enum {
1884 1885
    VIR_DOMAIN_CLOCK_OFFSET_UTC = 0,
    VIR_DOMAIN_CLOCK_OFFSET_LOCALTIME = 1,
1886
    VIR_DOMAIN_CLOCK_OFFSET_VARIABLE = 2,
1887
    VIR_DOMAIN_CLOCK_OFFSET_TIMEZONE = 3,
1888

1889
    VIR_DOMAIN_CLOCK_OFFSET_LAST
1890
} virDomainClockOffsetType;
1891

1892
typedef enum {
1893 1894 1895
    VIR_DOMAIN_CLOCK_BASIS_UTC = 0,
    VIR_DOMAIN_CLOCK_BASIS_LOCALTIME = 1,

1896
    VIR_DOMAIN_CLOCK_BASIS_LAST
1897
} virDomainClockBasis;
1898

1899 1900 1901 1902
typedef struct _virDomainClockDef virDomainClockDef;
typedef virDomainClockDef *virDomainClockDefPtr;
struct _virDomainClockDef {
    int offset;
1903

1904
    union {
1905 1906 1907
        /* Bug-compatibility-mode for Xen utc|localtime */
        int utc_reset;
        /* Adjustment in seconds, relative to UTC or LOCALTIME, when
1908
         * offset == VIR_DOMAIN_CLOCK_OFFSET_VARIABLE */
1909 1910 1911
        struct {
            long long adjustment;
            int basis;
1912 1913 1914 1915 1916 1917 1918

            /* domain start-time adjustment. This is a
             * private/internal read-only value that only exists when
             * a domain is running, and only if the clock
             * offset='variable'
             */
            long long adjustment0;
1919
        } variable;
1920 1921 1922 1923 1924

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

1926
    size_t ntimers;
1927
    virDomainTimerDefPtr *timers;
1928 1929
};

1930
# define VIR_DOMAIN_CPUMASK_LEN 1024
1931

1932 1933 1934
typedef struct _virDomainPinDef virDomainPinDef;
typedef virDomainPinDef *virDomainPinDefPtr;
struct _virDomainPinDef {
1935
    int id;
H
Hu Tao 已提交
1936
    virBitmapPtr cpumask;
1937 1938
};

1939
void virDomainPinDefFree(virDomainPinDefPtr def);
1940
void virDomainPinDefArrayFree(virDomainPinDefPtr *def, int npin);
1941

1942 1943
virDomainPinDefPtr *virDomainPinDefCopy(virDomainPinDefPtr *src,
                                        int npin);
1944

1945 1946 1947
virDomainPinDefPtr virDomainPinFind(virDomainPinDefPtr *def,
                                    int npin,
                                    int id);
1948

1949 1950 1951
typedef struct _virBlkioDevice virBlkioDevice;
typedef virBlkioDevice *virBlkioDevicePtr;
struct _virBlkioDevice {
1952 1953
    char *path;
    unsigned int weight;
1954 1955 1956 1957
    unsigned int riops;
    unsigned int wiops;
    unsigned long long rbps;
    unsigned long long wbps;
1958 1959
};

1960
typedef enum {
1961 1962 1963
    VIR_DOMAIN_RNG_MODEL_VIRTIO,

    VIR_DOMAIN_RNG_MODEL_LAST
1964
} virDomainRNGModel;
1965

1966
typedef enum {
1967 1968 1969 1970 1971
    VIR_DOMAIN_RNG_BACKEND_RANDOM,
    VIR_DOMAIN_RNG_BACKEND_EGD,
    /* VIR_DOMAIN_RNG_BACKEND_POOL, */

    VIR_DOMAIN_RNG_BACKEND_LAST
1972
} virDomainRNGBackend;
1973 1974 1975 1976

struct _virDomainRNGDef {
    int model;
    int backend;
1977 1978
    unsigned int rate; /* bytes per period */
    unsigned int period; /* milliseconds */
1979 1980 1981 1982 1983 1984 1985 1986 1987 1988

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

    virDomainDeviceInfo info;
};

1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010
typedef enum {
    VIR_DOMAIN_MEMORY_MODEL_NONE,
    VIR_DOMAIN_MEMORY_MODEL_DIMM, /* dimm hotpluggable memory device */

    VIR_DOMAIN_MEMORY_MODEL_LAST
} virDomainMemoryModel;

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

    /* target */
    int model; /* virDomainMemoryModel */
    unsigned int targetNode;
    unsigned long long size; /* kibibytes */

    virDomainDeviceInfo info;
};

void virDomainMemoryDefFree(virDomainMemoryDefPtr def);

2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025
struct _virDomainIdMapEntry {
    unsigned int start;
    unsigned int target;
    unsigned int count;
};

struct _virDomainIdMapDef {
    size_t nuidmap;
    virDomainIdMapEntryPtr uidmap;

    size_t ngidmap;
    virDomainIdMapEntryPtr gidmap;
};


H
Hu Tao 已提交
2026 2027 2028 2029 2030
struct _virDomainPanicDef {
    virDomainDeviceInfo info;
};


2031
void virBlkioDeviceArrayClear(virBlkioDevicePtr deviceWeights,
2032
                              int ndevices);
2033

2034 2035 2036 2037 2038
typedef struct _virDomainResourceDef virDomainResourceDef;
typedef virDomainResourceDef *virDomainResourceDefPtr;
struct _virDomainResourceDef {
    char *partition;
};
2039

2040
typedef struct _virDomainHugePage virDomainHugePage;
2041 2042
typedef virDomainHugePage *virDomainHugePagePtr;

2043
struct _virDomainHugePage {
2044 2045 2046 2047
    virBitmapPtr nodemask;      /* guest's NUMA node mask */
    unsigned long long size;    /* hugepage size in KiB */
};

2048 2049 2050 2051 2052 2053
typedef struct _virDomainIOThreadIDDef virDomainIOThreadIDDef;
typedef virDomainIOThreadIDDef *virDomainIOThreadIDDefPtr;

struct _virDomainIOThreadIDDef {
    bool autofill;
    unsigned int iothread_id;
2054
    int thread_id;
2055
    virBitmapPtr cpumask;
2056 2057 2058 2059
};

void virDomainIOThreadIDDefFree(virDomainIOThreadIDDefPtr def);

2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070
typedef struct _virDomainCputune virDomainCputune;
typedef virDomainCputune *virDomainCputunePtr;

struct _virDomainCputune {
    unsigned long shares;
    bool sharesSpecified;
    unsigned long long period;
    long long quota;
    unsigned long long emulator_period;
    long long emulator_quota;
    size_t nvcpupin;
2071 2072
    virDomainPinDefPtr *vcpupin;
    virDomainPinDefPtr emulatorpin;
2073 2074 2075 2076 2077

    size_t nvcpusched;
    virDomainThreadSchedParamPtr vcpusched;
    size_t niothreadsched;
    virDomainThreadSchedParamPtr iothreadsched;
2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093
};

typedef struct _virDomainBlkiotune virDomainBlkiotune;
typedef virDomainBlkiotune *virDomainBlkiotunePtr;

struct _virDomainBlkiotune {
    unsigned int weight;

    size_t ndevices;
    virBlkioDevicePtr devices;
};

typedef struct _virDomainMemtune virDomainMemtune;
typedef virDomainMemtune *virDomainMemtunePtr;

struct _virDomainMemtune {
2094 2095 2096 2097
    unsigned long long max_balloon; /* in kibibytes, capped at ulong thanks
                                       to virDomainGetMaxMemory */
    unsigned long long cur_balloon; /* in kibibytes, capped at ulong thanks
                                       to virDomainGetInfo */
2098 2099 2100 2101

    virDomainHugePagePtr hugepages;
    size_t nhugepages;

2102 2103 2104 2105
    /* maximum supported memory for a guest, for hotplugging */
    unsigned long long max_memory; /* in kibibytes */
    unsigned int memory_slots; /* maximum count of RAM memory slots */

2106 2107 2108
    bool nosharepages;
    bool locked;
    int dump_core; /* enum virTristateSwitch */
2109 2110 2111 2112
    unsigned long long hard_limit; /* in kibibytes, limit at off_t bytes */
    unsigned long long soft_limit; /* in kibibytes, limit at off_t bytes */
    unsigned long long min_guarantee; /* in kibibytes, limit at off_t bytes */
    unsigned long long swap_hard_limit; /* in kibibytes, limit at off_t bytes */
2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123
};

typedef struct _virDomainPowerManagement virDomainPowerManagement;
typedef virDomainPowerManagement *virDomainPowerManagementPtr;

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

2124 2125 2126 2127 2128 2129 2130
typedef struct _virDomainKeyWrapDef virDomainKeyWrapDef;
typedef virDomainKeyWrapDef *virDomainKeyWrapDefPtr;
struct _virDomainKeyWrapDef {
    int aes; /* enum virTristateSwitch */
    int dea; /* enum virTristateSwitch */
};

2131 2132 2133 2134 2135 2136
/*
 * Guest VM main configuration
 *
 * NB: if adding to this struct, virDomainDefCheckABIStability
 * may well need an update
 */
2137 2138
typedef struct _virDomainDef virDomainDef;
typedef virDomainDef *virDomainDefPtr;
2139 2140 2141 2142 2143
struct _virDomainDef {
    int virtType;
    int id;
    unsigned char uuid[VIR_UUID_BUFLEN];
    char *name;
2144
    char *title;
2145
    char *description;
2146

2147 2148
    virDomainBlkiotune blkio;
    virDomainMemtune mem;
2149

E
Eric Blake 已提交
2150 2151
    unsigned short vcpus;
    unsigned short maxvcpus;
O
Osier Yang 已提交
2152
    int placement_mode;
H
Hu Tao 已提交
2153
    virBitmapPtr cpumask;
2154

2155
    unsigned int iothreads;
2156 2157
    size_t niothreadids;
    virDomainIOThreadIDDefPtr *iothreadids;
2158

2159
    virDomainCputune cputune;
2160

2161
    virDomainNumaPtr numa;
2162
    virDomainResourceDefPtr resource;
2163
    virDomainIdMapDef idmap;
2164

2165 2166 2167 2168 2169
    /* These 3 are based on virDomainLifeCycleAction enum flags */
    int onReboot;
    int onPoweroff;
    int onCrash;

2170 2171
    int onLockFailure; /* enum virDomainLockFailureAction */

2172
    virDomainPowerManagement pm;
2173

2174 2175
    virDomainOSDef os;
    char *emulator;
2176 2177 2178
    /* These three options are of type virTristateSwitch,
     * except VIR_DOMAIN_FEATURE_CAPABILITIES that is of type
     * virDomainCapabilitiesPolicy */
2179
    int features[VIR_DOMAIN_FEATURE_LAST];
2180
    int apic_eoi;
2181
    int hyperv_features[VIR_DOMAIN_HYPERV_LAST];
2182
    int kvm_features[VIR_DOMAIN_KVM_LAST];
2183
    unsigned int hyperv_spinlocks;
M
Michal Privoznik 已提交
2184
    unsigned int gic_version;
2185

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

2189
    virDomainClockDef clock;
2190

2191
    size_t ngraphics;
2192
    virDomainGraphicsDefPtr *graphics;
2193

2194
    size_t ndisks;
2195 2196
    virDomainDiskDefPtr *disks;

2197
    size_t ncontrollers;
2198 2199
    virDomainControllerDefPtr *controllers;

2200
    size_t nfss;
2201 2202
    virDomainFSDefPtr *fss;

2203
    size_t nnets;
2204 2205
    virDomainNetDefPtr *nets;

2206
    size_t ninputs;
2207 2208
    virDomainInputDefPtr *inputs;

2209
    size_t nsounds;
2210 2211
    virDomainSoundDefPtr *sounds;

2212
    size_t nvideos;
2213 2214
    virDomainVideoDefPtr *videos;

2215
    size_t nhostdevs;
2216 2217
    virDomainHostdevDefPtr *hostdevs;

2218
    size_t nredirdevs;
2219 2220
    virDomainRedirdevDefPtr *redirdevs;

2221
    size_t nsmartcards;
E
Eric Blake 已提交
2222 2223
    virDomainSmartcardDefPtr *smartcards;

2224
    size_t nserials;
2225 2226
    virDomainChrDefPtr *serials;

2227
    size_t nparallels;
2228 2229
    virDomainChrDefPtr *parallels;

2230
    size_t nchannels;
2231 2232
    virDomainChrDefPtr *channels;

2233
    size_t nconsoles;
2234 2235
    virDomainChrDefPtr *consoles;

2236
    size_t nleases;
2237 2238
    virDomainLeaseDefPtr *leases;

2239
    size_t nhubs;
M
Marc-André Lureau 已提交
2240 2241
    virDomainHubDefPtr *hubs;

2242 2243 2244
    size_t nseclabels;
    virSecurityLabelDefPtr *seclabels;

2245 2246 2247
    size_t nrngs;
    virDomainRNGDefPtr *rngs;

2248 2249 2250
    size_t nshmems;
    virDomainShmemDefPtr *shmems;

2251 2252 2253
    size_t nmems;
    virDomainMemoryDefPtr *mems;

2254
    /* Only 1 */
R
Richard Jones 已提交
2255
    virDomainWatchdogDefPtr watchdog;
2256
    virDomainMemballoonDefPtr memballoon;
L
Li Zhang 已提交
2257
    virDomainNVRAMDefPtr nvram;
2258
    virDomainTPMDefPtr tpm;
2259
    virCPUDefPtr cpu;
2260
    virSysinfoDefPtr sysinfo;
2261
    virDomainRedirFilterDefPtr redirfilter;
H
Hu Tao 已提交
2262
    virDomainPanicDefPtr panic;
2263 2264 2265

    void *namespaceData;
    virDomainXMLNamespace ns;
2266

2267 2268
    virDomainKeyWrapDefPtr keywrap;

2269 2270
    /* Application-specific custom metadata */
    xmlNodePtr metadata;
2271 2272
};

2273 2274 2275 2276
unsigned long long virDomainDefGetMemoryInitial(virDomainDefPtr def);
void virDomainDefSetMemoryInitial(virDomainDefPtr def, unsigned long long size);
unsigned long long virDomainDefGetMemoryActual(virDomainDefPtr def);

2277 2278 2279 2280 2281 2282 2283
typedef enum {
    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_AES,
    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_DEA,

    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_LAST
} virDomainKeyWrapCipherName;

2284
typedef enum {
2285 2286 2287 2288 2289
    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 */
2290
    VIR_DOMAIN_TAINT_EXTERNAL_LAUNCH,  /* Externally launched guest domain */
2291
    VIR_DOMAIN_TAINT_HOST_CPU,         /* Host CPU passthrough in use */
2292
    VIR_DOMAIN_TAINT_HOOK,             /* Domain (possibly) changed via hook script */
2293
    VIR_DOMAIN_TAINT_CDROM_PASSTHROUGH,/* CDROM passthrough */
2294 2295

    VIR_DOMAIN_TAINT_LAST
2296
} virDomainTaintFlags;
2297

2298
/* Guest VM runtime state */
J
Jiri Denemark 已提交
2299 2300 2301 2302 2303 2304
typedef struct _virDomainStateReason virDomainStateReason;
struct _virDomainStateReason {
    int state;
    int reason;
};

2305 2306 2307
typedef struct _virDomainObj virDomainObj;
typedef virDomainObj *virDomainObjPtr;
struct _virDomainObj {
2308
    virObjectLockable parent;
2309

2310
    pid_t pid;
J
Jiri Denemark 已提交
2311
    virDomainStateReason state;
2312 2313 2314

    unsigned int autostart : 1;
    unsigned int persistent : 1;
2315
    unsigned int updated : 1;
2316
    unsigned int removing : 1;
2317 2318 2319

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

2321
    virDomainSnapshotObjListPtr snapshots;
C
Chris Lalancette 已提交
2322 2323
    virDomainSnapshotObjPtr current_snapshot;

2324 2325
    bool hasManagedSave;

2326 2327
    void *privateData;
    void (*privateDataFreeFunc)(void *);
2328 2329

    int taint;
2330 2331
};

2332 2333
typedef struct _virDomainObjList virDomainObjList;
typedef virDomainObjList *virDomainObjListPtr;
2334

2335 2336
typedef bool (*virDomainObjListACLFilter)(virConnectPtr conn,
                                          virDomainDefPtr def);
2337

2338 2339 2340

/* This structure holds various callbacks and data needed
 * while parsing and creating domain XMLs */
2341 2342
typedef struct _virDomainXMLOption virDomainXMLOption;
typedef virDomainXMLOption *virDomainXMLOptionPtr;
2343 2344 2345

typedef void *(*virDomainXMLPrivateDataAllocFunc)(void);
typedef void (*virDomainXMLPrivateDataFreeFunc)(void *);
2346
typedef virObjectPtr (*virDomainXMLPrivateDataNewFunc)(void);
2347 2348 2349
typedef int (*virDomainXMLPrivateDataFormatFunc)(virBufferPtr, void *);
typedef int (*virDomainXMLPrivateDataParseFunc)(xmlXPathContextPtr, void *);

2350 2351
/* Called once after everything else has been parsed, for adjusting
 * overall domain defaults.  */
2352 2353 2354
typedef int (*virDomainDefPostParseCallback)(virDomainDefPtr def,
                                             virCapsPtr caps,
                                             void *opaque);
2355 2356
/* Called once per device, for adjusting per-device settings while
 * leaving the overall domain otherwise unchanged.  */
2357
typedef int (*virDomainDeviceDefPostParseCallback)(virDomainDeviceDefPtr dev,
2358
                                                   const virDomainDef *def,
2359 2360 2361 2362 2363 2364
                                                   virCapsPtr caps,
                                                   void *opaque);

typedef struct _virDomainDefParserConfig virDomainDefParserConfig;
typedef virDomainDefParserConfig *virDomainDefParserConfigPtr;
struct _virDomainDefParserConfig {
2365
    /* driver domain definition callbacks */
2366 2367 2368
    virDomainDefPostParseCallback domainPostParseCallback;
    virDomainDeviceDefPostParseCallback devicesPostParseCallback;

2369
    /* private data for the callbacks */
2370 2371
    void *priv;
    virFreeCallback privFree;
2372 2373

    /* data */
2374
    bool hasWideSCSIBus;
2375
    unsigned char macPrefix[VIR_MAC_PREFIX_BUFLEN];
2376 2377
};

2378 2379 2380 2381 2382
typedef struct _virDomainXMLPrivateDataCallbacks virDomainXMLPrivateDataCallbacks;
typedef virDomainXMLPrivateDataCallbacks *virDomainXMLPrivateDataCallbacksPtr;
struct _virDomainXMLPrivateDataCallbacks {
    virDomainXMLPrivateDataAllocFunc  alloc;
    virDomainXMLPrivateDataFreeFunc   free;
2383
    virDomainXMLPrivateDataNewFunc    diskNew;
2384 2385 2386 2387
    virDomainXMLPrivateDataFormatFunc format;
    virDomainXMLPrivateDataParseFunc  parse;
};

2388 2389 2390
virDomainXMLOptionPtr virDomainXMLOptionNew(virDomainDefParserConfigPtr config,
                                            virDomainXMLPrivateDataCallbacksPtr priv,
                                            virDomainXMLNamespacePtr xmlns);
2391

2392 2393
void virDomainNetGenerateMAC(virDomainXMLOptionPtr xmlopt, virMacAddrPtr mac);

2394
virDomainXMLNamespacePtr
2395
virDomainXMLOptionGetNamespace(virDomainXMLOptionPtr xmlopt)
2396 2397
    ATTRIBUTE_NONNULL(1);

2398 2399 2400 2401 2402
int
virDomainDefPostParse(virDomainDefPtr def,
                      virCapsPtr caps,
                      virDomainXMLOptionPtr xmlopt);

2403
static inline bool
D
Daniel P. Berrange 已提交
2404
virDomainObjIsActive(virDomainObjPtr dom)
2405 2406 2407 2408
{
    return dom->def->id != -1;
}

2409
virDomainObjPtr virDomainObjNew(virDomainXMLOptionPtr caps)
2410
    ATTRIBUTE_NONNULL(1);
2411

2412
virDomainObjListPtr virDomainObjListNew(void);
2413

2414
virDomainObjPtr virDomainObjListFindByID(virDomainObjListPtr doms,
2415
                                         int id);
2416
virDomainObjPtr virDomainObjListFindByUUID(virDomainObjListPtr doms,
2417
                                           const unsigned char *uuid);
2418 2419
virDomainObjPtr virDomainObjListFindByUUIDRef(virDomainObjListPtr doms,
                                              const unsigned char *uuid);
2420
virDomainObjPtr virDomainObjListFindByName(virDomainObjListPtr doms,
2421
                                           const char *name);
2422

M
Michal Privoznik 已提交
2423 2424
void virDomainObjEndAPI(virDomainObjPtr *vm);

2425
bool virDomainObjTaint(virDomainObjPtr obj,
2426
                       virDomainTaintFlags taint);
2427

2428 2429

int virDomainDefCheckUnsupportedMemoryHotplug(virDomainDefPtr def);
2430
int virDomainDeviceDefCheckUnsupportedMemoryDevice(virDomainDeviceDefPtr dev);
2431

H
Hu Tao 已提交
2432
void virDomainPanicDefFree(virDomainPanicDefPtr panic);
2433
void virDomainResourceDefFree(virDomainResourceDefPtr resource);
2434 2435
void virDomainGraphicsDefFree(virDomainGraphicsDefPtr def);
void virDomainInputDefFree(virDomainInputDefPtr def);
2436
virDomainDiskDefPtr virDomainDiskDefNew(virDomainXMLOptionPtr xmlopt);
2437
void virDomainDiskDefFree(virDomainDiskDefPtr def);
2438
void virDomainLeaseDefFree(virDomainLeaseDefPtr def);
2439 2440 2441 2442 2443 2444 2445 2446 2447 2448
int virDomainDiskGetType(virDomainDiskDefPtr def);
void virDomainDiskSetType(virDomainDiskDefPtr def, int type);
const char *virDomainDiskGetSource(virDomainDiskDefPtr def);
int virDomainDiskSetSource(virDomainDiskDefPtr def, const char *src)
    ATTRIBUTE_RETURN_CHECK;
const char *virDomainDiskGetDriver(virDomainDiskDefPtr def);
int virDomainDiskSetDriver(virDomainDiskDefPtr def, const char *name)
    ATTRIBUTE_RETURN_CHECK;
int virDomainDiskGetFormat(virDomainDiskDefPtr def);
void virDomainDiskSetFormat(virDomainDiskDefPtr def, int format);
H
Han Cheng 已提交
2449 2450 2451
int virDomainDeviceFindControllerModel(virDomainDefPtr def,
                                       virDomainDeviceInfoPtr info,
                                       int controllerType);
2452 2453 2454
virDomainDiskDefPtr virDomainDiskFindByBusAndDst(virDomainDefPtr def,
                                                 int bus,
                                                 char *dst);
2455
void virDomainControllerDefFree(virDomainControllerDefPtr def);
2456
void virDomainFSDefFree(virDomainFSDefPtr def);
2457
void virDomainActualNetDefFree(virDomainActualNetDefPtr def);
2458
void virDomainNetDefFree(virDomainNetDefPtr def);
E
Eric Blake 已提交
2459
void virDomainSmartcardDefFree(virDomainSmartcardDefPtr def);
2460
void virDomainChrDefFree(virDomainChrDefPtr def);
2461
void virDomainChrSourceDefFree(virDomainChrSourceDefPtr def);
2462 2463
int virDomainChrSourceDefCopy(virDomainChrSourceDefPtr src,
                              virDomainChrSourceDefPtr dest);
2464
void virDomainSoundCodecDefFree(virDomainSoundCodecDefPtr def);
2465
void virDomainSoundDefFree(virDomainSoundDefPtr def);
2466
void virDomainMemballoonDefFree(virDomainMemballoonDefPtr def);
L
Li Zhang 已提交
2467
void virDomainNVRAMDefFree(virDomainNVRAMDefPtr def);
R
Richard Jones 已提交
2468
void virDomainWatchdogDefFree(virDomainWatchdogDefPtr def);
2469
void virDomainVideoDefFree(virDomainVideoDefPtr def);
2470 2471
virDomainHostdevDefPtr virDomainHostdevDefAlloc(void);
void virDomainHostdevDefClear(virDomainHostdevDefPtr def);
2472
void virDomainHostdevDefFree(virDomainHostdevDefPtr def);
M
Marc-André Lureau 已提交
2473
void virDomainHubDefFree(virDomainHubDefPtr def);
2474
void virDomainRedirdevDefFree(virDomainRedirdevDefPtr def);
2475
void virDomainRedirFilterDefFree(virDomainRedirFilterDefPtr def);
2476
void virDomainShmemDefFree(virDomainShmemDefPtr def);
2477
void virDomainDeviceDefFree(virDomainDeviceDefPtr def);
2478
virDomainDeviceDefPtr virDomainDeviceDefCopy(virDomainDeviceDefPtr src,
2479
                                             const virDomainDef *def,
2480 2481
                                             virCapsPtr caps,
                                             virDomainXMLOptionPtr xmlopt);
2482 2483
int virDomainDeviceAddressIsValid(virDomainDeviceInfoPtr info,
                                  int type);
2484
virDomainDeviceInfoPtr virDomainDeviceGetInfo(virDomainDeviceDefPtr device);
2485 2486
int virDomainDeviceInfoCopy(virDomainDeviceInfoPtr dst,
                            virDomainDeviceInfoPtr src);
2487
void virDomainDeviceInfoClear(virDomainDeviceInfoPtr info);
2488
void virDomainDefClearPCIAddresses(virDomainDefPtr def);
2489
void virDomainDefClearCCWAddresses(virDomainDefPtr def);
D
Daniel P. Berrange 已提交
2490
void virDomainDefClearDeviceAliases(virDomainDefPtr def);
2491
void virDomainTPMDefFree(virDomainTPMDefPtr def);
2492

2493
typedef int (*virDomainDeviceInfoCallback)(virDomainDefPtr def,
2494 2495
                                           virDomainDeviceDefPtr dev,
                                           virDomainDeviceInfoPtr info,
2496 2497 2498 2499 2500 2501
                                           void *opaque);

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

2502 2503 2504 2505
bool virDomainDefHasDeviceAddress(virDomainDefPtr def,
                                  virDomainDeviceInfoPtr info)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;

2506 2507
void virDomainDefFree(virDomainDefPtr vm);

M
Michal Novotny 已提交
2508 2509
virDomainChrDefPtr virDomainChrDefNew(void);

2510 2511 2512 2513
virDomainDefPtr virDomainDefNew(void);
virDomainDefPtr virDomainDefNewFull(const char *name,
                                    const unsigned char *uuid,
                                    int id);
2514

2515 2516 2517 2518
enum {
    VIR_DOMAIN_OBJ_LIST_ADD_LIVE = (1 << 0),
    VIR_DOMAIN_OBJ_LIST_ADD_CHECK_LIVE = (1 << 1),
};
2519
virDomainObjPtr virDomainObjListAdd(virDomainObjListPtr doms,
2520
                                    virDomainDefPtr def,
2521
                                    virDomainXMLOptionPtr xmlopt,
2522 2523
                                    unsigned int flags,
                                    virDomainDefPtr *oldDef);
2524
void virDomainObjAssignDef(virDomainObjPtr domain,
2525
                           virDomainDefPtr def,
2526 2527
                           bool live,
                           virDomainDefPtr *oldDef);
2528
int virDomainObjSetDefTransient(virCapsPtr caps,
2529
                                virDomainXMLOptionPtr xmlopt,
2530 2531
                                virDomainObjPtr domain,
                                bool live);
2532 2533
virDomainDefPtr
virDomainObjGetPersistentDef(virCapsPtr caps,
2534
                             virDomainXMLOptionPtr xmlopt,
2535
                             virDomainObjPtr domain);
2536 2537 2538

int
virDomainLiveConfigHelperMethod(virCapsPtr caps,
2539
                                virDomainXMLOptionPtr xmlopt,
2540 2541 2542 2543
                                virDomainObjPtr dom,
                                unsigned int *flags,
                                virDomainDefPtr *persistentDef);

2544 2545 2546 2547 2548 2549 2550
virDomainDefPtr virDomainDefCopy(virDomainDefPtr src,
                                 virCapsPtr caps,
                                 virDomainXMLOptionPtr xmlopt,
                                 bool migratable);
virDomainDefPtr virDomainObjCopyPersistentDef(virDomainObjPtr dom,
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt);
2551

2552 2553
void virDomainObjListRemove(virDomainObjListPtr doms,
                            virDomainObjPtr dom);
2554 2555
void virDomainObjListRemoveLocked(virDomainObjListPtr doms,
                                  virDomainObjPtr dom);
2556

2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569
typedef enum {
    /* parse internal domain status information */
    VIR_DOMAIN_DEF_PARSE_STATUS          = 1 << 0,
    VIR_DOMAIN_DEF_PARSE_INACTIVE        = 1 << 1,
    /* parse <actual> element */
    VIR_DOMAIN_DEF_PARSE_ACTUAL_NET      = 1 << 2,
    /* parse original states of host PCI device */
    VIR_DOMAIN_DEF_PARSE_PCI_ORIG_STATES = 1 << 3,
    VIR_DOMAIN_DEF_PARSE_ALLOW_ROM       = 1 << 4,
    VIR_DOMAIN_DEF_PARSE_ALLOW_BOOT      = 1 << 5,
    VIR_DOMAIN_DEF_PARSE_CLOCK_ADJUST    = 1 << 6,
    /* parse only source half of <disk> */
    VIR_DOMAIN_DEF_PARSE_DISK_SOURCE     = 1 << 7,
2570
    VIR_DOMAIN_DEF_PARSE_VALIDATE        = 1 << 8,
2571 2572 2573 2574
    /* don't validate os.type and arch against capabilities. Prevents
     * VMs from disappearing when qemu is removed and libvirtd is restarted
     */
    VIR_DOMAIN_DEF_PARSE_SKIP_OSTYPE_CHECKS = 1 << 9,
2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592
} virDomainDefParseFlags;

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

2593
virDomainDeviceDefPtr virDomainDeviceDefParse(const char *xmlStr,
2594
                                              const virDomainDef *def,
2595 2596
                                              virCapsPtr caps,
                                              virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2597
                                              unsigned int flags);
2598 2599 2600 2601
virStorageSourcePtr virDomainDiskDefSourceParse(const char *xmlStr,
                                                const virDomainDef *def,
                                                virDomainXMLOptionPtr xmlopt,
                                                unsigned int flags);
2602 2603
virDomainDefPtr virDomainDefParseString(const char *xmlStr,
                                        virCapsPtr caps,
2604
                                        virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2605
                                        unsigned int flags);
2606 2607
virDomainDefPtr virDomainDefParseFile(const char *filename,
                                      virCapsPtr caps,
2608
                                      virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2609
                                      unsigned int flags);
2610
virDomainDefPtr virDomainDefParseNode(xmlDocPtr doc,
2611
                                      xmlNodePtr root,
2612 2613
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
L
Laine Stump 已提交
2614
                                      unsigned int flags);
2615 2616 2617 2618 2619
virDomainObjPtr virDomainObjParseNode(xmlDocPtr xml,
                                      xmlNodePtr root,
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
                                      unsigned int flags);
2620 2621 2622 2623
virDomainObjPtr virDomainObjParseFile(const char *filename,
                                      virCapsPtr caps,
                                      virDomainXMLOptionPtr xmlopt,
                                      unsigned int flags);
2624

2625 2626 2627
bool virDomainDefCheckABIStability(virDomainDefPtr src,
                                   virDomainDefPtr dst);

2628
int virDomainDefAddImplicitControllers(virDomainDefPtr def);
2629

2630 2631 2632 2633 2634
virDomainIOThreadIDDefPtr virDomainIOThreadIDFind(virDomainDefPtr def,
                                                  unsigned int iothread_id);
virDomainIOThreadIDDefPtr virDomainIOThreadIDAdd(virDomainDefPtr def,
                                                 unsigned int iothread_id);
void virDomainIOThreadIDDel(virDomainDefPtr def, unsigned int iothread_id);
2635
void virDomainIOThreadSchedDelId(virDomainDefPtr def, unsigned int iothread_id);
2636

2637 2638
unsigned int virDomainDefFormatConvertXMLFlags(unsigned int flags);

2639
char *virDomainDefFormat(virDomainDefPtr def,
L
Laine Stump 已提交
2640
                         unsigned int flags);
2641 2642 2643
char *virDomainObjFormat(virDomainXMLOptionPtr xmlopt,
                         virDomainObjPtr obj,
                         unsigned int flags);
2644 2645 2646
int virDomainDefFormatInternal(virDomainDefPtr def,
                               unsigned int flags,
                               virBufferPtr buf);
2647

2648 2649 2650 2651
int virDomainDiskSourceFormat(virBufferPtr buf,
                              virStorageSourcePtr src,
                              int policy,
                              unsigned int flags);
2652

2653 2654 2655 2656
int virDomainNetDefFormat(virBufferPtr buf,
                          virDomainNetDefPtr def,
                          unsigned int flags);

2657 2658 2659 2660 2661 2662
typedef enum {
    VIR_DOMAIN_DEVICE_ACTION_ATTACH,
    VIR_DOMAIN_DEVICE_ACTION_DETACH,
    VIR_DOMAIN_DEVICE_ACTION_UPDATE,
} virDomainDeviceAction;

2663
int virDomainDefCompatibleDevice(virDomainDefPtr def,
2664 2665
                                 virDomainDeviceDefPtr dev,
                                 virDomainDeviceAction action);
2666

2667 2668 2669 2670 2671
int virDomainPinAdd(virDomainPinDefPtr **pindef_list,
                    size_t *npin,
                    unsigned char *cpumap,
                    int maplen,
                    int id);
2672

2673 2674 2675
void virDomainPinDel(virDomainPinDefPtr **pindef_list,
                     size_t *npin,
                     int vcpu);
2676

2677 2678 2679 2680 2681 2682
int virDomainEmulatorPinAdd(virDomainDefPtr def,
                              unsigned char *cpumap,
                              int maplen);

int virDomainEmulatorPinDel(virDomainDefPtr def);

2683 2684
void virDomainRNGDefFree(virDomainRNGDefPtr def);

2685
bool virDomainDiskDefDstDuplicates(virDomainDefPtr def);
2686 2687 2688 2689
int virDomainDiskIndexByAddress(virDomainDefPtr def,
                                virDevicePCIAddressPtr pci_controller,
                                unsigned int bus, unsigned int target,
                                unsigned int unit);
2690 2691 2692 2693 2694
virDomainDiskDefPtr virDomainDiskByAddress(virDomainDefPtr def,
                                           virDevicePCIAddressPtr pci_controller,
                                           unsigned int bus,
                                           unsigned int target,
                                           unsigned int unit);
2695 2696
int virDomainDiskIndexByName(virDomainDefPtr def, const char *name,
                             bool allow_ambiguous);
2697 2698 2699
virDomainDiskDefPtr virDomainDiskByName(virDomainDefPtr def,
                                        const char *name,
                                        bool allow_ambiguous);
2700
const char *virDomainDiskPathByName(virDomainDefPtr, const char *name);
2701
int virDomainDiskInsert(virDomainDefPtr def,
2702 2703
                        virDomainDiskDefPtr disk)
    ATTRIBUTE_RETURN_CHECK;
2704 2705
void virDomainDiskInsertPreAlloced(virDomainDefPtr def,
                                   virDomainDiskDefPtr disk);
2706 2707
int virDomainDiskDefAssignAddress(virDomainXMLOptionPtr xmlopt,
                                  virDomainDiskDefPtr def);
2708

2709 2710 2711 2712
virDomainDiskDefPtr
virDomainDiskRemove(virDomainDefPtr def, size_t i);
virDomainDiskDefPtr
virDomainDiskRemoveByName(virDomainDefPtr def, const char *name);
2713
int virDomainDiskSourceParse(xmlNodePtr node,
2714
                             xmlXPathContextPtr ctxt,
2715
                             virStorageSourcePtr src);
2716

2717 2718
int virDomainNetFindIdx(virDomainDefPtr def, virDomainNetDefPtr net);
virDomainNetDefPtr virDomainNetFind(virDomainDefPtr def, const char *device);
2719
bool virDomainHasNet(virDomainDefPtr def, virDomainNetDefPtr net);
2720
int virDomainNetInsert(virDomainDefPtr def, virDomainNetDefPtr net);
2721
virDomainNetDefPtr virDomainNetRemove(virDomainDefPtr def, size_t i);
2722
void virDomainNetRemoveHostdev(virDomainDefPtr def, virDomainNetDefPtr net);
2723

L
Laine Stump 已提交
2724
int virDomainHostdevInsert(virDomainDefPtr def, virDomainHostdevDefPtr hostdev);
2725 2726
virDomainHostdevDefPtr
virDomainHostdevRemove(virDomainDefPtr def, size_t i);
L
Laine Stump 已提交
2727 2728 2729
int virDomainHostdevFind(virDomainDefPtr def, virDomainHostdevDefPtr match,
                         virDomainHostdevDefPtr *found);

2730
int virDomainGraphicsListenGetType(virDomainGraphicsDefPtr def, size_t i)
2731
            ATTRIBUTE_NONNULL(1);
2732
int virDomainGraphicsListenSetType(virDomainGraphicsDefPtr def, size_t i, int val)
2733 2734
            ATTRIBUTE_NONNULL(1);
const char *virDomainGraphicsListenGetAddress(virDomainGraphicsDefPtr def,
2735
                                              size_t i)
2736 2737
            ATTRIBUTE_NONNULL(1);
int virDomainGraphicsListenSetAddress(virDomainGraphicsDefPtr def,
2738
                                      size_t i, const char *address,
2739 2740 2741
                                      int len, bool setType)
            ATTRIBUTE_NONNULL(1);
const char *virDomainGraphicsListenGetNetwork(virDomainGraphicsDefPtr def,
2742
                                              size_t i)
2743 2744
            ATTRIBUTE_NONNULL(1);
int virDomainGraphicsListenSetNetwork(virDomainGraphicsDefPtr def,
2745
                                      size_t i, const char *network, int len)
2746 2747
            ATTRIBUTE_NONNULL(1);

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

2765
int virDomainControllerInsert(virDomainDefPtr def,
2766 2767
                              virDomainControllerDefPtr controller)
    ATTRIBUTE_RETURN_CHECK;
2768 2769
void virDomainControllerInsertPreAlloced(virDomainDefPtr def,
                                         virDomainControllerDefPtr controller);
2770
int virDomainControllerFind(virDomainDefPtr def, int type, int idx);
2771
int virDomainControllerFindByType(virDomainDefPtr def, int type);
2772 2773
int virDomainControllerFindByPCIAddress(virDomainDefPtr def,
                                        virDevicePCIAddressPtr addr);
2774
virDomainControllerDefPtr virDomainControllerRemove(virDomainDefPtr def, size_t i);
2775 2776 2777
const char *virDomainControllerAliasFind(virDomainDefPtr def,
                                         int type, int idx)
    ATTRIBUTE_NONNULL(1);
2778 2779 2780 2781 2782

int virDomainLeaseIndex(virDomainDefPtr def,
                        virDomainLeaseDefPtr lease);
int virDomainLeaseInsert(virDomainDefPtr def,
                         virDomainLeaseDefPtr lease);
2783 2784
int virDomainLeaseInsertPreAlloc(virDomainDefPtr def)
    ATTRIBUTE_RETURN_CHECK;
2785 2786
void virDomainLeaseInsertPreAlloced(virDomainDefPtr def,
                                    virDomainLeaseDefPtr lease);
2787 2788 2789 2790 2791
virDomainLeaseDefPtr
virDomainLeaseRemoveAt(virDomainDefPtr def, size_t i);
virDomainLeaseDefPtr
virDomainLeaseRemove(virDomainDefPtr def,
                     virDomainLeaseDefPtr lease);
2792

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

2815 2816 2817 2818 2819 2820
int virDomainRNGInsert(virDomainDefPtr def,
                       virDomainRNGDefPtr rng,
                       bool inplace);
ssize_t virDomainRNGFind(virDomainDefPtr def, virDomainRNGDefPtr rng);
virDomainRNGDefPtr virDomainRNGRemove(virDomainDefPtr def, size_t idx);

2821
int virDomainSaveXML(const char *configDir,
2822 2823 2824
                     virDomainDefPtr def,
                     const char *xml);

2825
int virDomainSaveConfig(const char *configDir,
2826
                        virDomainDefPtr def);
2827
int virDomainSaveStatus(virDomainXMLOptionPtr xmlopt,
2828
                        const char *statusDir,
2829
                        virDomainObjPtr obj) ATTRIBUTE_RETURN_CHECK;
2830

2831 2832 2833 2834
typedef void (*virDomainLoadConfigNotify)(virDomainObjPtr dom,
                                          int newDomain,
                                          void *opaque);

2835 2836 2837 2838
int virDomainObjListLoadAllConfigs(virDomainObjListPtr doms,
                                   const char *configDir,
                                   const char *autostartDir,
                                   int liveStatus,
2839 2840
                                   virCapsPtr caps,
                                   virDomainXMLOptionPtr xmlopt,
2841 2842
                                   virDomainLoadConfigNotify notify,
                                   void *opaque);
2843

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

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

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

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

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

2865 2866
int virDomainObjListNumOfDomains(virDomainObjListPtr doms,
                                 bool active,
2867
                                 virDomainObjListACLFilter filter,
2868
                                 virConnectPtr conn);
2869 2870 2871

int virDomainObjListGetActiveIDs(virDomainObjListPtr doms,
                                 int *ids,
2872
                                 int maxids,
2873
                                 virDomainObjListACLFilter filter,
2874
                                 virConnectPtr conn);
2875 2876
int virDomainObjListGetInactiveNames(virDomainObjListPtr doms,
                                     char **const names,
2877
                                     int maxnames,
2878
                                     virDomainObjListACLFilter filter,
2879
                                     virConnectPtr conn);
2880

2881 2882 2883 2884 2885 2886 2887
typedef int (*virDomainObjListIterator)(virDomainObjPtr dom,
                                        void *opaque);

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

E
Eric Blake 已提交
2888 2889 2890 2891 2892 2893 2894 2895 2896
typedef int (*virDomainSmartcardDefIterator)(virDomainDefPtr def,
                                             virDomainSmartcardDefPtr dev,
                                             void *opaque);

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

2897 2898 2899 2900 2901 2902 2903 2904 2905
typedef int (*virDomainChrDefIterator)(virDomainDefPtr def,
                                       virDomainChrDefPtr dev,
                                       void *opaque);

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

2906 2907 2908 2909 2910 2911 2912 2913 2914 2915
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 已提交
2916 2917 2918 2919 2920 2921 2922
void
virDomainObjSetState(virDomainObjPtr obj, virDomainState state, int reason)
        ATTRIBUTE_NONNULL(1);
virDomainState
virDomainObjGetState(virDomainObjPtr obj, int *reason)
        ATTRIBUTE_NONNULL(1);

2923 2924 2925
virSecurityLabelDefPtr
virDomainDefGetSecurityLabelDef(virDomainDefPtr def, const char *model);

2926 2927 2928
virSecurityDeviceLabelDefPtr
virDomainChrDefGetSecurityLabelDef(virDomainChrDefPtr def, const char *model);

2929 2930
typedef const char* (*virEventActionToStringFunc)(int type);
typedef int (*virEventActionFromStringFunc)(const char *type);
2931

2932 2933 2934 2935 2936 2937 2938 2939 2940 2941
int virDomainMemoryInsert(virDomainDefPtr def, virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;
virDomainMemoryDefPtr virDomainMemoryRemove(virDomainDefPtr def, int idx)
    ATTRIBUTE_NONNULL(1);
int virDomainMemoryFindByDef(virDomainDefPtr def, virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;
int virDomainMemoryFindInactiveByDef(virDomainDefPtr def,
                                     virDomainMemoryDefPtr mem)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2) ATTRIBUTE_RETURN_CHECK;

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

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

3030
VIR_ENUM_DECL(virDomainSeclabel)
3031
VIR_ENUM_DECL(virDomainClockOffset)
3032
VIR_ENUM_DECL(virDomainClockBasis)
3033

3034
VIR_ENUM_DECL(virDomainTimerName)
3035
VIR_ENUM_DECL(virDomainTimerTrack)
3036 3037
VIR_ENUM_DECL(virDomainTimerTickpolicy)
VIR_ENUM_DECL(virDomainTimerMode)
O
Osier Yang 已提交
3038
VIR_ENUM_DECL(virDomainCpuPlacementMode)
3039

3040
VIR_ENUM_DECL(virDomainStartupPolicy)
3041

O
Osier Yang 已提交
3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075
# 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)

3076 3077 3078 3079 3080 3081
int virDomainObjListCollect(virDomainObjListPtr doms,
                            virConnectPtr conn,
                            virDomainObjPtr **vms,
                            size_t *nvms,
                            virDomainObjListACLFilter filter,
                            unsigned int flags);
3082 3083 3084
int virDomainObjListExport(virDomainObjListPtr doms,
                           virConnectPtr conn,
                           virDomainPtr **domains,
3085
                           virDomainObjListACLFilter filter,
3086
                           unsigned int flags);
3087 3088 3089 3090 3091 3092 3093 3094 3095
int virDomainObjListConvert(virDomainObjListPtr domlist,
                            virConnectPtr conn,
                            virDomainPtr *doms,
                            size_t ndoms,
                            virDomainObjPtr **vms,
                            size_t *nvms,
                            virDomainObjListACLFilter filter,
                            unsigned int flags,
                            bool skip_missing);
O
Osier Yang 已提交
3096

3097 3098 3099 3100 3101
int
virDomainDefMaybeAddController(virDomainDefPtr def,
                               int type,
                               int idx,
                               int model);
3102 3103 3104 3105
int
virDomainDefMaybeAddInput(virDomainDefPtr def,
                          int type,
                          int bus);
3106

3107 3108
char *virDomainDefGetDefaultEmulator(virDomainDefPtr def, virCapsPtr caps);

3109 3110
int virDomainDefFindDevice(virDomainDefPtr def,
                           const char *devAlias,
3111 3112
                           virDomainDeviceDefPtr dev,
                           bool reportError);
3113

3114
bool virDomainDiskSourceIsBlockType(virStorageSourcePtr src)
3115 3116
    ATTRIBUTE_NONNULL(1);

3117 3118
void virDomainChrSourceDefClear(virDomainChrSourceDefPtr def);

3119 3120 3121 3122 3123 3124 3125
char *virDomainObjGetMetadata(virDomainObjPtr vm,
                              int type,
                              const char *uri,
                              virCapsPtr caps,
                              virDomainXMLOptionPtr xmlopt,
                              unsigned int flags);

3126 3127 3128 3129 3130 3131 3132
int virDomainObjSetMetadata(virDomainObjPtr vm,
                            int type,
                            const char *metadata,
                            const char *key,
                            const char *uri,
                            virCapsPtr caps,
                            virDomainXMLOptionPtr xmlopt,
3133
                            const char *stateDir,
3134 3135 3136
                            const char *configDir,
                            unsigned int flags);

3137 3138 3139 3140 3141 3142 3143 3144
int
virDomainParseMemory(const char *xpath,
                     const char *units_xpath,
                     xmlXPathContextPtr ctxt,
                     unsigned long long *mem,
                     bool required,
                     bool capped);

3145 3146 3147
bool virDomainDefNeedsPlacementAdvice(virDomainDefPtr def)
    ATTRIBUTE_NONNULL(1);

3148 3149 3150
int virDomainDefCheckDuplicateDiskWWN(virDomainDefPtr def)
    ATTRIBUTE_NONNULL(1);

3151
#endif /* __DOMAIN_CONF_H */