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

#ifndef __DOMAIN_CONF_H
26
# define __DOMAIN_CONF_H
27

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

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

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

typedef struct _virDomainControllerDef virDomainControllerDef;
typedef virDomainControllerDef *virDomainControllerDefPtr;

typedef struct _virDomainLeaseDef virDomainLeaseDef;
typedef virDomainLeaseDef *virDomainLeaseDefPtr;

typedef struct _virDomainFSDef virDomainFSDef;
typedef virDomainFSDef *virDomainFSDefPtr;

typedef struct _virDomainNetDef virDomainNetDef;
typedef virDomainNetDef *virDomainNetDefPtr;

typedef struct _virDomainInputDef virDomainInputDef;
typedef virDomainInputDef *virDomainInputDefPtr;

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

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

typedef struct _virDomainVideoDef virDomainVideoDef;
typedef virDomainVideoDef *virDomainVideoDefPtr;

typedef struct _virDomainHostdevDef virDomainHostdevDef;
typedef virDomainHostdevDef *virDomainHostdevDefPtr;

typedef struct _virDomainWatchdogDef virDomainWatchdogDef;
typedef virDomainWatchdogDef *virDomainWatchdogDefPtr;

typedef struct _virDomainGraphicsDef virDomainGraphicsDef;
typedef virDomainGraphicsDef *virDomainGraphicsDefPtr;

typedef struct _virDomainHubDef virDomainHubDef;
typedef virDomainHubDef *virDomainHubDefPtr;

typedef struct _virDomainRedirdevDef virDomainRedirdevDef;
typedef virDomainRedirdevDef *virDomainRedirdevDefPtr;

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

typedef struct _virDomainRedirFilterDef virDomainRedirFilterDef;
typedef virDomainRedirFilterDef *virDomainRedirFilterDefPtr;

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

typedef struct _virDomainChrDef virDomainChrDef;
typedef virDomainChrDef *virDomainChrDefPtr;

typedef struct _virDomainMemballoonDef virDomainMemballoonDef;
typedef virDomainMemballoonDef *virDomainMemballoonDefPtr;

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

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

typedef struct _virDomainSnapshotObjList virDomainSnapshotObjList;
typedef virDomainSnapshotObjList *virDomainSnapshotObjListPtr;

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

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

typedef struct _virDomainIdMapDef virDomainIdMapDef;
typedef virDomainIdMapDef *virDomainIdMapDefPtr;

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

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

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

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

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

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

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

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

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

233
    VIR_DOMAIN_VIRT_LAST
234
} virDomainVirtType;
235

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

    VIR_DOMAIN_OSTYPE_LAST
} virDomainOSType;
VIR_ENUM_DECL(virDomainOS)


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

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

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

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

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

280

281
typedef enum {
282 283 284
    VIR_DOMAIN_HOSTDEV_MODE_SUBSYS,
    VIR_DOMAIN_HOSTDEV_MODE_CAPABILITIES,

285
    VIR_DOMAIN_HOSTDEV_MODE_LAST
286
} virDomainHostdevMode;
287

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

    VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_LAST
294
} virDomainHostdevSubsysType;
295

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

    VIR_DOMAIN_HOSTDEV_PCI_BACKEND_TYPE_LAST
304
} virDomainHostdevSubsysPCIBackendType;
305

306
VIR_ENUM_DECL(virDomainHostdevSubsysPCIBackend)
307

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

    VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_LAST,
} virDomainHostdevSCSIProtocolType;

VIR_ENUM_DECL(virDomainHostdevSubsysSCSIProtocol)

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

    unsigned vendor;
    unsigned product;
};

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

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

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

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

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

377

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

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

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


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

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

424

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

    VIR_DOMAIN_DISK_DEVICE_LAST
434
} virDomainDiskDevice;
435

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

    VIR_DOMAIN_DISK_BUS_LAST
448
} virDomainDiskBus;
449

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

    VIR_DOMAIN_DISK_CACHE_LAST
