driver.h 77.1 KB
Newer Older
1
/*
2
 * driver.h: description of the set of interfaces provided by a
3
 *           entry point to the virtualization engine
E
Eric Blake 已提交
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
 *
 * Copyright (C) 2006-2013 Red Hat, Inc.
 *
 * 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
 * License along with this library.  If not, see
 * <http://www.gnu.org/licenses/>.
20 21 22
 */

#ifndef __VIR_DRIVER_H__
23
# define __VIR_DRIVER_H__
24

25
# include <unistd.h>
26

27
# include "internal.h"
28
# include "libvirt_internal.h"
M
Martin Kletzander 已提交
29
# include "viruri.h"
30 31 32 33
/*
 * List of registered drivers numbers
 */
typedef enum {
34 35 36
    VIR_DRV_XEN_UNIFIED = 1,
    VIR_DRV_TEST = 2,
    VIR_DRV_QEMU = 3,
37
    VIR_DRV_REMOTE = 4,
38
    VIR_DRV_OPENVZ = 5,
39 40
    VIR_DRV_LXC = 6,
    VIR_DRV_UML = 7,
41
    VIR_DRV_VBOX = 8,
D
Daniel Veillard 已提交
42
    VIR_DRV_ONE = 9,
43
    VIR_DRV_ESX = 10,
44
    VIR_DRV_PHYP = 11,
45
    VIR_DRV_XENAPI = 12,
J
Jim Fehlig 已提交
46 47
    VIR_DRV_VMWARE = 13,
    VIR_DRV_LIBXL = 14,
M
Matthias Bolte 已提交
48
    VIR_DRV_HYPERV = 15,
D
Dmitry Guryanov 已提交
49
    VIR_DRV_PARALLELS = 16,
R
Roman Bogorodskiy 已提交
50
    VIR_DRV_BHYVE = 17,
51 52 53
} virDrvNo;


54 55 56 57 58 59 60 61 62 63 64 65 66 67
/* Status codes returned from driver open call. */
typedef enum {
    /* Opened successfully. */
    VIR_DRV_OPEN_SUCCESS = 0,

    /* 'name' is not for us. */
    VIR_DRV_OPEN_DECLINED = -1,

    /* 'name' is for us, but there was some error.  virConnectOpen will
     * return an error rather than continue probing the other drivers.
     */
    VIR_DRV_OPEN_ERROR = -2,
} virDrvOpenStatus;

D
Daniel Veillard 已提交
68

69
/* Internal feature-detection macro.  Don't call drv->supports_feature
70 71
 * directly if you don't have to, because it may be NULL, use this macro
 * instead.
72
 *
73 74 75
 * Note that this treats a possible error returned by drv->supports_feature
 * the same as not supported. If you care about the error, call
 * drv->supports_feature directly.
76 77
 *
 * Returns:
78
 *   != 0  Feature is supported.
79 80
 *   0     Feature is not supported.
 */
81 82 83
# define VIR_DRV_SUPPORTS_FEATURE(drv,conn,feature)                     \
    ((drv)->connectSupportsFeature ?                                    \
        (drv)->connectSupportsFeature((conn), (feature)) > 0 : 0)
84

85
typedef virDrvOpenStatus
86 87 88 89
(*virDrvConnectOpen)(virConnectPtr conn,
                     virConnectAuthPtr auth,
                     unsigned int flags);

90
typedef int
91 92
(*virDrvConnectClose)(virConnectPtr conn);

93
typedef int
94 95 96
(*virDrvConnectSupportsFeature)(virConnectPtr conn,
                                int feature);

97
typedef const char *
98 99
(*virDrvConnectGetType)(virConnectPtr conn);

100
typedef int
101 102 103
(*virDrvConnectGetVersion)(virConnectPtr conn,
                           unsigned long *hvVer);

104
typedef int
105 106 107
(*virDrvConnectGetLibVersion)(virConnectPtr conn,
                              unsigned long *libVer);

108
typedef char *
109 110
(*virDrvConnectGetHostname)(virConnectPtr conn);

111
typedef char *
112 113
(*virDrvConnectGetURI)(virConnectPtr conn);

E
Eric Blake 已提交
114
typedef char *
115 116 117
(*virDrvConnectGetSysinfo)(virConnectPtr conn,
                           unsigned int flags);

118
typedef int
119 120 121
(*virDrvConnectGetMaxVcpus)(virConnectPtr conn,
                            const char *type);

122
typedef int
123 124 125
(*virDrvNodeGetInfo)(virConnectPtr conn,
                     virNodeInfoPtr info);

126
typedef char *
127 128
(*virDrvConnectGetCapabilities)(virConnectPtr conn);

129 130 131 132 133 134 135 136
typedef char *
(*virDrvConnectGetDomainCapabilities)(virConnectPtr conn,
                                      const char *emulatorbin,
                                      const char *arch,
                                      const char *machine,
                                      const char *virttype,
                                      unsigned int flags);

137
typedef int
138 139 140 141
(*virDrvConnectListDomains)(virConnectPtr conn,
                            int *ids,
                            int maxids);

142
typedef int
143 144
(*virDrvConnectNumOfDomains)(virConnectPtr conn);

145
typedef virDomainPtr
146 147 148
(*virDrvDomainCreateXML)(virConnectPtr conn,
                         const char *xmlDesc,
                         unsigned int flags);
149 150 151 152 153 154
typedef virDomainPtr
(*virDrvDomainCreateXMLWithFiles)(virConnectPtr conn,
                                  const char *xmlDesc,
                                  unsigned int nfiles,
                                  int *files,
                                  unsigned int flags);
155

156
typedef virDomainPtr
157 158 159
(*virDrvDomainLookupByID)(virConnectPtr conn,
                          int id);

160
typedef virDomainPtr
161 162 163
(*virDrvDomainLookupByUUID)(virConnectPtr conn,
                            const unsigned char *uuid);

164
typedef virDomainPtr
165 166 167
(*virDrvDomainLookupByName)(virConnectPtr conn,
                            const char *name);

168
typedef int
169 170
(*virDrvDomainSuspend)(virDomainPtr domain);

171
typedef int
172 173
(*virDrvDomainResume)(virDomainPtr domain);

174
typedef int
175 176 177 178 179
 (*virDrvDomainPMSuspendForDuration)(virDomainPtr,
                                     unsigned int target,
                                     unsigned long long duration,
                                     unsigned int flags);

180
typedef int
181 182 183
(*virDrvDomainPMWakeup)(virDomainPtr domain,
                        unsigned int flags);

184
typedef int
185 186
(*virDrvDomainShutdown)(virDomainPtr domain);

187
typedef int
188 189 190
(*virDrvDomainReboot)(virDomainPtr domain,
                      unsigned int flags);

X
Xu He Jie 已提交
191
typedef int
192 193 194
(*virDrvDomainReset)(virDomainPtr domain,
                     unsigned int flags);

195
typedef int
196 197
(*virDrvDomainDestroy)(virDomainPtr domain);

198
typedef int
199 200 201
(*virDrvDomainDestroyFlags)(virDomainPtr domain,
                            unsigned int flags);

202
typedef char *
203
(*virDrvDomainGetOSType)(virDomainPtr domain);
G
Guido Günther 已提交
204 205

typedef char *
206 207
(*virDrvDomainGetHostname)(virDomainPtr domain,
                           unsigned int flags);
G
Guido Günther 已提交
208

209
typedef unsigned long long
210 211
(*virDrvDomainGetMaxMemory)(virDomainPtr domain);

212
typedef int
213 214 215
(*virDrvDomainSetMaxMemory)(virDomainPtr domain,
                            unsigned long memory);

216
typedef int
217 218 219
(*virDrvDomainSetMemory)(virDomainPtr domain,
                         unsigned long memory);

220
typedef int
221 222 223 224
(*virDrvDomainSetMemoryFlags)(virDomainPtr domain,
                              unsigned long memory,
                              unsigned int flags);

225 226 227 228 229
typedef int
(*virDrvDomainSetMemoryStatsPeriod)(virDomainPtr domain,
                                    int period,
                                    unsigned int flags);

230
typedef int
231 232 233 234 235
(*virDrvDomainSetMemoryParameters)(virDomainPtr domain,
                                   virTypedParameterPtr params,
                                   int nparams,
                                   unsigned int flags);

236
typedef int
237 238 239 240 241
(*virDrvDomainGetMemoryParameters)(virDomainPtr domain,
                                   virTypedParameterPtr params,
                                   int *nparams,
                                   unsigned int flags);

242
typedef int
243 244 245 246 247
(*virDrvDomainSetNumaParameters)(virDomainPtr domain,
                                 virTypedParameterPtr params,
                                 int nparams,
                                 unsigned int flags);

248
typedef int
249 250 251 252
(*virDrvDomainGetNumaParameters)(virDomainPtr domain,
                                 virTypedParameterPtr params,
                                 int *nparams,
                                 unsigned int flags);
253

254
typedef int
255 256 257 258 259
(*virDrvDomainSetBlkioParameters)(virDomainPtr domain,
                                  virTypedParameterPtr params,
                                  int nparams,
                                  unsigned int flags);

260
typedef int
261 262 263 264 265
(*virDrvDomainGetBlkioParameters)(virDomainPtr domain,
                                  virTypedParameterPtr params,
                                  int *nparams,
                                  unsigned int flags);

266
typedef int
267 268 269
(*virDrvDomainGetInfo)(virDomainPtr domain,
                       virDomainInfoPtr info);

270
typedef int
271 272 273 274 275
(*virDrvDomainGetState)(virDomainPtr domain,
                        int *state,
                        int *reason,
                        unsigned int flags);

276
typedef int
277 278 279 280
(*virDrvDomainGetControlInfo)(virDomainPtr domain,
                              virDomainControlInfoPtr info,
                              unsigned int flags);

281
typedef int
282 283 284
(*virDrvDomainSave)(virDomainPtr domain,
                    const char *to);

285
typedef int
286 287 288 289 290
(*virDrvDomainSaveFlags)(virDomainPtr domain,
                         const char *to,
                         const char *dxml,
                         unsigned int flags);

291
typedef int
292 293 294
(*virDrvDomainRestore)(virConnectPtr conn,
                       const char *from);

295
typedef int
296 297 298 299 300
(*virDrvDomainRestoreFlags)(virConnectPtr conn,
                            const char *from,
                            const char *dxml,
                            unsigned int flags);

301
typedef char *
302 303 304 305
(*virDrvDomainSaveImageGetXMLDesc)(virConnectPtr conn,
                                   const char *file,
                                   unsigned int flags);

306
typedef int
307 308 309 310 311
(*virDrvDomainSaveImageDefineXML)(virConnectPtr conn,
                                  const char *file,
                                  const char *dxml,
                                  unsigned int flags);

D
Daniel Veillard 已提交
312
typedef int
313 314 315 316
(*virDrvDomainCoreDump)(virDomainPtr domain,
                        const char *to,
                        unsigned int flags);

317 318 319 320 321 322
typedef int
(*virDrvDomainCoreDumpWithFormat)(virDomainPtr domain,
                                  const char *to,
                                  unsigned int dumpformat,
                                  unsigned int flags);

323
typedef char *
324 325 326 327 328
(*virDrvDomainScreenshot)(virDomainPtr domain,
                          virStreamPtr stream,
                          unsigned int screen,
                          unsigned int flags);

