From 4c0f24c10f5fa8d87b57f04374c3b85c79976e95 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Fri, 29 Jun 2007 12:44:57 +0000 Subject: [PATCH] Tue Jun 29 13:44:00 BST 2007 Richard W.M. Jones * docs/site.xsl, docs/libvir.html, docs/hvsupport.html: Document which libvirt versions supported various hypervisor calls. --- ChangeLog | 6 + docs/FAQ.html | 2 +- docs/architecture.html | 2 +- docs/bugs.html | 2 +- docs/downloads.html | 2 +- docs/errors.html | 2 +- docs/format.html | 2 +- docs/hvsupport.html | 365 ++++++++++++++++++++++++++++ docs/index.html | 3 + docs/intro.html | 2 +- docs/libvir.html | 540 +++++++++++++++++++++++++++++++++++++++++ docs/news.html | 2 +- docs/python.html | 2 +- docs/remote.html | 2 +- docs/site.xsl | 3 + docs/uri.html | 2 +- 16 files changed, 928 insertions(+), 11 deletions(-) create mode 100644 docs/hvsupport.html diff --git a/ChangeLog b/ChangeLog index 202243b199..3a2e3e7d72 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Tue Jun 29 13:44:00 BST 2007 Richard W.M. Jones + + * docs/site.xsl, docs/libvir.html, docs/hvsupport.html: + Document which libvirt versions supported various + hypervisor calls. + Tue Jun 27 18:32:00 EST 2007 Daniel P. Berrange * libvirt.spec.in: Remove Makefile & Makefile.in from -devel diff --git a/docs/FAQ.html b/docs/FAQ.html index f08f54928c..4b6a4412b7 100644 --- a/docs/FAQ.html +++ b/docs/FAQ.html @@ -77,4 +77,4 @@ via the pkg-config command line tool, like:

pkg-config libvirt --libs

-

+

diff --git a/docs/architecture.html b/docs/architecture.html index 9aecdf0bba..c46e0118bc 100644 --- a/docs/architecture.html +++ b/docs/architecture.html @@ -64,4 +64,4 @@ drivers present in driver.h:

  • xend_internal: implements the driver fun

Note that a given driver may only implement a subset of those functions, (for example saving a Xen domain state to disk and restoring it is only possible though the Xen Daemon), in that case the driver entry points for -unsupported functions are initialized to NULL.

+unsupported functions are initialized to NULL.

diff --git a/docs/bugs.html b/docs/bugs.html index 1aef989847..ea03e5ffdb 100644 --- a/docs/bugs.html +++ b/docs/bugs.html @@ -9,4 +9,4 @@ If possible generate the patches by using cvs diff -u in a CVS checkout.

W If you want to report a bug or ask for a feature, please check the existing open bugs, then if yours isn't a duplicate of an existing bug, log a new bug and attach any patch or extra data that you may have available. It is always a good idea to also to post to the mailing-list -too, so that everybody working on the project can see it, thanks !

+too, so that everybody working on the project can see it, thanks !

diff --git a/docs/downloads.html b/docs/downloads.html index e4fd7bccc9..603c73daac 100644 --- a/docs/downloads.html +++ b/docs/downloads.html @@ -7,4 +7,4 @@ available, first register onto the server:

cvs -d :pserver:anoncvs@l checkout the development tree with:

cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs co libvirt

Use ./autogen.sh to configure the local checkout, then make and make install, as usual. All normal cvs commands are now -available except commiting to the base.

+available except commiting to the base.

diff --git a/docs/errors.html b/docs/errors.html index dab18a0df1..c3292a8320 100644 --- a/docs/errors.html +++ b/docs/errors.html @@ -66,4 +66,4 @@ this point, see the error.py example about it:

def handler(ctxt, err):
 
 libvirt.registerErrorHandler(handler, 'context') 

the second argument to the registerErrorHandler function is passed as the fist argument of the callback like in the C version. The error is a tuple -containing the same field as a virError in C, but cast to Python.