459
} virDomainDiskCache;
460

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

    VIR_DOMAIN_DISK_ERROR_POLICY_LAST
469
} virDomainDiskErrorPolicy;
470

M
MORITA Kazutaka 已提交
471

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

    VIR_DOMAIN_DISK_TRAY_LAST
477
} virDomainDiskTray;
478

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

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

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

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

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

    VIR_DOMAIN_STARTUP_POLICY_LAST
503
} virDomainStartupPolicy;
504

505

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

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

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

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

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

    VIR_DOMAIN_DISK_DETECT_ZEROES_LAST
} virDomainDiskDetectZeroes;

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

549

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

    VIR_DOMAIN_DISK_MIRROR_STATE_LAST
} virDomainDiskMirrorState;


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

564 565
    virObjectPtr privateData;

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

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

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

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

L
Lei Li 已提交
588 589
    virDomainBlockIoTuneInfo blkdeviotune;

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


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

    VIR_DOMAIN_CONTROLLER_TYPE_LAST
625
} virDomainControllerType;
626

627

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

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

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

    VIR_DOMAIN_CONTROLLER_PCI_MODEL_NAME_LAST
} virDomainControllerPCIModelName;

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

665
    VIR_DOMAIN_CONTROLLER_MODEL_SCSI_LAST
666
} virDomainControllerModelSCSI;
667

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

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

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

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

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

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

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

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

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


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

    VIR_DOMAIN_FS_TYPE_LAST
764
} virDomainFSType;
765

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

    VIR_DOMAIN_FS_DRIVER_TYPE_LAST
776
} virDomainFSDriverType;
777

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

    VIR_DOMAIN_FS_ACCESSMODE_LAST
785
} virDomainFSAccessMode;
786

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

    VIR_DOMAIN_FS_WRPOLICY_LAST
793
} virDomainFSWrpolicy;
794

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

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


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

830
    VIR_DOMAIN_NET_TYPE_LAST
831
} virDomainNetType;
832

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

839
    VIR_DOMAIN_NET_BACKEND_TYPE_LAST
840
} virDomainNetBackendType;
841

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

848
    VIR_DOMAIN_NET_VIRTIO_TX_MODE_LAST
849
} virDomainNetVirtioTxModeType;
850

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

        VIR_DOMAIN_NET_INTERFACE_LINK_STATE_LAST
858
} virDomainNetInterfaceLinkState;
859

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

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

E
Eric Blake 已提交
980 981 982 983
/* 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"

984 985 986 987 988 989 990 991 992 993
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)

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

1000
    VIR_DOMAIN_CHR_DEVICE_TYPE_LAST
1001
} virDomainChrDeviceType;
1002

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

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

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

1016
    VIR_DOMAIN_CHR_CHANNEL_TARGET_TYPE_LAST
1017
} virDomainChrChannelTargetType;
1018

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

1030
    VIR_DOMAIN_CHR_CONSOLE_TARGET_TYPE_LAST
1031
} virDomainChrConsoleTargetType;
1032

1033
typedef enum {
1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
    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,
1044
    VIR_DOMAIN_CHR_TYPE_SPICEVMC,
1045
    VIR_DOMAIN_CHR_TYPE_SPICEPORT,
1046
    VIR_DOMAIN_CHR_TYPE_NMDM,
1047

1048
    VIR_DOMAIN_CHR_TYPE_LAST
1049
} virDomainChrType;
1050

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

1057
    VIR_DOMAIN_CHR_TCP_PROTOCOL_LAST
1058
} virDomainChrTcpProtocol;
1059

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

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

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

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

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

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

1121 1122
    virDomainChrDeviceState state;

1123
    virDomainChrSourceDef source;
1124 1125

    virDomainDeviceInfo info;
1126 1127 1128

    size_t nseclabels;
    virSecurityDeviceLabelDefPtr *seclabels;
1129 1130
};

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

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

# 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 已提交
1156 1157 1158 1159 1160
struct _virDomainHubDef {
    int type;
    virDomainDeviceInfo info;
};

1161
typedef enum {
1162 1163 1164
    VIR_DOMAIN_TPM_MODEL_TIS,

    VIR_DOMAIN_TPM_MODEL_LAST
1165
} virDomainTPMModel;
1166

1167
typedef enum {
1168 1169 1170
    VIR_DOMAIN_TPM_TYPE_PASSTHROUGH,

    VIR_DOMAIN_TPM_TYPE_LAST
1171
} virDomainTPMBackendType;
1172 1173 1174 1175

# define VIR_DOMAIN_TPM_DEFAULT_DEVICE "/dev/tpm0"

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

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

1192
    VIR_DOMAIN_INPUT_TYPE_LAST
1193
} virDomainInputType;
1194

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

    VIR_DOMAIN_INPUT_BUS_LAST
1203
} virDomainInputBus;
1204 1205 1206 1207

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

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

    VIR_DOMAIN_SOUND_CODEC_TYPE_LAST
1219
} virDomainSoundCodecType;
1220

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

    VIR_DOMAIN_SOUND_MODEL_LAST
1231
} virDomainSoundModel;
1232

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

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

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

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

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

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

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

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

1272

1273
typedef enum {
1274 1275 1276 1277 1278
    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,
1279
    VIR_DOMAIN_VIDEO_TYPE_QXL,
1280
    VIR_DOMAIN_VIDEO_TYPE_PARALLELS, /* pseudo device for VNC in containers */