329
typedef char *
330 331 332
(*virDrvDomainGetXMLDesc)(virDomainPtr dom,
                          unsigned int flags);

333
typedef char *
334 335 336 337 338
(*virDrvConnectDomainXMLFromNative)(virConnectPtr conn,
                                    const char *nativeFormat,
                                    const char *nativeConfig,
                                    unsigned int flags);

339
typedef char *
340 341 342 343 344
(*virDrvConnectDomainXMLToNative)(virConnectPtr conn,
                                  const char *nativeFormat,
                                  const char *domainXml,
                                  unsigned int flags);

345
typedef int
346 347 348 349
(*virDrvConnectListDefinedDomains)(virConnectPtr conn,
                                   char **const names,
                                   int maxnames);

350
typedef int
351 352 353 354
(*virDrvConnectListAllDomains)(virConnectPtr conn,
                               virDomainPtr **domains,
                               unsigned int flags);

355
typedef int
356 357
(*virDrvConnectNumOfDefinedDomains)(virConnectPtr conn);

358
typedef int
359 360
(*virDrvDomainCreate)(virDomainPtr dom);

361
typedef int
362 363
(*virDrvDomainCreateWithFlags)(virDomainPtr dom,
                               unsigned int flags);
364 365 366 367 368
typedef int
(*virDrvDomainCreateWithFiles)(virDomainPtr dom,
                               unsigned int nfiles,
                               int *files,
                               unsigned int flags);
369

370
typedef virDomainPtr
371 372 373
(*virDrvDomainDefineXML)(virConnectPtr conn,
                         const char *xml);

374
typedef int
375 376
(*virDrvDomainUndefine)(virDomainPtr dom);

O
Osier Yang 已提交
377
typedef int
378 379 380
(*virDrvDomainUndefineFlags)(virDomainPtr dom,
                             unsigned int flags);

381
typedef int
382 383 384
(*virDrvDomainSetVcpus)(virDomainPtr domain,
                        unsigned int nvcpus);

E
Eric Blake 已提交
385
typedef int
386 387 388 389
(*virDrvDomainSetVcpusFlags)(virDomainPtr domain,
                             unsigned int nvcpus,
                             unsigned int flags);

E
Eric Blake 已提交
390
typedef int
391 392 393
(*virDrvDomainGetVcpusFlags)(virDomainPtr domain,
                             unsigned int flags);

394
typedef int
395 396 397 398 399
(*virDrvDomainPinVcpu)(virDomainPtr domain,
                       unsigned int vcpu,
                       unsigned char *cpumap,
                       int maplen);

400
typedef int
401 402 403 404 405 406
(*virDrvDomainPinVcpuFlags)(virDomainPtr domain,
                            unsigned int vcpu,
                            unsigned char *cpumap,
                            int maplen,
                            unsigned int flags);

407
typedef int
408 409 410 411 412 413
(*virDrvDomainGetVcpuPinInfo)(virDomainPtr domain,
                              int ncpumaps,
                              unsigned char *cpumaps,
                              int maplen,
                              unsigned int flags);

414
typedef int
415 416 417 418
(*virDrvDomainPinEmulator)(virDomainPtr domain,
                           unsigned char *cpumap,
                           int maplen,
                           unsigned int flags);
419

420
typedef int
421 422 423 424 425
(*virDrvDomainGetEmulatorPinInfo)(virDomainPtr domain,
                                  unsigned char *cpumaps,
                                  int maplen,
                                  unsigned int flags);

426
typedef int
427 428 429 430 431
(*virDrvDomainGetVcpus)(virDomainPtr domain,
                        virVcpuInfoPtr info,
                        int maxinfo,
                        unsigned char *cpumaps,
                        int maplen);
432 433

typedef int
434 435 436 437 438 439
(*virDrvDomainGetMaxVcpus)(virDomainPtr domain);

typedef int
(*virDrvDomainGetSecurityLabel)(virDomainPtr domain,
                                virSecurityLabelPtr seclabel);

M
Marcelo Cerri 已提交
440
typedef int
441 442 443
(*virDrvDomainGetSecurityLabelList)(virDomainPtr domain,
                                    virSecurityLabelPtr* seclabels);

444
typedef int
445 446 447
(*virDrvNodeGetSecurityModel)(virConnectPtr conn,
                              virSecurityModelPtr secmodel);

448
typedef int
449 450 451
(*virDrvDomainAttachDevice)(virDomainPtr domain,
                            const char *xml);

J
Jim Fehlig 已提交
452
typedef int
453 454 455 456
(*virDrvDomainAttachDeviceFlags)(virDomainPtr domain,
                                 const char *xml,
                                 unsigned int flags);

457
typedef int
458 459 460
(*virDrvDomainDetachDevice)(virDomainPtr domain,
                            const char *xml);

J
Jim Fehlig 已提交
461
typedef int
462 463 464 465
(*virDrvDomainDetachDeviceFlags)(virDomainPtr domain,
                                 const char *xml,
                                 unsigned int flags);

466
typedef int
467 468 469 470
(*virDrvDomainUpdateDeviceFlags)(virDomainPtr domain,
                                 const char *xml,
                                 unsigned int flags);

471
typedef int
472 473 474
(*virDrvDomainGetAutostart)(virDomainPtr domain,
                            int *autostart);

475
typedef int
476 477
(*virDrvDomainSetAutostart)(virDomainPtr domain,
                            int autostart);
478

479
typedef char *
480 481
(*virDrvDomainGetSchedulerType)(virDomainPtr domain,
                                int *nparams);
482

483
typedef int
484 485 486
(*virDrvDomainGetSchedulerParameters)(virDomainPtr domain,
                                      virTypedParameterPtr params,
                                      int *nparams);
487

488
typedef int
489 490 491 492
(*virDrvDomainGetSchedulerParametersFlags)(virDomainPtr domain,
                                           virTypedParameterPtr params,
                                           int *nparams,
                                           unsigned int flags);
493

494
typedef int
495 496 497
(*virDrvDomainSetSchedulerParameters)(virDomainPtr domain,
                                      virTypedParameterPtr params,
                                      int nparams);
498

499
typedef int
500 501 502 503
(*virDrvDomainSetSchedulerParametersFlags)(virDomainPtr domain,
                                           virTypedParameterPtr params,
                                           int nparams,
                                           unsigned int flags);
504

505
typedef int
506 507 508 509
(*virDrvDomainBlockStats)(virDomainPtr domain,
                          const char *path,
                          struct _virDomainBlockStats *stats);

510
typedef int
511 512 513 514 515 516
(*virDrvDomainBlockStatsFlags)(virDomainPtr domain,
                               const char *path,
                               virTypedParameterPtr params,
                               int *nparams,
                               unsigned int flags);

517
typedef int
518 519 520 521
(*virDrvDomainInterfaceStats)(virDomainPtr domain,
                              const char *path,
                              struct _virDomainInterfaceStats *stats);

522
typedef int
523 524 525 526 527 528
(*virDrvDomainSetInterfaceParameters)(virDomainPtr dom,
                                      const char *device,
                                      virTypedParameterPtr params,
                                      int nparams,
                                      unsigned int flags);

529
typedef int
530 531 532 533 534
(*virDrvDomainGetInterfaceParameters)(virDomainPtr dom,
                                      const char *device,
                                      virTypedParameterPtr params,
                                      int *nparams,
                                      unsigned int flags);
535

536
typedef int
537 538 539 540
(*virDrvDomainMemoryStats)(virDomainPtr domain,
                           struct _virDomainMemoryStat *stats,
                           unsigned int nr_stats,
                           unsigned int flags);
541

R
Richard W.M. Jones 已提交
542
typedef int
543 544 545 546 547 548 549
(*virDrvDomainBlockPeek)(virDomainPtr domain,
                         const char *path,
                         unsigned long long offset,
                         size_t size,
                         void *buffer,
                         unsigned int flags);

O
Osier Yang 已提交
550
typedef int
551 552 553 554 555
(*virDrvDomainBlockResize)(virDomainPtr domain,
                           const char *path,
                           unsigned long long size,
                           unsigned int flags);

R
Richard W.M. Jones 已提交
556
typedef int
557 558 559 560 561 562
(*virDrvDomainMemoryPeek)(virDomainPtr domain,
                          unsigned long long start,
                          size_t size,
                          void *buffer,
                          unsigned int flags);

563
typedef int
564 565 566 567
(*virDrvDomainGetBlockInfo)(virDomainPtr domain,
                            const char *path,
                            virDomainBlockInfoPtr info,
                            unsigned int flags);
R
Richard W.M. Jones 已提交
568

569
typedef int
570 571 572 573 574 575 576 577
(*virDrvDomainMigratePrepare)(virConnectPtr dconn,
                              char **cookie,
                              int *cookielen,
                              const char *uri_in,
                              char **uri_out,
                              unsigned long flags,
                              const char *dname,
                              unsigned long resource);
578 579

typedef int
580 581 582 583 584 585 586
(*virDrvDomainMigratePerform)(virDomainPtr domain,
                              const char *cookie,
                              int cookielen,
                              const char *uri,
                              unsigned long flags,
                              const char *dname,
                              unsigned long resource);
587 588

typedef virDomainPtr
589 590 591 592 593 594
(*virDrvDomainMigrateFinish)(virConnectPtr dconn,
                             const char *dname,
                             const char *cookie,
                             int cookielen,
                             const char *uri,
                             unsigned long flags);
595

596
typedef int
597 598 599 600 601
(*virDrvNodeGetCPUStats)(virConnectPtr conn,
                         int cpuNum,
                         virNodeCPUStatsPtr params,
                         int *nparams,
                         unsigned int flags);
602

603
typedef int
604 605 606 607 608
(*virDrvNodeGetMemoryStats)(virConnectPtr conn,
                            int cellNum,
                            virNodeMemoryStatsPtr params,
                            int *nparams,
                            unsigned int flags);
609

610
typedef int
611 612 613 614
(*virDrvNodeGetCellsFreeMemory)(virConnectPtr conn,
                                unsigned long long *freeMems,
                                int startCell,
                                int maxCells);
615

616
typedef unsigned long long
617
(*virDrvNodeGetFreeMemory)(virConnectPtr conn);
618

619
typedef int
620 621 622 623
(*virDrvConnectDomainEventRegister)(virConnectPtr conn,
                                    virConnectDomainEventCallback cb,
                                    void *opaque,
                                    virFreeCallback freecb);
624 625

typedef int
626 627
(*virDrvConnectDomainEventDeregister)(virConnectPtr conn,
                                      virConnectDomainEventCallback cb);
628

D
Daniel Veillard 已提交
629
typedef int
630 631 632 633 634 635 636 637 638
(*virDrvDomainMigratePrepare2)(virConnectPtr dconn,
                               char **cookie,
                               int *cookielen,
                               const char *uri_in,
                               char **uri_out,
                               unsigned long flags,
                               const char *dname,
                               unsigned long resource,
                               const char *dom_xml);
D
Daniel Veillard 已提交
639 640

typedef virDomainPtr
641 642 643 644 645 646 647
(*virDrvDomainMigrateFinish2)(virConnectPtr dconn,
                              const char *dname,
                              const char *cookie,
                              int cookielen,
                              const char *uri,
                              unsigned long flags,
                              int retcode);
