release of 0.6.3

* NEWS configure.in libvirt.spec.in docs/*: release of 0.6.3
* po/*: regenerated
* src/libvirt.c src/virterror.c: fixed some function comments
Daniel

ChangeLog

+Fri Apr 24 15:55:56 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* NEWS configure.in libvirt.spec.in docs/*: release of 0.6.3
+	* po/*: regenerated
+	* src/libvirt.c src/virterror.c: fixed some function comments
+
 Fri Apr 24 14:07:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
 
 	Add virNodeDeviceCreateXML / virNodeDeviceDestroy boilerplate

NEWS

@@ -5,6 +5,39 @@
        http://libvirt.org/news.html
 
 
+0.6.3: Apr 24 2009:
+   - New features: VirtualBox driver support (Pritesh Kothari),
+          virt-xml-validate new command (Daniel Berrange)
+   - Portability: patch to build on Centos (Joseph Shraibman),
+          build breakage (Anton Protopopov), 
+   - Documentation: Linux Containers documentation (Serge Hallyn),
+          improvement and updates of architecture pages, fix
+          virNodeGetFreeMemory documentation to reflect reality,
+          man page cleanups (Daniel Berrange), man page typo
+          (Robert P. J. Day), VirtualBox Documentation (Pritesh Kothari),
+          
+   - Bug fixes: veth off-by-one error (Dan Smith), vcpupin to inactive
+          Xen crash (Takahashi Tomohiro), virsh ttyconsole return value,
+          use format= not fmt= on QEmu commandline (Mark McLoughlin),
+          use UUID for internal domain lookups (Daniel Berrange), remote
+          domain ID related bugs (Daniel Berrange), QEmu pidfile handling
+          bugs (Daniel Berrange), network config handling on old Xen (Daniel
+          Berrange)
+   - Improvements: add SCSI storage rescan (David Allan), rootless
+          LXC containers support improvements (Serge Hallyn), getHostname
+          support for LXC (Dan Smith), cleanup and logging output of some
+          domain functions (Guido Gnther), drop pool lock when allocating
+          volumes (Cole Robinson), LXC handle kernel without CLONE_NEWUSER
+          support (Serge Hallyn), cpu pinning on defined Xen domains (Takahashi
+          Tomohiro), dynamic bridge names support (Soren Hansen), LXC use
+          of private /dev/pts when available (Daniel Berrange),
+          virNodeDeviceCreateXML and virNodeDeviceDestroy entry points
+          (Dave Allan)
+   - Cleanups: don't hardcode getgrnam_r buffer to 1024 bytes (Guido
+          Gnther), qemudBuildCommandLine API cleanup (Daniel Berrange),
+          
+
+
 0.6.2: Apr  3 2009:
    - New features: support SASL auth for VNC server (Daniel Berrange),
           memory ballooning in QEMU (Daniel Berrange), SCSI HBA storage pool

configure.in

 dnl Process this file with autoconf to produce a configure script.
 
-AC_INIT([libvirt], [0.6.2])
+AC_INIT([libvirt], [0.6.3])
 AC_CONFIG_SRCDIR([src/libvirt.c])
 AC_CONFIG_AUX_DIR([build-aux])
 AM_CONFIG_HEADER([config.h])

docs/apibuild.py

@@ -39,6 +39,7 @@ ignored_functions = {
   "virDomainMigratePrepare": "private function for migration",
   "virDomainMigratePrepare2": "private function for migration",
   "virDrvSupportsFeature": "private function for remote access",
+  "DllMain": "specific function fo Win32",
 }
 
 def escape(raw):

docs/index.html

@@ -99,6 +99,8 @@
 	The <a href="http://openvz.org/">OpenVZ</a> Linux container system
       </li><li>
 	The <a href="http://user-mode-linux.sourceforge.net/">User Mode Linux</a> paravirtualized kernel
+      </li><li>
+	The <a href="http://www.virtualbox.org/">VirtualBox</a> hypervisor
       </li><li>
 	Storage on IDE/SCSI/USB disks, FibreChannel, LVM, iSCSI, NFS and filesystems
       </li></ul>

docs/index.html.in

@@ -52,6 +52,9 @@
       <li>
 	The <a href="http://user-mode-linux.sourceforge.net/">User Mode Linux</a> paravirtualized kernel
       </li>
+      <li>
+	The <a href="http://www.virtualbox.org/">VirtualBox</a> hypervisor
+      </li>
       <li>
 	Storage on IDE/SCSI/USB disks, FibreChannel, LVM, iSCSI, NFS and filesystems
       </li>

docs/libvirt-api.xml

@@ -180,6 +180,7 @@
      <exports symbol='virConnectNumOfDefinedNetworks' type='function'/>
      <exports symbol='virConnectNumOfDomains' type='function'/>
      <exports symbol='virNetworkGetUUID' type='function'/>
+     <exports symbol='virNodeDeviceCreateXML' type='function'/>
      <exports symbol='virStoragePoolGetConnect' type='function'/>
      <exports symbol='virConnectGetVersion' type='function'/>
      <exports symbol='virDomainFree' type='function'/>
@@ -249,6 +250,7 @@
      <exports symbol='virDomainPinVcpu' type='function'/>
      <exports symbol='virNodeGetSecurityModel' type='function'/>
      <exports symbol='virDomainRestore' type='function'/>
+     <exports symbol='virNodeDeviceDestroy' type='function'/>
      <exports symbol='virStorageVolGetPath' type='function'/>
      <exports symbol='virNetworkLookupByUUIDString' type='function'/>
      <exports symbol='virConnectDomainEventCallback' type='function'/>
@@ -997,7 +999,7 @@ see note above'/>
     </function>
     <function name='virConnectRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the connection. For each additional call to this method, there shall be a corresponding call to virConnectClose to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a connection would increment the reference count.</info>
-      <return type='int' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure'/>
       <arg name='conn' type='virConnectPtr' info='the connection to hold a reference on'/>
     </function>
     <function name='virCopyLastError' file='virterror' module='virterror'>
@@ -1237,8 +1239,8 @@ see note above'/>
     </function>
     <function name='virDomainRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the domain. For each additional call to this method, there shall be a corresponding call to virDomainFree to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a domain would increment the reference count.</info>
-      <return type='int' info=''/>
-      <arg name='domain' type='virDomainPtr' info=''/>
+      <return type='int' info='0 in case of success and -1 in case of failure.'/>
+      <arg name='domain' type='virDomainPtr' info='the domain to hold a reference on'/>
     </function>
     <function name='virDomainRestore' file='libvirt' module='libvirt'>
       <info>This method will restore a domain saved to disk by virDomainSave().</info>
@@ -1483,8 +1485,8 @@ see note above'/>
     </function>
     <function name='virNetworkRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the network. For each additional call to this method, there shall be a corresponding call to virNetworkFree to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a network would increment the reference count.</info>
-      <return type='int' info=''/>
-      <arg name='network' type='virNetworkPtr' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
+      <arg name='network' type='virNetworkPtr' info='the network to hold a reference on'/>
     </function>
     <function name='virNetworkSetAutostart' file='libvirt' module='libvirt'>
       <info>Configure the network to be automatically started when the host machine boots.</info>
@@ -1497,10 +1499,22 @@ see note above'/>
       <return type='int' info='0 in case of success, -1 in case of error'/>
       <arg name='network' type='virNetworkPtr' info='pointer to a defined network'/>
     </function>
+    <function name='virNodeDeviceCreateXML' file='libvirt' module='libvirt'>
+      <info>Create a new device on the VM host machine, for example, virtual HBAs created using vport_create.</info>
+      <return type='virNodeDevicePtr' info='a node device object if successful, NULL in case of failure'/>
+      <arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
+      <arg name='xmlDesc' type='const char *' info='string containing an XML description of the device to be created'/>
+      <arg name='flags' type='unsigned int' info='callers should always pass 0'/>
+    </function>
+    <function name='virNodeDeviceDestroy' file='libvirt' module='libvirt'>
+      <info>Destroy the device object. The virtual device is removed from the host operating system. This function may require privileged access</info>
+      <return type='int' info='0 in case of success and -1 in case of failure.'/>
+      <arg name='dev' type='virNodeDevicePtr' info='a device object'/>
+    </function>
     <function name='virNodeDeviceDettach' file='libvirt' module='libvirt'>
-      <info></info>
-      <return type='int' info=''/>
-      <arg name='dev' type='virNodeDevicePtr' info=''/>
+      <info>Dettach the node device from the node itself so that it may be assigned to a guest domain.  Depending on the hypervisor, this may involve operations such as unbinding any device drivers from the device, binding the device to a dummy device driver and resetting the device.  If the device is currently in use by the node, this method may fail.  Once the device is not assigned to any guest, it may be re-attached to the node using the virNodeDeviceReattach() method.</info>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
+      <arg name='dev' type='virNodeDevicePtr' info='pointer to the node device'/>
     </function>
     <function name='virNodeDeviceFree' file='libvirt' module='libvirt'>
       <info>Drops a reference to the node device, freeing it if this was the last reference.</info>
@@ -1543,17 +1557,17 @@ see note above'/>
     </function>
     <function name='virNodeDeviceReAttach' file='libvirt' module='libvirt'>
       <info>Re-attach a previously dettached node device to the node so that it may be used by the node again.  Depending on the hypervisor, this may involve operations such as resetting the device, unbinding it from a dummy device driver and binding it to its appropriate driver.  If the device is currently in use by a guest, this method may fail.</info>
-      <return type='int' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
       <arg name='dev' type='virNodeDevicePtr' info='pointer to the node device'/>
     </function>
     <function name='virNodeDeviceRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the dev. For each additional call to this method, there shall be a corresponding call to virNodeDeviceFree to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a dev would increment the reference count.</info>
-      <return type='int' info=''/>
-      <arg name='dev' type='virNodeDevicePtr' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
+      <arg name='dev' type='virNodeDevicePtr' info='the dev to hold a reference on'/>
     </function>
     <function name='virNodeDeviceReset' file='libvirt' module='libvirt'>
       <info>Reset a previously dettached node device to the node before or after assigning it to a guest.  The exact reset semantics depends on the hypervisor and device type but, for example, KVM will attempt to reset PCI devices with a Function Level Reset, Secondary Bus Reset or a Power Management D-State reset.  If the reset will affect other devices which are currently in use, this function may fail.</info>
-      <return type='int' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
       <arg name='dev' type='virNodeDevicePtr' info='pointer to the node device'/>
     </function>
     <function name='virNodeGetCellsFreeMemory' file='libvirt' module='libvirt'>
@@ -1735,8 +1749,8 @@ see note above'/>
     </function>
     <function name='virStoragePoolRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the pool. For each additional call to this method, there shall be a corresponding call to virStoragePoolFree to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a pool would increment the reference count.</info>
-      <return type='int' info=''/>
-      <arg name='pool' type='virStoragePoolPtr' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
+      <arg name='pool' type='virStoragePoolPtr' info='the pool to hold a reference on'/>
     </function>
     <function name='virStoragePoolRefresh' file='libvirt' module='libvirt'>
       <info>Request that the pool refresh its list of volumes. This may involve communicating with a remote server, and/or initializing new devices at the OS layer</info>
@@ -1825,8 +1839,8 @@ see note above'/>
     </function>
     <function name='virStorageVolRef' file='libvirt' module='libvirt'>
       <info>Increment the reference count on the vol. For each additional call to this method, there shall be a corresponding call to virStorageVolFree to release the reference count, once the caller no longer needs the reference to this object.  This method is typically useful for applications where multiple threads are using a connection, and it is required that the connection remain open until all threads have finished using it. ie, each new thread using a vol would increment the reference count.</info>
-      <return type='int' info=''/>
-      <arg name='vol' type='virStorageVolPtr' info=''/>
+      <return type='int' info='0 in case of success, -1 in case of failure.'/>
+      <arg name='vol' type='virStorageVolPtr' info='the vol to hold a reference on'/>
     </function>
   </symbols>
 </api>

docs/libvirt-refs.xml

@@ -334,6 +334,8 @@
     <reference name='virNetworkSetAutostart' href='html/libvirt-libvirt.html#virNetworkSetAutostart'/>
     <reference name='virNetworkUndefine' href='html/libvirt-libvirt.html#virNetworkUndefine'/>
     <reference name='virNodeDevice' href='html/libvirt-libvirt.html#virNodeDevice'/>
+    <reference name='virNodeDeviceCreateXML' href='html/libvirt-libvirt.html#virNodeDeviceCreateXML'/>
+    <reference name='virNodeDeviceDestroy' href='html/libvirt-libvirt.html#virNodeDeviceDestroy'/>
     <reference name='virNodeDeviceDettach' href='html/libvirt-libvirt.html#virNodeDeviceDettach'/>
     <reference name='virNodeDeviceFree' href='html/libvirt-libvirt.html#virNodeDeviceFree'/>
     <reference name='virNodeDeviceGetName' href='html/libvirt-libvirt.html#virNodeDeviceGetName'/>
@@ -760,6 +762,8 @@
       <ref name='virNetworkSetAutostart'/>
       <ref name='virNetworkUndefine'/>
       <ref name='virNodeDevice'/>
+      <ref name='virNodeDeviceCreateXML'/>
+      <ref name='virNodeDeviceDestroy'/>
       <ref name='virNodeDeviceDettach'/>
       <ref name='virNodeDeviceFree'/>
       <ref name='virNodeDeviceGetName'/>
@@ -888,6 +892,7 @@
       <ref name='virNetworkLookupByUUIDString'/>
     </type>
     <type name='virNodeDevicePtr'>
+      <ref name='virNodeDeviceCreateXML'/>
       <ref name='virNodeDeviceLookupByName'/>
     </type>
     <type name='virStoragePoolPtr'>
@@ -952,6 +957,7 @@
       <ref name='virDomainPinVcpu'/>
       <ref name='virDomainReboot'/>
       <ref name='virDomainSetVcpus'/>
+      <ref name='virNodeDeviceCreateXML'/>
       <ref name='virNodeDeviceGetXMLDesc'/>
       <ref name='virNodeListDevices'/>
       <ref name='virNodeNumOfDevices'/>
@@ -1035,6 +1041,7 @@
       <ref name='virNetworkLookupByName'/>
       <ref name='virNetworkLookupByUUID'/>
       <ref name='virNetworkLookupByUUIDString'/>
+      <ref name='virNodeDeviceCreateXML'/>
       <ref name='virNodeDeviceLookupByName'/>
       <ref name='virNodeGetCellsFreeMemory'/>
       <ref name='virNodeGetFreeMemory'/>
@@ -1158,6 +1165,7 @@
       <ref name='virNetworkUndefine'/>
     </type>
     <type name='virNodeDevicePtr'>
+      <ref name='virNodeDeviceDestroy'/>
       <ref name='virNodeDeviceDettach'/>
       <ref name='virNodeDeviceFree'/>
       <ref name='virNodeDeviceGetName'/>
@@ -1477,6 +1485,8 @@
       <ref name='virNetworkSetAutostart'/>
       <ref name='virNetworkUndefine'/>
       <ref name='virNodeDevice'/>
+      <ref name='virNodeDeviceCreateXML'/>
+      <ref name='virNodeDeviceDestroy'/>
       <ref name='virNodeDeviceDettach'/>
       <ref name='virNodeDeviceFree'/>
       <ref name='virNodeDeviceGetName'/>
@@ -1783,6 +1793,7 @@
           <ref name='virDomainAttachDevice'/>
           <ref name='virNetworkCreate'/>
           <ref name='virNetworkCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
           <ref name='virStoragePoolCreateXML'/>
           <ref name='virStorageVolCreateXML'/>
         </word>
@@ -1814,6 +1825,7 @@
           <ref name='virStorageVolDelete'/>
         </word>
         <word name='Depending'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virStorageVolGetPath'/>
         </word>
@@ -1824,8 +1836,12 @@
           <ref name='virDomainDestroy'/>
           <ref name='virDomainDetachDevice'/>
           <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
           <ref name='virStoragePoolDestroy'/>
         </word>
+        <word name='Dettach'>
+          <ref name='virNodeDeviceDettach'/>
+        </word>
         <word name='Divide'>
           <ref name='virNodeGetFreeMemory'/>
         </word>
@@ -1952,6 +1968,9 @@
         </word>
       </letter>
       <letter name='H'>
+        <word name='HBAs'>
+          <ref name='virNodeDeviceCreateXML'/>
+        </word>
         <word name='Hence'>
           <ref name='virDomainBlockPeek'/>
         </word>
@@ -2101,6 +2120,9 @@
           <ref name='virDomainGetVcpus'/>
           <ref name='virGetVersion'/>
         </word>
+        <word name='Once'>
+          <ref name='virNodeDeviceDettach'/>
+        </word>
         <word name='One'>
           <ref name='_virConnectCredential'/>
           <ref name='virConnCopyLastError'/>
@@ -2391,26 +2413,6 @@
         </word>
       </letter>
       <letter name='X'>
-        <word name='XML'>
-          <ref name='virConnectFindStoragePoolSources'/>
-          <ref name='virConnectGetCapabilities'/>
-          <ref name='virConnectGetMaxVcpus'/>
-          <ref name='virDomainAttachDevice'/>
-          <ref name='virDomainCreateLinux'/>
-          <ref name='virDomainCreateXML'/>
-          <ref name='virDomainDefineXML'/>
-          <ref name='virDomainDetachDevice'/>
-          <ref name='virDomainGetXMLDesc'/>
-          <ref name='virNetworkCreateXML'/>
-          <ref name='virNetworkDefineXML'/>
-          <ref name='virNetworkGetXMLDesc'/>
-          <ref name='virNodeDeviceGetXMLDesc'/>
-          <ref name='virStoragePoolCreateXML'/>
-          <ref name='virStoragePoolDefineXML'/>
-          <ref name='virStoragePoolGetXMLDesc'/>
-          <ref name='virStorageVolCreateXML'/>
-          <ref name='virStorageVolGetXMLDesc'/>
-        </word>
         <word name='Xen'>
           <ref name='_virDomainBlockStats'/>
           <ref name='virDomainCoreDump'/>
@@ -2453,6 +2455,7 @@
           <ref name='virDomainSuspend'/>
           <ref name='virGetLastError'/>
           <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
           <ref name='virResetLastError'/>
         </word>
         <word name='accessed'>
@@ -2586,6 +2589,7 @@
           <ref name='virDomainBlockPeek'/>
           <ref name='virDomainCreateLinux'/>
           <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='amount'>
           <ref name='virDomainGetMaxMemory'/>
@@ -2597,6 +2601,7 @@
           <ref name='virDomainCoreDump'/>
         </word>
         <word name='any'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virStoragePoolDestroy'/>
         </word>
         <word name='anymore'>
@@ -2672,6 +2677,7 @@
           <ref name='virStorageVolGetXMLDesc'/>
         </word>
         <word name='assigned'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virStorageVolGetPath'/>
         </word>
         <word name='assigning'>
@@ -2817,6 +2823,7 @@
           <ref name='virDomainMigrate'/>
         </word>
         <word name='binding'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
         </word>
         <word name='bindings'>
@@ -2937,6 +2944,7 @@
         <word name='callers'>
           <ref name='virDomainCreateLinux'/>
           <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='calling'>
           <ref name='virConnectDomainEventRegister'/>
@@ -3125,6 +3133,7 @@
           <ref name='virConnectFindStoragePoolSources'/>
           <ref name='virDomainCreateLinux'/>
           <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='contains'>
           <ref name='virStoragePoolLookupByVolume'/>
@@ -3221,6 +3230,9 @@
           <ref name='virNetworkDefineXML'/>
           <ref name='virStorageVolCreateXML'/>
         </word>
+        <word name='created'>
+          <ref name='virNodeDeviceCreateXML'/>
+        </word>
         <word name='creation'>
           <ref name='virStoragePoolCreateXML'/>
           <ref name='virStoragePoolDefineXML'/>
@@ -3237,6 +3249,7 @@
         </word>
         <word name='currently'>
           <ref name='virDomainCoreDump'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virNodeDeviceReset'/>
           <ref name='virStoragePoolRefresh'/>
@@ -3333,6 +3346,7 @@
           <ref name='virNetworkCreateXML'/>
           <ref name='virNetworkDefineXML'/>
           <ref name='virNetworkGetXMLDesc'/>
+          <ref name='virNodeDeviceCreateXML'/>
           <ref name='virStoragePoolCreateXML'/>
           <ref name='virStoragePoolDefineXML'/>
           <ref name='virStorageVolCreateXML'/>
@@ -3475,9 +3489,14 @@
           <ref name='virDomainMemoryPeek'/>
           <ref name='virDomainMigrate'/>
           <ref name='virGetVersion'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
         </word>
+        <word name='drivers'>
+          <ref name='virNodeDeviceDettach'/>
+        </word>
         <word name='dummy'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
         </word>
         <word name='dump'>
@@ -3582,6 +3601,7 @@
         <word name='example'>
           <ref name='virDomainBlockStats'/>
           <ref name='virDomainMigrate'/>
+          <ref name='virNodeDeviceCreateXML'/>
           <ref name='virNodeDeviceReset'/>
         </word>
         <word name='execution'>
@@ -3634,6 +3654,7 @@
         </word>
         <word name='fail'>
           <ref name='virDomainSetVcpus'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virNodeDeviceReset'/>
         </word>
@@ -3838,6 +3859,8 @@
           <ref name='virDomainResume'/>
           <ref name='virEventHandleCallback'/>
           <ref name='virNetworkCreate'/>
+          <ref name='virNodeDeviceDestroy'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virStorageVolDelete'/>
           <ref name='virStorageVolGetKey'/>
@@ -3930,6 +3953,7 @@
           <ref name='virDomainGetMaxVcpus'/>
           <ref name='virDomainReboot'/>
           <ref name='virDomainShutdown'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virNodeDeviceReset'/>
         </word>
@@ -3995,6 +4019,11 @@
         </word>
         <word name='hold'>
           <ref name='virConnectRef'/>
+          <ref name='virDomainRef'/>
+          <ref name='virNetworkRef'/>
+          <ref name='virNodeDeviceRef'/>
+          <ref name='virStoragePoolRef'/>
+          <ref name='virStorageVolRef'/>
         </word>
         <word name='host'>
           <ref name='VIR_NODEINFO_MAXCPUS'/>
@@ -4005,6 +4034,8 @@
           <ref name='virDomainSetAutostart'/>
           <ref name='virNetworkGetAutostart'/>
           <ref name='virNetworkSetAutostart'/>
+          <ref name='virNodeDeviceCreateXML'/>
+          <ref name='virNodeDeviceDestroy'/>
           <ref name='virStoragePoolCreateXML'/>
           <ref name='virStoragePoolDestroy'/>
           <ref name='virStoragePoolFree'/>
@@ -4197,6 +4228,7 @@
           <ref name='virEventRemoveTimeoutFunc'/>
         </word>
         <word name='involve'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virStoragePoolRefresh'/>
         </word>
@@ -4229,6 +4261,7 @@
           <ref name='virStorageVolLookupByPath'/>
         </word>
         <word name='itself'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virStoragePoolDelete'/>
         </word>
       </letter>
@@ -4482,6 +4515,7 @@
           <ref name='virDomainSetAutostart'/>
           <ref name='virNetworkGetAutostart'/>
           <ref name='virNetworkSetAutostart'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='macro'>
           <ref name='VIR_COPY_CPUMAP'/>
@@ -4584,6 +4618,7 @@
           <ref name='virDomainRestore'/>
           <ref name='virDomainSave'/>
           <ref name='virNetworkRef'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virNodeDeviceRef'/>
           <ref name='virStoragePoolGetXMLDesc'/>
@@ -4750,6 +4785,8 @@
         </word>
         <word name='node'>
           <ref name='_virNodeInfo'/>
+          <ref name='virNodeDeviceCreateXML'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceFree'/>
           <ref name='virNodeDeviceGetXMLDesc'/>
           <ref name='virNodeDeviceLookupByName'/>
@@ -4880,6 +4917,9 @@
           <ref name='virStoragePoolRef'/>
           <ref name='virStorageVolRef'/>
         </word>
+        <word name='operating'>
+          <ref name='virNodeDeviceDestroy'/>
+        </word>
         <word name='operation'>
           <ref name='virDomainGetOSType'/>
           <ref name='virDomainGetSecurityLabel'/>
@@ -4888,6 +4928,7 @@
           <ref name='virStoragePoolDelete'/>
         </word>
         <word name='operations'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
         </word>
         <word name='option'>
@@ -4997,6 +5038,7 @@
           <ref name='virDomainCreateXML'/>
           <ref name='virEventAddHandleFunc'/>
           <ref name='virEventAddTimeoutFunc'/>
+          <ref name='virNodeDeviceCreateXML'/>
           <ref name='virNodeDeviceGetXMLDesc'/>
           <ref name='virNodeListDevices'/>
           <ref name='virNodeNumOfDevices'/>
@@ -5115,6 +5157,7 @@
           <ref name='virDomainSetVcpus'/>
           <ref name='virDomainSuspend'/>
           <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
         </word>
         <word name='problem'>
           <ref name='virDomainSave'/>
@@ -5196,6 +5239,9 @@
           <ref name='virDomainLookupByUUID'/>
           <ref name='virNetworkLookupByUUID'/>
         </word>
+        <word name='re-attached'>
+          <ref name='virNodeDeviceDettach'/>
+        </word>
         <word name='reactivate'>
           <ref name='virDomainSuspend'/>
         </word>
@@ -5302,6 +5348,9 @@
         <word name='remove'>
           <ref name='virEventRemoveTimeoutFunc'/>
         </word>
+        <word name='removed'>
+          <ref name='virNodeDeviceDestroy'/>
+        </word>
         <word name='removes'>
           <ref name='virEventRemoveTimeoutFunc'/>
         </word>
@@ -5337,6 +5386,7 @@
         <word name='require'>
           <ref name='virDomainDestroy'/>
           <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
         </word>
         <word name='required'>
           <ref name='VIR_CPU_MAPLEN'/>
@@ -5374,6 +5424,7 @@
           <ref name='virSetErrorFunc'/>
         </word>
         <word name='resetting'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virResetLastError'/>
         </word>
@@ -5603,6 +5654,7 @@
           <ref name='virDomainShutdown'/>
           <ref name='virNetworkFree'/>
           <ref name='virNetworkSetAutostart'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='show'>
           <ref name='_virConnectCredential'/>
@@ -5792,6 +5844,7 @@
           <ref name='virNetworkGetName'/>
           <ref name='virNetworkGetUUIDString'/>
           <ref name='virNetworkLookupByUUIDString'/>
+          <ref name='virNodeDeviceCreateXML'/>
           <ref name='virStoragePoolGetUUIDString'/>
         </word>
         <word name='structure'>
@@ -5816,10 +5869,12 @@
         <word name='successful'>
           <ref name='virDomainMigrate'/>
           <ref name='virDomainSave'/>
+          <ref name='virNodeDeviceCreateXML'/>
         </word>
         <word name='such'>
           <ref name='virConnCopyLastError'/>
           <ref name='virConnGetLastError'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virStoragePoolGetInfo'/>
           <ref name='virStorageVolGetInfo'/>
@@ -5872,6 +5927,7 @@
           <ref name='virDomainGetOSType'/>
           <ref name='virDomainGetVcpus'/>
           <ref name='virDomainPinVcpu'/>
+          <ref name='virNodeDeviceDestroy'/>
         </word>
       </letter>
     </chunk>
@@ -6067,6 +6123,7 @@
       </letter>
       <letter name='u'>
         <word name='unbinding'>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
         </word>
         <word name='undefined'>
@@ -6172,6 +6229,7 @@
           <ref name='virDomainGetConnect'/>
           <ref name='virErrorFunc'/>
           <ref name='virNetworkGetConnect'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceReAttach'/>
           <ref name='virNodeDeviceReset'/>
           <ref name='virStoragePoolBuild'/>
@@ -6250,6 +6308,8 @@
           <ref name='virConnectRef'/>
           <ref name='virDomainRef'/>
           <ref name='virNetworkRef'/>
+          <ref name='virNodeDeviceCreateXML'/>
+          <ref name='virNodeDeviceDettach'/>
           <ref name='virNodeDeviceRef'/>
           <ref name='virStoragePoolRef'/>
           <ref name='virStorageVolRef'/>
@@ -6444,6 +6504,9 @@
         <word name='virNodeDevicePtr'>
           <ref name='virNodeDeviceLookupByName'/>
         </word>
+        <word name='virNodeDeviceReattach'>
+          <ref name='virNodeDeviceDettach'/>
+        </word>
         <word name='virNodeInfo'>
           <ref name='nodeinfo'/>
           <ref name='virNodeGetInfo'/>
@@ -6516,6 +6579,8 @@
           <ref name='virDomainPinVcpu'/>
           <ref name='virDomainSetVcpus'/>
           <ref name='virNetworkCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
+          <ref name='virNodeDeviceDestroy'/>
         </word>
         <word name='virtualization'>
           <ref name='virDomainGetVcpus'/>
@@ -6534,6 +6599,9 @@
           <ref name='virStoragePoolRefresh'/>
           <ref name='virStorageVolCreateXML'/>
         </word>
+        <word name='vport_create'>
+          <ref name='virNodeDeviceCreateXML'/>
+        </word>
       </letter>
       <letter name='w'>
         <word name='want'>

docs/news.html

@@ -76,6 +76,32 @@
         <p>Here is the list of official releases, however since it is early on in the
 development of libvirt, it is preferable when possible to just use the <a href="downloads.html">CVS version or snapshot</a>, contact the mailing list
 and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
+        <h3>0.6.3: Apr 24 2009</h3>
+        <ul><li>New features: VirtualBox driver support (Pritesh Kothari),
+          virt-xml-validate new command (Daniel Berrange)</li><li>Portability: patch to build on Centos (Joseph Shraibman),
+          build breakage (Anton Protopopov), </li><li>Documentation: Linux Containers documentation (Serge Hallyn),
+          improvement and updates of architecture pages, fix
+          virNodeGetFreeMemory documentation to reflect reality,
+          man page cleanups (Daniel Berrange), man page typo
+          (Robert P. J. Day), VirtualBox Documentation (Pritesh Kothari),
+          </li><li>Bug fixes: veth off-by-one error (Dan Smith), vcpupin to inactive
+          Xen crash (Takahashi Tomohiro), virsh ttyconsole return value,
+          use format= not fmt= on QEmu commandline (Mark McLoughlin),
+          use UUID for internal domain lookups (Daniel Berrange), remote
+          domain ID related bugs (Daniel Berrange), QEmu pidfile handling
+          bugs (Daniel Berrange), network config handling on old Xen (Daniel
+          Berrange)</li><li>Improvements: add SCSI storage rescan (David Allan), rootless
+          LXC containers support improvements (Serge Hallyn), getHostname
+          support for LXC (Dan Smith), cleanup and logging output of some
+          domain functions (Guido Gnther), drop pool lock when allocating
+          volumes (Cole Robinson), LXC handle kernel without CLONE_NEWUSER
+          support (Serge Hallyn), cpu pinning on defined Xen domains (Takahashi
+          Tomohiro), dynamic bridge names support (Soren Hansen), LXC use
+          of private /dev/pts when available (Daniel Berrange),
+          virNodeDeviceCreateXML and virNodeDeviceDestroy entry points
+          (Dave Allan)</li><li>Cleanups: don't hardcode getgrnam_r buffer to 1024 bytes (Guido
+          Gnther), qemudBuildCommandLine API cleanup (Daniel Berrange),
+          </li></ul>
         <h3>0.6.2: Apr  3 2009</h3>
         <ul><li>New features: support SASL auth for VNC server (Daniel Berrange),
           memory ballooning in QEMU (Daniel Berrange), SCSI HBA storage pool

docs/news.html.in

@@ -5,6 +5,39 @@
     <p>Here is the list of official releases, however since it is early on in the
 development of libvirt, it is preferable when possible to just use the <a href="downloads.html">CVS version or snapshot</a>, contact the mailing list
 and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
+    <h3>0.6.3: Apr 24 2009</h3>
+    <ul>
+      <li>New features: VirtualBox driver support (Pritesh Kothari),
+          virt-xml-validate new command (Daniel Berrange)</li>
+      <li>Portability: patch to build on Centos (Joseph Shraibman),
+          build breakage (Anton Protopopov), </li>
+      <li>Documentation: Linux Containers documentation (Serge Hallyn),
+          improvement and updates of architecture pages, fix
+          virNodeGetFreeMemory documentation to reflect reality,
+          man page cleanups (Daniel Berrange), man page typo
+          (Robert P. J. Day), VirtualBox Documentation (Pritesh Kothari),
+          </li>
+      <li>Bug fixes: veth off-by-one error (Dan Smith), vcpupin to inactive
+          Xen crash (Takahashi Tomohiro), virsh ttyconsole return value,
+          use format= not fmt= on QEmu commandline (Mark McLoughlin),
+          use UUID for internal domain lookups (Daniel Berrange), remote
+          domain ID related bugs (Daniel Berrange), QEmu pidfile handling
+          bugs (Daniel Berrange), network config handling on old Xen (Daniel
+          Berrange)</li>
+      <li>Improvements: add SCSI storage rescan (David Allan), rootless
+          LXC containers support improvements (Serge Hallyn), getHostname
+          support for LXC (Dan Smith), cleanup and logging output of some
+          domain functions (Guido Günther), drop pool lock when allocating
+          volumes (Cole Robinson), LXC handle kernel without CLONE_NEWUSER
+          support (Serge Hallyn), cpu pinning on defined Xen domains (Takahashi
+          Tomohiro), dynamic bridge names support (Soren Hansen), LXC use
+          of private /dev/pts when available (Daniel Berrange),
+          virNodeDeviceCreateXML and virNodeDeviceDestroy entry points
+          (Dave Allan)</li>
+      <li>Cleanups: don't hardcode getgrnam_r buffer to 1024 bytes (Guido
+          Günther), qemudBuildCommandLine API cleanup (Daniel Berrange),
+          </li>
+    </ul>
     <h3>0.6.2: Apr  3 2009</h3>
     <ul>
       <li>New features: support SASL auth for VNC server (Daniel Berrange),

include/libvirt/libvirt.h

@@ -442,7 +442,7 @@ extern virConnectAuthPtr virConnectAuthPtrDefault;
  * version * 1,000,000 + minor * 1000 + micro
  */
 