M
Marc-André Lureau 已提交
1281
    VIR_DOMAIN_VIDEO_TYPE_VIRTIO,
1282 1283

    VIR_DOMAIN_VIDEO_TYPE_LAST
1284
} virDomainVideoType;
1285 1286


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


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

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

1315
    VIR_DOMAIN_GRAPHICS_TYPE_LAST
1316
} virDomainGraphicsType;
1317

1318
typedef enum {
1319 1320 1321 1322 1323 1324
    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
1325
} virDomainGraphicsVNCSharePolicy;
1326

1327
typedef enum {
1328 1329 1330 1331 1332 1333
    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
1334
} virDomainGraphicsAuthConnectedType;
1335

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

1345
typedef enum {
1346 1347 1348 1349 1350 1351
    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 已提交
1352
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_SMARTCARD,
1353
    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_USBREDIR,
1354 1355

    VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST
1356
} virDomainGraphicsSpiceChannelName;
1357

1358
typedef enum {
1359 1360 1361 1362 1363
    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
1364
} virDomainGraphicsSpiceChannelMode;
1365

1366
typedef enum {
1367 1368 1369 1370 1371 1372 1373 1374 1375
    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
1376
} virDomainGraphicsSpiceImageCompression;
1377

1378
typedef enum {
1379 1380 1381 1382 1383 1384
    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
1385
} virDomainGraphicsSpiceJpegCompression;
1386

1387
typedef enum {
1388 1389 1390 1391 1392 1393
    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
1394
} virDomainGraphicsSpiceZlibCompression;
1395

1396
typedef enum {
P
Peng Zhou 已提交
1397 1398 1399 1400 1401
    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
1402
} virDomainGraphicsSpiceMouseMode;
P
Peng Zhou 已提交
1403

1404
typedef enum {
1405 1406 1407 1408 1409 1410
    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
1411
} virDomainGraphicsSpiceStreamingMode;
1412

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

1419
    VIR_DOMAIN_GRAPHICS_LISTEN_TYPE_LAST
1420
} virDomainGraphicsListenType;
1421

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

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

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

