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.
 */
M
Michal Privoznik 已提交
81
# define VIR_DRV_SUPPORTS_FEATURE(drv, conn, feature)                   \
82 83
    ((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 1195
typedef struct _virDriver virDriver;
typedef virDriver *virDriverPtr;
1196

1197 1198 1199 1200 1201
/**
 * _virDriver:
 *
 * Structure associated to a virtualization driver, defining the various
 * entry points for it.
1202 1203 1204 1205 1206 1207
 *
 * All drivers must support the following fields/methods:
 *  - no
 *  - name
 *  - open
 *  - close
1208 1209
 */
struct _virDriver {
1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226
    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;
1227
    virDrvDomainCreateXMLWithFiles domainCreateXMLWithFiles;
1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246
    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;
1247
    virDrvDomainSetMemoryStatsPeriod domainSetMemoryStatsPeriod;
1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263
    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;
1264
    virDrvDomainCoreDumpWithFormat domainCoreDumpWithFormat;
1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285
    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;
1286
    virDrvDomainCreateWithFiles domainCreateWithFiles;
1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298
    virDrvDomainDefineXML domainDefineXML;
    virDrvDomainUndefine domainUndefine;
    virDrvDomainUndefineFlags domainUndefineFlags;
    virDrvDomainAttachDevice domainAttachDevice;
    virDrvDomainAttachDeviceFlags domainAttachDeviceFlags;
    virDrvDomainDetachDevice domainDetachDevice;
    virDrvDomainDetachDeviceFlags domainDetachDeviceFlags;
    virDrvDomainUpdateDeviceFlags domainUpdateDeviceFlags;
    virDrvDomainGetAutostart domainGetAutostart;
    virDrvDomainSetAutostart domainSetAutostart;
    virDrvDomainGetSchedulerType domainGetSchedulerType;
    virDrvDomainGetSchedulerParameters domainGetSchedulerParameters;
1299
    virDrvDomainGetSchedulerParametersFlags domainGetSchedulerParametersFlags;
1300
    virDrvDomainSetSchedulerParameters domainSetSchedulerParameters;
1301
    virDrvDomainSetSchedulerParametersFlags domainSetSchedulerParametersFlags;
1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323
    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;
1324
    virDrvNodeDeviceDetachFlags nodeDeviceDetachFlags;
1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338
    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;
1339 1340
    virDrvDomainMigrateGetCompressionCache domainMigrateGetCompressionCache;
    virDrvDomainMigrateSetCompressionCache domainMigrateSetCompressionCache;
1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353
    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;
1354
    virDrvDomainSnapshotListChildrenNames domainSnapshotListChildrenNames;
1355
    virDrvDomainSnapshotListAllChildren domainSnapshotListAllChildren;
1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366
    virDrvDomainSnapshotLookupByName domainSnapshotLookupByName;
    virDrvDomainHasCurrentSnapshot domainHasCurrentSnapshot;
    virDrvDomainSnapshotGetParent domainSnapshotGetParent;
    virDrvDomainSnapshotCurrent domainSnapshotCurrent;
    virDrvDomainSnapshotIsCurrent domainSnapshotIsCurrent;
    virDrvDomainSnapshotHasMetadata domainSnapshotHasMetadata;
    virDrvDomainRevertToSnapshot domainRevertToSnapshot;
    virDrvDomainSnapshotDelete domainSnapshotDelete;
    virDrvDomainQemuMonitorCommand domainQemuMonitorCommand;
    virDrvDomainQemuAttach domainQemuAttach;
    virDrvDomainQemuAgentCommand domainQemuAgentCommand;
1367 1368
    virDrvConnectDomainQemuMonitorEventRegister connectDomainQemuMonitorEventRegister;
    virDrvConnectDomainQemuMonitorEventDeregister connectDomainQemuMonitorEventDeregister;
1369 1370 1371 1372 1373 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
    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;
1401 1402 1403 1404 1405 1406
    virDrvDomainMigrateBegin3Params domainMigrateBegin3Params;
    virDrvDomainMigratePrepare3Params domainMigratePrepare3Params;
    virDrvDomainMigratePrepareTunnel3Params domainMigratePrepareTunnel3Params;
    virDrvDomainMigratePerform3Params domainMigratePerform3Params;
    virDrvDomainMigrateFinish3Params domainMigrateFinish3Params;
    virDrvDomainMigrateConfirm3Params domainMigrateConfirm3Params;
1407
    virDrvConnectGetCPUModelNames connectGetCPUModelNames;
1408 1409
    virDrvDomainFSFreeze domainFSFreeze;
    virDrvDomainFSThaw domainFSThaw;
1410 1411
    virDrvDomainGetTime domainGetTime;
    virDrvDomainSetTime domainSetTime;
M
Michal Privoznik 已提交
1412
    virDrvNodeGetFreePages nodeGetFreePages;
1413
    virDrvConnectGetDomainCapabilities connectGetDomainCapabilities;
1414 1415
};

1416 1417 1418 1419

typedef virDrvConnectOpen virDrvNetworkOpen;
typedef virDrvConnectClose virDrvNetworkClose;

1420
typedef int
1421 1422
(*virDrvConnectNumOfNetworks)(virConnectPtr conn);

1423
typedef int
1424 1425 1426 1427
(*virDrvConnectListNetworks)(virConnectPtr conn,
                             char **const names,
                             int maxnames);

1428
typedef int
1429 1430
(*virDrvConnectNumOfDefinedNetworks)(virConnectPtr conn);

1431
typedef int
1432 1433 1434 1435
(*virDrvConnectListDefinedNetworks)(virConnectPtr conn,
                                    char **const names,
                                    int maxnames);

1436
typedef int
1437 1438 1439 1440
(*virDrvConnectListAllNetworks)(virConnectPtr conn,
                                virNetworkPtr **nets,
                                unsigned int flags);

1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452
typedef int
(*virDrvConnectNetworkEventRegisterAny)(virConnectPtr conn,
                                        virNetworkPtr dom,
                                        int eventID,
                                        virConnectNetworkEventGenericCallback cb,
                                        void *opaque,
                                        virFreeCallback freecb);

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

1453
typedef virNetworkPtr
1454 1455 1456
(*virDrvNetworkLookupByUUID)(virConnectPtr conn,
                             const unsigned char *uuid);

1457
typedef virNetworkPtr
1458 1459 1460
(*virDrvNetworkLookupByName)(virConnectPtr conn,
                             const char *name);

1461
typedef virNetworkPtr
1462 1463 1464
(*virDrvNetworkCreateXML)(virConnectPtr conn,
                          const char *xmlDesc);

1465
typedef virNetworkPtr
1466 1467 1468
(*virDrvNetworkDefineXML)(virConnectPtr conn,
                          const char *xml);

1469
typedef int
1470 1471
(*virDrvNetworkUndefine)(virNetworkPtr network);

1472
typedef int
1473 1474 1475 1476 1477 1478 1479
(*virDrvNetworkUpdate)(virNetworkPtr network,
                       unsigned int command, /* virNetworkUpdateCommand */
                       unsigned int section, /* virNetworkUpdateSection */
                       int parentIndex,
                       const char *xml,
                       unsigned int flags);

1480
typedef int
1481 1482
(*virDrvNetworkCreate)(virNetworkPtr network);

1483
typedef int
1484 1485
(*virDrvNetworkDestroy)(virNetworkPtr network);

1486
typedef char *
1487 1488 1489
(*virDrvNetworkGetXMLDesc)(virNetworkPtr network,
                           unsigned int flags);

1490
typedef char *
1491 1492
(*virDrvNetworkGetBridgeName)(virNetworkPtr network);

1493
typedef int
1494 1495 1496
(*virDrvNetworkGetAutostart)(virNetworkPtr network,
                             int *autostart);

1497
typedef int
1498 1499
(*virDrvNetworkSetAutostart)(virNetworkPtr network,
                             int autostart);
1500

1501
typedef int
1502 1503
(*virDrvNetworkIsActive)(virNetworkPtr net);

1504
typedef int
1505
(*virDrvNetworkIsPersistent)(virNetworkPtr net);
1506

1507 1508 1509 1510 1511
typedef int
(*virDrvNetworkGetDHCPLeases)(virNetworkPtr network,
                              const char *mac,
                              virNetworkDHCPLeasePtr **leases,
                              unsigned int flags);
1512 1513 1514 1515 1516 1517 1518 1519 1520

typedef struct _virNetworkDriver virNetworkDriver;
typedef virNetworkDriver *virNetworkDriverPtr;

/**
 * _virNetworkDriver:
 *
 * Structure associated to a network virtualization driver, defining the various
 * entry points for it.
1521 1522 1523 1524
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
1525 1526
 */
struct _virNetworkDriver {
1527
    const char * name; /* the name of the driver */
1528 1529
    virDrvNetworkOpen networkOpen;
    virDrvNetworkClose networkClose;
1530 1531 1532 1533 1534
    virDrvConnectNumOfNetworks connectNumOfNetworks;
    virDrvConnectListNetworks connectListNetworks;
    virDrvConnectNumOfDefinedNetworks connectNumOfDefinedNetworks;
    virDrvConnectListDefinedNetworks connectListDefinedNetworks;
    virDrvConnectListAllNetworks connectListAllNetworks;
1535 1536
    virDrvConnectNetworkEventRegisterAny connectNetworkEventRegisterAny;
    virDrvConnectNetworkEventDeregisterAny connectNetworkEventDeregisterAny;
1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550
    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;
1551
    virDrvNetworkGetDHCPLeases networkGetDHCPLeases;
1552 1553
};

1554

1555 1556 1557
typedef virDrvConnectOpen virDrvInterfaceOpen;
typedef virDrvConnectClose virDrvInterfaceClose;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1657

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


1834 1835 1836 1837 1838 1839 1840

typedef struct _virStorageDriver virStorageDriver;
typedef virStorageDriver *virStorageDriverPtr;

/**
 * _virStorageDriver:
 *
1841
 * Structure associated to a storage driver, defining the various
1842 1843 1844 1845 1846 1847 1848
 * entry points for it.
 *
 * All drivers must support the following fields/methods:
 *  - open
 *  - close
 */
struct _virStorageDriver {
1849
    const char * name; /* the name of the driver */
1850 1851
    virDrvStorageOpen storageOpen;
    virDrvStorageClose storageClose;
1852 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
    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;
1892 1893
};

1894
# ifdef WITH_LIBVIRTD
1895

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

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

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

typedef int
(*virDrvStateReload)(void);

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

typedef struct _virStateDriver virStateDriver;
typedef virStateDriver *virStateDriverPtr;

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

1926

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


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

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

1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960
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);
1961

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

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

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

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

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


1982

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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;
2081 2082
    virDrvSecretOpen secretOpen;
    virDrvSecretClose secretClose;
2083 2084 2085 2086 2087 2088 2089 2090 2091 2092
    virDrvConnectNumOfSecrets connectNumOfSecrets;
    virDrvConnectListSecrets connectListSecrets;
    virDrvConnectListAllSecrets connectListAllSecrets;
    virDrvSecretLookupByUUID secretLookupByUUID;
    virDrvSecretLookupByUsage secretLookupByUsage;
    virDrvSecretDefineXML secretDefineXML;
    virDrvSecretGetXMLDesc secretGetXMLDesc;
    virDrvSecretSetValue secretSetValue;
    virDrvSecretGetValue secretGetValue;
    virDrvSecretUndefine secretUndefine;
2093 2094
};