D
Daniel Veillard 已提交
648

649
typedef int
650 651
(*virDrvNodeDeviceDettach)(virNodeDevicePtr dev);

652 653 654 655 656
typedef int
(*virDrvNodeDeviceDetachFlags)(virNodeDevicePtr dev,
                               const char *driverName,
                               unsigned int flags);

657
typedef int
658 659
(*virDrvNodeDeviceReAttach)(virNodeDevicePtr dev);

660
typedef int
661
(*virDrvNodeDeviceReset)(virNodeDevicePtr dev);
662

C
Chris Lalancette 已提交
663
typedef int
664 665 666 667 668 669
(*virDrvDomainMigratePrepareTunnel)(virConnectPtr dconn,
                                    virStreamPtr st,
                                    unsigned long flags,
                                    const char *dname,
                                    unsigned long resource,
                                    const char *dom_xml);
C
Chris Lalancette 已提交
670

671
typedef int
672 673
(*virDrvConnectIsEncrypted)(virConnectPtr conn);

674
typedef int
675 676
(*virDrvConnectIsSecure)(virConnectPtr conn);

J
Jiri Denemark 已提交
677
typedef int
678 679
(*virDrvConnectIsAlive)(virConnectPtr conn);

680
typedef int
681 682
(*virDrvDomainIsActive)(virDomainPtr dom);

683
typedef int
684 685
(*virDrvDomainIsPersistent)(virDomainPtr dom);

O
Osier Yang 已提交
686
typedef int
687
(*virDrvDomainIsUpdated)(virDomainPtr dom);
688

J
Jiri Denemark 已提交
689
typedef int
690 691 692 693
(*virDrvConnectCompareCPU)(virConnectPtr conn,
                           const char *cpu,
                           unsigned int flags);

694
typedef char *
695 696 697 698
(*virDrvConnectBaselineCPU)(virConnectPtr conn,
                            const char **xmlCPUs,
                            unsigned int ncpus,
                            unsigned int flags);
J
Jiri Denemark 已提交
699

700 701 702 703 704 705
typedef int
(*virDrvConnectGetCPUModelNames)(virConnectPtr conn,
                                 const char *args,
                                 char ***models,
                                 unsigned int flags);

706
typedef int
707 708 709
(*virDrvDomainGetJobInfo)(virDomainPtr domain,
                          virDomainJobInfoPtr info);

710
typedef int
711 712 713 714 715
(*virDrvDomainGetJobStats)(virDomainPtr domain,
                           int *type,
                           virTypedParameterPtr *params,
                           int *nparams,
                           unsigned int flags);
716

717
typedef int
718
(*virDrvDomainAbortJob)(virDomainPtr domain);
719

720
typedef int
721 722 723 724
(*virDrvDomainMigrateSetMaxDowntime)(virDomainPtr domain,
                                     unsigned long long downtime,
                                     unsigned int flags);

725
typedef int
726 727 728 729
(*virDrvDomainMigrateGetCompressionCache)(virDomainPtr domain,
                                          unsigned long long *cacheSize,
                                          unsigned int flags);

730
typedef int
731 732 733
(*virDrvDomainMigrateSetCompressionCache)(virDomainPtr domain,
                                          unsigned long long cacheSize,
                                          unsigned int flags);
734

735
typedef int
736 737 738
(*virDrvDomainMigrateSetMaxSpeed)(virDomainPtr domain,
                                  unsigned long bandwidth,
                                  unsigned int flags);
739

740
typedef int
741 742 743
(*virDrvDomainMigrateGetMaxSpeed)(virDomainPtr domain,
                                  unsigned long *bandwidth,
                                  unsigned int flags);
744

745
typedef int
746 747 748 749 750 751
(*virDrvConnectDomainEventRegisterAny)(virConnectPtr conn,
                                       virDomainPtr dom,
                                       int eventID,
                                       virConnectDomainEventGenericCallback cb,
                                       void *opaque,
                                       virFreeCallback freecb);
752 753

typedef int
754 755
(*virDrvConnectDomainEventDeregisterAny)(virConnectPtr conn,
                                         int callbackID);
756

757
typedef int
758 759
(*virDrvDomainManagedSave)(virDomainPtr domain,
                           unsigned int flags);
760 761

typedef int
762 763
(*virDrvDomainHasManagedSaveImage)(virDomainPtr domain,
                                   unsigned int flags);
764 765

typedef int
766 767
(*virDrvDomainManagedSaveRemove)(virDomainPtr domain,
                                 unsigned int flags);
768

C
Chris Lalancette 已提交
769
typedef virDomainSnapshotPtr
770 771 772
(*virDrvDomainSnapshotCreateXML)(virDomainPtr domain,
                                 const char *xmlDesc,
                                 unsigned int flags);
C
Chris Lalancette 已提交
773 774

typedef char *
775 776
(*virDrvDomainSnapshotGetXMLDesc)(virDomainSnapshotPtr snapshot,
                                  unsigned int flags);
C
Chris Lalancette 已提交
777 778

typedef int
779 780
(*virDrvDomainSnapshotNum)(virDomainPtr domain,
                           unsigned int flags);
C
Chris Lalancette 已提交
781 782

typedef int
783 784 785 786
(*virDrvDomainSnapshotListNames)(virDomainPtr domain,
                                 char **names,
                                 int nameslen,
                                 unsigned int flags);
C
Chris Lalancette 已提交
787

788
typedef int
789 790 791
(*virDrvDomainListAllSnapshots)(virDomainPtr domain,
                                virDomainSnapshotPtr **snaps,
                                unsigned int flags);
792

793
typedef int
794 795
(*virDrvDomainSnapshotNumChildren)(virDomainSnapshotPtr snapshot,
                                   unsigned int flags);
796 797

typedef int
798 799 800 801
(*virDrvDomainSnapshotListChildrenNames)(virDomainSnapshotPtr snapshot,
                                         char **names,
                                         int nameslen,
                                         unsigned int flags);
802

803
typedef int
804 805 806
(*virDrvDomainSnapshotListAllChildren)(virDomainSnapshotPtr snapshot,
                                       virDomainSnapshotPtr **snaps,
                                       unsigned int flags);
807

C
Chris Lalancette 已提交
808
typedef virDomainSnapshotPtr
809 810 811
(*virDrvDomainSnapshotLookupByName)(virDomainPtr domain,
                                    const char *name,
                                    unsigned int flags);
C
Chris Lalancette 已提交
812 813

typedef int
814 815
(*virDrvDomainHasCurrentSnapshot)(virDomainPtr domain,
                                  unsigned int flags);
C
Chris Lalancette 已提交
816

817
typedef virDomainSnapshotPtr
818 819
(*virDrvDomainSnapshotGetParent)(virDomainSnapshotPtr snapshot,
                                 unsigned int flags);
820

C
Chris Lalancette 已提交
821
typedef virDomainSnapshotPtr
822 823
(*virDrvDomainSnapshotCurrent)(virDomainPtr domain,
                               unsigned int flags);
C
Chris Lalancette 已提交
824

E
Eric Blake 已提交
825
typedef int
826 827
(*virDrvDomainSnapshotIsCurrent)(virDomainSnapshotPtr snapshot,
                                 unsigned int flags);
E
Eric Blake 已提交
828 829

typedef int
830 831
(*virDrvDomainSnapshotHasMetadata)(virDomainSnapshotPtr snapshot,
                                   unsigned int flags);
E
Eric Blake 已提交
832

C
Chris Lalancette 已提交
833
typedef int
834 835
(*virDrvDomainRevertToSnapshot)(virDomainSnapshotPtr snapshot,
                                unsigned int flags);
C
Chris Lalancette 已提交
836 837

typedef int
838 839
(*virDrvDomainSnapshotDelete)(virDomainSnapshotPtr snapshot,
                              unsigned int flags);
C
Chris Lalancette 已提交
840

C
Chris Lalancette 已提交
841
typedef int
842 843 844 845 846
(*virDrvDomainQemuMonitorCommand)(virDomainPtr domain,
                                  const char *cmd,
                                  char **result,
                                  unsigned int flags);

847
typedef char *
848 849 850 851
(*virDrvDomainQemuAgentCommand)(virDomainPtr domain,
                                const char *cmd,
                                int timeout,
                                unsigned int flags);
C
Chris Lalancette 已提交
852

853
/* Choice of unsigned int rather than pid_t is intentional.  */
854
typedef virDomainPtr
855 856 857
(*virDrvDomainQemuAttach)(virConnectPtr conn,
                          unsigned int pid_value,
                          unsigned int flags);
858

859 860 861 862 863 864 865 866 867 868 869 870 871
typedef int
(*virDrvConnectDomainQemuMonitorEventRegister)(virConnectPtr conn,
                                               virDomainPtr dom,
                                               const char *event,
                                               virConnectDomainQemuMonitorEventCallback cb,
                                               void *opaque,
                                               virFreeCallback freecb,
                                               unsigned int flags);

typedef int
(*virDrvConnectDomainQemuMonitorEventDeregister)(virConnectPtr conn,
                                                 int callbackID);

872
typedef int
873 874 875 876 877
(*virDrvDomainOpenConsole)(virDomainPtr dom,
                           const char *dev_name,
                           virStreamPtr st,
                           unsigned int flags);

878
typedef int
879 880 881 882
(*virDrvDomainOpenChannel)(virDomainPtr dom,
                           const char *name,
                           virStreamPtr st,
                           unsigned int flags);
883

884
typedef int
885 886 887 888
(*virDrvDomainOpenGraphics)(virDomainPtr dom,
                            unsigned int idx,
                            int fd,
                            unsigned int flags);
C
Chris Lalancette 已提交
889

890
typedef int
891 892
(*virDrvDomainInjectNMI)(virDomainPtr dom,
                         unsigned int flags);
893

894
typedef int
895 896 897 898 899 900
(*virDrvDomainSendKey)(virDomainPtr dom,
                       unsigned int codeset,
                       unsigned int holdtime,
                       unsigned int *keycodes,
                       int nkeycodes,
                       unsigned int flags);
901

902
typedef int
903 904 905 906
(*virDrvDomainSendProcessSignal)(virDomainPtr dom,
                                 long long pid_value,
                                 unsigned int signum,
                                 unsigned int flags);
907

908
typedef char *
909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954
(*virDrvDomainMigrateBegin3)(virDomainPtr domain,
                             const char *xmlin,
                             char **cookieout,
                             int *cookieoutlen,
                             unsigned long flags,
                             const char *dname,
                             unsigned long resource);

typedef int
(*virDrvDomainMigratePrepare3)(virConnectPtr dconn,
                               const char *cookiein,
                               int cookieinlen,
                               char **cookieout,
                               int *cookieoutlen,
                               const char *uri_in,
                               char **uri_out,
                               unsigned long flags,
                               const char *dname,
                               unsigned long resource,
                               const char *dom_xml);

typedef int
(*virDrvDomainMigratePrepareTunnel3)(virConnectPtr dconn,
                                     virStreamPtr st,
                                     const char *cookiein,
                                     int cookieinlen,
                                     char **cookieout,
                                     int *cookieoutlen,
                                     unsigned long flags,
                                     const char *dname,
                                     unsigned long resource,
                                     const char *dom_xml);