1439
struct _virDomainGraphicsDef {
M
Michal Privoznik 已提交
1440 1441 1442 1443 1444
    /* 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.
     */
1445
    virDomainGraphicsType type;
1446 1447 1448
    union {
        struct {
            int port;
1449
            bool portReserved;
M
Martin Kletzander 已提交
1450
            int websocket;
1451
            bool autoport;
1452
            char *keymap;
1453
            virDomainGraphicsAuthDef auth;
1454
            int sharePolicy;
1455 1456 1457 1458
        } vnc;
        struct {
            char *display;
            char *xauth;
1459
            bool fullscreen;
1460
        } sdl;
1461 1462
        struct {
            int port;
1463 1464 1465
            bool autoport;
            bool replaceUser;
            bool multiUser;
1466 1467 1468
        } rdp;
        struct {
            char *display;
1469
            bool fullscreen;
1470
        } desktop;
1471 1472 1473
        struct {
            int port;
            int tlsPort;
1474 1475
            bool portReserved;
            bool tlsPortReserved;
1476
            virDomainGraphicsSpiceMouseMode mousemode;
1477
            char *keymap;
1478
            virDomainGraphicsAuthDef auth;
1479
            bool autoport;
1480
            int channels[VIR_DOMAIN_GRAPHICS_SPICE_CHANNEL_LAST];
1481
            virDomainGraphicsSpiceChannelMode defaultMode;
1482 1483 1484 1485
            int image;
            int jpeg;
            int zlib;
            int playback;
1486
            int streaming;
1487 1488 1489
            virTristateBool copypaste;
            virTristateBool filetransfer;
            virTristateBool gl;
1490
        } spice;
1491
    } data;
1492 1493 1494 1495 1496
    /* 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;
1497 1498
};

1499
typedef enum {
1500 1501 1502
    VIR_DOMAIN_REDIRDEV_BUS_USB,

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

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

    union {
        virDomainChrSourceDef chr;
    } source;

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

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

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

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

    VIR_DOMAIN_MEMBALLOON_MODEL_LAST
};

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

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

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

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

    VIR_DOMAIN_SMBIOS_LAST
1569
} virDomainSmbiosMode;
1570

1571

1572
# define VIR_DOMAIN_MAX_BOOT_DEVS 4
1573

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

1580
    VIR_DOMAIN_BOOT_LAST
1581
} virDomainBootOrder;
1582

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

    VIR_DOMAIN_FEATURE_LAST
1599
} virDomainFeature;
1600

1601 1602
# define VIR_DOMAIN_HYPERV_VENDOR_ID_MAX 12

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

    VIR_DOMAIN_HYPERV_LAST
1615
} virDomainHyperv;
1616

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

    VIR_DOMAIN_KVM_LAST
} virDomainKVM;

1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672
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;

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

    VIR_DOMAIN_LIFECYCLE_LAST
1680
} virDomainLifecycleAction;
1681

1682
typedef enum {
1683 1684 1685 1686 1687 1688 1689 1690
    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
1691
} virDomainLifecycleCrashAction;
1692

1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704
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 已提交
1705 1706 1707
typedef struct _virDomainBIOSDef virDomainBIOSDef;
typedef virDomainBIOSDef *virDomainBIOSDefPtr;
struct _virDomainBIOSDef {
J
Ján Tomko 已提交
1708
    int useserial; /* enum virTristateBool */
1709 1710 1711
    /* reboot-timeout parameters */
    bool rt_set;
    int rt_delay;
M
Michal Privoznik 已提交
1712 1713
};

1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729
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 */
1730
    char *templt;   /* user override of path to master nvram */
1731 1732 1733 1734
};

void virDomainLoaderDefFree(virDomainLoaderDefPtr loader);

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

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

1763
typedef enum {
1764 1765 1766 1767 1768
    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 已提交
1769
    VIR_DOMAIN_TIMER_NAME_KVMCLOCK,
1770
    VIR_DOMAIN_TIMER_NAME_HYPERVCLOCK,
1771

1772
    VIR_DOMAIN_TIMER_NAME_LAST
1773
} virDomainTimerNameType;
1774

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

1780
    VIR_DOMAIN_TIMER_TRACK_LAST
1781
} virDomainTimerTrackType;
1782

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

1789
    VIR_DOMAIN_TIMER_TICKPOLICY_LAST