-#define LIBVIR_VERSION_NUMBER 6002
+#define LIBVIR_VERSION_NUMBER 6003
 
 int                     virGetVersion           (unsigned long *libVer,
                                                  const char *type,

libvirt.spec.in

@@ -506,6 +506,10 @@ fi
 %endif
 
 %changelog
+* Fri Apr 24 2009 Daniel Veillard <veillard@redhat.com> - 0.6.3-1
+- release of 0.6.3
+- VirtualBox driver
+
 * Fri Apr  3 2009 Daniel Veillard <veillard@redhat.com> - 0.6.2-1
 - release of 0.6.2
 

src/libvirt.c

@@ -1151,6 +1151,8 @@ virConnectClose(virConnectPtr conn)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a connection would increment
  * the reference count.
+ *
+ * Returns 0 in case of success, -1 in case of failure
  */
 int
 virConnectRef(virConnectPtr conn)
@@ -1816,7 +1818,7 @@ virDomainFree(virDomainPtr domain)
 
 /**
  * virDomainRef:
- * @conn: the domain to hold a reference on
+ * @domain: the domain to hold a reference on
  *
  * Increment the reference count on the domain. For each
  * additional call to this method, there shall be a corresponding
@@ -1828,6 +1830,8 @@ virDomainFree(virDomainPtr domain)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a domain would increment
  * the reference count.
+ *
+ * Returns 0 in case of success and -1 in case of failure.
  */
 int
 virDomainRef(virDomainPtr domain)
@@ -4967,7 +4971,7 @@ virNetworkFree(virNetworkPtr network)
 
 /**
  * virNetworkRef:
- * @conn: the network to hold a reference on
+ * @network: the network to hold a reference on
  *
  * Increment the reference count on the network. For each
  * additional call to this method, there shall be a corresponding
@@ -4979,6 +4983,8 @@ virNetworkFree(virNetworkPtr network)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a network would increment
  * the reference count.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virNetworkRef(virNetworkPtr network)
@@ -6051,7 +6057,7 @@ virStoragePoolFree(virStoragePoolPtr pool)
 
 /**
  * virStoragePoolRef:
- * @conn: the pool to hold a reference on
+ * @pool: the pool to hold a reference on
  *
  * Increment the reference count on the pool. For each
  * additional call to this method, there shall be a corresponding
@@ -6063,6 +6069,8 @@ virStoragePoolFree(virStoragePoolPtr pool)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a pool would increment
  * the reference count.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virStoragePoolRef(virStoragePoolPtr pool)
@@ -6832,7 +6840,7 @@ virStorageVolFree(virStorageVolPtr vol)
 
 /**
  * virStorageVolRef:
- * @conn: the vol to hold a reference on
+ * @vol: the vol to hold a reference on
  *
  * Increment the reference count on the vol. For each
  * additional call to this method, there shall be a corresponding
@@ -6844,6 +6852,8 @@ virStorageVolFree(virStorageVolPtr vol)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a vol would increment
  * the reference count.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virStorageVolRef(virStorageVolPtr vol)
@@ -7334,7 +7344,7 @@ int virNodeDeviceFree(virNodeDevicePtr dev)
 
 /**
  * virNodeDeviceRef:
- * @conn: the dev to hold a reference on
+ * @dev: the dev to hold a reference on
  *
  * Increment the reference count on the dev. For each
  * additional call to this method, there shall be a corresponding
@@ -7346,6 +7356,8 @@ int virNodeDeviceFree(virNodeDevicePtr dev)
  * connection remain open until all threads have finished using
  * it. ie, each new thread using a dev would increment
  * the reference count.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virNodeDeviceRef(virNodeDevicePtr dev)
@@ -7362,7 +7374,7 @@ virNodeDeviceRef(virNodeDevicePtr dev)
 }
 
 /**
- * virNodeDeviceAttach:
+ * virNodeDeviceDettach:
  * @dev: pointer to the node device
  *
  * Dettach the node device from the node itself so that it may be
@@ -7377,6 +7389,8 @@ virNodeDeviceRef(virNodeDevicePtr dev)
  *
  * Once the device is not assigned to any guest, it may be re-attached
  * to the node using the virNodeDeviceReattach() method.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virNodeDeviceDettach(virNodeDevicePtr dev)
@@ -7418,6 +7432,8 @@ error:
  * and binding it to its appropriate driver.
  *
  * If the device is currently in use by a guest, this method may fail.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virNodeDeviceReAttach(virNodeDevicePtr dev)
@@ -7461,6 +7477,8 @@ error:
  *
  * If the reset will affect other devices which are currently in use,
  * this function may fail.
+ *
+ * Returns 0 in case of success, -1 in case of failure.
  */
 int
 virNodeDeviceReset(virNodeDevicePtr dev)

src/virterror.c

@@ -177,6 +177,13 @@ virLastErrFreeData(void *data)
 }
 
 
+/**
+ * virErrorInitialize:
+ *
+ * Initialize the error data (per thread)
+ *
+ * Returns 0 in case of success, -1 in case of failure.
+ */
 int
 virErrorInitialize(void)
 {
@@ -534,7 +541,8 @@ virDefaultErrorFunc(virErrorPtr err)
                 dom, lvl, domain, network, err->message);
 }
 
-/*
+/**
+ * virSetGlobalError:
  * Internal helper to ensure the global error object
  * is initialized with a generic message if not already
  * set.
@@ -548,7 +556,10 @@ virSetGlobalError(void)
         virErrorGenericFailure(err);
 }
 
-/*
+/**
+ * virSetConnError:
+ * @conn: pointer to the hypervisor connection
+ *
  * Internal helper to ensure the connection error object
  * is initialized from the global object.
  */