typedef int
(*virDrvDomainMigratePerform3)(virDomainPtr dom,
                               const char *xmlin,
                               const char *cookiein,
                               int cookieinlen,
                               char **cookieout,
                               int *cookieoutlen,
                               const char *dconnuri,
                               const char *uri,
                               unsigned long flags,
                               const char *dname,
                               unsigned long resource);
955

956
typedef virDomainPtr
957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979
(*virDrvDomainMigrateFinish3)(virConnectPtr dconn,
                              const char *dname,
                              const char *cookiein,
                              int cookieinlen,
                              char **cookieout,
                              int *cookieoutlen,
                              const char *dconnuri,
                              const char *uri,
                              unsigned long flags,
                              int cancelled);

typedef int
(*virDrvDomainMigrateConfirm3)(virDomainPtr domain,
                               const char *cookiein,
                               int cookieinlen,
                               unsigned long flags,
                               int cancelled);

typedef int
(*virDrvNodeSuspendForDuration)(virConnectPtr conn,
                                unsigned int target,
                                unsigned long long duration,
                                unsigned int flags);
980 981

typedef int
982 983 984
(*virDrvDomainBlockJobAbort)(virDomainPtr dom,
                             const char *path,
                             unsigned int flags);
985 986

typedef int
987 988 989 990
(*virDrvDomainGetBlockJobInfo)(virDomainPtr dom,
                               const char *path,
                               virDomainBlockJobInfoPtr info,
                               unsigned int flags);
991 992

typedef int
993 994 995 996
(*virDrvDomainBlockJobSetSpeed)(virDomainPtr dom,
                                const char *path,
                                unsigned long bandwidth,
                                unsigned int flags);
997 998

typedef int
999 1000 1001 1002 1003
(*virDrvDomainBlockPull)(virDomainPtr dom,
                         const char *path,
                         unsigned long bandwidth,
                         unsigned int flags);

1004
typedef int
1005 1006 1007 1008 1009 1010
(*virDrvDomainBlockRebase)(virDomainPtr dom,
                           const char *path,
                           const char *base,
                           unsigned long bandwidth,
                           unsigned int flags);

E
Eric Blake 已提交
1011
typedef int
1012 1013 1014 1015 1016 1017
(*virDrvDomainBlockCommit)(virDomainPtr dom,
                           const char *disk,
                           const char *base,
                           const char *top,
                           unsigned long bandwidth,
                           unsigned int flags);
1018

J
Jiri Denemark 已提交
1019
typedef int
1020 1021 1022
(*virDrvConnectSetKeepAlive)(virConnectPtr conn,
                             int interval,
                             unsigned int count);
1023

1024
typedef int
1025 1026 1027 1028 1029 1030
(*virDrvDomainSetBlockIoTune)(virDomainPtr dom,
                              const char *disk,
                              virTypedParameterPtr params,
                              int nparams,
                              unsigned int flags);

1031
typedef int
1032 1033 1034 1035 1036 1037
(*virDrvDomainGetBlockIoTune)(virDomainPtr dom,
                              const char *disk,
                              virTypedParameterPtr params,
                              int *nparams,
                              unsigned int flags);

1038
typedef int
1039 1040
(*virDrvDomainShutdownFlags)(virDomainPtr domain,
                             unsigned int flags);
1041

1042
typedef int
1043 1044 1045 1046 1047 1048
(*virDrvDomainGetCPUStats)(virDomainPtr domain,
                           virTypedParameterPtr params,
                           unsigned int nparams,
                           int start_cpu,
                           unsigned int ncpus,
                           unsigned int flags);
1049

1050
typedef int
1051 1052 1053 1054
(*virDrvDomainGetDiskErrors)(virDomainPtr dom,
                             virDomainDiskErrorPtr errors,
                             unsigned int maxerrors,
                             unsigned int flags);
1055

1056
typedef int
1057 1058 1059 1060 1061 1062
(*virDrvDomainSetMetadata)(virDomainPtr dom,
                           int type,
                           const char *metadata,
                           const char *key,
                           const char *uri,
                           unsigned int flags);
1063 1064

typedef char *
1065 1066 1067 1068
(*virDrvDomainGetMetadata)(virDomainPtr dom,
                           int type,
                           const char *uri,
                           unsigned int flags);
1069

1070
typedef int
1071 1072 1073 1074
(*virDrvNodeGetMemoryParameters)(virConnectPtr conn,
                                 virTypedParameterPtr params,
                                 int *nparams,
                                 unsigned int flags);
1075 1076

typedef int
1077 1078 1079 1080
(*virDrvNodeSetMemoryParameters)(virConnectPtr conn,
                                 virTypedParameterPtr params,
                                 int nparams,
                                 unsigned int flags);
1081

1082
typedef int
1083 1084 1085 1086 1087
(*virDrvNodeGetCPUMap)(virConnectPtr conn,
                       unsigned char **cpumap,
                       unsigned int *online,
                       unsigned int flags);

1088
typedef int
1089 1090 1091 1092
(*virDrvDomainFSTrim)(virDomainPtr dom,
                      const char *mountPoint,
                      unsigned long long minimum,
                      unsigned int flags);
1093

1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105
typedef int
(*virDrvDomainGetTime)(virDomainPtr dom,
                       long long *seconds,
                       unsigned int *nseconds,
                       unsigned int flags);

typedef int
(*virDrvDomainSetTime)(virDomainPtr dom,
                       long long seconds,
                       unsigned int nseconds,
                       unsigned int flags);

1106
typedef int
1107 1108 1109 1110
(*virDrvDomainLxcOpenNamespace)(virDomainPtr dom,
                                int **fdlist,
                                unsigned int flags);

1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171
typedef char *
(*virDrvDomainMigrateBegin3Params)(virDomainPtr domain,
                                   virTypedParameterPtr params,
                                   int nparams,
                                   char **cookieout,
                                   int *cookieoutlen,
                                   unsigned int flags);

typedef int
(*virDrvDomainMigratePrepare3Params)(virConnectPtr dconn,
                                     virTypedParameterPtr params,
                                     int nparams,
                                     const char *cookiein,
                                     int cookieinlen,
                                     char **cookieout,
                                     int *cookieoutlen,
                                     char **uri_out,
                                     unsigned int flags);

typedef int
(*virDrvDomainMigratePrepareTunnel3Params)(virConnectPtr dconn,
                                           virStreamPtr st,
                                           virTypedParameterPtr params,
                                           int nparams,
                                           const char *cookiein,
                                           int cookieinlen,
                                           char **cookieout,
                                           int *cookieoutlen,
                                           unsigned int flags);

typedef int
(*virDrvDomainMigratePerform3Params)(virDomainPtr dom,
                                     const char *dconnuri,
                                     virTypedParameterPtr params,
                                     int nparams,
                                     const char *cookiein,
                                     int cookieinlen,
                                     char **cookieout,
                                     int *cookieoutlen,
                                     unsigned int flags);

typedef virDomainPtr
(*virDrvDomainMigrateFinish3Params)(virConnectPtr dconn,
                                    virTypedParameterPtr params,
                                    int nparams,
                                    const char *cookiein,
                                    int cookieinlen,
                                    char **cookieout,
                                    int *cookieoutlen,
                                    unsigned int flags,
                                    int cancelled);

typedef int
(*virDrvDomainMigrateConfirm3Params)(virDomainPtr domain,
                                     virTypedParameterPtr params,
                                     int nparams,
                                     const char *cookiein,
                                     int cookieinlen,
                                     unsigned int flags,
                                     int cancelled);

1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183
typedef int
(*virDrvDomainFSFreeze)(virDomainPtr dom,
                        const char **mountpoints,
                        unsigned int nmountpoints,
                        unsigned int flags);

typedef int
(*virDrvDomainFSThaw)(virDomainPtr dom,
                      const char **mountpoints,
                      unsigned int nmountpoints,
                      unsigned int flags);

M
Michal Privoznik 已提交
1184 1185 1186 1187 1188 1189 1190 1191 1192
typedef int
(*virDrvNodeGetFreePages)(virConnectPtr conn,
                          unsigned int npages,
                          unsigned int *pages,
                          int startCell,
                          unsigned int cellCount,
                          unsigned long long *counts,
                          unsigned int flags);

1193 1194
typedef int
(*virDrvNetworkGetDHCPLeases)(virNetworkPtr network,
1195
                              const char *mac,
1196 1197 1198
                              virNetworkDHCPLeasePtr **leases,
                              unsigned int flags);

1199 1200
typedef struct _virDriver virDriver;
typedef virDriver *virDriverPtr;
1201

1202 1203 1204 1205 1206
/**
 * _virDriver:
 *
 * Structure associated to a virtualization driver, defining the various
 * entry points for it.
1207 1208 1209 1210 1211 1212
 *
 * All drivers must support the following fields/methods:
 *  - no
 *  - name
 *  - open
 *  - close
1213 1214
 */