1790
} virDomainTimerTickpolicyType;
1791

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

1799
    VIR_DOMAIN_TIMER_MODE_LAST
1800
} virDomainTimerModeType;
1801

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

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

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

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

1824 1825 1826 1827 1828 1829 1830
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 */

1831 1832 1833 1834
    virDomainTimerCatchupDef catchup;

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

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

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

1847
    VIR_DOMAIN_CLOCK_OFFSET_LAST
1848
} virDomainClockOffsetType;
1849

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

1854
    VIR_DOMAIN_CLOCK_BASIS_LAST
1855
} virDomainClockBasis;
1856

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

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

            /* 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;
1877
        } variable;
1878 1879 1880 1881 1882

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

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

1888

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

1900
typedef enum {
1901 1902 1903
    VIR_DOMAIN_RNG_MODEL_VIRTIO,

    VIR_DOMAIN_RNG_MODEL_LAST
1904
} virDomainRNGModel;
1905

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

    VIR_DOMAIN_RNG_BACKEND_LAST
1912
} virDomainRNGBackend;
1913 1914 1915 1916

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

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

    virDomainDeviceInfo info;
};

1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942
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 */
1943
    int targetNode;
1944 1945 1946 1947 1948 1949 1950
    unsigned long long size; /* kibibytes */

    virDomainDeviceInfo info;
};

void virDomainMemoryDefFree(virDomainMemoryDefPtr def);

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

struct _virDomainIdMapDef {
    size_t nuidmap;
    virDomainIdMapEntryPtr uidmap;

    size_t ngidmap;
    virDomainIdMapEntryPtr gidmap;
};


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

    VIR_DOMAIN_PANIC_MODEL_LAST
} virDomainPanicModel;

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


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

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

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

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

1999 2000
# define VIR_DOMAIN_CPUMASK_LEN 1024

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

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

    virDomainThreadSchedParam sched;
2011 2012 2013 2014
};

void virDomainIOThreadIDDefFree(virDomainIOThreadIDDefPtr def);

2015

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

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

2031 2032 2033 2034 2035 2036

typedef struct _virDomainVcpuInfo virDomainVcpuInfo;
typedef virDomainVcpuInfo *virDomainVcpuInfoPtr;

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

    virDomainThreadSchedParam sched;
2040 2041
};

2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055
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 {
2056 2057 2058
    /* total memory size including memory modules in kibibytes, this field
     * should be accessed only via accessors */
    unsigned long long total_memory;
2059 2060
    unsigned long long cur_balloon; /* in kibibytes, capped at ulong thanks
                                       to virDomainGetInfo */
2061 2062 2063 2064

    virDomainHugePagePtr hugepages;
    size_t nhugepages;

2065 2066 2067 2068
    /* 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 */

2069 2070 2071
    bool nosharepages;
    bool locked;
    int dump_core; /* enum virTristateSwitch */
2072 2073 2074 2075
    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 */
2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086
};

typedef struct _virDomainPowerManagement virDomainPowerManagement;
typedef virDomainPowerManagement *virDomainPowerManagementPtr;

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

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

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

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

2117 2118
    virDomainBlkiotune blkio;
    virDomainMemtune mem;
2119

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

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

2129
    virDomainCputune cputune;
2130

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

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

2140 2141
    int onLockFailure; /* enum virDomainLockFailureAction */

2142
    virDomainPowerManagement pm;
2143

Q
Qiaowei Ren 已提交
2144 2145
    virDomainPerfDefPtr perf;

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

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

2162
    virDomainClockDef clock;
2163

2164
    size_t ngraphics;
2165
    virDomainGraphicsDefPtr *graphics;
2166

2167
    size_t ndisks;
2168 2169
    virDomainDiskDefPtr *disks;

2170
    size_t ncontrollers;
2171 2172
    virDomainControllerDefPtr *controllers;

2173
    size_t nfss;
2174 2175
    virDomainFSDefPtr *fss;