2095

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

2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118
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);
2119

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

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

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

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


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


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

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

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

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

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

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

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

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


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 {
2191
    const char * name; /* the name of the driver */
2192 2193
    virDrvNWFilterOpen nwfilterOpen;
    virDrvNWFilterClose nwfilterClose;
2194
    virDrvConnectNumOfNWFilters connectNumOfNWFilters;
2195 2196 2197 2198 2199 2200 2201
    virDrvConnectListNWFilters connectListNWFilters;
    virDrvConnectListAllNWFilters connectListAllNWFilters;
    virDrvNWFilterLookupByName nwfilterLookupByName;
    virDrvNWFilterLookupByUUID nwfilterLookupByUUID;
    virDrvNWFilterDefineXML nwfilterDefineXML;
    virDrvNWFilterUndefine nwfilterUndefine;
    virDrvNWFilterGetXMLDesc nwfilterGetXMLDesc;
S
Stefan Berger 已提交
2202 2203 2204
};


2205 2206 2207 2208 2209
/*
 * Registration
 * TODO: also need ways to (des)activate a given driver
 *       lookup based on the URI given in a virConnectOpen(ReadOnly)
 */
2210 2211 2212 2213 2214 2215 2216
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;
2217
# ifdef WITH_LIBVIRTD
2218
int virRegisterStateDriver(virStateDriverPtr) ATTRIBUTE_RETURN_CHECK;
2219
# endif
2220
void *virDriverLoadModule(const char *name);
2221 2222

#endif /* __VIR_DRIVER_H__ */