struct _virDriver {
1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231
    int no; /* the number virDrvNo */
    const char *name; /* the name of the driver */
    virDrvConnectOpen connectOpen;
    virDrvConnectClose connectClose;
    virDrvConnectSupportsFeature connectSupportsFeature;
    virDrvConnectGetType connectGetType;
    virDrvConnectGetVersion connectGetVersion;
    virDrvConnectGetLibVersion connectGetLibVersion;
    virDrvConnectGetHostname connectGetHostname;
    virDrvConnectGetSysinfo connectGetSysinfo;
    virDrvConnectGetMaxVcpus connectGetMaxVcpus;
    virDrvNodeGetInfo nodeGetInfo;
    virDrvConnectGetCapabilities connectGetCapabilities;
    virDrvConnectListDomains connectListDomains;
    virDrvConnectNumOfDomains connectNumOfDomains;
    virDrvConnectListAllDomains connectListAllDomains;
    virDrvDomainCreateXML domainCreateXML;
1232
    virDrvDomainCreateXMLWithFiles domainCreateXMLWithFiles;
1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251
    virDrvDomainLookupByID domainLookupByID;
    virDrvDomainLookupByUUID domainLookupByUUID;
    virDrvDomainLookupByName domainLookupByName;
    virDrvDomainSuspend domainSuspend;
    virDrvDomainResume domainResume;
    virDrvDomainPMSuspendForDuration domainPMSuspendForDuration;
    virDrvDomainPMWakeup domainPMWakeup;
    virDrvDomainShutdown domainShutdown;
    virDrvDomainShutdownFlags domainShutdownFlags;
    virDrvDomainReboot domainReboot;
    virDrvDomainReset domainReset;
    virDrvDomainDestroy domainDestroy;
    virDrvDomainDestroyFlags domainDestroyFlags;
    virDrvDomainGetOSType domainGetOSType;
    virDrvDomainGetHostname domainGetHostname;
    virDrvDomainGetMaxMemory domainGetMaxMemory;
    virDrvDomainSetMaxMemory domainSetMaxMemory;
    virDrvDomainSetMemory domainSetMemory;
    virDrvDomainSetMemoryFlags domainSetMemoryFlags;
1252
    virDrvDomainSetMemoryStatsPeriod domainSetMemoryStatsPeriod;
1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268
    virDrvDomainSetMemoryParameters domainSetMemoryParameters;
    virDrvDomainGetMemoryParameters domainGetMemoryParameters;
    virDrvDomainSetNumaParameters domainSetNumaParameters;
    virDrvDomainGetNumaParameters domainGetNumaParameters;
    virDrvDomainSetBlkioParameters domainSetBlkioParameters;
    virDrvDomainGetBlkioParameters domainGetBlkioParameters;
    virDrvDomainGetInfo domainGetInfo;
    virDrvDomainGetState domainGetState;
    virDrvDomainGetControlInfo domainGetControlInfo;
    virDrvDomainSave domainSave;
    virDrvDomainSaveFlags domainSaveFlags;
    virDrvDomainRestore domainRestore;
    virDrvDomainRestoreFlags domainRestoreFlags;
    virDrvDomainSaveImageGetXMLDesc domainSaveImageGetXMLDesc;
    virDrvDomainSaveImageDefineXML domainSaveImageDefineXML;
    virDrvDomainCoreDump domainCoreDump;
1269
    virDrvDomainCoreDumpWithFormat domainCoreDumpWithFormat;
1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290
    virDrvDomainScreenshot domainScreenshot;
    virDrvDomainSetVcpus domainSetVcpus;
    virDrvDomainSetVcpusFlags domainSetVcpusFlags;
    virDrvDomainGetVcpusFlags domainGetVcpusFlags;
    virDrvDomainPinVcpu domainPinVcpu;
    virDrvDomainPinVcpuFlags domainPinVcpuFlags;
    virDrvDomainGetVcpuPinInfo domainGetVcpuPinInfo;
    virDrvDomainPinEmulator domainPinEmulator;
    virDrvDomainGetEmulatorPinInfo domainGetEmulatorPinInfo;
    virDrvDomainGetVcpus domainGetVcpus;
    virDrvDomainGetMaxVcpus domainGetMaxVcpus;
    virDrvDomainGetSecurityLabel domainGetSecurityLabel;
    virDrvDomainGetSecurityLabelList domainGetSecurityLabelList;
    virDrvNodeGetSecurityModel nodeGetSecurityModel;
    virDrvDomainGetXMLDesc domainGetXMLDesc;
    virDrvConnectDomainXMLFromNative connectDomainXMLFromNative;
    virDrvConnectDomainXMLToNative connectDomainXMLToNative;
    virDrvConnectListDefinedDomains connectListDefinedDomains;
    virDrvConnectNumOfDefinedDomains connectNumOfDefinedDomains;
    virDrvDomainCreate domainCreate;
    virDrvDomainCreateWithFlags domainCreateWithFlags;
1291
    virDrvDomainCreateWithFiles domainCreateWithFiles;
1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303
    virDrvDomainDefineXML domainDefineXML;
    virDrvDomainUndefine domainUndefine;
    virDrvDomainUndefineFlags domainUndefineFlags;
    virDrvDomainAttachDevice domainAttachDevice;
    virDrvDomainAttachDeviceFlags domainAttachDeviceFlags;
    virDrvDomainDetachDevice domainDetachDevice;
    virDrvDomainDetachDeviceFlags domainDetachDeviceFlags;
    virDrvDomainUpdateDeviceFlags domainUpdateDeviceFlags;
    virDrvDomainGetAutostart domainGetAutostart;
    virDrvDomainSetAutostart domainSetAutostart;
    virDrvDomainGetSchedulerType domainGetSchedulerType;
    virDrvDomainGetSchedulerParameters domainGetSchedulerParameters;
1304
    virDrvDomainGetSchedulerParametersFlags domainGetSchedulerParametersFlags;
1305
    virDrvDomainSetSchedulerParameters domainSetSchedulerParameters;
1306
    virDrvDomainSetSchedulerParametersFlags domainSetSchedulerParametersFlags;
1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328
    virDrvDomainMigratePrepare domainMigratePrepare;
    virDrvDomainMigratePerform domainMigratePerform;
    virDrvDomainMigrateFinish domainMigrateFinish;
    virDrvDomainBlockResize domainBlockResize;
    virDrvDomainBlockStats domainBlockStats;
    virDrvDomainBlockStatsFlags domainBlockStatsFlags;
    virDrvDomainInterfaceStats domainInterfaceStats;
    virDrvDomainSetInterfaceParameters domainSetInterfaceParameters;
    virDrvDomainGetInterfaceParameters domainGetInterfaceParameters;
    virDrvDomainMemoryStats domainMemoryStats;
    virDrvDomainBlockPeek domainBlockPeek;
    virDrvDomainMemoryPeek domainMemoryPeek;
    virDrvDomainGetBlockInfo domainGetBlockInfo;
    virDrvNodeGetCPUStats nodeGetCPUStats;
    virDrvNodeGetMemoryStats nodeGetMemoryStats;
    virDrvNodeGetCellsFreeMemory nodeGetCellsFreeMemory;
    virDrvNodeGetFreeMemory nodeGetFreeMemory;
    virDrvConnectDomainEventRegister connectDomainEventRegister;
    virDrvConnectDomainEventDeregister connectDomainEventDeregister;
    virDrvDomainMigratePrepare2 domainMigratePrepare2;
    virDrvDomainMigrateFinish2 domainMigrateFinish2;
    virDrvNodeDeviceDettach nodeDeviceDettach;
1329
    virDrvNodeDeviceDetachFlags nodeDeviceDetachFlags;
1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343
    virDrvNodeDeviceReAttach nodeDeviceReAttach;
    virDrvNodeDeviceReset nodeDeviceReset;
    virDrvDomainMigratePrepareTunnel domainMigratePrepareTunnel;
    virDrvConnectIsEncrypted connectIsEncrypted;
    virDrvConnectIsSecure connectIsSecure;
    virDrvDomainIsActive domainIsActive;
    virDrvDomainIsPersistent domainIsPersistent;
    virDrvDomainIsUpdated domainIsUpdated;
    virDrvConnectCompareCPU connectCompareCPU;
    virDrvConnectBaselineCPU connectBaselineCPU;
    virDrvDomainGetJobInfo domainGetJobInfo;
    virDrvDomainGetJobStats domainGetJobStats;
    virDrvDomainAbortJob domainAbortJob;
    virDrvDomainMigrateSetMaxDowntime domainMigrateSetMaxDowntime;
1344 1345
    virDrvDomainMigrateGetCompressionCache domainMigrateGetCompressionCache;
    virDrvDomainMigrateSetCompressionCache domainMigrateSetCompressionCache;
1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358
    virDrvDomainMigrateGetMaxSpeed domainMigrateGetMaxSpeed;
    virDrvDomainMigrateSetMaxSpeed domainMigrateSetMaxSpeed;
    virDrvConnectDomainEventRegisterAny connectDomainEventRegisterAny;
    virDrvConnectDomainEventDeregisterAny connectDomainEventDeregisterAny;
    virDrvDomainManagedSave domainManagedSave;
    virDrvDomainHasManagedSaveImage domainHasManagedSaveImage;
    virDrvDomainManagedSaveRemove domainManagedSaveRemove;
    virDrvDomainSnapshotCreateXML domainSnapshotCreateXML;
    virDrvDomainSnapshotGetXMLDesc domainSnapshotGetXMLDesc;
    virDrvDomainSnapshotNum domainSnapshotNum;
    virDrvDomainSnapshotListNames domainSnapshotListNames;
    virDrvDomainListAllSnapshots domainListAllSnapshots;
    virDrvDomainSnapshotNumChildren domainSnapshotNumChildren;
1359
    virDrvDomainSnapshotListChildrenNames domainSnapshotListChildrenNames;
1360
    virDrvDomainSnapshotListAllChildren domainSnapshotListAllChildren;
1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371
    virDrvDomainSnapshotLookupByName domainSnapshotLookupByName;
    virDrvDomainHasCurrentSnapshot domainHasCurrentSnapshot;
    virDrvDomainSnapshotGetParent domainSnapshotGetParent;
    virDrvDomainSnapshotCurrent domainSnapshotCurrent;
    virDrvDomainSnapshotIsCurrent domainSnapshotIsCurrent;
    virDrvDomainSnapshotHasMetadata domainSnapshotHasMetadata;
    virDrvDomainRevertToSnapshot domainRevertToSnapshot;
    virDrvDomainSnapshotDelete domainSnapshotDelete;
    virDrvDomainQemuMonitorCommand domainQemuMonitorCommand;
    virDrvDomainQemuAttach domainQemuAttach;
    virDrvDomainQemuAgentCommand domainQemuAgentCommand;
1372 1373
    virDrvConnectDomainQemuMonitorEventRegister connectDomainQemuMonitorEventRegister;
    virDrvConnectDomainQemuMonitorEventDeregister connectDomainQemuMonitorEventDeregister;
1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405
    virDrvDomainOpenConsole domainOpenConsole;
    virDrvDomainOpenChannel domainOpenChannel;
    virDrvDomainOpenGraphics domainOpenGraphics;
    virDrvDomainInjectNMI domainInjectNMI;
    virDrvDomainMigrateBegin3 domainMigrateBegin3;
    virDrvDomainMigratePrepare3 domainMigratePrepare3;
    virDrvDomainMigratePrepareTunnel3 domainMigratePrepareTunnel3;
    virDrvDomainMigratePerform3 domainMigratePerform3;
    virDrvDomainMigrateFinish3 domainMigrateFinish3;
    virDrvDomainMigrateConfirm3 domainMigrateConfirm3;
    virDrvDomainSendKey domainSendKey;
    virDrvDomainBlockJobAbort domainBlockJobAbort;
    virDrvDomainGetBlockJobInfo domainGetBlockJobInfo;
    virDrvDomainBlockJobSetSpeed domainBlockJobSetSpeed;
    virDrvDomainBlockPull domainBlockPull;
    virDrvDomainBlockRebase domainBlockRebase;
    virDrvDomainBlockCommit domainBlockCommit;
    virDrvConnectSetKeepAlive connectSetKeepAlive;
    virDrvConnectIsAlive connectIsAlive;
    virDrvNodeSuspendForDuration nodeSuspendForDuration;
    virDrvDomainSetBlockIoTune domainSetBlockIoTune;
    virDrvDomainGetBlockIoTune domainGetBlockIoTune;
    virDrvDomainGetCPUStats domainGetCPUStats;
    virDrvDomainGetDiskErrors domainGetDiskErrors;
    virDrvDomainSetMetadata domainSetMetadata;
    virDrvDomainGetMetadata domainGetMetadata;
    virDrvNodeGetMemoryParameters nodeGetMemoryParameters;
    virDrvNodeSetMemoryParameters nodeSetMemoryParameters;
    virDrvNodeGetCPUMap nodeGetCPUMap;
    virDrvDomainFSTrim domainFSTrim;
    virDrvDomainSendProcessSignal domainSendProcessSignal;
    virDrvDomainLxcOpenNamespace domainLxcOpenNamespace;
1406 1407 1408 1409 1410 1411
    virDrvDomainMigrateBegin3Params domainMigrateBegin3Params;
    virDrvDomainMigratePrepare3Params domainMigratePrepare3Params;
    virDrvDomainMigratePrepareTunnel3Params domainMigratePrepareTunnel3Params;
    virDrvDomainMigratePerform3Params domainMigratePerform3Params;
    virDrvDomainMigrateFinish3Params domainMigrateFinish3Params;
    virDrvDomainMigrateConfirm3Params domainMigrateConfirm3Params;
1412
    virDrvConnectGetCPUModelNames connectGetCPUModelNames;
1413 1414
    virDrvDomainFSFreeze domainFSFreeze;
    virDrvDomainFSThaw domainFSThaw;
1415 1416
    virDrvDomainGetTime domainGetTime;
    virDrvDomainSetTime domainSetTime;
M
Michal Privoznik 已提交
1417
    virDrvNodeGetFreePages nodeGetFreePages;
1418
    virDrvConnectGetDomainCapabilities connectGetDomainCapabilities;
1419 1420
};