2176
    size_t nnets;
2177 2178
    virDomainNetDefPtr *nets;

2179
    size_t ninputs;
2180 2181
    virDomainInputDefPtr *inputs;

2182
    size_t nsounds;
2183 2184
    virDomainSoundDefPtr *sounds;

2185
    size_t nvideos;
2186 2187
    virDomainVideoDefPtr *videos;

2188
    size_t nhostdevs;
2189 2190
    virDomainHostdevDefPtr *hostdevs;

2191
    size_t nredirdevs;
2192 2193
    virDomainRedirdevDefPtr *redirdevs;

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

2197
    size_t nserials;
2198 2199
    virDomainChrDefPtr *serials;

2200
    size_t nparallels;
2201 2202
    virDomainChrDefPtr *parallels;

2203
    size_t nchannels;
2204 2205
    virDomainChrDefPtr *channels;

2206
    size_t nconsoles;
2207 2208
    virDomainChrDefPtr *consoles;

2209
    size_t nleases;
2210 2211
    virDomainLeaseDefPtr *leases;

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

2215 2216 2217
    size_t nseclabels;
    virSecurityLabelDefPtr *seclabels;

2218 2219 2220
    size_t nrngs;
    virDomainRNGDefPtr *rngs;

2221 2222 2223
    size_t nshmems;
    virDomainShmemDefPtr *shmems;

2224 2225 2226
    size_t nmems;
    virDomainMemoryDefPtr *mems;

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

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

    void *namespaceData;
    virDomainXMLNamespace ns;
2241

2242 2243
    virDomainKeyWrapDefPtr keywrap;

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

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

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

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

    VIR_DOMAIN_KEY_WRAP_CIPHER_NAME_LAST
} virDomainKeyWrapCipherName;

2269
typedef enum {
2270 2271 2272 2273 2274
    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 */
2275
    VIR_DOMAIN_TAINT_EXTERNAL_LAUNCH,  /* Externally launched guest domain */
2276
    VIR_DOMAIN_TAINT_HOST_CPU,         /* Host CPU passthrough in use */
2277
    VIR_DOMAIN_TAINT_HOOK,             /* Domain (possibly) changed via hook script */
2278
    VIR_DOMAIN_TAINT_CDROM_PASSTHROUGH,/* CDROM passthrough */
Y
Yuri Chornoivan 已提交
2279
    VIR_DOMAIN_TAINT_CUSTOM_DTB,       /* Custom device tree blob was specified */
2280 2281

    VIR_DOMAIN_TAINT_LAST
2282
} virDomainTaintFlags;
2283

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

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

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

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

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

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

2311 2312
    bool hasManagedSave;

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

    int taint;
2317 2318 2319

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

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

2325

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2530 2531
void virDomainDefFree(virDomainDefPtr vm);

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

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

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

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

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

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

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

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

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

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

2655
int virDomainDefAddImplicitDevices(virDomainDefPtr def);
2656

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

2663 2664
unsigned int virDomainDefFormatConvertXMLFlags(unsigned int flags);

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

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

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

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

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

2697 2698
void virDomainRNGDefFree(virDomainRNGDefPtr def);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2883 2884 2885 2886 2887 2888 2889 2890 2891 2892
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 已提交
2893 2894 2895 2896 2897 2898 2899
void
virDomainObjSetState(virDomainObjPtr obj, virDomainState state, int reason)
        ATTRIBUTE_NONNULL(1);
virDomainState
virDomainObjGetState(virDomainObjPtr obj, int *reason)
        ATTRIBUTE_NONNULL(1);

2900 2901 2902
virSecurityLabelDefPtr
virDomainDefGetSecurityLabelDef(virDomainDefPtr def, const char *model);

2903 2904 2905
virSecurityDeviceLabelDefPtr
virDomainChrDefGetSecurityLabelDef(virDomainChrDefPtr def, const char *model);

2906 2907
typedef const char* (*virEventActionToStringFunc)(int type);
typedef int (*virEventActionFromStringFunc)(const char *type);
2908