+containing the same field as a virError in C, but cast to Python.

diff --git a/docs/format.html b/docs/format.html index a131ea78d4..e2f0446b25 100644 --- a/docs/format.html +++ b/docs/format.html @@ -412,4 +412,4 @@ Xen support, you will see the os_type of xen to indicate a paravirtual kernel, then architecture informations and potential features.

The third block (in green) gives similar informations but when running a 32 bit OS fully virtualized with Xen using the hvm support.

This section is likely to be updated and augmented in the future, see the discussion which led to the capabilities format in the mailing-list -archives.

+archives.

diff --git a/docs/hvsupport.html b/docs/hvsupport.html new file mode 100644 index 0000000000..8b10a9420e --- /dev/null +++ b/docs/hvsupport.html @@ -0,0 +1,365 @@ + + +Hypervisor support

Hypervisor support

+This page documents which libvirt calls work on +which hypervisors. +

+This information changes frequently. This page was last checked or +updated on 2007-06-28. +

Domain functions

x = not supported; empty cell means no information

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Function Since Xen QEMU KVM Remote
virConnectClose All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectGetCapabilities 0.2.1 ≥ 0.2.1 ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
virConnectGetHostname 0.3.0 ≥ 0.3.0 ≥ 0.3.0
virConnectGetMaxVcpus 0.2.1 ≥ 0.2.1 x x ≥ 0.3.0
virConnectGetType All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectGetURI 0.3.0 ≥ 0.3.0 ≥ 0.3.0
virConnectGetVersion All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectListDefinedDomains 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectListDomains All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectNumOfDefinedDomains 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectNumOfDomains All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectOpen All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virConnectOpenReadOnly All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainAttachDevice 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
virDomainCoreDump 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
virDomainCreate 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainCreateLinux All ≥ 0.0.5 x x ≥ 0.3.0
virDomainDefineXML 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainDestroy All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainDetachDevice 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
virDomainFree All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetAutostart 0.2.1 x ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
virDomainGetConnect 0.3.0 not a HV function
virDomainGetID All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetInfo All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetMaxMemory All All x x ≥ 0.3.0
virDomainGetMaxVcpus 0.2.1 ≥ 0.2.1 x x ≥ 0.3.0
virDomainGetName All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetOSType All All x x ≥ 0.3.0
virDomainGetSchedulerParameters 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
virDomainGetSchedulerType 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
virDomainGetUUID 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetUUIDString 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainGetVcpus 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
virDomainGetXMLDesc All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainLookupByID All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainLookupByName All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainLookupByUUID 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainLookupByUUIDString 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainPinVcpu 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
virDomainReboot 0.1.0 ≥ 0.1.0 x x ≥ 0.3.0
virDomainRestore All All x x ≥ 0.3.0
virDomainResume All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainSave All All x x ≥ 0.3.0
virDomainSetAutostart 0.2.1 x ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
virDomainSetMaxMemory All All x x ≥ 0.3.0
virDomainSetMemory 0.1.1 ≥ 0.1.1 x x ≥ 0.3.0
virDomainSetSchedulerParameters 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
virDomainSetVcpus 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
virDomainShutdown All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainSuspend All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virDomainUndefine 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
virGetVersion All All Returns -1 if HV unsupported.
virInitialize 0.1.0 not a HV function
virNodeGetInfo 0.1.0 ≥ 0.1.0 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0

Network functions

+Network functions are not hypervisor-specific. For historical +reasons they require the QEMU daemon to be running (this +restriction may be lifted in future). Most network functions +first appeared in libvirt 0.2.0. +