1421 1422 1423 1424

typedef virDrvConnectOpen virDrvNetworkOpen;
typedef virDrvConnectClose virDrvNetworkClose;

1425
typedef int
1426 1427
(*virDrvConnectNumOfNetworks)(virConnectPtr conn);

1428
typedef int
1429 1430 1431 1432
(*virDrvConnectListNetworks)(virConnectPtr conn,
                             char **const names,
                             int maxnames);

1433
typedef int
1434 1435
(*virDrvConnectNumOfDefinedNetworks)(virConnectPtr conn);

1436
typedef int
1437 1438 1439 1440
(*virDrvConnectListDefinedNetworks)(virConnectPtr conn,
                                    char **const names,
                                    int maxnames);

1441
typedef int
1442 1443 1444 1445
(*virDrvConnectListAllNetworks)(virConnectPtr conn,
                                virNetworkPtr **nets,
                                unsigned int flags);

1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457
typedef int
(*virDrvConnectNetworkEventRegisterAny)(virConnectPtr conn,
                                        virNetworkPtr dom,
                                        int eventID,
                                        virConnectNetworkEventGenericCallback cb,
                                        void *opaque,
                                        virFreeCallback freecb);

typedef int
(*virDrvConnectNetworkEventDeregisterAny)(virConnectPtr conn,
                                          int callbackID);

1458
typedef virNetworkPtr
1459 1460 1461
(*virDrvNetworkLookupByUUID)(virConnectPtr conn,
                             const unsigned char *uuid);

1462
typedef virNetworkPtr
1463 1464 1465
(*virDrvNetworkLookupByName)(virConnectPtr conn,
                             const char *name);

1466
typedef virNetworkPtr
1467 1468 1469
(*virDrvNetworkCreateXML)(virConnectPtr conn,
                          const char *xmlDesc);

1470
typedef virNetworkPtr
1471 1472 1473
(*virDrvNetworkDefineXML)(virConnectPtr conn,
                          const char *xml);

1474
typedef int
1475 1476
(*virDrvNetworkUndefine)(virNetworkPtr network);

1477
typedef int
1478 1479 1480 1481 1482 1483 1484
(*virDrvNetworkUpdate)(virNetworkPtr network,
                       unsigned int command, /* virNetworkUpdateCommand */
                       unsigned int section, /* virNetworkUpdateSection */
                       int parentIndex,
                       const char *xml,
                       unsigned int flags);

1485
typedef int
1486 1487
(*virDrvNetworkCreate)(virNetworkPtr network);

1488
typedef int
1489 1490
(*virDrvNetworkDestroy)(virNetworkPtr network);

1491
typedef char *
1492 1493 1494
(*virDrvNetworkGetXMLDesc)(virNetworkPtr network,
                           unsigned int flags);

1495
typedef char *
1496 1497
(*virDrvNetworkGetBridgeName)(virNetworkPtr network);

1498
typedef int
1499 1500 1501
(*virDrvNetworkGetAutostart)(virNetworkPtr network,
                             int *autostart);

1502
typedef int
1503 1504
(*virDrvNetworkSetAutostart)(virNetworkPtr network,
                             int autostart);
1505

1506
typedef int
1507 1508
(*virDrvNetworkIsActive)(virNetworkPtr net);

1509
typedef int
1510
(*virDrvNetworkIsPersistent)(virNetworkPtr net);
1511 1512


1513 1514 1515 1516 1517 1518 1519 1520 1521

typedef struct _virNetworkDriver virNetworkDriver;
typedef virNetworkDriver *virNetworkDriverPtr;

/**
 * _virNetworkDriver:
 *
 * Structure associated to a network virtualization driver, defining the various
 * entry points for it.
1522 1523 1524 1525
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
1526 1527
 */
struct _virNetworkDriver {
1528
    const char * name; /* the name of the driver */
1529 1530
    virDrvNetworkOpen networkOpen;
    virDrvNetworkClose networkClose;
1531 1532 1533 1534 1535
    virDrvConnectNumOfNetworks connectNumOfNetworks;
    virDrvConnectListNetworks connectListNetworks;
    virDrvConnectNumOfDefinedNetworks connectNumOfDefinedNetworks;
    virDrvConnectListDefinedNetworks connectListDefinedNetworks;
    virDrvConnectListAllNetworks connectListAllNetworks;
1536 1537
    virDrvConnectNetworkEventRegisterAny connectNetworkEventRegisterAny;
    virDrvConnectNetworkEventDeregisterAny connectNetworkEventDeregisterAny;
1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551
    virDrvNetworkLookupByUUID networkLookupByUUID;
    virDrvNetworkLookupByName networkLookupByName;
    virDrvNetworkCreateXML networkCreateXML;
    virDrvNetworkDefineXML networkDefineXML;
    virDrvNetworkUndefine networkUndefine;
    virDrvNetworkUpdate networkUpdate;
    virDrvNetworkCreate networkCreate;
    virDrvNetworkDestroy networkDestroy;
    virDrvNetworkGetXMLDesc networkGetXMLDesc;
    virDrvNetworkGetBridgeName networkGetBridgeName;
    virDrvNetworkGetAutostart networkGetAutostart;
    virDrvNetworkSetAutostart networkSetAutostart;
    virDrvNetworkIsActive networkIsActive;
    virDrvNetworkIsPersistent networkIsPersistent;
1552
    virDrvNetworkGetDHCPLeases networkGetDHCPLeases;
1553 1554
};

1555

1556 1557 1558
typedef virDrvConnectOpen virDrvInterfaceOpen;
typedef virDrvConnectClose virDrvInterfaceClose;

D
Daniel Veillard 已提交
1559
typedef int
1560 1561
(*virDrvConnectNumOfInterfaces)(virConnectPtr conn);

D
Daniel Veillard 已提交
1562
typedef int
1563 1564 1565 1566
(*virDrvConnectListInterfaces)(virConnectPtr conn,
                               char **const names,
                               int maxnames);

1567
typedef int
1568 1569
(*virDrvConnectNumOfDefinedInterfaces)(virConnectPtr conn);

1570
typedef int
1571 1572 1573 1574
(*virDrvConnectListDefinedInterfaces)(virConnectPtr conn,
                                      char **const names,
                                      int maxnames);

1575
typedef int
1576 1577 1578 1579
(*virDrvConnectListAllInterfaces)(virConnectPtr conn,
                                  virInterfacePtr **ifaces,
                                  unsigned int flags);

D
Daniel Veillard 已提交
1580
typedef virInterfacePtr
1581 1582 1583
(*virDrvInterfaceLookupByName)(virConnectPtr conn,
                               const char *name);

D
Daniel Veillard 已提交
1584
typedef virInterfacePtr
1585 1586
(*virDrvInterfaceLookupByMACString)(virConnectPtr conn,
                                    const char *mac);
D
Daniel Veillard 已提交
1587 1588

typedef char *
1589 1590
(*virDrvInterfaceGetXMLDesc)(virInterfacePtr iface,
                             unsigned int flags);
D
Daniel Veillard 已提交
1591 1592

typedef virInterfacePtr
1593 1594 1595 1596
(*virDrvInterfaceDefineXML)(virConnectPtr conn,
                            const char *xmlDesc,
                            unsigned int flags);

D
Daniel Veillard 已提交
1597
typedef int
1598 1599
(*virDrvInterfaceUndefine)(virInterfacePtr iface);

D
Daniel Veillard 已提交
1600
typedef int
1601 1602 1603
(*virDrvInterfaceCreate)(virInterfacePtr iface,
                         unsigned int flags);

D
Daniel Veillard 已提交
1604
typedef int
1605 1606
(*virDrvInterfaceDestroy)(virInterfacePtr iface,
                          unsigned int flags);
D
Daniel Veillard 已提交
1607

1608
typedef int
1609
(*virDrvInterfaceIsActive)(virInterfacePtr iface);
1610

1611
typedef int
1612 1613 1614
(*virDrvInterfaceChangeBegin)(virConnectPtr conn,
                              unsigned int flags);

1615
typedef int
1616 1617 1618
(*virDrvInterfaceChangeCommit)(virConnectPtr conn,
                               unsigned int flags);

1619
typedef int
1620 1621
(*virDrvInterfaceChangeRollback)(virConnectPtr conn,
                                 unsigned int flags);
1622

D
Daniel Veillard 已提交
1623 1624 1625 1626 1627 1628
typedef struct _virInterfaceDriver virInterfaceDriver;
typedef virInterfaceDriver *virInterfaceDriverPtr;

/**
 * _virInterfaceDriver:
 *
1629
 * Structure associated to a network interface driver, defining the various
D
Daniel Veillard 已提交
1630 1631 1632 1633 1634 1635 1636
 * entry points for it.
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
 */
struct _virInterfaceDriver {
1637
    const char *name; /* the name of the driver */
1638 1639
    virDrvInterfaceOpen interfaceOpen;
    virDrvInterfaceClose interfaceClose;
1640 1641 1642 1643 1644 1645
    virDrvConnectNumOfInterfaces connectNumOfInterfaces;
    virDrvConnectListInterfaces connectListInterfaces;
    virDrvConnectNumOfDefinedInterfaces connectNumOfDefinedInterfaces;
    virDrvConnectListDefinedInterfaces connectListDefinedInterfaces;
    virDrvConnectListAllInterfaces connectListAllInterfaces;
    virDrvInterfaceLookupByName interfaceLookupByName;
D
Daniel Veillard 已提交
1646
    virDrvInterfaceLookupByMACString interfaceLookupByMACString;
1647 1648 1649 1650 1651 1652 1653 1654 1655
    virDrvInterfaceGetXMLDesc interfaceGetXMLDesc;
    virDrvInterfaceDefineXML interfaceDefineXML;
    virDrvInterfaceUndefine interfaceUndefine;
    virDrvInterfaceCreate interfaceCreate;
    virDrvInterfaceDestroy interfaceDestroy;
    virDrvInterfaceIsActive interfaceIsActive;
    virDrvInterfaceChangeBegin interfaceChangeBegin;
    virDrvInterfaceChangeCommit interfaceChangeCommit;
    virDrvInterfaceChangeRollback interfaceChangeRollback;
D
Daniel Veillard 已提交
1656 1657
};

1658

1659 1660 1661 1662
typedef virDrvConnectOpen virDrvStorageOpen;
typedef virDrvConnectClose virDrvStorageClose;


1663
typedef int
1664 1665
(*virDrvConnectNumOfStoragePools)(virConnectPtr conn);

1666
typedef int
1667 1668 1669 1670
(*virDrvConnectListStoragePools)(virConnectPtr conn,
                                 char **const names,
                                 int maxnames);