2909 2910 2911 2912 2913 2914 2915 2916 2917 2918
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;

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

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

3010
VIR_ENUM_DECL(virDomainSeclabel)
3011
VIR_ENUM_DECL(virDomainClockOffset)
3012
VIR_ENUM_DECL(virDomainClockBasis)
3013

3014
VIR_ENUM_DECL(virDomainTimerName)
3015
VIR_ENUM_DECL(virDomainTimerTrack)
3016 3017
VIR_ENUM_DECL(virDomainTimerTickpolicy)
VIR_ENUM_DECL(virDomainTimerMode)
O
Osier Yang 已提交
3018
VIR_ENUM_DECL(virDomainCpuPlacementMode)
3019

3020
VIR_ENUM_DECL(virDomainStartupPolicy)
3021

3022 3023
virDomainControllerDefPtr
virDomainDefAddController(virDomainDefPtr def, int type, int idx, int model);
3024 3025
int
virDomainDefAddUSBController(virDomainDefPtr def, int idx, int model);
3026 3027 3028 3029 3030
int
virDomainDefMaybeAddController(virDomainDefPtr def,
                               int type,
                               int idx,
                               int model);
3031 3032 3033 3034
int
virDomainDefMaybeAddInput(virDomainDefPtr def,
                          int type,
                          int bus);
3035

3036 3037
char *virDomainDefGetDefaultEmulator(virDomainDefPtr def, virCapsPtr caps);

3038 3039
int virDomainDefFindDevice(virDomainDefPtr def,
                           const char *devAlias,
3040 3041
                           virDomainDeviceDefPtr dev,
                           bool reportError);
3042

3043 3044
void virDomainChrSourceDefClear(virDomainChrSourceDefPtr def);

3045 3046 3047 3048 3049 3050 3051
char *virDomainObjGetMetadata(virDomainObjPtr vm,
                              int type,
                              const char *uri,
                              virCapsPtr caps,
                              virDomainXMLOptionPtr xmlopt,
                              unsigned int flags);

3052 3053 3054 3055 3056 3057 3058
int virDomainObjSetMetadata(virDomainObjPtr vm,
                            int type,
                            const char *metadata,
                            const char *key,
                            const char *uri,
                            virCapsPtr caps,
                            virDomainXMLOptionPtr xmlopt,
3059
                            const char *stateDir,
3060 3061 3062
                            const char *configDir,
                            unsigned int flags);

3063 3064 3065 3066 3067 3068 3069 3070
int
virDomainParseMemory(const char *xpath,
                     const char *units_xpath,
                     xmlXPathContextPtr ctxt,
                     unsigned long long *mem,
                     bool required,
                     bool capped);

3071 3072 3073
bool virDomainDefNeedsPlacementAdvice(virDomainDefPtr def)
    ATTRIBUTE_NONNULL(1);

3074 3075
int virDomainDiskDefCheckDuplicateInfo(const virDomainDiskDef *a,
                                       const virDomainDiskDef *b)
3076
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
3077

3078 3079 3080 3081 3082 3083 3084 3085
int virDomainDefGetVcpuPinInfoHelper(virDomainDefPtr def,
                                     int maplen,
                                     int ncpumaps,
                                     unsigned char *cpumaps,
                                     int hostcpus,
                                     virBitmapPtr autoCpuset)
    ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(4) ATTRIBUTE_RETURN_CHECK;

3086 3087
bool virDomainDefHasMemballoon(const virDomainDef *def) ATTRIBUTE_NONNULL(1);

M
Martin Kletzander 已提交
3088 3089
char *virDomainObjGetShortName(virDomainObjPtr vm);

3090 3091 3092 3093 3094
int
virDomainGetBlkioParametersAssignFromDef(virDomainDefPtr def,
                                         virTypedParameterPtr params,
                                         int *nparams,
                                         int maxparams);
3095
#endif /* __DOMAIN_CONF_H */