+ + + + + + + + + + + + + + + + + + + + + + +
Function Since
virConnectNumOfNetworks 0.2.0
virConnectListNetworks 0.2.0
virConnectNumOfDefinedNetworks 0.2.0
virConnectListDefinedNetworks 0.2.0
virNetworkCreate 0.2.0
virNetworkCreateXML 0.2.0
virNetworkDefineXML 0.2.0
virNetworkDestroy 0.2.0
virNetworkFree 0.2.0
virNetworkGetAutostart 0.2.1
virNetworkGetConnect 0.3.0
virNetworkGetBridgeName 0.2.0
virNetworkGetName 0.2.0
virNetworkGetUUID 0.2.0
virNetworkGetUUIDString 0.2.0
virNetworkGetXMLDesc 0.2.0
virNetworkLookupByName 0.2.0
virNetworkLookupByUUID 0.2.0
virNetworkLookupByUUIDString 0.2.0
virNetworkSetAutostart 0.2.1
virNetworkUndefine 0.2.0

diff --git a/docs/index.html b/docs/index.html index 62c0d9bc7d..af9d394670 100644 --- a/docs/index.html +++ b/docs/index.html @@ -67,6 +67,9 @@ virtualization mechanisms, it currently also support Connection URIs +
  • + Hypervisor support +
  • API Menu
  • diff --git a/docs/intro.html b/docs/intro.html index 8cb23d2ea5..5e5e75084a 100644 --- a/docs/intro.html +++ b/docs/intro.html @@ -28,4 +28,4 @@ exception being domain migration between node capabilities which may need to be added at the libvirt level). Where possible libvirt should be extendable to be able to provide the same API for remote nodes, however this is not the case at the moment, the code currently handle only local node accesses -(extension for remote access support is being worked on, see the mailing list discussions about it).

    +(extension for remote access support is being worked on, see the mailing list discussions about it).

    diff --git a/docs/libvir.html b/docs/libvir.html index b4468b63bb..7dbe97d31d 100644 --- a/docs/libvir.html +++ b/docs/libvir.html @@ -2543,5 +2543,545 @@ You should consider using libvirt remote support in future.

    +

    Hypervisor support

    + +

    +This page documents which libvirt calls work on +which hypervisors. +

    + +

    +This information changes frequently. This page was last checked or +updated on 2007-06-29. +

    + +

    Domain functions

    + +

    x = not supported; empty cell means no information

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Function Since Xen QEMU KVM Remote
    virConnectClose All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectGetCapabilities 0.2.1 ≥ 0.2.1 ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
    virConnectGetHostname 0.3.0 ≥ 0.3.0 ≥ 0.3.0
    virConnectGetMaxVcpus 0.2.1 ≥ 0.2.1 x x ≥ 0.3.0
    virConnectGetType All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectGetURI 0.3.0 ≥ 0.3.0 ≥ 0.3.0
    virConnectGetVersion All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectListDefinedDomains 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectListDomains All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectNumOfDefinedDomains 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectNumOfDomains All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectOpen All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virConnectOpenReadOnly All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainAttachDevice 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
    virDomainCoreDump 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
    virDomainCreate 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainCreateLinux All ≥ 0.0.5 x x ≥ 0.3.0
    virDomainDefineXML 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainDestroy All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainDetachDevice 0.1.9 ≥ 0.1.9 x x ≥ 0.3.0
    virDomainFree All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetAutostart 0.2.1 x ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
    virDomainGetConnect 0.3.0 not a HV function
    virDomainGetID All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetInfo All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetMaxMemory All All x x ≥ 0.3.0
    virDomainGetMaxVcpus 0.2.1 ≥ 0.2.1 x x ≥ 0.3.0
    virDomainGetName All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetOSType All All x x ≥ 0.3.0
    virDomainGetSchedulerParameters 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
    virDomainGetSchedulerType 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
    virDomainGetUUID 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetUUIDString 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainGetVcpus 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
    virDomainGetXMLDesc All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainLookupByID All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainLookupByName All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainLookupByUUID 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainLookupByUUIDString 0.1.10 ≥ 0.1.10 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainPinVcpu 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
    virDomainReboot 0.1.0 ≥ 0.1.0 x x ≥ 0.3.0
    virDomainRestore All All x x ≥ 0.3.0
    virDomainResume All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainSave All All x x ≥ 0.3.0
    virDomainSetAutostart 0.2.1 x ≥ 0.2.1 ≥ 0.2.1 ≥ 0.3.0
    virDomainSetMaxMemory All All x x ≥ 0.3.0
    virDomainSetMemory 0.1.1 ≥ 0.1.1 x x ≥ 0.3.0
    virDomainSetSchedulerParameters 0.2.3 ≥ 0.2.3 x x ≥ 0.3.0
    virDomainSetVcpus 0.1.4 ≥ 0.1.4 x x ≥ 0.3.0
    virDomainShutdown All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainSuspend All All ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virDomainUndefine 0.1.5 ≥ 0.1.9 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    virGetVersion All All Returns -1 if HV unsupported.
    virInitialize 0.1.0 not a HV function
    virNodeGetInfo 0.1.0 ≥ 0.1.0 ≥ 0.2.0 ≥ 0.2.0 ≥ 0.3.0
    + +

    Network functions

    + +

    +Network functions are not hypervisor-specific. For historical +reasons they require the QEMU daemon to be running (this +restriction may be lifted in future). Most network functions +first appeared in libvirt 0.2.0. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Function Since
    virConnectNumOfNetworks 0.2.0
    virConnectListNetworks 0.2.0
    virConnectNumOfDefinedNetworks 0.2.0
    virConnectListDefinedNetworks 0.2.0
    virNetworkCreate 0.2.0
    virNetworkCreateXML 0.2.0
    virNetworkDefineXML 0.2.0
    virNetworkDestroy 0.2.0
    virNetworkFree 0.2.0
    virNetworkGetAutostart 0.2.1
    virNetworkGetConnect 0.3.0
    virNetworkGetBridgeName 0.2.0
    virNetworkGetName 0.2.0
    virNetworkGetUUID 0.2.0
    virNetworkGetUUIDString 0.2.0
    virNetworkGetXMLDesc 0.2.0
    virNetworkLookupByName 0.2.0
    virNetworkLookupByUUID 0.2.0
    virNetworkLookupByUUIDString 0.2.0
    virNetworkSetAutostart 0.2.1
    virNetworkUndefine 0.2.0
    + diff --git a/docs/news.html b/docs/news.html index d9216d412f..3516d8e8d0 100644 --- a/docs/news.html +++ b/docs/news.html @@ -246,4 +246,4 @@ and check the ChangeLog to gauge progresses.

    0.0.1: Dec 19 2005

    • First release
    • Basic management of existing Xen domains
    • Minimal autogenerated Python bindings
    • -

    +

    diff --git a/docs/python.html b/docs/python.html index adf9320035..49deb3ce85 100644 --- a/docs/python.html +++ b/docs/python.html @@ -51,4 +51,4 @@ from the C API, the only points to notice are:

    • the import of the modu
    • extracting and printing some informations about the domain using various methods associated to the virDomain class.
    • -

    +

    diff --git a/docs/remote.html b/docs/remote.html index 7c0ebbe064..fe9e1b5519 100644 --- a/docs/remote.html +++ b/docs/remote.html @@ -582,4 +582,4 @@ also possible.

    The protocol contains support for multiple program types and protocol versioning, modelled after SunRPC. -

    +

    diff --git a/docs/site.xsl b/docs/site.xsl index 6108802e55..cf7b88a451 100644 --- a/docs/site.xsl +++ b/docs/site.xsl @@ -57,6 +57,9 @@ uri.html + + hvsupport.html + unknown.html diff --git a/docs/uri.html b/docs/uri.html index d77f71993f..be365751ae 100644 --- a/docs/uri.html +++ b/docs/uri.html @@ -171,4 +171,4 @@ connection.

    You should consider using libvirt remote support in future. -

    +