1671
typedef int
1672 1673
(*virDrvConnectNumOfDefinedStoragePools)(virConnectPtr conn);

1674
typedef int
1675 1676 1677 1678
(*virDrvConnectListDefinedStoragePools)(virConnectPtr conn,
                                        char **const names,
                                        int maxnames);

1679
typedef int
1680 1681 1682 1683
(*virDrvConnectListAllStoragePools)(virConnectPtr conn,
                                    virStoragePoolPtr **pools,
                                    unsigned int flags);

1684
typedef char *
1685 1686 1687 1688 1689
(*virDrvConnectFindStoragePoolSources)(virConnectPtr conn,
                                       const char *type,
                                       const char *srcSpec,
                                       unsigned int flags);

1690
typedef virStoragePoolPtr
1691 1692 1693
(*virDrvStoragePoolLookupByName)(virConnectPtr conn,
                                 const char *name);

1694
typedef virStoragePoolPtr
1695 1696 1697
(*virDrvStoragePoolLookupByUUID)(virConnectPtr conn,
                                 const unsigned char *uuid);

1698
typedef virStoragePoolPtr
1699 1700
(*virDrvStoragePoolLookupByVolume)(virStorageVolPtr vol);

1701
typedef virStoragePoolPtr
1702 1703 1704 1705
(*virDrvStoragePoolCreateXML)(virConnectPtr conn,
                              const char *xmlDesc,
                              unsigned int flags);

1706
typedef virStoragePoolPtr
1707 1708 1709 1710
(*virDrvStoragePoolDefineXML)(virConnectPtr conn,
                              const char *xmlDesc,
                              unsigned int flags);

1711
typedef int
1712 1713
(*virDrvStoragePoolUndefine)(virStoragePoolPtr pool);

1714
typedef int
1715 1716 1717
(*virDrvStoragePoolBuild)(virStoragePoolPtr pool,
                          unsigned int flags);

1718
typedef int
1719 1720 1721
(*virDrvStoragePoolCreate)(virStoragePoolPtr pool,
                           unsigned int flags);

1722
typedef int
1723 1724
(*virDrvStoragePoolDestroy)(virStoragePoolPtr pool);

1725
typedef int
1726 1727 1728
(*virDrvStoragePoolDelete)(virStoragePoolPtr pool,
                           unsigned int flags);

1729
typedef int
1730 1731 1732
(*virDrvStoragePoolRefresh)(virStoragePoolPtr pool,
                            unsigned int flags);

1733
typedef int
1734 1735 1736
(*virDrvStoragePoolGetInfo)(virStoragePoolPtr vol,
                            virStoragePoolInfoPtr info);

1737
typedef char *
1738 1739 1740
(*virDrvStoragePoolGetXMLDesc)(virStoragePoolPtr pool,
                               unsigned int flags);

1741
typedef int
1742 1743 1744
(*virDrvStoragePoolGetAutostart)(virStoragePoolPtr pool,
                                 int *autostart);

1745
typedef int
1746 1747 1748
(*virDrvStoragePoolSetAutostart)(virStoragePoolPtr pool,
                                 int autostart);

1749
typedef int
1750 1751
(*virDrvStoragePoolNumOfVolumes)(virStoragePoolPtr pool);

1752
typedef int
1753 1754 1755 1756
(*virDrvStoragePoolListVolumes)(virStoragePoolPtr pool,
                                char **const names,
                                int maxnames);

1757
typedef int
1758 1759 1760
(*virDrvStoragePoolListAllVolumes)(virStoragePoolPtr pool,
                                   virStorageVolPtr **vols,
                                   unsigned int flags);
1761 1762

typedef virStorageVolPtr
1763 1764 1765
(*virDrvStorageVolLookupByName)(virStoragePoolPtr pool,
                                const char *name);

1766
typedef virStorageVolPtr
1767 1768
(*virDrvStorageVolLookupByKey)(virConnectPtr pool,
                               const char *key);
1769

1770 1771 1772
typedef virStorageVolPtr
(*virDrvStorageVolLookupByPath)(virConnectPtr pool,
                                const char *path);
1773 1774

typedef virStorageVolPtr
1775 1776 1777 1778
(*virDrvStorageVolCreateXML)(virStoragePoolPtr pool,
                             const char *xmldesc,
                             unsigned int flags);

1779
typedef int
1780 1781
(*virDrvStorageVolDelete)(virStorageVolPtr vol,
                          unsigned int flags);
1782

1783
typedef int
1784 1785 1786
(*virDrvStorageVolWipe)(virStorageVolPtr vol,
                        unsigned int flags);

1787
typedef int
1788 1789 1790
(*virDrvStorageVolWipePattern)(virStorageVolPtr vol,
                               unsigned int algorithm,
                               unsigned int flags);
1791

1792
typedef int
1793 1794 1795
(*virDrvStorageVolGetInfo)(virStorageVolPtr vol,
                           virStorageVolInfoPtr info);

1796
typedef char *
1797 1798 1799
(*virDrvStorageVolGetXMLDesc)(virStorageVolPtr pool,
                              unsigned int flags);

1800
typedef char *
1801
(*virDrvStorageVolGetPath)(virStorageVolPtr vol);
1802

1803
typedef virStorageVolPtr
1804 1805 1806
(*virDrvStorageVolCreateXMLFrom)(virStoragePoolPtr pool,
                                 const char *xmldesc,
                                 virStorageVolPtr clonevol,
1807
                                 unsigned int flags);
1808

1809
typedef int
1810 1811 1812 1813 1814 1815
(*virDrvStorageVolDownload)(virStorageVolPtr vol,
                            virStreamPtr stream,
                            unsigned long long offset,
                            unsigned long long length,
                            unsigned int flags);

1816
typedef int
1817 1818 1819 1820 1821
(*virDrvStorageVolUpload)(virStorageVolPtr vol,
                          virStreamPtr stream,
                          unsigned long long offset,
                          unsigned long long length,
                          unsigned int flags);
1822

1823
typedef int
1824 1825 1826 1827
(*virDrvStorageVolResize)(virStorageVolPtr vol,
                          unsigned long long capacity,
                          unsigned int flags);

1828
typedef int
1829 1830 1831 1832
(*virDrvStoragePoolIsActive)(virStoragePoolPtr pool);

typedef int
(*virDrvStoragePoolIsPersistent)(virStoragePoolPtr pool);
1833 1834


1835 1836 1837 1838 1839 1840 1841

typedef struct _virStorageDriver virStorageDriver;
typedef virStorageDriver *virStorageDriverPtr;

/**
 * _virStorageDriver:
 *
1842
 * Structure associated to a storage driver, defining the various
1843 1844 1845 1846 1847 1848 1849
 * entry points for it.
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
 */
struct _virStorageDriver {
1850
    const char * name; /* the name of the driver */
1851 1852
    virDrvStorageOpen storageOpen;
    virDrvStorageClose storageClose;
1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892
    virDrvConnectNumOfStoragePools connectNumOfStoragePools;
    virDrvConnectListStoragePools connectListStoragePools;
    virDrvConnectNumOfDefinedStoragePools connectNumOfDefinedStoragePools;
    virDrvConnectListDefinedStoragePools connectListDefinedStoragePools;
    virDrvConnectListAllStoragePools connectListAllStoragePools;
    virDrvConnectFindStoragePoolSources connectFindStoragePoolSources;
    virDrvStoragePoolLookupByName storagePoolLookupByName;
    virDrvStoragePoolLookupByUUID storagePoolLookupByUUID;
    virDrvStoragePoolLookupByVolume storagePoolLookupByVolume;
    virDrvStoragePoolCreateXML storagePoolCreateXML;
    virDrvStoragePoolDefineXML storagePoolDefineXML;
    virDrvStoragePoolBuild storagePoolBuild;
    virDrvStoragePoolUndefine storagePoolUndefine;
    virDrvStoragePoolCreate storagePoolCreate;
    virDrvStoragePoolDestroy storagePoolDestroy;
    virDrvStoragePoolDelete storagePoolDelete;
    virDrvStoragePoolRefresh storagePoolRefresh;
    virDrvStoragePoolGetInfo storagePoolGetInfo;
    virDrvStoragePoolGetXMLDesc storagePoolGetXMLDesc;
    virDrvStoragePoolGetAutostart storagePoolGetAutostart;
    virDrvStoragePoolSetAutostart storagePoolSetAutostart;
    virDrvStoragePoolNumOfVolumes storagePoolNumOfVolumes;
    virDrvStoragePoolListVolumes storagePoolListVolumes;
    virDrvStoragePoolListAllVolumes storagePoolListAllVolumes;
    virDrvStorageVolLookupByName storageVolLookupByName;
    virDrvStorageVolLookupByKey storageVolLookupByKey;
    virDrvStorageVolLookupByPath storageVolLookupByPath;
    virDrvStorageVolCreateXML storageVolCreateXML;
    virDrvStorageVolCreateXMLFrom storageVolCreateXMLFrom;
    virDrvStorageVolDownload storageVolDownload;
    virDrvStorageVolUpload storageVolUpload;
    virDrvStorageVolDelete storageVolDelete;
    virDrvStorageVolWipe storageVolWipe;
    virDrvStorageVolWipePattern storageVolWipePattern;
    virDrvStorageVolGetInfo storageVolGetInfo;
    virDrvStorageVolGetXMLDesc storageVolGetXMLDesc;
    virDrvStorageVolGetPath storageVolGetPath;
    virDrvStorageVolResize storageVolResize;
    virDrvStoragePoolIsActive storagePoolIsActive;
    virDrvStoragePoolIsPersistent storagePoolIsPersistent;
1893 1894
};

1895
# ifdef WITH_LIBVIRTD
1896

1897 1898 1899 1900 1901
typedef int
(*virDrvStateInitialize)(bool privileged,
                         virStateInhibitCallback callback,
                         void *opaque);

1902 1903 1904
typedef void
(*virDrvStateAutoStart)(void);

1905 1906 1907 1908 1909 1910 1911 1912
typedef int
(*virDrvStateCleanup)(void);

typedef int
(*virDrvStateReload)(void);

typedef int
(*virDrvStateStop)(void);
1913 1914 1915 1916 1917

typedef struct _virStateDriver virStateDriver;
typedef virStateDriver *virStateDriverPtr;

struct _virStateDriver {
1918
    const char *name;
1919
    virDrvStateInitialize stateInitialize;
1920
    virDrvStateAutoStart stateAutoStart;
1921 1922 1923
    virDrvStateCleanup stateCleanup;
    virDrvStateReload stateReload;
    virDrvStateStop stateStop;
1924
};
1925
# endif
1926

1927

1928 1929 1930 1931
typedef virDrvConnectOpen virDrvNodeDeviceOpen;
typedef virDrvConnectClose virDrvNodeDeviceClose;


1932 1933 1934 1935
typedef int
(*virDrvNodeNumOfDevices)(virConnectPtr conn,
                          const char *cap,
                          unsigned int flags);
1936

1937 1938 1939 1940 1941 1942
typedef int
(*virDrvNodeListDevices)(virConnectPtr conn,
                         const char *cap,
                         char **const names,
                         int maxnames,
                         unsigned int flags);
1943

1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961
typedef int
(*virDrvConnectListAllNodeDevices)(virConnectPtr conn,
                                   virNodeDevicePtr **devices,
                                   unsigned int flags);

typedef virNodeDevicePtr
(*virDrvNodeDeviceLookupByName)(virConnectPtr conn,
                                const char *name);

typedef virNodeDevicePtr
(*virDrvNodeDeviceLookupSCSIHostByWWN)(virConnectPtr conn,
                                       const char *wwnn,
                                       const char *wwpn,
                                       unsigned int flags);

typedef char *
(*virDrvNodeDeviceGetXMLDesc)(virNodeDevicePtr dev,
                              unsigned int flags);
1962

1963 1964
typedef char *
(*virDrvNodeDeviceGetParent)(virNodeDevicePtr dev);
1965

1966 1967
typedef int
(*virDrvNodeDeviceNumOfCaps)(virNodeDevicePtr dev);
1968

1969 1970 1971 1972
typedef int
(*virDrvNodeDeviceListCaps)(virNodeDevicePtr dev,
                            char **const names,
                            int maxnames);
1973

1974 1975 1976 1977
typedef virNodeDevicePtr
(*virDrvNodeDeviceCreateXML)(virConnectPtr conn,
                             const char *xmlDesc,
                             unsigned int flags);
1978

1979 1980
typedef int
(*virDrvNodeDeviceDestroy)(virNodeDevicePtr dev);
1981 1982


1983

1984 1985
typedef struct _virNodeDeviceDriver virNodeDeviceDriver;
typedef virNodeDeviceDriver *virNodeDeviceDriverPtr;
1986

1987
/**
1988
 * _virNodeDeviceDriver:
1989 1990 1991 1992 1993
 *
 * Structure associated with monitoring the devices
 * on a virtualized node.
 *
 */
1994
struct _virNodeDeviceDriver {
1995
    const char * name; /* the name of the driver */
1996 1997
    virDrvNodeDeviceOpen nodeDeviceOpen;
    virDrvNodeDeviceClose nodeDeviceClose;
1998 1999
    virDrvNodeNumOfDevices nodeNumOfDevices;
    virDrvNodeListDevices nodeListDevices;
2000 2001
    virDrvConnectListAllNodeDevices connectListAllNodeDevices;
    virDrvNodeDeviceLookupByName nodeDeviceLookupByName;
2002 2003 2004 2005 2006 2007 2008
    virDrvNodeDeviceLookupSCSIHostByWWN nodeDeviceLookupSCSIHostByWWN;
    virDrvNodeDeviceGetXMLDesc nodeDeviceGetXMLDesc;
    virDrvNodeDeviceGetParent nodeDeviceGetParent;
    virDrvNodeDeviceNumOfCaps nodeDeviceNumOfCaps;
    virDrvNodeDeviceListCaps nodeDeviceListCaps;
    virDrvNodeDeviceCreateXML nodeDeviceCreateXML;
    virDrvNodeDeviceDestroy nodeDeviceDestroy;
2009 2010
};

2011 2012
enum {
    /* This getValue call is inside libvirt, override the "private" flag.
E
Eric Blake 已提交
2013
       This flag cannot be set by outside callers. */
2014
    VIR_SECRET_GET_VALUE_INTERNAL_CALL = 1 << 0,
2015 2016
};

2017 2018 2019 2020
typedef virDrvConnectOpen virDrvSecretOpen;
typedef virDrvConnectClose virDrvSecretClose;


2021
typedef virSecretPtr
2022 2023 2024
(*virDrvSecretLookupByUUID)(virConnectPtr conn,
                            const unsigned char *uuid);

2025
typedef virSecretPtr
2026 2027 2028 2029
(*virDrvSecretLookupByUsage)(virConnectPtr conn,
                             int usageType,
                             const char *usageID);

2030
typedef virSecretPtr
2031 2032 2033 2034
(*virDrvSecretDefineXML)(virConnectPtr conn,
                         const char *xml,
                         unsigned int flags);

2035
typedef char *
2036 2037 2038
(*virDrvSecretGetXMLDesc)(virSecretPtr secret,
                          unsigned int flags);

2039
typedef int
2040 2041 2042 2043 2044
(*virDrvSecretSetValue)(virSecretPtr secret,
                        const unsigned char *value,
                        size_t value_size,
                        unsigned int flags);

2045
typedef unsigned char *
2046 2047 2048 2049 2050
(*virDrvSecretGetValue)(virSecretPtr secret,
                        size_t *value_size,
                        unsigned int flags,
                        unsigned int internalFlags);

2051
typedef int
2052 2053
(*virDrvSecretUndefine)(virSecretPtr secret);

2054
typedef int
2055 2056
(*virDrvConnectNumOfSecrets)(virConnectPtr conn);

2057
typedef int
2058 2059 2060 2061
(*virDrvConnectListSecrets)(virConnectPtr conn,
                            char **uuids,
                            int maxuuids);

2062
typedef int
2063 2064 2065
(*virDrvConnectListAllSecrets)(virConnectPtr conn,
                               virSecretPtr **secrets,
                               unsigned int flags);
2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081

typedef struct _virSecretDriver virSecretDriver;
typedef virSecretDriver *virSecretDriverPtr;

/**
 * _virSecretDriver:
 *
 * Structure associated to a driver for storing secrets, defining the various
 * entry points for it.
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
 */
struct _virSecretDriver {
    const char *name;
2082 2083
    virDrvSecretOpen secretOpen;
    virDrvSecretClose secretClose;
2084 2085 2086 2087 2088 2089 2090 2091 2092 2093
    virDrvConnectNumOfSecrets connectNumOfSecrets;
    virDrvConnectListSecrets connectListSecrets;
    virDrvConnectListAllSecrets connectListAllSecrets;
    virDrvSecretLookupByUUID secretLookupByUUID;
    virDrvSecretLookupByUsage secretLookupByUsage;
    virDrvSecretDefineXML secretDefineXML;
    virDrvSecretGetXMLDesc secretGetXMLDesc;
    virDrvSecretSetValue secretSetValue;
    virDrvSecretGetValue secretGetValue;
    virDrvSecretUndefine secretUndefine;
2094 2095
};

2096

2097 2098 2099 2100
typedef int
(*virDrvStreamSend)(virStreamPtr st,
                    const char *data,
                    size_t nbytes);
2101

2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119
typedef int
(*virDrvStreamRecv)(virStreamPtr st,
                    char *data,
                    size_t nbytes);

typedef int
(*virDrvStreamEventAddCallback)(virStreamPtr stream,
                                int events,
                                virStreamEventCallback cb,
                                void *opaque,
                                virFreeCallback ff);

typedef int
(*virDrvStreamEventUpdateCallback)(virStreamPtr stream,
                                   int events);

typedef int
(*virDrvStreamEventRemoveCallback)(virStreamPtr stream);
2120

2121 2122
typedef int
(*virDrvStreamFinish)(virStreamPtr st);
2123

2124 2125
typedef int
(*virDrvStreamAbort)(virStreamPtr st);
2126

2127 2128
typedef struct _virStreamDriver virStreamDriver;
typedef virStreamDriver *virStreamDriverPtr;
2129 2130

struct _virStreamDriver {
2131 2132 2133
    virDrvStreamSend streamSend;
    virDrvStreamRecv streamRecv;
    virDrvStreamEventAddCallback streamEventAddCallback;
2134 2135
    virDrvStreamEventUpdateCallback streamEventUpdateCallback;
    virDrvStreamEventRemoveCallback streamEventRemoveCallback;
2136 2137
    virDrvStreamFinish streamFinish;
    virDrvStreamAbort streamAbort;
2138 2139 2140
};


2141 2142 2143 2144
typedef virDrvConnectOpen virDrvNWFilterOpen;
typedef virDrvConnectClose virDrvNWFilterClose;


S
Stefan Berger 已提交
2145
typedef int
2146 2147
(*virDrvConnectNumOfNWFilters)(virConnectPtr conn);

S
Stefan Berger 已提交
2148
typedef int
2149 2150 2151 2152
(*virDrvConnectListNWFilters)(virConnectPtr conn,
                              char **const names,
                              int maxnames);

2153
typedef int
2154 2155 2156 2157
(*virDrvConnectListAllNWFilters)(virConnectPtr conn,
                                 virNWFilterPtr **filters,
                                 unsigned int flags);

S
Stefan Berger 已提交
2158
typedef virNWFilterPtr
2159 2160 2161
(*virDrvNWFilterLookupByName)(virConnectPtr conn,
                              const char *name);

S
Stefan Berger 已提交
2162
typedef virNWFilterPtr
2163 2164 2165
(*virDrvNWFilterLookupByUUID)(virConnectPtr conn,
                              const unsigned char *uuid);

S
Stefan Berger 已提交
2166
typedef virNWFilterPtr
2167 2168 2169
(*virDrvNWFilterDefineXML)(virConnectPtr conn,
                           const char *xmlDesc);

S
Stefan Berger 已提交
2170
typedef int
2171
(*virDrvNWFilterUndefine)(virNWFilterPtr nwfilter);
S
Stefan Berger 已提交
2172 2173

typedef char *
2174 2175
(*virDrvNWFilterGetXMLDesc)(virNWFilterPtr nwfilter,
                            unsigned int flags);
S
Stefan Berger 已提交
2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191


typedef struct _virNWFilterDriver virNWFilterDriver;
typedef virNWFilterDriver *virNWFilterDriverPtr;

/**
 * _virNWFilterDriver:
 *
 * Structure associated to a network filter driver, defining the various
 * entry points for it.
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
 */
struct _virNWFilterDriver {
2192
    const char * name; /* the name of the driver */
2193 2194
    virDrvNWFilterOpen nwfilterOpen;
    virDrvNWFilterClose nwfilterClose;
2195
    virDrvConnectNumOfNWFilters connectNumOfNWFilters;
2196 2197 2198 2199 2200 2201 2202
    virDrvConnectListNWFilters connectListNWFilters;
    virDrvConnectListAllNWFilters connectListAllNWFilters;
    virDrvNWFilterLookupByName nwfilterLookupByName;
    virDrvNWFilterLookupByUUID nwfilterLookupByUUID;
    virDrvNWFilterDefineXML nwfilterDefineXML;
    virDrvNWFilterUndefine nwfilterUndefine;
    virDrvNWFilterGetXMLDesc nwfilterGetXMLDesc;
S
Stefan Berger 已提交
2203 2204 2205
};


2206 2207 2208 2209 2210
/*
 * Registration
 * TODO: also need ways to (des)activate a given driver
 *       lookup based on the URI given in a virConnectOpen(ReadOnly)
 */
2211 2212 2213 2214 2215 2216 2217
int virRegisterDriver(virDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterNetworkDriver(virNetworkDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterInterfaceDriver(virInterfaceDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterStorageDriver(virStorageDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterNodeDeviceDriver(virNodeDeviceDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterSecretDriver(virSecretDriverPtr) ATTRIBUTE_RETURN_CHECK;
int virRegisterNWFilterDriver(virNWFilterDriverPtr) ATTRIBUTE_RETURN_CHECK;
2218
# ifdef WITH_LIBVIRTD
2219
int virRegisterStateDriver(virStateDriverPtr) ATTRIBUTE_RETURN_CHECK;
2220
# endif
2221
void *virDriverLoadModule(const char *name);
2222 2223

#endif /* __VIR_DRIVER_H__ */