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
Add virNodeDeviceCreateXML / virNodeDeviceDestroy boilerplate public API and remote protocol impl
2025-08-18 13:50:02 +03:00 · 2009-04-24 14:04:54 +00:00 · 2009-04-24 13:11:23 +00:00 · 2009-04-24 12:19:00 +00:00 · 2009-04-24 12:17:50 +00:00 · 2009-04-24 10:09:24 +00:00
248 changed files with 90578 additions and 78677 deletions
--- a/.hgignore
+++ b/.hgignore
@ -46,12 +46,19 @@ docs/examples/info1
 docs/examples/python/Makefile
 docs/examples/python/Makefile.in
 docs/examples/suspend
+docs/schemas/Makefile
+docs/schemas/Makefile.in
 examples/domain-events/events-c/*.exe
 examples/domain-events/events-c/.deps
 examples/domain-events/events-c/.libs
 examples/domain-events/events-c/Makefile
 examples/domain-events/events-c/Makefile.in
 examples/domain-events/events-c/event-test
+examples/hellolibvirt/.deps
+examples/hellolibvirt/.libs
+examples/hellolibvirt/Makefile
+examples/hellolibvirt/Makefile.in
+examples/hellolibvirt/hellolibvirt
 gnulib/lib/*.la
 gnulib/lib/*.lo
 gnulib/lib/.deps
@ -260,6 +267,7 @@ tests/qemuxml2argvtest
 tests/qemuxml2xmltest
 tests/qparamtest
 tests/reconnect
+tests/seclabeltest
 tests/sexpr2xmldata/Makefile
 tests/sexpr2xmldata/Makefile.in
 tests/sexpr2xmltest
@ -274,4 +282,8 @@ tests/xmconfigtest
 tests/xml2sexprdata/Makefile
 tests/xml2sexprdata/Makefile.in
 tests/xml2sexprtest
+tools/Makefile
+tools/Makefile.in
+tools/virt-xml-validate
+tools/virt-xml-validate.1
 update.log
--- a/2
+++ b/2
@ -68,6 +68,8 @@ Patches have also been contributed by:
  Amit Shah            <amit.shah@redhat.com>
  Florian Vichot       <florian.vichot@diateam.net>
  Takahashi Tomohiro   <takatom@jp.fujitsu.com>
+  Serge E. Hallyn      <serue@us.ibm.com>
+  Soren Hansen         <soren@canonical.com>

  [....send patches to get your name here....]

--- a/284
+++ b/284
@ -1,3 +1,287 @@
+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
+	public API and remote protocol impl
+	* include/libvirt/libvirt.h, include/libvirt/libvirt.h.in,
+	 src/libvirt_public.syms: Public API definition of new
+	virNodeDeviceCreateXML and virNodeDeviceDestroy methods
+	* qemud/remote.c: Dispatch code for new APIs
+	* qemud/remote_dispatch_args.h, qemud/remote_dispatch_prototypes.h,
+	qemud/remote_dispatch_ret.h, qemud/remote_dispatch_table.h:
+	Re-generate stubs for dispatcher
+	* qemud/remote_protocol.x: Define wire protocol for node
+	device create / destroy APIs
+	* qemud/remote_protocol.c, qemud/remote_protocol.h:
+	Re-generate based off protocol additions
+	* src/driver.h: Define internal driver API contract for
+	new public APIs
+	* src/libvirt.c: Wire up public API to driver API for
+	virNodeDeviceCreateXML/virNodeDeviceDestroy
+	* src/remote_internal.c: Client for new node device methods
+
+Fri Apr 24 13:19:47 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/libvirt_private.syms: Add virDomainHostdevDefFree needed
+	by Xen driver when built as a module.
+
+Fri Apr 24 13:17:47 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	Fix network config in XM driver
+	* src/xm_internal.c: Fix setting of bridge & script parameters
+	in VIF config
+	* src/xend_internal.h, src/xend_internal.c: Export the 
+	default bridge script name to XM driver
+	* tests/xmconfigdata/*: Update to take account of script=
+	setting in VIF config
+
+Fri Apr 24 12:06:47 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* po/*: updated a could of locale, regenerated
+	* docs/libvirt-api.xml docs/libvirt-refs.xml: regenerated too
+
+Wed Apr 22 15:28:03 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/network_driver.c: Explicit check for NULL, to avoid
+	compiler complaining about "assignment treated as truth value
+	in conditional".
+
+Wed Apr 22 15:27:03 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	Use private /dev/pts instance for containers (needs 'newinstance'
+	mount flag for devpts since 2.6.29 kernels), fallback to shared
+	instance if not supported
+	* src/domain_conf.h, src/domain_conf.c: Add a convenient
+	routine virDomainGetRootFilesystem()
+	* src/libvirt_private.sym: export virDomainGetRootFilesystem
+	to drivers
+	* src/util.c, src/util.h: Add virFileOpenTtyAt() to allow
+	alternate path to /dev/ptmx to be given
+	* src/lxc_controller.c: Attempt to setup a private /dev/pts
+	instance for the container's stdio I/O
+	* src/lxc_container.h, src/lxc_container.c: Pull in the
+	private /dev/pts instance setup by controller, and create
+	a symlink for /dev/ptmx.
+
+Tue Apr 21 20:14:03 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/qemu_driver.c: Remove pidfile when domain shuts down and
+	cleanup stale pidfile before domain startup.
+
+Tue Apr 21 14:39:03 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* po/POTFILES.in: Add vbox_tmpl.c file
+	* src/vbox/vbox_tmpl.c: Adjust domain IDs to start from 1
+	instead of 0, refuse domain ID 0.
+
+Tue Apr 21 20:58:50 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/network_conf.c src/network_conf.h: add dynamic bridge names
+	  support, patch by Soren Hansen
+	* AUTHORS: add Soren
+
+Tue Apr 21 17:08:57 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/xend_internal.c: let xend try vcpu pinning operation even
+	  if the domain is not running, patch by Takahashi Tomohiro
+
+Tue Apr 21 15:38:29 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* docs/drvvbox.html.in docs/drvvbox.html: tiny fixes to VirtualBox
+	  docs
+
+Tue Apr 21 14:22:03 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* docs/drvvbox.html.in docs/hvsupport.html.in docs/drivers.html.in
+	  docs/sitemap.html.in docs/*.html: VirtualBox Documentation by
+	  Pritesh Kothari
+
+Mon Apr 20 14:25:41 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/lxc_container.c src/lxc_container.h: cope with kernels
+	  where CLONE_NEWUSER is not supported, patch by Serge Hallyn
+
+Mon Apr 20 12:54:02 GMT 2009 Mark McLoughlin <markmc@redhat.com>
+
+	* docs/virsh.pod, virsh.1: fix typo reported by Robert P. J. Day
+
+Mon Apr 20 11:24:23 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* po/*: merge in a lot of localization updates and regenerate
+
+Mon Apr 20 11:06:20 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/bridge.c: fix a compilation breakage raised by Anton Protopopov
+
+Sun Apr 19 17:46:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* mingw32-libvirt.spec.in: Added new virt-xml-validate tool
+	missed from previous commit
+
+Sun Apr 19 17:36:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* autobuild.sh, mingw32-libvirt.spec.in: Disable vbox driver
+	for Win32 builds
+
+Sun Apr 19 17:36:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/Makefile.am: Add another vbox file to EXTRA_DIST
+
+Sun Apr 19 16:49:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/virterror.c: Add missing 'break' in error code string
+	formatter.
+
+Sun Apr 19 16:29:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	Improve error reporting for lookup failures on inactive domains
+	* src/qemu_driver.c: Do all domain lookups based on UUID and
+	use correct error code for missing domains.
+
+Sun Apr 19 16:19:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	Fix 2 domain ID handling bugs in remote driver
+	* src/remote_internal.c: Add virDomainCreate(), do a lookup
+	to find the ID of newly created domain. Reset ID to -1 after
+	doing a destroy operation on a domain
+
+Sun Apr 19 16:14:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/domain_conf.c: Switch over todo domain lookup based
+	on UUID in virDomainAssignDef
+
+Sun Apr 19 16:14:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* docs/libvirt-api.xml, docs/libvirt-refs.xml,
+	docs/devhelp/libvirt-libvirt.html, docs/devhelp/libvirt-virterror.html,
+	docs/html/libvirt-libvirt.html, docs/html/libvirt-virterror.html:
+	Regenerate API docs to pull in latest VBox error code definitions
+
+Sun Apr 19 16:12:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/Makefile.am: Add 2 missing vbox files to EXTRA_DIST
+
+Sun Apr 19 16:00:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	Add command line tool for validating XML and improve POD docs
+	for virsh
+	* Makefile.am, configure.in: Add tools/ sub-directory
+	* docs/virsh.pod, docs/Makefile.am, virsh.1: Fix misc errors
+	in POD formating, and improve licensing/copyright/bugs section
+	* libvirt.spec.in: Add virt-xml-validate tool & man page
+	* tools/virt-xml-validate.in, tools/Makefile.am: Add tool for
+	validating XML files against schemas
+	* .hgignore, tools/.gitignore, tools/.cvsignore, m4/.gitignore:
+	Update to ignore more generated files
+
+Sun Apr 19 15:44:22 BST 2009 Daniel P. Berrange <berrange@redhat.com>
+
+	* src/qemu_conf.c, src/qemu_conf.h: Pass in virDomainDefPtr to
+	qemudBuildCommandLine, instead of virDomainObjPtr
+	* src/qemu_driver.c, tests/qemuxml2argvtest.c: Update for above
+	API change.
+
+Fri Apr 17 21:10:28 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/libvirt_private.syms src/storage_backend.h
+	  src/storage_backend_fs.c src/storage_conf.h src/storage_driver.c:
+	  drop the pool lock when allocating fs volumes, patch by Cole Robinson
+
+Fri Apr 17 18:05:52 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* configure.in include/libvirt/virterror.h src/Makefile.am
+	  src/domain_conf.[ch] src/driver.h src/virterror.c src/vbox/README
+	  src/vbox/vbox_CAPI_v2_2.h src/vbox/vbox_V2_2.c
+	  src/vbox/vbox_XPCOMCGlue.[ch] src/vbox/vbox_driver.[ch]
+	  src/vbox/vbox_tmpl.c: integration of the VirtualBox support
+	  patches by Pritesh Kothari
+
+Fri Apr 17 17:32:16 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/libvirt.c: fix the doc of virNodeGetFreeMemory to say bytes
+	* docs/drvlxc.html.in docs/drvlxc.html: fix command used in examples
+
+Thu Apr 16 17:48:30 CEST 2009 Guido Günther <agx@sigxcpu.org>
+
+	* src/qemu_driver.c (qemudMonitorCommandExtra): don't log monitor
+	  output to domain log file. It's logged via the logging system
+	  already.
+	  (qemudDomainGetMemoryBalloon, qemudDomainSave,
+	   qemudDomainChangeEjectableMedia, qemudDomainAttachPciDiskDevice,
+	   qemudDomainAttachUsbMassstorageDevice, qemudDomainAttachHostDevice,
+	   qemudDomainDetachPciDiskDevice, qemudDomainBlockStats,
+	   qemudDomainMemoryPeek, qemudDomainMigratePerform): prefix monitor
+	   debug output with vm name.
+
+Thu Apr 16 16:48:51 CEST 2009 Guido Günther <agx@sigxcpu.org>
+
+	* src/qemud.c (remoteReadConfigFile): don't hardcode buffer for
+	  getgrnam_r to 1024 bytes and increase it on ERANGE.
+
+Thu Apr 16 15:20:02 GMT 2009 Mark McLoughlin <markmc@redhat.com>
+
+	* src/qemu_conf.c: pass "format=" to qemu -drive rather
+	than "fmt="
+
+	* tests/qemuxml2argvdata/*: fix test cases.
+
+Thu Apr 16 14:05:28 GMT 2009 Mark McLoughlin <markmc@redhat.com>
+
+	* src/lxc_container.c: syntax-check fixes
+
+Wed Apr 15 22:40:50 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* docs/Makefile.am docs/api.html docs/api.html.in docs/archdomain.html
+	 docs/archnetwork.html docs/archnode.html docs/archstorage.html
+	 docs/goals.html docs/intro.html
+	 docs/libvirt-daemon-arch.fig docs/libvirt-daemon-arch.png
+	 docs/libvirt-driver-arch.fig docs/libvirt-driver-arch.png
+	 docs/libvirt-object-model.fig docs/libvirt-object-model.png
+	 docs/page.xsl docs/sitemap.html docs/sitemap.html.in:
+	 adding a new api page, extending the stylesheet to allow references
+	 and including images from Dan Berrange
+
+Wed Apr 15 22:08:12 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/virsh.c: fix for virsh ttyconsole return value bug #495954
+
+Wed Apr 15 21:59:09 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn
+
+Wed Apr 15 11:52:15 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/xm_internal.c: fix a crash on vcpupin to inactive Xen domains,
+	  as raised by Takahashi Tomohiro
+
+Wed Apr 15 11:33:33 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/lxc_driver.c: adds the getHostname method to the lxc driver
+	  patch by Dan Smith
+
+Tue Apr 14 10:46:44 PDT 2009 Dan Smith <danms@us.ibm.com>
+
+	* src/veth.c: Fix veth off-by-one error
+	  patch by Serge Hallyn
+	* src/lxc_container.c: Stop rootless containers from messing with
+	  system mounts.  Also, make pivot_root code more robust.
+	  patch by Serge Hallyn
+
+Tue Apr 14 14:46:29 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* libvirt.spec.in: fix build on RHEL and Centos 5.x, patch
+	  by Joseph Shraibman, fixes #495610
+
+Tue Apr  7 14:48:35 CEST 2009 Daniel Veillard <veillard@redhat.com>
+
+	* src/storage_backend_scsi.[ch]: add SCSI storage rescan support,
+	  patch by David Allan
+
 Fri Apr  3 16:47:22 CEST 2009 Daniel Veillard <veillard@redhat.com>

 	* configure.in libvirt.spec.in NEWS docs/*: release of 0.6.2
--- a/Makefile.am
+++ b/Makefile.am
@ -3,7 +3,7 @@
 LCOV = lcov
 GENHTML = genhtml

-SUBDIRS = gnulib/lib include src qemud proxy docs gnulib/tests \
+SUBDIRS = gnulib/lib include src qemud tools proxy docs gnulib/tests \
  python tests po examples/domain-events/events-c examples/hellolibvirt

 ACLOCAL_AMFLAGS = -I m4 -I gnulib/m4
--- a/33
+++ b/33
@ -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 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)
+   - Cleanups: don't hardcode getgrnam_r buffer to 1024 bytes (Guido
+          G<>nther), 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
--- a/autobuild.sh
+++ b/autobuild.sh
@ -74,6 +74,7 @@ if [ -x /usr/bin/i686-pc-mingw32-gcc ]; then
    --without-qemu \
    --without-lxc \
    --without-uml \
+    --without-vbox \
    --without-openvz \
    --without-libvirtd

--- a/configure.in
+++ b/configure.in
@ -1,6 +1,6 @@
 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])
@ -182,6 +182,8 @@ AC_ARG_WITH([uml],
 [  --with-uml              add UML support (on)],[],[with_uml=yes])
 AC_ARG_WITH([openvz],
 [  --with-openvz           add OpenVZ support (on)],[],[with_openvz=yes])
+AC_ARG_WITH([vbox],
+[  --with-vbox             add VirtualBox support (on)],[],[with_vbox=yes])
 AC_ARG_WITH([lxc],
 [  --with-lxc              add Linux Container support (on)],[],[with_lxc=yes])
 AC_ARG_WITH([test],
@ -277,6 +279,11 @@ if test "$with_openvz" = "yes"; then
 fi
 AM_CONDITIONAL([WITH_OPENVZ], [test "$with_openvz" = "yes"])

+if test "x$with_vbox" = "xyes"; then
+    AC_DEFINE_UNQUOTED([WITH_VBOX], 1, [whether VirtualBox driver is enabled])
+fi
+AM_CONDITIONAL([WITH_VBOX], [test "$with_vbox" = "yes"])
+
 if test "$with_libvirtd" = "no" ; then
  with_lxc=no
 fi
@ -1342,6 +1349,7 @@ AC_OUTPUT(Makefile src/Makefile include/Makefile docs/Makefile \
 	  include/libvirt/Makefile include/libvirt/libvirt.h \
 	  python/Makefile python/tests/Makefile \
          qemud/Makefile \
+          tools/Makefile \
          tests/Makefile proxy/Makefile \
          tests/xml2sexprdata/Makefile \
          tests/sexpr2xmldata/Makefile \
@ -1362,6 +1370,7 @@ AC_MSG_NOTICE([   Proxy: $with_xen_proxy])
 AC_MSG_NOTICE([    QEMU: $with_qemu])
 AC_MSG_NOTICE([     UML: $with_uml])
 AC_MSG_NOTICE([  OpenVZ: $with_openvz])
+AC_MSG_NOTICE([    VBox: $with_vbox])
 AC_MSG_NOTICE([     LXC: $with_lxc])
 AC_MSG_NOTICE([    Test: $with_test])
 AC_MSG_NOTICE([  Remote: $with_remote])
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@ -29,6 +29,9 @@ png = \
  libvirtLogo.png \
  libvirt-net-logical.png \
  libvirt-net-physical.png \
+  libvirt-daemon-arch.png \
+  libvirt-driver-arch.png \
+  libvirt-object-model.png \
  madeWith.png \
  windows-cygwin-1.png \
  windows-cygwin-2.png \
@ -54,7 +57,10 @@ xml = \

 fig = \
  libvirt-net-logical.fig \
-  libvirt-net-physical.fig
+  libvirt-net-physical.fig \
+  libvirt-daemon-arch.fig \
+  libvirt-driver-arch.fig \
+  libvirt-object-model.fig

 EXTRA_DIST=					\
  libvirt-api.xml libvirt-refs.xml apibuild.py	\
@ -66,7 +72,7 @@ EXTRA_DIST=					\
 all: web $(top_builddir)/NEWS $(man_MANS)

 virsh.1: virsh.pod
-	pod2man -c "Virtualization Support" $(srcdir)/virsh.pod > $@-t
+	pod2man -c "Virtualization Support" -r "$(PACKAGE)-$(VERSION)" $(srcdir)/virsh.pod > $@-t
 	mv $@-t $@
 	cp $@ $(top_builddir)

@ -83,6 +89,9 @@ ChangeLog.html.in: ChangeLog.xml ChangeLog.xsl
 	  name=`echo $@ | sed -e 's/.tmp//'`; \
 	  $(XSLTPROC) --nonet $(top_srcdir)/docs/ChangeLog.xsl $< > $@ || (rm $@ && exit 1) ; fi )

+%.png: %.fig
+	convert -rotate 90 $< $@
+
 %.html.tmp: %.html.in site.xsl page.xsl sitemap.html.in
 	@(if [ -x $(XSLTPROC) ] ; then \
 	  echo "Generating $@"; \
--- a/docs/api.html
+++ b/docs/api.html
@ -0,0 +1,242 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<!--
+        This file is autogenerated from api.html.in
+        Do not edit this file. Changes will be lost.
+      -->
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+    <link rel="stylesheet" type="text/css" href="main.css" />
+    <link rel="SHORTCUT ICON" href="32favicon.png" />
+    <title>libvirt: The libvirt API concepts</title>
+    <meta name="description" content="libvirt, virtualization, virtualization API" />
+  </head>
+  <body>
+    <div id="header">
+      <div id="headerLogo"></div>
+      <div id="headerSearch">
+        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
+            <input id="query" name="query" type="text" size="12" value="" />
+            <input id="submit" name="submit" type="submit" value="Search" />
+          </div></form>
+      </div>
+    </div>
+    <div id="body">
+      <div id="menu">
+        <ul class="l0"><li>
+            <div>
+              <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a>
+              <ul class="l1"><li>
+                  <div>
+                    <a title="Information about deploying and using libvirt" class="inactive" href="deployment.html">Deployment</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Overview of the logical subsystems in the libvirt API" class="active" href="intro.html">Architecture</a>
+                    <ul class="l2"><li>
+                        <div>
+                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <span class="active">API concepts</span>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Providing isolated networks and NAT based network connectivity" class="inactive" href="archnetwork.html">Network</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Managing storage pools and volumes" class="inactive" href="archstorage.html">Storage</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Enumerating host node devices" class="inactive" href="archnode.html">Node Devices</a>
+                        </div>
+                      </li></ul>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Hypervisor specific driver information" class="inactive" href="drivers.html">Drivers</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a>
+                  </div>
+                </li></ul>
+            </div>
+          </li><li>
+            <div>
+              <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Frequently asked questions" class="inactive" href="FAQ.html">FAQ</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
+            </div>
+          </li></ul>
+      </div>
+      <div id="content">
+        <h1>The libvirt API concepts</h1>
+        <p> This page describes the main principles and architecture choices
+    behind the definition of the libvirt API:
+    </p>
+        <ul><li>
+        <a href="#Objects">Objects exposed</a>
+      </li><li>
+        <a href="#Functions">Functions and naming conventions</a>
+      </li><li>
+        <a href="#Driver">The drivers</a>
+      </li><li>
+        <a href="#Remote">Daemon and remote access</a>
+      </li></ul>
+        <h2>
+          <a name="Objects" id="Objects">Objects exposed</a>
+        </h2>
+        <p> As defined in the <a href="goals.html">goals section</a>, libvirt
+    API need to expose all the resources needed to manage the virtualization
+    support of recent operating systems. The first object manipulated though
+    the API is <code>virConnectPtr</code> which represent a connection to
+    an hypervisor. Any application using libvirt is likely to start using the
+    API by calling one of <a href="html/libvirt-libvirt.html#virConnectOpen">the virConnectOpen functions</a>. You will note that those functions take
+    a name argument which is actually an URI to select the right hypervisor to
+    open, this is needed to allow remote connections and also select between
+    different possible hypervisors (for example on a Linux system it may be
+    possible to use both KVM and LinuxContainers on the same node). A NULL
+    name will default to a preselected hypervisor but it's probably not a
+    wise thing to do in most cases. See the <a href="uri.html">connection
+    URI</a> page for a full descriptions of the values allowed.</p>
+        <p>
+    </p>
+        <p> Once the application obtained a <a href="html/libvirt-libvirt.html#virConnectPtr"><code>virConnectPtr</code></a>
+    connection to the
+    hypervisor it can then use it to manage domains and related resources
+    available for virtualization like storage and networking. All those are
+    exposed as first class objects, and connected to the hypervisor connection
+    (and the node or cluster where it is available).</p>
+        <p class="image">
+      <img alt="first class objects exposed by the API" src="libvirt-object-model.png" /></p>
+        <p> The figure above shows the five main objects exported by the API:</p>
+        <ul><li>virConnectPtr: represent a connection to an hypervisor.</li><li>virDomainPtr: represent one domain either active or defined (i.e.
+      existing as permanent config file and storage but not currently running
+      on that node). The function <a href="html/libvirt-libvirt.html#virConnectListDomains"><code>virConnectListDomains</code></a>
+      allows to list all the IDs for the domains active on this hypervisor.</li><li>virNetworkPtr: represent one network either active or defined (i.e.
+      existing as permanent config file and storage but not currently activated.
+      The function <a href="html/libvirt-libvirt.html#virConnectListNetworks"><code>virConnectListNetworks</code></a>
+      allows to list all the virtualization networks actived on this node.</li><li>virStorageVolPtr: represent one storage volume, usually this is used
+      as a block device available to one of the domains. The function
+      <a href="html/libvirt-libvirt.html#virStorageVolLookupByPath"><code>virStorageVolLookupByPath</code></a> allows to find
+      the object based on its path on the node.</li><li>virStoragePoolPtr: represent a storage pool, i.e. a logical area
+      which can be used to allocate and store storage volumes. The function
+      <a href="html/libvirt-libvirt.html#virStoragePoolLookupByVolume"><code>virStoragePoolLookupByVolume</code></a> allows to find
+      the storage pool containing a given storage volume.</li></ul>
+        <p> Most object manipulated by the library can also be represented using
+      XML descriptions. This is used primarily to create those object, but is
+      also helpful to modify or save their description back.</p>
+        <p> Domains, network and storage pools can be either <code>active</code>
+      i.e. either running or available for immediate use, or
+      <code>defined</code> in which case they are inactive but there is
+      a permanent definition available in the system for them. Based on this
+      thay can be activated dynamically in order to be used.</p>
+        <p> Most kind of object can also be named in various ways:</p>
+        <p>
+    </p>
+        <ul><li>by their <code>name</code>, an user friendly identifier but
+      whose unicity cannot be garanteed between two nodes.</li><li>by their <code>ID</code>, which is a runtime unique identifier
+      provided by the hypervisor for one given activation of the object,
+      but it becomes invalid once the resource is deactivated.</li><li>by their <code>UUID</code>, a 16 bytes unique identifier
+      as defined in <a href="http://www.ietf.org/rfc/rfc4122.txt">RFC 4122</a>,
+      which is garanteed to be unique for long term usage and across a
+      set of nodes.</li></ul>
+        <h2>
+          <a name="Functions" id="Functions">Functions and naming
+      conventions</a>
+        </h2>
+        <p> The naming of the functions present in the library is usually
+      made of a prefix describing the object associated to the function
+      and a verb describing the action on that object.</p>
+        <p> For each first class object you will find apis
+      for the following actions:</p>
+        <ul><li><b>Lookup</b>:...LookupByName, 
+      </li><li><b>Enumeration</b>:virConnectList... and virConnectNumOf...:
+        those are used to enumerate a set of object available to an given
+        hypervisor connection like:
+        <a href="html/libvirt-libvirt.html#virConnectListDomains"><code>virConnectListDomains</code></a>,
+        <a href="html/libvirt-libvirt.html#virConnectNumOfDomains"><code>virConnectNumOfDomains</code></a>,
+        <a href="html/libvirt-libvirt.html#virConnectListNetworks"><code>virConnectListNetworks</code></a>,
+        <a href="html/libvirt-libvirt.html#virConnectListStoragePools"><code>virConnectListStoragePools</code></a>, etc.</li><li><b>Description</b>: ...GetInfo: those are generic accessor providing
+        a set of informations about an object, they are
+        <a href="html/libvirt-libvirt.html#virNodeGetInfo"><code>virNodeGetInfo</code></a>,
+        <a href="html/libvirt-libvirt.html#virDomainGetInfo"><code>virDomainGetInfo</code></a>,
+        <a href="html/libvirt-libvirt.html#virStoragePoolGetInfo"><code>virStoragePoolGetInfo</code></a>,
+        <a href="html/libvirt-libvirt.html#virStorageVolGetInfo"><code>virStorageVolGetInfo</code></a>.</li><li><b>Accessors</b>: ...Get... and ...Set...: those are more specific
+        accessors to query or modify the given object, like
+        <a href="html/libvirt-libvirt.html#virConnectGetType"><code>virConnectGetType</code></a>,
+        <a href="html/libvirt-libvirt.html#virDomainGetMaxMemory"><code>virDomainGetMaxMemory</code></a>,
+        <a href="html/libvirt-libvirt.html#virDomainSetMemory"><code>virDomainSetMemory</code></a>,
+        <a href="html/libvirt-libvirt.html#virDomainGetVcpus"><code>virDomainGetVcpus</code></a>,
+        <a href="html/libvirt-libvirt.html#virStoragePoolSetAutostart"><code>virStoragePoolSetAutostart</code></a>,
+        <a href="html/libvirt-libvirt.html#virNetworkGetBridgeName"><code>virNetworkGetBridgeName</code></a>, etc.</li><li><b>Creation</b>: </li><li><b>Destruction</b>: ... </li></ul>
+        <p> For more in-depth details of the storage related APIs see
+      <a href="storage.html">the storage management page</a>, 
+    </p>
+        <h2>
+          <a name="Driver" id="Driver">The libvirt drivers</a>
+        </h2>
+        <p></p>
+        <p class="image">
+      <img alt="The libvirt driver architecture" src="libvirt-driver-arch.png" /></p>
+        <h2>
+          <a name="Remote" id="Remote">Daemon and remote access</a>
+        </h2>
+        <p></p>
+        <p class="image">
+      <img alt="The libvirt daemon and remote architecture" src="libvirt-daemon-arch.png" /></p>
+      </div>
+    </div>
+    <div id="footer">
+      <p id="sponsor">
+	    Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
+    </div>
+  </body>
+</html>
--- a/docs/api.html.in
+++ b/docs/api.html.in
@ -0,0 +1,136 @@
+<?xml version="1.0"?>
+<html>
+  <body>
+    <h1>The libvirt API concepts</h1>
+
+    <p> This page describes the main principles and architecture choices
+    behind the definition of the libvirt API:
+    <ul>
+      <li>
+        <a href="#Objects">Objects exposed</a>
+      </li>
+      <li>
+        <a href="#Functions">Functions and naming conventions</a>
+      </li>
+      <li>
+        <a href="#Driver">The drivers</a>
+      </li>
+      <li>
+        <a href="#Remote">Daemon and remote access</a>
+      </li>
+    </ul>
+    <h2><a name="Objects" id="Objects">Objects exposed</a></h2>
+    <p> As defined in the <a href="goals.html">goals section</a>, libvirt
+    API need to expose all the resources needed to manage the virtualization
+    support of recent operating systems. The first object manipulated though
+    the API is <code>virConnectPtr</code> which represent a connection to
+    an hypervisor. Any application using libvirt is likely to start using the
+    API by calling one of <a href="html/libvirt-libvirt.html#virConnectOpen"
+    >the virConnectOpen functions</a>. You will note that those functions take
+    a name argument which is actually an URI to select the right hypervisor to
+    open, this is needed to allow remote connections and also select between
+    different possible hypervisors (for example on a Linux system it may be
+    possible to use both KVM and LinuxContainers on the same node). A NULL
+    name will default to a preselected hypervisor but it's probably not a
+    wise thing to do in most cases. See the <a href="uri.html">connection
+    URI</a> page for a full descriptions of the values allowed.<p>
+    <p> Once the application obtained a <code class='docref'>virConnectPtr</code>
+    connection to the
+    hypervisor it can then use it to manage domains and related resources
+    available for virtualization like storage and networking. All those are
+    exposed as first class objects, and connected to the hypervisor connection
+    (and the node or cluster where it is available).</p>
+    <p class="image">
+      <img alt="first class objects exposed by the API"
+           src="libvirt-object-model.png"/>
+    </p>
+    <p> The figure above shows the five main objects exported by the API:</p>
+    <ul>
+      <li>virConnectPtr: represent a connection to an hypervisor.</li>
+      <li>virDomainPtr: represent one domain either active or defined (i.e.
+      existing as permanent config file and storage but not currently running
+      on that node). The function <code class='docref'>virConnectListDomains</code>
+      allows to list all the IDs for the domains active on this hypervisor.</li>
+      <li>virNetworkPtr: represent one network either active or defined (i.e.
+      existing as permanent config file and storage but not currently activated.
+      The function <code class='docref'>virConnectListNetworks</code>
+      allows to list all the virtualization networks actived on this node.</li>
+      <li>virStorageVolPtr: represent one storage volume, usually this is used
+      as a block device available to one of the domains. The function
+      <code class="docref">virStorageVolLookupByPath</code> allows to find
+      the object based on its path on the node.</li>
+      <li>virStoragePoolPtr: represent a storage pool, i.e. a logical area
+      which can be used to allocate and store storage volumes. The function
+      <code class="docref">virStoragePoolLookupByVolume</code> allows to find
+      the storage pool containing a given storage volume.</li>
+    </ul>
+    <p> Most object manipulated by the library can also be represented using
+      XML descriptions. This is used primarily to create those object, but is
+      also helpful to modify or save their description back.</p>
+    <p> Domains, network and storage pools can be either <code>active</code>
+      i.e. either running or available for immediate use, or
+      <code>defined</code> in which case they are inactive but there is
+      a permanent definition available in the system for them. Based on this
+      thay can be activated dynamically in order to be used.</p>
+    <p> Most kind of object can also be named in various ways:<p>
+    <ul>
+      <li>by their <code>name</code>, an user friendly identifier but
+      whose unicity cannot be garanteed between two nodes.</li>
+      <li>by their <code>ID</code>, which is a runtime unique identifier
+      provided by the hypervisor for one given activation of the object,
+      but it becomes invalid once the resource is deactivated.</li >
+      <li>by their <code>UUID</code>, a 16 bytes unique identifier
+      as defined in <a href="http://www.ietf.org/rfc/rfc4122.txt">RFC 4122</a>,
+      which is garanteed to be unique for long term usage and across a
+      set of nodes.</li>
+    </ul>
+    
+    <h2><a name="Functions" id="Functions">Functions and naming
+      conventions</a></h2>
+    <p> The naming of the functions present in the library is usually
+      made of a prefix describing the object associated to the function
+      and a verb describing the action on that object.</p>
+    <p> For each first class object you will find apis
+      for the following actions:</p>
+    <ul>
+      <li><b>Lookup</b>:...LookupByName, 
+      <li><b>Enumeration</b>:virConnectList... and virConnectNumOf...:
+        those are used to enumerate a set of object available to an given
+        hypervisor connection like:
+        <code class='docref'>virConnectListDomains</code>,
+        <code class='docref'>virConnectNumOfDomains</code>,
+        <code class='docref'>virConnectListNetworks</code>,
+        <code class='docref'>virConnectListStoragePools</code>, etc.</li>
+      <li><b>Description</b>: ...GetInfo: those are generic accessor providing
+        a set of informations about an object, they are
+        <code class='docref'>virNodeGetInfo</code>,
+        <code class='docref'>virDomainGetInfo</code>,
+        <code class='docref'>virStoragePoolGetInfo</code>,
+        <code class='docref'>virStorageVolGetInfo</code>.</li>
+      <li><b>Accessors</b>: ...Get... and ...Set...: those are more specific
+        accessors to query or modify the given object, like
+        <code class='docref'>virConnectGetType</code>,
+        <code class='docref'>virDomainGetMaxMemory</code>,
+        <code class='docref'>virDomainSetMemory</code>,
+        <code class='docref'>virDomainGetVcpus</code>,
+        <code class='docref'>virStoragePoolSetAutostart</code>,
+        <code class='docref'>virNetworkGetBridgeName</code>, etc.</li>
+      <li><b>Creation</b>: </li>
+      <li><b>Destruction</b>: ... </li>
+    </ul>
+    <p> For more in-depth details of the storage related APIs see
+      <a href="storage.html">the storage management page</a>, 
+    <h2><a name="Driver" id="Driver">The libvirt drivers</a></h2>
+    <p></p>
+    <p class="image">
+      <img alt="The libvirt driver architecture"
+           src="libvirt-driver-arch.png"/>
+    </p>
+    <h2><a name="Remote" id="Remote">Daemon and remote access</a></h2>
+    <p></p>
+    <p class="image">
+      <img alt="The libvirt daemon and remote architecture"
+           src="libvirt-daemon-arch.png"/>
+    </p>
+  </body>
+</html>
--- a/docs/apibuild.py
+++ b/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):
--- a/docs/archdomain.html
+++ b/docs/archdomain.html
@ -50,6 +50,10 @@
                        <div>
                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <span class="active">Domains</span>
--- a/docs/archnetwork.html
+++ b/docs/archnetwork.html
@ -50,6 +50,10 @@
                        <div>
                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
--- a/docs/archnode.html
+++ b/docs/archnode.html
@ -50,6 +50,10 @@
                        <div>
                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
--- a/docs/archstorage.html
+++ b/docs/archstorage.html
@ -50,6 +50,10 @@
                        <div>
                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
--- a/docs/devhelp/libvirt-libvirt.html
+++ b/docs/devhelp/libvirt-libvirt.html
@ -130,6 +130,7 @@ int	<a href="#virDomainGetSchedulerParameters">virDomainGetSchedulerParameters</
 int	<a href="#virConnectNumOfDefinedNetworks">virConnectNumOfDefinedNetworks</a>	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn);
 int	<a href="#virConnectNumOfDomains">virConnectNumOfDomains</a>		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn);
 int	<a href="#virNetworkGetUUID">virNetworkGetUUID</a>		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/>					 unsigned char * uuid);
+<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a>	<a href="#virNodeDeviceCreateXML">virNodeDeviceCreateXML</a>	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>						 const char * xmlDesc, <br/>						 unsigned int flags);
 <a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a>	<a href="#virStoragePoolGetConnect">virStoragePoolGetConnect</a>	(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool);
 int	<a href="#virConnectGetVersion">virConnectGetVersion</a>		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 unsigned long * hvVer);
 int	<a href="#virDomainFree">virDomainFree</a>			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain);
@ -199,6 +200,7 @@ char *	<a href="#virConnectFindStoragePoolSources">virConnectFindStoragePoolSour
 int	<a href="#virDomainPinVcpu">virDomainPinVcpu</a>		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/>					 unsigned int vcpu, <br/>					 unsigned char * cpumap, <br/>					 int maplen);
 int	<a href="#virNodeGetSecurityModel">virNodeGetSecurityModel</a>		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 <a href="libvirt-libvirt.html#virSecurityModelPtr">virSecurityModelPtr</a> secmodel);
 int	<a href="#virDomainRestore">virDomainRestore</a>		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 const char * from);
+int	<a href="#virNodeDeviceDestroy">virNodeDeviceDestroy</a>		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev);
 char *	<a href="#virStorageVolGetPath">virStorageVolGetPath</a>		(<a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a> vol);
 <a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a>	<a href="#virNetworkLookupByUUIDString">virNetworkLookupByUUIDString</a>	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>						 const char * uuidstr);
 typedef int <a href="#virConnectDomainEventCallback">virConnectDomainEventCallback</a>	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 <a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> dom, <br/>					 int event, <br/>					 int detail, <br/>					 void * opaque);
@ -882,7 +884,7 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virConnectRef"/>virConnectRef ()</h3><pre class="programlisting">int	virConnectRef			(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/>
 </pre><p>Increment the reference count on the connection. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virConnectClose">virConnectClose</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>the connection to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>the connection to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virDomainAttachDevice"/>virDomainAttachDevice ()</h3><pre class="programlisting">int	virDomainAttachDevice		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/>					 const char * xml)<br/>
 </pre><p>Create a virtual device attachment to backend.</p>
@ -913,7 +915,7 @@ The content of this structure is not made public by the API.
 <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xmlDesc</tt></i>:</span></td><td>string containing an XML description of the domain</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>callers should always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new domain object or NULL in case of failure</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virDomainDefineXML"/>virDomainDefineXML ()</h3><pre class="programlisting"><a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a>	virDomainDefineXML	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 const char * xml)<br/>
-</pre><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine().</p>
+</pre><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine(). A previous definition for this domain would be overriden if it already exists.</p>
 <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xml</tt></i>:</span></td><td>the XML description for the domain, preferably in UTF-8</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>NULL in case of error, a pointer to the domain otherwise</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virDomainDestroy"/>virDomainDestroy ()</h3><pre class="programlisting">int	virDomainDestroy		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/>
@ -1026,7 +1028,7 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virDomainRef"/>virDomainRef ()</h3><pre class="programlisting">int	virDomainRef			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/>
 </pre><p>Increment the reference count on the domain. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virDomainFree">virDomainFree</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>the domain to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virDomainRestore"/>virDomainRestore ()</h3><pre class="programlisting">int	virDomainRestore		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 const char * from)<br/>
 </pre><p>This method will restore a domain saved to disk by virDomainSave().</p>
@ -1146,7 +1148,7 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNetworkRef"/>virNetworkRef ()</h3><pre class="programlisting">int	virNetworkRef			(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/>
 </pre><p>Increment the reference count on the network. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNetworkFree">virNetworkFree</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>the network to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNetworkSetAutostart"/>virNetworkSetAutostart ()</h3><pre class="programlisting">int	virNetworkSetAutostart		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/>					 int autostart)<br/>
 </pre><p>Configure the network to be automatically started when the host machine boots.</p>
@ -1155,10 +1157,18 @@ The content of this structure is not made public by the API.
        <div class="refsect2" lang="en"><h3><a name="virNetworkUndefine"/>virNetworkUndefine ()</h3><pre class="programlisting">int	virNetworkUndefine		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/>
 </pre><p>Undefine a network but does not stop it if it is running</p>
 <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>pointer to a defined network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of error</td></tr></tbody></table></div></div>
+        <hr/>
+        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceCreateXML"/>virNodeDeviceCreateXML ()</h3><pre class="programlisting"><a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a>	virNodeDeviceCreateXML	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>						 const char * xmlDesc, <br/>						 unsigned int flags)<br/>
+</pre><p>Create a new device on the VM host machine, for example, virtual HBAs created using vport_create.</p>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xmlDesc</tt></i>:</span></td><td>string containing an XML description of the device to be created</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>callers should always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a node device object if successful, NULL in case of failure</td></tr></tbody></table></div></div>
+        <hr/>
+        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceDestroy"/>virNodeDeviceDestroy ()</h3><pre class="programlisting">int	virNodeDeviceDestroy		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
+</pre><p>Destroy the device object. The virtual device is removed from the host operating system. This function may require privileged access</p>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>a device object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceDettach"/>virNodeDeviceDettach ()</h3><pre class="programlisting">int	virNodeDeviceDettach		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
-</pre><p/>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+</pre><p>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.</p>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceFree"/>virNodeDeviceFree ()</h3><pre class="programlisting">int	virNodeDeviceFree		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
 </pre><p>Drops a reference to the node device, freeing it if this was the last reference.</p>
@ -1190,23 +1200,23 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceReAttach"/>virNodeDeviceReAttach ()</h3><pre class="programlisting">int	virNodeDeviceReAttach		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
 </pre><p>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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceRef"/>virNodeDeviceRef ()</h3><pre class="programlisting">int	virNodeDeviceRef		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
 </pre><p>Increment the reference count on the dev. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNodeDeviceFree">virNodeDeviceFree</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the dev to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeDeviceReset"/>virNodeDeviceReset ()</h3><pre class="programlisting">int	virNodeDeviceReset		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br/>
 </pre><p>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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeGetCellsFreeMemory"/>virNodeGetCellsFreeMemory ()</h3><pre class="programlisting">int	virNodeGetCellsFreeMemory	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 unsigned long long * freeMems, <br/>					 int startCell, <br/>					 int maxCells)<br/>
 </pre><p>This call returns the amount of free memory in one or more NUMA cells. The @freeMems array must be allocated by the caller and will be filled with the amount of free memory in kilobytes for each cell requested, starting with startCell (in freeMems[0]), up to either (startCell + maxCells), or the number of additional cells in the node, whichever is smaller.</p>
 <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>freeMems</tt></i>:</span></td><td>pointer to the array of unsigned long long</td></tr><tr><td><span class="term"><i><tt>startCell</tt></i>:</span></td><td>index of first cell to return freeMems info on.</td></tr><tr><td><span class="term"><i><tt>maxCells</tt></i>:</span></td><td>Maximum number of cells for which freeMems information can be returned.</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of entries filled in freeMems, or -1 in case of error.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeGetFreeMemory"/>virNodeGetFreeMemory ()</h3><pre class="programlisting">unsigned long long	virNodeGetFreeMemory	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/>
-</pre><p>provides the free memory available on the Node</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the available free memory in kilobytes or 0 in case of error</td></tr></tbody></table></div></div>
+</pre><p>provides the free memory available on the Node Note: most libvirt APIs provide memory sizes in kilobytes, but in this function the returned value is in bytes. Divide by 1024 as necessary.</p>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the available free memory in bytes or 0 in case of error</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virNodeGetInfo"/>virNodeGetInfo ()</h3><pre class="programlisting">int	virNodeGetInfo			(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/>					 <a href="libvirt-libvirt.html#virNodeInfoPtr">virNodeInfoPtr</a> info)<br/>
 </pre><p>Extract hardware information about the node.</p>
@ -1306,7 +1316,7 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virStoragePoolRef"/>virStoragePoolRef ()</h3><pre class="programlisting">int	virStoragePoolRef		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool)<br/>
 </pre><p>Increment the reference count on the pool. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStoragePoolFree">virStoragePoolFree</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>the pool to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virStoragePoolRefresh"/>virStoragePoolRefresh ()</h3><pre class="programlisting">int	virStoragePoolRefresh		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br/>					 unsigned int flags)<br/>
 </pre><p>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</p>
@ -1370,7 +1380,7 @@ The content of this structure is not made public by the API.
        <hr/>
        <div class="refsect2" lang="en"><h3><a name="virStorageVolRef"/>virStorageVolRef ()</h3><pre class="programlisting">int	virStorageVolRef		(<a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a> vol)<br/>
 </pre><p>Increment the reference count on the vol. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStorageVolFree">virStorageVolFree</a> 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.</p>
-<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>vol</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td/></tr></tbody></table></div></div>
+<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>vol</tt></i>:</span></td><td>the vol to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div>
        <hr/>
      </div>
    </div>
--- a/docs/devhelp/libvirt-virterror.html
+++ b/docs/devhelp/libvirt-virterror.html
@ -106,7 +106,8 @@ void	<a href="#virConnResetLastError">virConnResetLastError</a>		(<a href="libvi
    <a name="VIR_FROM_UML">VIR_FROM_UML</a> = 21 /* Error at the UML driver */
    <a name="VIR_FROM_NODEDEV">VIR_FROM_NODEDEV</a> = 22 /* Error from node device monitor */
    <a name="VIR_FROM_XEN_INOTIFY">VIR_FROM_XEN_INOTIFY</a> = 23 /* Error from xen inotify layer */
-    <a name="VIR_FROM_SECURITY">VIR_FROM_SECURITY</a> = 24 /*  Error from security framework */
+    <a name="VIR_FROM_SECURITY">VIR_FROM_SECURITY</a> = 24 /* Error from security framework */
+    <a name="VIR_FROM_VBOX">VIR_FROM_VBOX</a> = 25 /*  Error from VirtualBox driver */
 };
 </pre><p/>
 </div>
--- a/docs/drivers.html
+++ b/docs/drivers.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
@ -137,7 +141,7 @@
        <p>
      The hypervisor drivers currently supported by libvirt are:
    </p>
-        <ul><li><strong><a href="drvxen.html">Xen</a></strong></li><li><strong><a href="drvqemu.html">QEMU</a></strong></li><li><strong><a href="drvlxc.html">LXC</a></strong></li><li><strong><a href="drvtest.html">Test</a></strong></li><li><strong><a href="drvopenvz.html">OpenVZ</a></strong></li></ul>
+        <ul><li><strong><a href="drvxen.html">Xen</a></strong></li><li><strong><a href="drvqemu.html">QEMU</a></strong></li><li><strong><a href="drvlxc.html">LXC</a></strong></li><li><strong><a href="drvtest.html">Test</a></strong></li><li><strong><a href="drvopenvz.html">OpenVZ</a></strong></li><li><strong><a href="drvvbox.html">VirtualBox</a></strong></li></ul>
      </div>
    </div>
    <div id="footer">
--- a/docs/drivers.html.in
+++ b/docs/drivers.html.in
@ -22,6 +22,7 @@
      <li><strong><a href="drvlxc.html">LXC</a></strong></li>
      <li><strong><a href="drvtest.html">Test</a></strong></li>
      <li><strong><a href="drvopenvz.html">OpenVZ</a></strong></li>
+      <li><strong><a href="drvvbox.html">VirtualBox</a></strong></li>
    </ul>
  </body>
 </html>
--- a/docs/drvlxc.html
+++ b/docs/drvlxc.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
@ -126,6 +130,81 @@
      </div>
      <div id="content">
        <h1>LXC container driver</h1>
+        <p>
+The libvirt LXC driver manages "Linux Containers".  Containers are sets of processes
+with private namespaces which can (but don't always) look like separate machines, but
+do not have their own OS.  Here are two example configurations.  The first is a very
+light-weight "application container" which does not have it's own root image.  You would
+start it using
+</p>
+        <h3>Example config version 1</h3>
+        <p></p>
+        <pre>
+&lt;domain type='lxc'&gt;
+	&lt;name&gt;vm1&lt;/name&gt;
+	&lt;memory&gt;500000&lt;/memory&gt;
+	&lt;os&gt;
+		&lt;type&gt;exe&lt;/type&gt;
+		&lt;init&gt;/bin/sh&lt;/init&gt;
+	&lt;/os&gt;
+	&lt;vcpu&gt;1&lt;/vcpu&gt;
+	&lt;clock offset='utc'/&gt;
+	&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
+	&lt;on_reboot&gt;restart&lt;/on_reboot&gt;
+	&lt;on_crash&gt;destroy&lt;/on_crash&gt;
+	&lt;devices&gt;
+		&lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
+		&lt;interface type='network'&gt;
+			&lt;source network='default'/&gt;
+		&lt;/interface&gt;
+		&lt;console type='pty' /&gt;
+	&lt;/devices&gt;
+&lt;/domain&gt;
+</pre>
+        <p>
+The next example assumes there is a private root filesystem
+(perhaps hand-crafted using busybox, or installed from media,
+debootstrap, whatever) under /opt/vm-1-root:
+</p>
+        <p></p>
+        <pre>
+&lt;domain type='lxc'&gt;
+	&lt;name&gt;vm1&lt;/name&gt;
+	&lt;memory&gt;32768&lt;/memory&gt;
+	&lt;os&gt;
+		&lt;type&gt;exe&lt;/type&gt;
+		&lt;init&gt;/init&lt;/init&gt;
+	&lt;/os&gt;
+	&lt;vcpu&gt;1&lt;/vcpu&gt;
+	&lt;clock offset='utc'/&gt;
+	&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
+	&lt;on_reboot&gt;restart&lt;/on_reboot&gt;
+	&lt;on_crash&gt;destroy&lt;/on_crash&gt;
+	&lt;devices&gt;
+		&lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
+		&lt;filesystem type='mount'&gt;
+			&lt;source dir='/opt/vm-1-root'/&gt;
+			&lt;target dir='/'/&gt;
+		&lt;/filesystem&gt;
+		&lt;interface type='network'&gt;
+			&lt;source network='default'/&gt;
+		&lt;/interface&gt;
+		&lt;console type='pty' /&gt;
+	&lt;/devices&gt;
+&lt;/domain&gt;
+</pre>
+        <p>
+In both cases, you can define and start a container using:</p>
+        <pre>
+virsh --connect lxc:/// define v1.xml
+virsh --connect lxc:/// start v1.xml
+</pre>
+        <pre>
+virsh --connect lxc:/// console v1
+</pre>
+        <p>Now doing 'ps -ef' will only show processes in the container, for
+instance.
+</p>
      </div>
    </div>
    <div id="footer">
--- a/docs/drvlxc.html.in
+++ b/docs/drvlxc.html.in
@ -1,5 +1,84 @@
 <html>
  <body>
    <h1>LXC container driver</h1>
+<p>
+The libvirt LXC driver manages "Linux Containers".  Containers are sets of processes
+with private namespaces which can (but don't always) look like separate machines, but
+do not have their own OS.  Here are two example configurations.  The first is a very
+light-weight "application container" which does not have it's own root image.  You would
+start it using
+</p>
+
+<h3>Example config version 1</h3>
+<p></p>
+<pre>
+&lt;domain type='lxc'&gt;
+	&lt;name&gt;vm1&lt;/name&gt;
+	&lt;memory&gt;500000&lt;/memory&gt;
+	&lt;os&gt;
+		&lt;type&gt;exe&lt;/type&gt;
+		&lt;init&gt;/bin/sh&lt;/init&gt;
+	&lt;/os&gt;
+	&lt;vcpu&gt;1&lt;/vcpu&gt;
+	&lt;clock offset='utc'/&gt;
+	&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
+	&lt;on_reboot&gt;restart&lt;/on_reboot&gt;
+	&lt;on_crash&gt;destroy&lt;/on_crash&gt;
+	&lt;devices&gt;
+		&lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
+		&lt;interface type='network'&gt;
+			&lt;source network='default'/&gt;
+		&lt;/interface&gt;
+		&lt;console type='pty' /&gt;
+	&lt;/devices&gt;
+&lt;/domain&gt;
+</pre>
+
+<p>
+The next example assumes there is a private root filesystem
+(perhaps hand-crafted using busybox, or installed from media,
+debootstrap, whatever) under /opt/vm-1-root:
+</p>
+<p></p>
+<pre>
+&lt;domain type='lxc'&gt;
+	&lt;name&gt;vm1&lt;/name&gt;
+	&lt;memory&gt;32768&lt;/memory&gt;
+	&lt;os&gt;
+		&lt;type&gt;exe&lt;/type&gt;
+		&lt;init&gt;/init&lt;/init&gt;
+	&lt;/os&gt;
+	&lt;vcpu&gt;1&lt;/vcpu&gt;
+	&lt;clock offset='utc'/&gt;
+	&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
+	&lt;on_reboot&gt;restart&lt;/on_reboot&gt;
+	&lt;on_crash&gt;destroy&lt;/on_crash&gt;
+	&lt;devices&gt;
+		&lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
+		&lt;filesystem type='mount'&gt;
+			&lt;source dir='/opt/vm-1-root'/&gt;
+			&lt;target dir='/'/&gt;
+		&lt;/filesystem&gt;
+		&lt;interface type='network'&gt;
+			&lt;source network='default'/&gt;
+		&lt;/interface&gt;
+		&lt;console type='pty' /&gt;
+	&lt;/devices&gt;
+&lt;/domain&gt;
+</pre>
+
+<p>
+In both cases, you can define and start a container using:</p>
+<pre>
+virsh --connect lxc:/// define v1.xml
+virsh --connect lxc:/// start v1.xml
+</pre>
+and then get a console  using:
+<pre>
+virsh --connect lxc:/// console v1
+</pre>
+<p>Now doing 'ps -ef' will only show processes in the container, for
+instance.
+</p>
  </body>
 </html>
--- a/docs/drvopenvz.html
+++ b/docs/drvopenvz.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/drvqemu.html
+++ b/docs/drvqemu.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/drvremote.html
+++ b/docs/drvremote.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/drvtest.html
+++ b/docs/drvtest.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/drvuml.html
+++ b/docs/drvuml.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/drvvbox.html
+++ b/docs/drvvbox.html
@ -0,0 +1,250 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<!--
+        This file is autogenerated from drvvbox.html.in
+        Do not edit this file. Changes will be lost.
+      -->
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+    <link rel="stylesheet" type="text/css" href="main.css" />
+    <link rel="SHORTCUT ICON" href="32favicon.png" />
+    <title>libvirt: VirtualBox hypervisor driver</title>
+    <meta name="description" content="libvirt, virtualization, virtualization API" />
+  </head>
+  <body>
+    <div id="header">
+      <div id="headerLogo"></div>
+      <div id="headerSearch">
+        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
+            <input id="query" name="query" type="text" size="12" value="" />
+            <input id="submit" name="submit" type="submit" value="Search" />
+          </div></form>
+      </div>
+    </div>
+    <div id="body">
+      <div id="menu">
+        <ul class="l0"><li>
+            <div>
+              <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a>
+              <ul class="l1"><li>
+                  <div>
+                    <a title="Information about deploying and using libvirt" class="inactive" href="deployment.html">Deployment</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Overview of the logical subsystems in the libvirt API" class="inactive" href="intro.html">Architecture</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Hypervisor specific driver information" class="active" href="drivers.html">Drivers</a>
+                    <ul class="l2"><li>
+                        <div>
+                          <a title="Driver the Xen hypervisor" class="inactive" href="drvxen.html">Xen</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for QEMU, KQEMU, KVM and Xenner" class="inactive" href="drvqemu.html">QEMU / KVM</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for the Linux native container API" class="inactive" href="drvlxc.html">Linux Container</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Psuedo-driver simulating APIs in memory for test suites" class="inactive" href="drvtest.html">Test</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver providing secure remote to the libvirt APIs" class="inactive" href="drvremote.html">Remote</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for the OpenVZ container technology" class="inactive" href="drvopenvz.html">OpenVZ</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for the User Mode Linux technology" class="inactive" href="drvuml.html">UML</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
+                        </div>
+                      </li><li>
+                        <div>
+                          <span class="active">VirtualBox</span>
+                        </div>
+                      </li></ul>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a>
+                  </div>
+                </li><li>
+                  <div>
+                    <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a>
+                  </div>
+                </li></ul>
+            </div>
+          </li><li>
+            <div>
+              <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Frequently asked questions" class="inactive" href="FAQ.html">FAQ</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
+            </div>
+          </li><li>
+            <div>
+              <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
+            </div>
+          </li></ul>
+      </div>
+      <div id="content">
+        <h1>VirtualBox hypervisor driver</h1>
+        <p>
+        The libvirt VirtualBox driver can manage any VirtualBox version
+        from version 2.2 onwards.
+    </p>
+        <h2>Connections to VirtualBox driver</h2>
+        <p>
+    The libvirt VirtualBox driver provides per-user drivers (the "session" instance).
+    The uri of the driver protocol is "vbox". Some example connection URIs for the driver are:
+    </p>
+        <pre>
+    vbox:///session                      (local access to per-user instance)
+    vbox+unix:///session                 (local access to per-user instance)
+    vbox+tcp://user@example.com/session  (remote access, SASl/Kerberos)
+    vbox+ssh://user@example.com/session  (remote access, SSH tunnelled)
+    </pre>
+        <h2>
+          <a name="xmlconfig" id="xmlconfig">Example domain XML config</a>
+        </h2>
+        <pre>
+    &lt;domain type='vbox'&gt;
+    &lt;name&gt;vbox&lt;/name&gt;
+    &lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;
+
+    &lt;os&gt;
+        &lt;type&gt;hvm&lt;/type&gt;
+        &lt;boot dev='cdrom'/&gt;
+        &lt;boot dev='hd'/&gt;
+        &lt;boot dev='fd'/&gt;
+        &lt;boot dev='network'/&gt;
+    &lt;/os&gt;
+
+    &lt;memory&gt;654321&lt;/memory&gt;
+    &lt;vcpu&gt;1&lt;/vcpu&gt;
+
+    &lt;features&gt;
+        &lt;pae/&gt;
+        &lt;acpi/&gt;
+        &lt;apic/&gt;
+    &lt;/features&gt;
+
+    &lt;devices&gt;
+        &lt;disk type='file' device='cdrom'&gt;
+            &lt;source file='/home/user/Downloads/slax-6.0.9.iso'/&gt;
+            &lt;target dev='hdc'/&gt;
+            &lt;readonly/&gt;
+        &lt;/disk&gt;
+
+        &lt;disk type='file' device='disk'&gt;
+            &lt;source file='/home/user/tmp/vbox.vdi'/&gt;
+            &lt;target dev='hdd'/&gt;
+        &lt;/disk&gt;
+
+        &lt;disk type='file' device='floppy'&gt;
+            &lt;source file='/home/user/tmp/WIN98C.IMG'/&gt;
+            &lt;target dev='fda'/&gt;
+        &lt;/disk&gt;
+
+        &lt;!--BRIDGE--&gt;
+        &lt;interface type='bridge'&gt;
+            &lt;source bridge='eth0'/&gt;
+            &lt;mac address='00:16:3e:5d:c7:9e'/&gt;
+            &lt;model type='am79c973'/&gt;
+        &lt;/interface&gt;
+
+        &lt;!--NAT--&gt;
+        &lt;interface type='user'&gt;
+            &lt;mac address='56:16:3e:5d:c7:9e'/&gt;
+            &lt;model type='82540eM'/&gt;
+        &lt;/interface&gt;
+
+        &lt;sound model='sb16'/&gt;
+
+        &lt;parallel type='dev'&gt;
+            &lt;source path='/dev/pts/1'/&gt;
+            &lt;target port='0'/&gt;
+        &lt;/parallel&gt;
+
+        &lt;parallel type='dev'&gt;
+            &lt;source path='/dev/pts/2'/&gt;
+            &lt;target port='1'/&gt;
+        &lt;/parallel&gt;
+
+        &lt;serial type="dev"&gt;
+            &lt;source path="/dev/ttyS0"/&gt;
+            &lt;target port="0"/&gt;
+        &lt;/serial&gt;
+
+        &lt;serial type="pipe"&gt;
+            &lt;source path="/tmp/serial.txt"/&gt;
+            &lt;target port="1"/&gt;
+        &lt;/serial&gt;
+
+        &lt;hostdev mode='subsystem' type='usb'&gt;
+            &lt;source&gt;
+                &lt;vendor id='0x1234'/&gt;
+                &lt;product id='0xbeef'/&gt;
+            &lt;/source&gt;
+        &lt;/hostdev&gt;
+
+        &lt;hostdev mode='subsystem' type='usb'&gt;
+            &lt;source&gt;
+                &lt;vendor id='0x4321'/&gt;
+                &lt;product id='0xfeeb'/&gt;
+            &lt;/source&gt;
+        &lt;/hostdev&gt;
+
+    &lt;/devices&gt;
+
+    &lt;/domain&gt;
+    </pre>
+      </div>
+    </div>
+    <div id="footer">
+      <p id="sponsor">
+	    Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
+    </div>
+  </body>
+</html>
--- a/docs/drvvbox.html.in
+++ b/docs/drvvbox.html.in
@ -0,0 +1,119 @@
+<html>
+    <body>
+        <h1>VirtualBox hypervisor driver</h1>
+        <p>
+        The libvirt VirtualBox driver can manage any VirtualBox version
+        from version 2.2 onwards.
+    </p>
+
+    <h2>Connections to VirtualBox driver</h2>
+
+    <p>
+    The libvirt VirtualBox driver provides per-user drivers (the "session" instance).
+    The uri of the driver protocol is "vbox". Some example connection URIs for the driver are:
+    </p>
+
+    <pre>
+    vbox:///session                      (local access to per-user instance)
+    vbox+unix:///session                 (local access to per-user instance)
+    vbox+tcp://user@example.com/session  (remote access, SASl/Kerberos)
+    vbox+ssh://user@example.com/session  (remote access, SSH tunnelled)
+    </pre>
+
+    <h2><a name="xmlconfig">Example domain XML config</a></h2>
+
+    <pre>
+    &lt;domain type='vbox'&gt;
+    &lt;name&gt;vbox&lt;/name&gt;
+    &lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;
+
+    &lt;os&gt;
+        &lt;type&gt;hvm&lt;/type&gt;
+        &lt;boot dev='cdrom'/&gt;
+        &lt;boot dev='hd'/&gt;
+        &lt;boot dev='fd'/&gt;
+        &lt;boot dev='network'/&gt;
+    &lt;/os&gt;
+
+    &lt;memory&gt;654321&lt;/memory&gt;
+    &lt;vcpu&gt;1&lt;/vcpu&gt;
+
+    &lt;features&gt;
+        &lt;pae/&gt;
+        &lt;acpi/&gt;
+        &lt;apic/&gt;
+    &lt;/features&gt;
+
+    &lt;devices&gt;
+        &lt;disk type='file' device='cdrom'&gt;
+            &lt;source file='/home/user/Downloads/slax-6.0.9.iso'/&gt;
+            &lt;target dev='hdc'/&gt;
+            &lt;readonly/&gt;
+        &lt;/disk&gt;
+
+        &lt;disk type='file' device='disk'&gt;
+            &lt;source file='/home/user/tmp/vbox.vdi'/&gt;
+            &lt;target dev='hdd'/&gt;
+        &lt;/disk&gt;
+
+        &lt;disk type='file' device='floppy'&gt;
+            &lt;source file='/home/user/tmp/WIN98C.IMG'/&gt;
+            &lt;target dev='fda'/&gt;
+        &lt;/disk&gt;
+
+        &lt;!--BRIDGE--&gt;
+        &lt;interface type='bridge'&gt;
+            &lt;source bridge='eth0'/&gt;
+            &lt;mac address='00:16:3e:5d:c7:9e'/&gt;
+            &lt;model type='am79c973'/&gt;
+        &lt;/interface&gt;
+
+        &lt;!--NAT--&gt;
+        &lt;interface type='user'&gt;
+            &lt;mac address='56:16:3e:5d:c7:9e'/&gt;
+            &lt;model type='82540eM'/&gt;
+        &lt;/interface&gt;
+
+        &lt;sound model='sb16'/&gt;
+
+        &lt;parallel type='dev'&gt;
+            &lt;source path='/dev/pts/1'/&gt;
+            &lt;target port='0'/&gt;
+        &lt;/parallel&gt;
+
+        &lt;parallel type='dev'&gt;
+            &lt;source path='/dev/pts/2'/&gt;
+            &lt;target port='1'/&gt;
+        &lt;/parallel&gt;
+
+        &lt;serial type="dev"&gt;
+            &lt;source path="/dev/ttyS0"/&gt;
+            &lt;target port="0"/&gt;
+        &lt;/serial&gt;
+
+        &lt;serial type="pipe"&gt;
+            &lt;source path="/tmp/serial.txt"/&gt;
+            &lt;target port="1"/&gt;
+        &lt;/serial&gt;
+
+        &lt;hostdev mode='subsystem' type='usb'&gt;
+            &lt;source&gt;
+                &lt;vendor id='0x1234'/&gt;
+                &lt;product id='0xbeef'/&gt;
+            &lt;/source&gt;
+        &lt;/hostdev&gt;
+
+        &lt;hostdev mode='subsystem' type='usb'&gt;
+            &lt;source&gt;
+                &lt;vendor id='0x4321'/&gt;
+                &lt;product id='0xfeeb'/&gt;
+            &lt;/source&gt;
+        &lt;/hostdev&gt;
+
+    &lt;/devices&gt;
+
+    &lt;/domain&gt;
+    </pre>
+
+    </body>
+</html>
--- a/docs/drvxen.html
+++ b/docs/drvxen.html
@ -86,6 +86,10 @@
                        <div>
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/goals.html
+++ b/docs/goals.html
@ -50,6 +50,10 @@
                        <div>
                          <span class="active">Goals</span>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
--- a/docs/html/libvirt-libvirt.html
+++ b/docs/html/libvirt-libvirt.html
@ -202,6 +202,8 @@ char *	<a href="#virNetworkGetXMLDesc">virNetworkGetXMLDesc</a>		(<a href="libvi
 int	<a href="#virNetworkRef">virNetworkRef</a>			(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)
 int	<a href="#virNetworkSetAutostart">virNetworkSetAutostart</a>		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br />					 int autostart)
 int	<a href="#virNetworkUndefine">virNetworkUndefine</a>		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)
+<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a>	<a href="#virNodeDeviceCreateXML">virNodeDeviceCreateXML</a>	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />						 const char * xmlDesc, <br />						 unsigned int flags)
+int	<a href="#virNodeDeviceDestroy">virNodeDeviceDestroy</a>		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)
 int	<a href="#virNodeDeviceDettach">virNodeDeviceDettach</a>		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)
 int	<a href="#virNodeDeviceFree">virNodeDeviceFree</a>		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)
 const char *	<a href="#virNodeDeviceGetName">virNodeDeviceGetName</a>	(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)
@ -382,7 +384,7 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>This function should be called first to get a connection to the Hypervisor and xen store</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>URI of the hypervisor</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the hypervisor connection or NULL in case of error URIs are documented at http://libvirt.org/uri.html</td></tr></tbody></table></div><h3><a name="virConnectOpenAuth" id="virConnectOpenAuth"><code>virConnectOpenAuth</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a>	virConnectOpenAuth	(const char * name, <br />					 <a href="libvirt-libvirt.html#virConnectAuthPtr">virConnectAuthPtr</a> auth, <br />					 int flags)<br />
 </pre><p>This function should be called first to get a connection to the Hypervisor. If necessary, authentication will be performed fetching credentials via the callback</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>URI of the hypervisor</td></tr><tr><td><span class="term"><i><tt>auth</tt></i>:</span></td><td>Authenticate callback parameters</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>Open flags</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the hypervisor connection or NULL in case of error URIs are documented at http://libvirt.org/uri.html</td></tr></tbody></table></div><h3><a name="virConnectOpenReadOnly" id="virConnectOpenReadOnly"><code>virConnectOpenReadOnly</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a>	virConnectOpenReadOnly	(const char * name)<br />
 </pre><p>This function should be called first to get a restricted connection to the library functionalities. The set of APIs usable are then restricted on the available methods to control the domains.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>URI of the hypervisor</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the hypervisor connection or NULL in case of error URIs are documented at http://libvirt.org/uri.html</td></tr></tbody></table></div><h3><a name="virConnectRef" id="virConnectRef"><code>virConnectRef</code></a></h3><pre class="programlisting">int	virConnectRef			(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br />
-</pre><p>Increment the reference count on the connection. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virConnectClose">virConnectClose</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>the connection to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virDomainAttachDevice" id="virDomainAttachDevice"><code>virDomainAttachDevice</code></a></h3><pre class="programlisting">int	virDomainAttachDevice		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 const char * xml)<br />
+</pre><p>Increment the reference count on the connection. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virConnectClose">virConnectClose</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>the connection to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure</td></tr></tbody></table></div><h3><a name="virDomainAttachDevice" id="virDomainAttachDevice"><code>virDomainAttachDevice</code></a></h3><pre class="programlisting">int	virDomainAttachDevice		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 const char * xml)<br />
 </pre><p>Create a virtual device attachment to backend.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to domain object</td></tr><tr><td><span class="term"><i><tt>xml</tt></i>:</span></td><td>pointer to XML description of one device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainBlockPeek" id="virDomainBlockPeek"><code>virDomainBlockPeek</code></a></h3><pre class="programlisting">int	virDomainBlockPeek		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> dom, <br />					 const char * path, <br />					 unsigned long long offset, <br />					 size_t size, <br />					 void * buffer, <br />					 unsigned int flags)<br />
 </pre><p>This function allows you to read the contents of a domain's disk device. Typical uses for this are to determine if the domain has written a Master Boot Record (indicating that the domain has completed installation), or to try to work out the state of the domain's filesystems. (Note that in the local case you might try to open the block device or file directly, but that won't work in the remote case, nor if you don't have sufficient permission. Hence the need for this call). 'path' must be a device or file corresponding to the domain. In other words it must be the precise string returned in a &lt;disk&gt;&lt;source dev='...'/&gt;&lt;/disk&gt; from virDomainGetXMLDesc. 'offset' and 'size' represent an area which must lie entirely within the device or file. 'size' may be 0 to test if the call would succeed. 'buffer' is the return buffer and must be at least 'size' bytes. NB. The remote driver imposes a 64K byte limit on 'size'. For your program to be able to work reliably over a remote connection you should split large requests to &lt;= 65536 bytes.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dom</tt></i>:</span></td><td>pointer to the domain object</td></tr><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td>path to the block device</td></tr><tr><td><span class="term"><i><tt>offset</tt></i>:</span></td><td>offset within block device</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td>size to read</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td>return buffer (must be at least size bytes)</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>unused, always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or -1 in case of failure. really 64 bits</td></tr></tbody></table></div><h3><a name="virDomainBlockStats" id="virDomainBlockStats"><code>virDomainBlockStats</code></a></h3><pre class="programlisting">int	virDomainBlockStats		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> dom, <br />					 const char * path, <br />					 <a href="libvirt-libvirt.html#virDomainBlockStatsPtr">virDomainBlockStatsPtr</a> stats, <br />					 size_t size)<br />
 </pre><p>This function returns block device (disk) stats for block devices attached to the domain. The path parameter is the name of the block device. Get this by calling <a href="libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a> and finding the &lt;target dev='...'&gt; attribute within //domain/devices/disk. (For example, "xvda"). Domains may have more than one block device. To get stats for each you should make multiple calls to this function. Individual fields within the stats structure may be returned as -1, which indicates that the hypervisor does not support that particular statistic.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dom</tt></i>:</span></td><td>pointer to the domain object</td></tr><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td>path to the block device</td></tr><tr><td><span class="term"><i><tt>stats</tt></i>:</span></td><td>block device stats (returned)</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td>size of stats structure</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainCoreDump" id="virDomainCoreDump"><code>virDomainCoreDump</code></a></h3><pre class="programlisting">int	virDomainCoreDump		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 const char * to, <br />					 int flags)<br />
@ -390,7 +392,7 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>launch a defined domain. If the call succeed the domain moves from the defined to the running domains pools.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to a defined domain</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of error</td></tr></tbody></table></div><h3><a name="virDomainCreateLinux" id="virDomainCreateLinux"><code>virDomainCreateLinux</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a>	virDomainCreateLinux	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * xmlDesc, <br />					 unsigned int flags)<br />
 </pre><p>Deprecated after 0.4.6. Renamed to virDomainCreateXML() providing identical functionality. This existing name will left indefinitely for API compatability.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xmlDesc</tt></i>:</span></td><td>string containing an XML description of the domain</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>callers should always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new domain object or NULL in case of failure</td></tr></tbody></table></div><h3><a name="virDomainCreateXML" id="virDomainCreateXML"><code>virDomainCreateXML</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a>	virDomainCreateXML	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * xmlDesc, <br />					 unsigned int flags)<br />
 </pre><p>Launch a new guest domain, based on an XML description similar to the one returned by virDomainGetXMLDesc() This function may requires privileged access to the hypervisor. The domain is not persistent, so its definition will disappear when it is destroyed, or if the host is restarted (see virDomainDefineXML() to define persistent domains).</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xmlDesc</tt></i>:</span></td><td>string containing an XML description of the domain</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>callers should always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new domain object or NULL in case of failure</td></tr></tbody></table></div><h3><a name="virDomainDefineXML" id="virDomainDefineXML"><code>virDomainDefineXML</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a>	virDomainDefineXML	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * xml)<br />
-</pre><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine().</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xml</tt></i>:</span></td><td>the XML description for the domain, preferably in UTF-8</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>NULL in case of error, a pointer to the domain otherwise</td></tr></tbody></table></div><h3><a name="virDomainDestroy" id="virDomainDestroy"><code>virDomainDestroy</code></a></h3><pre class="programlisting">int	virDomainDestroy		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br />
+</pre><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine(). A previous definition for this domain would be overriden if it already exists.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xml</tt></i>:</span></td><td>the XML description for the domain, preferably in UTF-8</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>NULL in case of error, a pointer to the domain otherwise</td></tr></tbody></table></div><h3><a name="virDomainDestroy" id="virDomainDestroy"><code>virDomainDestroy</code></a></h3><pre class="programlisting">int	virDomainDestroy		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br />
 </pre><p>Destroy the domain object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor. This does not free the associated <a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> object. This function may require privileged access</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainDetachDevice" id="virDomainDetachDevice"><code>virDomainDetachDevice</code></a></h3><pre class="programlisting">int	virDomainDetachDevice		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 const char * xml)<br />
 </pre><p>Destroy a virtual device attachment to backend.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to domain object</td></tr><tr><td><span class="term"><i><tt>xml</tt></i>:</span></td><td>pointer to XML description of one device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainFree" id="virDomainFree"><code>virDomainFree</code></a></h3><pre class="programlisting">int	virDomainFree			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br />
 </pre><p>Free the domain object. The running instance is kept alive. The data structure is freed and should not be used thereafter.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainGetAutostart" id="virDomainGetAutostart"><code>virDomainGetAutostart</code></a></h3><pre class="programlisting">int	virDomainGetAutostart		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 int * autostart)<br />
@ -418,7 +420,7 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>Migrate the domain object from its current host to the destination host given by dconn (a connection to the destination host). Flags may be one of more of the following: <a href="libvirt-libvirt.html#VIR_MIGRATE_LIVE">VIR_MIGRATE_LIVE</a> Attempt a live migration. If a hypervisor supports renaming domains during migration, then you may set the dname parameter to the new name (otherwise it keeps the same name). If this is not supported by the hypervisor, dname must be NULL or else you will get an error. Since typically the two hypervisors connect directly to each other in order to perform the migration, you may need to specify a path from the source to the destination. This is the purpose of the uri parameter. If uri is NULL, then libvirt will try to find the best method. Uri may specify the hostname or IP address of the destination host as seen from the source. Or uri may be a URI giving transport, hostname, user, port, etc. in the usual form. Refer to driver documentation for the particular URIs supported. The maximum bandwidth (in Mbps) that will be used to do migration can be specified with the bandwidth parameter. If set to 0, libvirt will choose a suitable default. Some hypervisors do not support this feature and will return an error if bandwidth is not 0. To see which features are supported by the current hypervisor, see virConnectGetCapabilities, /capabilities/host/migration_features. There are many limitations on migration imposed by the underlying technology - for example it may not be possible to migrate between different processors even with the same architecture, or between different types of hypervisor.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>dconn</tt></i>:</span></td><td>destination host (a connection object)</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>flags</td></tr><tr><td><span class="term"><i><tt>dname</tt></i>:</span></td><td>(optional) rename domain to this at destination</td></tr><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td>(optional) dest hostname/URI as seen from the source host</td></tr><tr><td><span class="term"><i><tt>bandwidth</tt></i>:</span></td><td>(optional) specify migration bandwidth limit in Mbps</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the new domain object if the migration was successful, or NULL in case of error. Note that the new domain object exists in the scope of the destination connection (dconn).</td></tr></tbody></table></div><h3><a name="virDomainPinVcpu" id="virDomainPinVcpu"><code>virDomainPinVcpu</code></a></h3><pre class="programlisting">int	virDomainPinVcpu		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 unsigned int vcpu, <br />					 unsigned char * cpumap, <br />					 int maplen)<br />
 </pre><p>Dynamically change the real CPUs which can be allocated to a virtual CPU. This function requires privileged access to the hypervisor.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to domain object, or NULL for Domain0</td></tr><tr><td><span class="term"><i><tt>vcpu</tt></i>:</span></td><td>virtual CPU number</td></tr><tr><td><span class="term"><i><tt>cpumap</tt></i>:</span></td><td>pointer to a bit map of real CPUs (in 8-bit bytes) (IN) Each bit set to 1 means that corresponding CPU is usable. Bytes are stored in little-endian order: CPU0-7, 8-15... In each byte, lowest CPU number is least significant bit.</td></tr><tr><td><span class="term"><i><tt>maplen</tt></i>:</span></td><td>number of bytes in cpumap, from 1 up to size of CPU map in underlying virtualization system (Xen...). If maplen &lt; size, missing bytes are set to zero. If maplen &gt; size, failure code is returned.</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainReboot" id="virDomainReboot"><code>virDomainReboot</code></a></h3><pre class="programlisting">int	virDomainReboot			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 unsigned int flags)<br />
 </pre><p>Reboot a domain, the domain object is still usable there after but the domain OS is being stopped for a restart. Note that the guest OS may ignore the request.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>extra flags for the reboot operation, not used yet</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainRef" id="virDomainRef"><code>virDomainRef</code></a></h3><pre class="programlisting">int	virDomainRef			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br />
-</pre><p>Increment the reference count on the domain. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virDomainFree">virDomainFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virDomainRestore" id="virDomainRestore"><code>virDomainRestore</code></a></h3><pre class="programlisting">int	virDomainRestore		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * from)<br />
+</pre><p>Increment the reference count on the domain. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virDomainFree">virDomainFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>the domain to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainRestore" id="virDomainRestore"><code>virDomainRestore</code></a></h3><pre class="programlisting">int	virDomainRestore		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * from)<br />
 </pre><p>This method will restore a domain saved to disk by virDomainSave().</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td>path to the</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainResume" id="virDomainResume"><code>virDomainResume</code></a></h3><pre class="programlisting">int	virDomainResume			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br />
 </pre><p>Resume an suspended domain, the process is restarted from the state where it was frozen by calling virSuspendDomain(). This function may requires privileged access</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainSave" id="virDomainSave"><code>virDomainSave</code></a></h3><pre class="programlisting">int	virDomainSave			(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 const char * to)<br />
 </pre><p>This method will suspend a domain and save its memory contents to a file on disk. After the call, if successful, the domain is not listed as running anymore (this may be a problem). Use virDomainRestore() to restore a domain after saving.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td>path for the output file</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virDomainSetAutostart" id="virDomainSetAutostart"><code>virDomainSetAutostart</code></a></h3><pre class="programlisting">int	virDomainSetAutostart		(<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br />					 int autostart)<br />
@ -457,10 +459,12 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>Try to lookup a network on the given hypervisor based on its name.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>name for the network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new network object or NULL in case of failure. If the network cannot be found, then <a href="libvirt-virterror.html#VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a> error is raised.</td></tr></tbody></table></div><h3><a name="virNetworkLookupByUUID" id="virNetworkLookupByUUID"><code>virNetworkLookupByUUID</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a>	virNetworkLookupByUUID	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const unsigned char * uuid)<br />
 </pre><p>Try to lookup a network on the given hypervisor based on its UUID.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>uuid</tt></i>:</span></td><td>the raw UUID for the network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new network object or NULL in case of failure. If the network cannot be found, then <a href="libvirt-virterror.html#VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a> error is raised.</td></tr></tbody></table></div><h3><a name="virNetworkLookupByUUIDString" id="virNetworkLookupByUUIDString"><code>virNetworkLookupByUUIDString</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a>	virNetworkLookupByUUIDString	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />						 const char * uuidstr)<br />
 </pre><p>Try to lookup a network on the given hypervisor based on its UUID.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>uuidstr</tt></i>:</span></td><td>the string UUID for the network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new network object or NULL in case of failure. If the network cannot be found, then <a href="libvirt-virterror.html#VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a> error is raised.</td></tr></tbody></table></div><h3><a name="virNetworkRef" id="virNetworkRef"><code>virNetworkRef</code></a></h3><pre class="programlisting">int	virNetworkRef			(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br />
-</pre><p>Increment the reference count on the network. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNetworkFree">virNetworkFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virNetworkSetAutostart" id="virNetworkSetAutostart"><code>virNetworkSetAutostart</code></a></h3><pre class="programlisting">int	virNetworkSetAutostart		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br />					 int autostart)<br />
+</pre><p>Increment the reference count on the network. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNetworkFree">virNetworkFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>the network to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNetworkSetAutostart" id="virNetworkSetAutostart"><code>virNetworkSetAutostart</code></a></h3><pre class="programlisting">int	virNetworkSetAutostart		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br />					 int autostart)<br />
 </pre><p>Configure the network to be automatically started when the host machine boots.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>whether the network should be automatically started 0 or 1</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div><h3><a name="virNetworkUndefine" id="virNetworkUndefine"><code>virNetworkUndefine</code></a></h3><pre class="programlisting">int	virNetworkUndefine		(<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br />
-</pre><p>Undefine a network but does not stop it if it is running</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>pointer to a defined network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of error</td></tr></tbody></table></div><h3><a name="virNodeDeviceDettach" id="virNodeDeviceDettach"><code>virNodeDeviceDettach</code></a></h3><pre class="programlisting">int	virNodeDeviceDettach		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
-</pre><p></p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virNodeDeviceFree" id="virNodeDeviceFree"><code>virNodeDeviceFree</code></a></h3><pre class="programlisting">int	virNodeDeviceFree		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
+</pre><p>Undefine a network but does not stop it if it is running</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>pointer to a defined network</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of error</td></tr></tbody></table></div><h3><a name="virNodeDeviceCreateXML" id="virNodeDeviceCreateXML"><code>virNodeDeviceCreateXML</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a>	virNodeDeviceCreateXML	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />						 const char * xmlDesc, <br />						 unsigned int flags)<br />
+</pre><p>Create a new device on the VM host machine, for example, virtual HBAs created using vport_create.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>xmlDesc</tt></i>:</span></td><td>string containing an XML description of the device to be created</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>callers should always pass 0</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a node device object if successful, NULL in case of failure</td></tr></tbody></table></div><h3><a name="virNodeDeviceDestroy" id="virNodeDeviceDestroy"><code>virNodeDeviceDestroy</code></a></h3><pre class="programlisting">int	virNodeDeviceDestroy		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
+</pre><p>Destroy the device object. The virtual device is removed from the host operating system. This function may require privileged access</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>a device object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeDeviceDettach" id="virNodeDeviceDettach"><code>virNodeDeviceDettach</code></a></h3><pre class="programlisting">int	virNodeDeviceDettach		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
+</pre><p>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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeDeviceFree" id="virNodeDeviceFree"><code>virNodeDeviceFree</code></a></h3><pre class="programlisting">int	virNodeDeviceFree		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
 </pre><p>Drops a reference to the node device, freeing it if this was the last reference.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the 0 for success, -1 for error.</td></tr></tbody></table></div><h3><a name="virNodeDeviceGetName" id="virNodeDeviceGetName"><code>virNodeDeviceGetName</code></a></h3><pre class="programlisting">const char *	virNodeDeviceGetName	(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
 </pre><p>Just return the device name</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the device name or NULL in case of error</td></tr></tbody></table></div><h3><a name="virNodeDeviceGetParent" id="virNodeDeviceGetParent"><code>virNodeDeviceGetParent</code></a></h3><pre class="programlisting">const char *	virNodeDeviceGetParent	(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
 </pre><p>Accessor for the parent of the device</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the name of the device's parent, or NULL if the device has no parent.</td></tr></tbody></table></div><h3><a name="virNodeDeviceGetXMLDesc" id="virNodeDeviceGetXMLDesc"><code>virNodeDeviceGetXMLDesc</code></a></h3><pre class="programlisting">char *	virNodeDeviceGetXMLDesc		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev, <br />					 unsigned int flags)<br />
@ -468,11 +472,11 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>Lists the names of the capabilities supported by the device.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the device</td></tr><tr><td><span class="term"><i><tt>names</tt></i>:</span></td><td>array to collect the list of capability names</td></tr><tr><td><span class="term"><i><tt>maxnames</tt></i>:</span></td><td>size of @names</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of capability names listed in @names.</td></tr></tbody></table></div><h3><a name="virNodeDeviceLookupByName" id="virNodeDeviceLookupByName"><code>virNodeDeviceLookupByName</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a>	virNodeDeviceLookupByName	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />							 const char * name)<br />
 </pre><p>Lookup a node device by its name.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>unique device name</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a <a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> if found, NULL otherwise.</td></tr></tbody></table></div><h3><a name="virNodeDeviceNumOfCaps" id="virNodeDeviceNumOfCaps"><code>virNodeDeviceNumOfCaps</code></a></h3><pre class="programlisting">int	virNodeDeviceNumOfCaps		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
 </pre><p>Accessor for the number of capabilities supported by the device.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of capabilities supported by the device.</td></tr></tbody></table></div><h3><a name="virNodeDeviceReAttach" id="virNodeDeviceReAttach"><code>virNodeDeviceReAttach</code></a></h3><pre class="programlisting">int	virNodeDeviceReAttach		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
-</pre><p>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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virNodeDeviceRef" id="virNodeDeviceRef"><code>virNodeDeviceRef</code></a></h3><pre class="programlisting">int	virNodeDeviceRef		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
-</pre><p>Increment the reference count on the dev. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNodeDeviceFree">virNodeDeviceFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virNodeDeviceReset" id="virNodeDeviceReset"><code>virNodeDeviceReset</code></a></h3><pre class="programlisting">int	virNodeDeviceReset		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
-</pre><p>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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virNodeGetCellsFreeMemory" id="virNodeGetCellsFreeMemory"><code>virNodeGetCellsFreeMemory</code></a></h3><pre class="programlisting">int	virNodeGetCellsFreeMemory	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 unsigned long long * freeMems, <br />					 int startCell, <br />					 int maxCells)<br />
+</pre><p>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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeDeviceRef" id="virNodeDeviceRef"><code>virNodeDeviceRef</code></a></h3><pre class="programlisting">int	virNodeDeviceRef		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
+</pre><p>Increment the reference count on the dev. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virNodeDeviceFree">virNodeDeviceFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>the dev to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeDeviceReset" id="virNodeDeviceReset"><code>virNodeDeviceReset</code></a></h3><pre class="programlisting">int	virNodeDeviceReset		(<a href="libvirt-libvirt.html#virNodeDevicePtr">virNodeDevicePtr</a> dev)<br />
+</pre><p>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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>dev</tt></i>:</span></td><td>pointer to the node device</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeGetCellsFreeMemory" id="virNodeGetCellsFreeMemory"><code>virNodeGetCellsFreeMemory</code></a></h3><pre class="programlisting">int	virNodeGetCellsFreeMemory	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 unsigned long long * freeMems, <br />					 int startCell, <br />					 int maxCells)<br />
 </pre><p>This call returns the amount of free memory in one or more NUMA cells. The @freeMems array must be allocated by the caller and will be filled with the amount of free memory in kilobytes for each cell requested, starting with startCell (in freeMems[0]), up to either (startCell + maxCells), or the number of additional cells in the node, whichever is smaller.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>freeMems</tt></i>:</span></td><td>pointer to the array of unsigned long long</td></tr><tr><td><span class="term"><i><tt>startCell</tt></i>:</span></td><td>index of first cell to return freeMems info on.</td></tr><tr><td><span class="term"><i><tt>maxCells</tt></i>:</span></td><td>Maximum number of cells for which freeMems information can be returned.</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of entries filled in freeMems, or -1 in case of error.</td></tr></tbody></table></div><h3><a name="virNodeGetFreeMemory" id="virNodeGetFreeMemory"><code>virNodeGetFreeMemory</code></a></h3><pre class="programlisting">unsigned long long	virNodeGetFreeMemory	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br />
-</pre><p>provides the free memory available on the Node</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the available free memory in kilobytes or 0 in case of error</td></tr></tbody></table></div><h3><a name="virNodeGetInfo" id="virNodeGetInfo"><code>virNodeGetInfo</code></a></h3><pre class="programlisting">int	virNodeGetInfo			(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 <a href="libvirt-libvirt.html#virNodeInfoPtr">virNodeInfoPtr</a> info)<br />
+</pre><p>provides the free memory available on the Node Note: most libvirt APIs provide memory sizes in kilobytes, but in this function the returned value is in bytes. Divide by 1024 as necessary.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the available free memory in bytes or 0 in case of error</td></tr></tbody></table></div><h3><a name="virNodeGetInfo" id="virNodeGetInfo"><code>virNodeGetInfo</code></a></h3><pre class="programlisting">int	virNodeGetInfo			(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 <a href="libvirt-libvirt.html#virNodeInfoPtr">virNodeInfoPtr</a> info)<br />
 </pre><p>Extract hardware information about the node.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>info</tt></i>:</span></td><td>pointer to a <a href="libvirt-libvirt.html#virNodeInfo">virNodeInfo</a> structure allocated by the user</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virNodeGetSecurityModel" id="virNodeGetSecurityModel"><code>virNodeGetSecurityModel</code></a></h3><pre class="programlisting">int	virNodeGetSecurityModel		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 <a href="libvirt-libvirt.html#virSecurityModelPtr">virSecurityModelPtr</a> secmodel)<br />
 </pre><p>Extract the security model of a hypervisor.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>a connection object</td></tr><tr><td><span class="term"><i><tt>secmodel</tt></i>:</span></td><td>pointer to a <a href="libvirt-libvirt.html#virSecurityModel">virSecurityModel</a> structure</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure, and -2 if the operation is not supported (caller decides if that's an error).</td></tr></tbody></table></div><h3><a name="virNodeListDevices" id="virNodeListDevices"><code>virNodeListDevices</code></a></h3><pre class="programlisting">int	virNodeListDevices		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * cap, <br />					 char ** const names, <br />					 int maxnames, <br />					 unsigned int flags)<br />
 </pre><p>Collect the list of node devices, and store their names in @names If the optional 'cap' argument is non-NULL, then the count will be restricted to devices with the specified capability</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>cap</tt></i>:</span></td><td>capability name</td></tr><tr><td><span class="term"><i><tt>names</tt></i>:</span></td><td>array to collect the list of node device names</td></tr><tr><td><span class="term"><i><tt>maxnames</tt></i>:</span></td><td>size of @names</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>flags (unused, pass 0)</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of node devices found or -1 in case of error</td></tr></tbody></table></div><h3><a name="virNodeNumOfDevices" id="virNodeNumOfDevices"><code>virNodeNumOfDevices</code></a></h3><pre class="programlisting">int	virNodeNumOfDevices		(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />					 const char * cap, <br />					 unsigned int flags)<br />
@ -497,7 +501,7 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>Fetch a storage pool based on its globally unique id</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to hypervisor connection</td></tr><tr><td><span class="term"><i><tt>uuidstr</tt></i>:</span></td><td>globally unique id of pool to fetch</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a <a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> object, or NULL if no matching pool is found</td></tr></tbody></table></div><h3><a name="virStoragePoolLookupByVolume" id="virStoragePoolLookupByVolume"><code>virStoragePoolLookupByVolume</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a>	virStoragePoolLookupByVolume	(<a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a> vol)<br />
 </pre><p>Fetch a storage pool which contains a particular volume</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>vol</tt></i>:</span></td><td>pointer to storage volume</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a <a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> object, or NULL if no matching pool is found</td></tr></tbody></table></div><h3><a name="virStoragePoolNumOfVolumes" id="virStoragePoolNumOfVolumes"><code>virStoragePoolNumOfVolumes</code></a></h3><pre class="programlisting">int	virStoragePoolNumOfVolumes	(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool)<br />
 </pre><p>Fetch the number of storage volumes within a pool</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>pointer to storage pool</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of storage pools, or -1 on failure</td></tr></tbody></table></div><h3><a name="virStoragePoolRef" id="virStoragePoolRef"><code>virStoragePoolRef</code></a></h3><pre class="programlisting">int	virStoragePoolRef		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool)<br />
-</pre><p>Increment the reference count on the pool. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStoragePoolFree">virStoragePoolFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div><h3><a name="virStoragePoolRefresh" id="virStoragePoolRefresh"><code>virStoragePoolRefresh</code></a></h3><pre class="programlisting">int	virStoragePoolRefresh		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br />					 unsigned int flags)<br />
+</pre><p>Increment the reference count on the pool. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStoragePoolFree">virStoragePoolFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>the pool to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div><h3><a name="virStoragePoolRefresh" id="virStoragePoolRefresh"><code>virStoragePoolRefresh</code></a></h3><pre class="programlisting">int	virStoragePoolRefresh		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br />					 unsigned int flags)<br />
 </pre><p>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</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>pointer to storage pool</td></tr><tr><td><span class="term"><i><tt>flags</tt></i>:</span></td><td>flags to control refresh behaviour (currently unused, use 0)</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the volume list was refreshed, -1 on failure</td></tr></tbody></table></div><h3><a name="virStoragePoolSetAutostart" id="virStoragePoolSetAutostart"><code>virStoragePoolSetAutostart</code></a></h3><pre class="programlisting">int	virStoragePoolSetAutostart	(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br />					 int autostart)<br />
 </pre><p>Sets the autostart flag</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>pointer to storage pool</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>new flag setting</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 on success, -1 on failure</td></tr></tbody></table></div><h3><a name="virStoragePoolUndefine" id="virStoragePoolUndefine"><code>virStoragePoolUndefine</code></a></h3><pre class="programlisting">int	virStoragePoolUndefine		(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool)<br />
 </pre><p>Undefine an inactive storage pool</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>pointer to storage pool</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a <a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> object, or NULL if creation failed</td></tr></tbody></table></div><h3><a name="virStorageVolCreateXML" id="virStorageVolCreateXML"><code>virStorageVolCreateXML</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a>	virStorageVolCreateXML	(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br />						 const char * xmldesc, <br />						 unsigned int flags)<br />
@ -513,5 +517,5 @@ int	<a href="#virStorageVolRef">virStorageVolRef</a>		(<a href="libvirt-libvirt.
 </pre><p>Fetch a pointer to a storage volume based on its globally unique key</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to hypervisor connection</td></tr><tr><td><span class="term"><i><tt>key</tt></i>:</span></td><td>globally unique key</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a storage volume, or NULL if not found / error</td></tr></tbody></table></div><h3><a name="virStorageVolLookupByName" id="virStorageVolLookupByName"><code>virStorageVolLookupByName</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a>	virStorageVolLookupByName	(<a href="libvirt-libvirt.html#virStoragePoolPtr">virStoragePoolPtr</a> pool, <br />							 const char * name)<br />
 </pre><p>Fetch a pointer to a storage volume based on its name within a pool</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>pool</tt></i>:</span></td><td>pointer to storage pool</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>name of storage volume</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a storage volume, or NULL if not found / error</td></tr></tbody></table></div><h3><a name="virStorageVolLookupByPath" id="virStorageVolLookupByPath"><code>virStorageVolLookupByPath</code></a></h3><pre class="programlisting"><a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a>	virStorageVolLookupByPath	(<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br />							 const char * path)<br />
 </pre><p>Fetch a pointer to a storage volume based on its locally (host) unique path</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to hypervisor connection</td></tr><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td>locally unique path</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a storage volume, or NULL if not found / error</td></tr></tbody></table></div><h3><a name="virStorageVolRef" id="virStorageVolRef"><code>virStorageVolRef</code></a></h3><pre class="programlisting">int	virStorageVolRef		(<a href="libvirt-libvirt.html#virStorageVolPtr">virStorageVolPtr</a> vol)<br />
-</pre><p>Increment the reference count on the vol. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStorageVolFree">virStorageVolFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>vol</tt></i>:</span></td><td></td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td></td></tr></tbody></table></div></div></div><div id="footer"><p id="sponsor">
+</pre><p>Increment the reference count on the vol. For each additional call to this method, there shall be a corresponding call to <a href="libvirt-libvirt.html#virStorageVolFree">virStorageVolFree</a> 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.</p><div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>vol</tt></i>:</span></td><td>the vol to hold a reference on</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, -1 in case of failure.</td></tr></tbody></table></div></div></div><div id="footer"><p id="sponsor">
 	    Sponsored by:<br /><a href="http://et.redhat.com/"><img src="../et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p></div></body></html>
--- a/docs/html/libvirt-virterror.html
+++ b/docs/html/libvirt-virterror.html
@ -27,7 +27,7 @@ void	<a href="#virSetErrorFunc">virSetErrorFunc</a>			(void * userData, <br />
 </pre><table><tr><td>int</td><td>code</td><td> : The error code, a <a href="libvirt-virterror.html#virErrorNumber">virErrorNumber</a></td></tr><tr><td>int</td><td>domain</td><td> : What part of the library raised this error</td></tr><tr><td>char *</td><td>message</td><td> : human-readable informative error message</td></tr><tr><td><a href="libvirt-virterror.html#virErrorLevel">virErrorLevel</a></td><td>level</td><td> : how consequent is the error</td></tr><tr><td><a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a></td><td>conn</td><td> : connection if available, deprecated see note above</td></tr><tr><td><a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a></td><td>dom</td><td> : domain if available, deprecated see note above</td></tr><tr><td>char *</td><td>str1</td><td> : extra string information</td></tr><tr><td>char *</td><td>str2</td><td> : extra string information</td></tr><tr><td>char *</td><td>str3</td><td> : extra string information</td></tr><tr><td>int</td><td>int1</td><td> : extra number information</td></tr><tr><td>int</td><td>int2</td><td> : extra number information</td></tr><tr><td><a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a></td><td>net</td><td> : network if available, deprecated see note above</td></tr></table><pre>
 }
 </pre></div><h3><a name="virErrorDomain" id="virErrorDomain"><code>virErrorDomain</code></a></h3><div class="api"><pre>enum virErrorDomain {
-</pre><table><tr><td><a name="VIR_FROM_NONE" id="VIR_FROM_NONE">VIR_FROM_NONE</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_FROM_XEN" id="VIR_FROM_XEN">VIR_FROM_XEN</a></td><td> = </td><td>1</td><td> : Error at Xen hypervisor layer</td></tr><tr><td><a name="VIR_FROM_XEND" id="VIR_FROM_XEND">VIR_FROM_XEND</a></td><td> = </td><td>2</td><td> : Error at connection with xend daemon</td></tr><tr><td><a name="VIR_FROM_XENSTORE" id="VIR_FROM_XENSTORE">VIR_FROM_XENSTORE</a></td><td> = </td><td>3</td><td> : Error at connection with xen store</td></tr><tr><td><a name="VIR_FROM_SEXPR" id="VIR_FROM_SEXPR">VIR_FROM_SEXPR</a></td><td> = </td><td>4</td><td> : Error in the S-Expression code</td></tr><tr><td><a name="VIR_FROM_XML" id="VIR_FROM_XML">VIR_FROM_XML</a></td><td> = </td><td>5</td><td> : Error in the XML code</td></tr><tr><td><a name="VIR_FROM_DOM" id="VIR_FROM_DOM">VIR_FROM_DOM</a></td><td> = </td><td>6</td><td> : Error when operating on a domain</td></tr><tr><td><a name="VIR_FROM_RPC" id="VIR_FROM_RPC">VIR_FROM_RPC</a></td><td> = </td><td>7</td><td> : Error in the XML-RPC code</td></tr><tr><td><a name="VIR_FROM_PROXY" id="VIR_FROM_PROXY">VIR_FROM_PROXY</a></td><td> = </td><td>8</td><td> : Error in the proxy code</td></tr><tr><td><a name="VIR_FROM_CONF" id="VIR_FROM_CONF">VIR_FROM_CONF</a></td><td> = </td><td>9</td><td> : Error in the configuration file handling</td></tr><tr><td><a name="VIR_FROM_QEMU" id="VIR_FROM_QEMU">VIR_FROM_QEMU</a></td><td> = </td><td>10</td><td> : Error at the QEMU daemon</td></tr><tr><td><a name="VIR_FROM_NET" id="VIR_FROM_NET">VIR_FROM_NET</a></td><td> = </td><td>11</td><td> : Error when operating on a network</td></tr><tr><td><a name="VIR_FROM_TEST" id="VIR_FROM_TEST">VIR_FROM_TEST</a></td><td> = </td><td>12</td><td> : Error from test driver</td></tr><tr><td><a name="VIR_FROM_REMOTE" id="VIR_FROM_REMOTE">VIR_FROM_REMOTE</a></td><td> = </td><td>13</td><td> : Error from remote driver</td></tr><tr><td><a name="VIR_FROM_OPENVZ" id="VIR_FROM_OPENVZ">VIR_FROM_OPENVZ</a></td><td> = </td><td>14</td><td> : Error from OpenVZ driver</td></tr><tr><td><a name="VIR_FROM_XENXM" id="VIR_FROM_XENXM">VIR_FROM_XENXM</a></td><td> = </td><td>15</td><td> : Error at Xen XM layer</td></tr><tr><td><a name="VIR_FROM_STATS_LINUX" id="VIR_FROM_STATS_LINUX">VIR_FROM_STATS_LINUX</a></td><td> = </td><td>16</td><td> : Error in the Linux Stats code</td></tr><tr><td><a name="VIR_FROM_LXC" id="VIR_FROM_LXC">VIR_FROM_LXC</a></td><td> = </td><td>17</td><td> : Error from Linux Container driver</td></tr><tr><td><a name="VIR_FROM_STORAGE" id="VIR_FROM_STORAGE">VIR_FROM_STORAGE</a></td><td> = </td><td>18</td><td> : Error from storage driver</td></tr><tr><td><a name="VIR_FROM_NETWORK" id="VIR_FROM_NETWORK">VIR_FROM_NETWORK</a></td><td> = </td><td>19</td><td> : Error from network config</td></tr><tr><td><a name="VIR_FROM_DOMAIN" id="VIR_FROM_DOMAIN">VIR_FROM_DOMAIN</a></td><td> = </td><td>20</td><td> : Error from domain config</td></tr><tr><td><a name="VIR_FROM_UML" id="VIR_FROM_UML">VIR_FROM_UML</a></td><td> = </td><td>21</td><td> : Error at the UML driver</td></tr><tr><td><a name="VIR_FROM_NODEDEV" id="VIR_FROM_NODEDEV">VIR_FROM_NODEDEV</a></td><td> = </td><td>22</td><td> : Error from node device monitor</td></tr><tr><td><a name="VIR_FROM_XEN_INOTIFY" id="VIR_FROM_XEN_INOTIFY">VIR_FROM_XEN_INOTIFY</a></td><td> = </td><td>23</td><td> : Error from xen inotify layer</td></tr><tr><td><a name="VIR_FROM_SECURITY" id="VIR_FROM_SECURITY">VIR_FROM_SECURITY</a></td><td> = </td><td>24</td><td> : Error from security framework</td></tr></table><pre>}
+</pre><table><tr><td><a name="VIR_FROM_NONE" id="VIR_FROM_NONE">VIR_FROM_NONE</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_FROM_XEN" id="VIR_FROM_XEN">VIR_FROM_XEN</a></td><td> = </td><td>1</td><td> : Error at Xen hypervisor layer</td></tr><tr><td><a name="VIR_FROM_XEND" id="VIR_FROM_XEND">VIR_FROM_XEND</a></td><td> = </td><td>2</td><td> : Error at connection with xend daemon</td></tr><tr><td><a name="VIR_FROM_XENSTORE" id="VIR_FROM_XENSTORE">VIR_FROM_XENSTORE</a></td><td> = </td><td>3</td><td> : Error at connection with xen store</td></tr><tr><td><a name="VIR_FROM_SEXPR" id="VIR_FROM_SEXPR">VIR_FROM_SEXPR</a></td><td> = </td><td>4</td><td> : Error in the S-Expression code</td></tr><tr><td><a name="VIR_FROM_XML" id="VIR_FROM_XML">VIR_FROM_XML</a></td><td> = </td><td>5</td><td> : Error in the XML code</td></tr><tr><td><a name="VIR_FROM_DOM" id="VIR_FROM_DOM">VIR_FROM_DOM</a></td><td> = </td><td>6</td><td> : Error when operating on a domain</td></tr><tr><td><a name="VIR_FROM_RPC" id="VIR_FROM_RPC">VIR_FROM_RPC</a></td><td> = </td><td>7</td><td> : Error in the XML-RPC code</td></tr><tr><td><a name="VIR_FROM_PROXY" id="VIR_FROM_PROXY">VIR_FROM_PROXY</a></td><td> = </td><td>8</td><td> : Error in the proxy code</td></tr><tr><td><a name="VIR_FROM_CONF" id="VIR_FROM_CONF">VIR_FROM_CONF</a></td><td> = </td><td>9</td><td> : Error in the configuration file handling</td></tr><tr><td><a name="VIR_FROM_QEMU" id="VIR_FROM_QEMU">VIR_FROM_QEMU</a></td><td> = </td><td>10</td><td> : Error at the QEMU daemon</td></tr><tr><td><a name="VIR_FROM_NET" id="VIR_FROM_NET">VIR_FROM_NET</a></td><td> = </td><td>11</td><td> : Error when operating on a network</td></tr><tr><td><a name="VIR_FROM_TEST" id="VIR_FROM_TEST">VIR_FROM_TEST</a></td><td> = </td><td>12</td><td> : Error from test driver</td></tr><tr><td><a name="VIR_FROM_REMOTE" id="VIR_FROM_REMOTE">VIR_FROM_REMOTE</a></td><td> = </td><td>13</td><td> : Error from remote driver</td></tr><tr><td><a name="VIR_FROM_OPENVZ" id="VIR_FROM_OPENVZ">VIR_FROM_OPENVZ</a></td><td> = </td><td>14</td><td> : Error from OpenVZ driver</td></tr><tr><td><a name="VIR_FROM_XENXM" id="VIR_FROM_XENXM">VIR_FROM_XENXM</a></td><td> = </td><td>15</td><td> : Error at Xen XM layer</td></tr><tr><td><a name="VIR_FROM_STATS_LINUX" id="VIR_FROM_STATS_LINUX">VIR_FROM_STATS_LINUX</a></td><td> = </td><td>16</td><td> : Error in the Linux Stats code</td></tr><tr><td><a name="VIR_FROM_LXC" id="VIR_FROM_LXC">VIR_FROM_LXC</a></td><td> = </td><td>17</td><td> : Error from Linux Container driver</td></tr><tr><td><a name="VIR_FROM_STORAGE" id="VIR_FROM_STORAGE">VIR_FROM_STORAGE</a></td><td> = </td><td>18</td><td> : Error from storage driver</td></tr><tr><td><a name="VIR_FROM_NETWORK" id="VIR_FROM_NETWORK">VIR_FROM_NETWORK</a></td><td> = </td><td>19</td><td> : Error from network config</td></tr><tr><td><a name="VIR_FROM_DOMAIN" id="VIR_FROM_DOMAIN">VIR_FROM_DOMAIN</a></td><td> = </td><td>20</td><td> : Error from domain config</td></tr><tr><td><a name="VIR_FROM_UML" id="VIR_FROM_UML">VIR_FROM_UML</a></td><td> = </td><td>21</td><td> : Error at the UML driver</td></tr><tr><td><a name="VIR_FROM_NODEDEV" id="VIR_FROM_NODEDEV">VIR_FROM_NODEDEV</a></td><td> = </td><td>22</td><td> : Error from node device monitor</td></tr><tr><td><a name="VIR_FROM_XEN_INOTIFY" id="VIR_FROM_XEN_INOTIFY">VIR_FROM_XEN_INOTIFY</a></td><td> = </td><td>23</td><td> : Error from xen inotify layer</td></tr><tr><td><a name="VIR_FROM_SECURITY" id="VIR_FROM_SECURITY">VIR_FROM_SECURITY</a></td><td> = </td><td>24</td><td> : Error from security framework</td></tr><tr><td><a name="VIR_FROM_VBOX" id="VIR_FROM_VBOX">VIR_FROM_VBOX</a></td><td> = </td><td>25</td><td> : Error from VirtualBox driver</td></tr></table><pre>}
 </pre></div><h3><a name="virErrorLevel" id="virErrorLevel"><code>virErrorLevel</code></a></h3><div class="api"><pre>enum virErrorLevel {
 </pre><table><tr><td><a name="VIR_ERR_NONE" id="VIR_ERR_NONE">VIR_ERR_NONE</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_ERR_WARNING" id="VIR_ERR_WARNING">VIR_ERR_WARNING</a></td><td> = </td><td>1</td><td> : A simple warning</td></tr><tr><td><a name="VIR_ERR_ERROR" id="VIR_ERR_ERROR">VIR_ERR_ERROR</a></td><td> = </td><td>2</td><td> : An error</td></tr></table><pre>}
 </pre></div><h3><a name="virErrorNumber" id="virErrorNumber"><code>virErrorNumber</code></a></h3><div class="api"><pre>enum virErrorNumber {
--- a/docs/hvsupport.html
+++ b/docs/hvsupport.html
--- a/docs/hvsupport.html.in
+++ b/docs/hvsupport.html.in
@ -21,6 +21,7 @@ updated on <i>2008-06-05</i>.
        <th><a href="drvqemu.html">QEMU</a></th>
        <th><a href="drvkvm.html">KVM</a></th>
        <th><a href="remote.html">Remote</a></th>
+        <th><a href="drvvbox.html">VirtualBox</a></th>
      </tr>
      <tr>
        <td> virConnectClose </td>
@ -29,6 +30,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectGetCapabilities </td>
@ -37,6 +39,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectGetHostname </td>
@ -45,6 +48,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.3.3 </td>
        <td> &#x2265; 0.3.3 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectGetMaxVcpus </td>
@ -53,6 +57,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virConnectGetType </td>
@ -61,6 +66,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectGetURI </td>
@ -69,6 +75,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.3.0 </td>
        <td> &#x2265; 0.3.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectGetVersion </td>
@ -77,6 +84,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectListDefinedDomains </td>
@ -85,6 +93,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectListDomains </td>
@ -93,6 +102,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectNumOfDefinedDomains </td>
@ -101,6 +111,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectNumOfDomains </td>
@ -109,6 +120,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectOpen </td>
@ -117,6 +129,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virConnectOpenAuth </td>
@ -125,6 +138,7 @@ updated on <i>2008-06-05</i>.
        <td>  </td>
        <td>  </td>
        <td>  </td>
+        <td>  </td>
      </tr>
      <tr>
        <td> virConnectOpenReadOnly </td>
@ -133,6 +147,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainAttachDevice </td>
@ -141,6 +156,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainBlockPeek </td>
@ -149,6 +165,7 @@ updated on <i>2008-06-05</i>.
        <td> 0.4.3 </td>
        <td> 0.4.3 </td>
        <td> x </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainBlockStats </td>
@ -157,6 +174,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.2 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainCoreDump </td>
@ -165,6 +183,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainCreate </td>
@ -173,6 +192,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainCreateLinux </td>
@ -181,6 +201,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainDefineXML </td>
@ -189,6 +210,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainDestroy </td>
@ -197,6 +219,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainDetachDevice </td>
@ -205,6 +228,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainFree </td>
@ -213,6 +237,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetAutostart </td>
@ -221,11 +246,12 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainGetConnect </td>
        <td> 0.3.0 </td>
-        <td colspan="4"> not a HV function </td>
+        <td colspan="5"> not a HV function </td>
      </tr>
      <tr>
        <td> virDomainGetID </td>
@ -234,6 +260,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetInfo </td>
@ -242,6 +269,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetMaxMemory </td>
@ -250,6 +278,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetMaxVcpus </td>
@ -258,6 +287,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainGetName </td>
@ -266,6 +296,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetOSType </td>
@ -274,6 +305,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetSchedulerParameters </td>
@ -282,6 +314,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainGetSchedulerType </td>
@ -290,6 +323,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainGetUUID </td>
@ -298,6 +332,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetUUIDString </td>
@ -306,6 +341,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainGetVcpus </td>
@ -314,6 +350,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainInterfaceStats </td>
@ -322,6 +359,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.2 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainGetXMLDesc </td>
@ -330,6 +368,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainLookupByID </td>
@ -338,6 +377,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainLookupByName </td>
@ -346,6 +386,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainLookupByUUID </td>
@ -354,6 +395,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainLookupByUUIDString </td>
@ -362,6 +404,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainMigrate </td>
@ -370,6 +413,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> 0.3.2 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainPinVcpu </td>
@ -378,6 +422,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainReboot </td>
@ -386,6 +431,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainRestore </td>
@ -394,6 +440,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> &#x2265; 0.3.2 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainResume </td>
@ -402,6 +449,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainSave </td>
@ -410,6 +458,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> &#x2265; 0.3.2 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainSetAutostart </td>
@ -418,6 +467,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.2.1 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainSetMaxMemory </td>
@ -434,6 +484,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainSetSchedulerParameters </td>
@ -442,6 +493,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainSetVcpus </td>
@ -450,6 +502,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virDomainShutdown </td>
@ -458,6 +511,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainSuspend </td>
@ -466,6 +520,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virDomainUndefine </td>
@ -474,17 +529,18 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virGetVersion </td>
        <td> All </td>
        <td> All </td>
-        <td colspan="3"> Returns -1 if HV unsupported. </td>
+        <td colspan="4"> Returns -1 if HV unsupported. </td>
      </tr>
      <tr>
        <td> virInitialize </td>
        <td> 0.1.0 </td>
-        <td colspan="4"> not a HV function </td>
+        <td colspan="5"> not a HV function </td>
      </tr>
      <tr>
        <td> virDomainMemoryPeek </td>
@ -493,6 +549,7 @@ updated on <i>2008-06-05</i>.
        <td> 0.4.3 </td>
        <td> 0.4.3 </td>
        <td> x </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virNodeGetInfo </td>
@ -501,6 +558,7 @@ updated on <i>2008-06-05</i>.
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.2.0 </td>
        <td> &#x2265; 0.3.0 </td>
+        <td> &#x2265; 0.6.3 </td>
      </tr>
      <tr>
        <td> virNodeGetFreeMemory </td>
@ -509,6 +567,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> x </td>
+        <td> x </td>
      </tr>
      <tr>
        <td> virNodeGetCellsFreeMemory </td>
@ -517,6 +576,7 @@ updated on <i>2008-06-05</i>.
        <td> x </td>
        <td> x </td>
        <td> x </td>
+        <td> x </td>
      </tr>
    </table>
    <h3>Network functions</h3>
--- a/docs/index.html
+++ b/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>
--- a/docs/index.html.in
+++ b/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>
--- a/docs/intro.html
+++ b/docs/intro.html
@ -50,6 +50,10 @@
                        <div>
                          <a title="Terminology and goals of libvirt API" class="inactive" href="goals.html">Goals</a>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="The libvirt API concepts" class="inactive" href="api.html">API concepts</a>
+                        </div>
                      </li><li>
                        <div>
                          <a title="Managing virtual machines" class="inactive" href="archdomain.html">Domains</a>
--- a/docs/libvirt-api.xml
+++ b/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'/>
@ -356,6 +358,7 @@
     <exports symbol='VIR_ERR_AUTH_FAILED' type='enum'/>
     <exports symbol='VIR_FROM_XML' type='enum'/>
     <exports symbol='VIR_ERR_OPERATION_DENIED' type='enum'/>
+     <exports symbol='VIR_FROM_VBOX' type='enum'/>
     <exports symbol='VIR_FROM_STORAGE' type='enum'/>
     <exports symbol='VIR_ERR_NO_KERNEL' type='enum'/>
     <exports symbol='VIR_WAR_NO_STORAGE' type='enum'/>
@ -608,12 +611,13 @@
    <enum name='VIR_FROM_QEMU' file='virterror' value='10' type='virErrorDomain' info='Error at the QEMU daemon'/>
    <enum name='VIR_FROM_REMOTE' file='virterror' value='13' type='virErrorDomain' info='Error from remote driver'/>
    <enum name='VIR_FROM_RPC' file='virterror' value='7' type='virErrorDomain' info='Error in the XML-RPC code'/>
-    <enum name='VIR_FROM_SECURITY' file='virterror' value='24' type='virErrorDomain' info=' Error from security framework'/>
+    <enum name='VIR_FROM_SECURITY' file='virterror' value='24' type='virErrorDomain' info='Error from security framework'/>
    <enum name='VIR_FROM_SEXPR' file='virterror' value='4' type='virErrorDomain' info='Error in the S-Expression code'/>
    <enum name='VIR_FROM_STATS_LINUX' file='virterror' value='16' type='virErrorDomain' info='Error in the Linux Stats code'/>
    <enum name='VIR_FROM_STORAGE' file='virterror' value='18' type='virErrorDomain' info='Error from storage driver'/>
    <enum name='VIR_FROM_TEST' file='virterror' value='12' type='virErrorDomain' info='Error from test driver'/>
    <enum name='VIR_FROM_UML' file='virterror' value='21' type='virErrorDomain' info='Error at the UML driver'/>
+    <enum name='VIR_FROM_VBOX' file='virterror' value='25' type='virErrorDomain' info=' Error from VirtualBox driver'/>
    <enum name='VIR_FROM_XEN' file='virterror' value='1' type='virErrorDomain' info='Error at Xen hypervisor layer'/>
    <enum name='VIR_FROM_XEND' file='virterror' value='2' type='virErrorDomain' info='Error at connection with xend daemon'/>
    <enum name='VIR_FROM_XENSTORE' file='virterror' value='3' type='virErrorDomain' info='Error at connection with xen store'/>
@ -995,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'>
@ -1059,7 +1063,7 @@ see note above'/>
      <arg name='flags' type='unsigned int' info='callers should always pass 0'/>
    </function>
    <function name='virDomainDefineXML' file='libvirt' module='libvirt'>
-      <info>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine().</info>
+      <info>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with virDomainUndefine(). A previous definition for this domain would be overriden if it already exists.</info>
      <return type='virDomainPtr' info='NULL in case of error, a pointer to the domain otherwise'/>
      <arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
      <arg name='xml' type='const char *' info='the XML description for the domain, preferably in UTF-8'/>
@ -1235,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>
@ -1481,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>
@ -1495,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>
@ -1541,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'>
@ -1563,8 +1579,8 @@ see note above'/>
      <arg name='maxCells' type='int' info='Maximum number of cells for which freeMems information can be returned.'/>
    </function>
    <function name='virNodeGetFreeMemory' file='libvirt' module='libvirt'>
-      <info>provides the free memory available on the Node</info>
-      <return type='unsigned long long' info='the available free memory in kilobytes or 0 in case of error'/>
+      <info>provides the free memory available on the Node Note: most libvirt APIs provide memory sizes in kilobytes, but in this function the returned value is in bytes. Divide by 1024 as necessary.</info>
+      <return type='unsigned long long' info='the available free memory in bytes or 0 in case of error'/>
      <arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
    </function>
    <function name='virNodeGetInfo' file='libvirt' module='libvirt'>
@ -1733,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>
@ -1823,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>
--- a/docs/libvirt-daemon-arch.fig
+++ b/docs/libvirt-daemon-arch.fig
@ -0,0 +1,114 @@
+#FIG 3.2  Produced by xfig version 3.2.5
+Landscape
+Center
+Inches
+Letter  
+100.00
+Single
+-2
+1200 2
+6 75 150 13050 5100
+6 4425 764 5938 1150
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 764 5938 764 5938 1150 4425 1150 4425 764
+4 0 0 50 -1 16 15 0.0000 4 131 415 4519 1053 xen\001
+-6
+6 4425 1246 5938 1631
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 1246 5938 1246 5938 1631 4425 1631 4425 1246
+4 0 0 50 -1 16 15 0.0000 4 178 640 4519 1535 qemu\001
+-6
+6 4425 1728 5938 2113
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 1728 5938 1728 5938 2113 4425 2113 4425 1728
+4 0 0 50 -1 16 15 0.0000 4 178 829 4519 2017 openvz\001
+-6
+6 4425 2210 5938 2595
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 2210 5938 2210 5938 2595 4425 2595 4425 2210
+4 0 0 50 -1 16 15 0.0000 4 178 320 4519 2499 lxc\001
+-6
+6 4425 2691 5938 3077
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 2691 5938 2691 5938 3077 4425 3077 4425 2691
+4 0 0 50 -1 16 15 0.0000 4 166 415 4519 2980 test\001
+-6
+6 4425 3173 5938 3559
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 4425 3173 5938 3173 5938 3559 4425 3559 4425 3173
+4 0 0 50 -1 16 15 0.0000 4 166 794 4519 3462 remote\001
+-6
+6 11328 764 12842 1150
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 764 12842 764 12842 1150 11328 1150 11328 764
+4 0 0 50 -1 16 15 0.0000 4 131 415 11423 1053 xen\001
+-6
+6 11328 1246 12842 1631
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 1246 12842 1246 12842 1631 11328 1631 11328 1246
+4 0 0 50 -1 16 15 0.0000 4 178 640 11423 1535 qemu\001
+-6
+6 11328 1728 12842 2113
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 1728 12842 1728 12842 2113 11328 2113 11328 1728
+4 0 0 50 -1 16 15 0.0000 4 178 829 11423 2017 openvz\001
+-6
+6 11328 2210 12842 2595
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 2210 12842 2210 12842 2595 11328 2595 11328 2210
+4 0 0 50 -1 16 15 0.0000 4 178 320 11423 2499 lxc\001
+-6
+6 11328 2691 12842 3077
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 2691 12842 2691 12842 3077 11328 3077 11328 2691
+4 0 0 50 -1 16 15 0.0000 4 166 415 11423 2980 test\001
+-6
+6 11328 3173 12842 3559
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 11328 3173 12842 3173 12842 3559 11328 3559 11328 3173
+4 0 0 50 -1 16 15 0.0000 4 166 794 11423 3462 remote\001
+-6
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 75 1342 1587 1342 1587 2113 75 2113 75 1342
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 2
+	0 0 1.00 76.37 152.74
+	 1587 1728 3101 1728
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 4
+	0 0 1.00 76.37 152.74
+	 5938 3365 6883 3365 7262 1728 7640 1728
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 4
+	0 0 1.00 76.37 152.74
+	 3101 1728 3858 1728 4141 3365 4425 3365
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 3101 572 6127 572 6127 3751 3101 3751 3101 572
+2 1 0 5 0 7 50 -1 -1 12.000 0 0 -1 0 0 2
+	 3101 572 3101 3751
+2 1 2 5 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 3858 572 3858 3751
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 2
+	0 0 1.00 76.37 152.74
+	 9154 1728 10004 1728
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 7640 1342 9154 1342 9154 2113 7640 2113 7640 1342
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 4
+	0 0 1.00 76.37 152.74
+	 10004 1728 10760 1728 10950 2402 11328 2402
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 10004 572 13030 572 13030 3751 10004 3751 10004 572
+2 1 0 5 0 7 50 -1 -1 12.000 0 0 -1 0 0 2
+	 10004 572 10004 3751
+2 1 2 5 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 10760 572 10760 3751
+4 0 0 50 -1 16 15 0.0000 4 225 1256 170 1728 Application\001
+4 0 0 50 -1 16 13 0.0000 4 154 367 1966 1631 URI\001
+4 0 0 50 -1 16 15 5.3233 4 178 1149 3763 4040 Driver API\001
+4 0 0 50 -1 16 15 5.3233 4 178 1173 3101 4040 Public API\001
+4 0 0 50 -1 16 15 5.3233 4 225 1233 4992 4040 Driver Impl\001
+4 0 0 50 -1 16 18 0.0000 4 213 652 3763 379 libvirt\001
+4 0 0 50 -1 16 13 0.0000 4 154 901 1966 2017 lxc://host/\001
+4 0 0 50 -1 16 15 0.0000 4 178 747 7734 1728 libvirtd\001
+4 0 0 50 -1 16 15 5.3233 4 178 1149 10666 4040 Driver API\001
+4 0 0 50 -1 16 15 5.3233 4 178 1173 10004 4040 Public API\001
+4 0 0 50 -1 16 15 5.3233 4 225 1233 11896 4040 Driver Impl\001
+4 0 0 50 -1 16 18 0.0000 4 213 652 10666 379 libvirt\001
+-6
--- a/docs/libvirt-daemon-arch.png
+++ b/docs/libvirt-daemon-arch.png
--- a/docs/libvirt-driver-arch.fig
+++ b/docs/libvirt-driver-arch.fig
@ -0,0 +1,62 @@
+#FIG 3.2  Produced by xfig version 3.2.5
+Landscape
+Center
+Inches
+Letter  
+100.00
+Single
+-2
+1200 2
+6 1200 225 10950 8147
+6 8208 1291 10646 1900
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 1291 10646 1291 10646 1900 8208 1900 8208 1291
+4 0 0 50 -1 16 24 0.0000 4 214 639 8360 1748 xen\001
+-6
+6 8208 2054 10646 2662
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 2054 10646 2054 10646 2662 8208 2662 8208 2054
+4 0 0 50 -1 16 24 0.0000 4 305 975 8360 2510 qemu\001
+-6
+6 8208 2815 10646 3424
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 2815 10646 2815 10646 3424 8208 3424 8208 2815
+4 0 0 50 -1 16 24 0.0000 4 305 1280 8360 3272 openvz\001
+-6
+6 8208 3577 10646 4187
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 3577 10646 3577 10646 4187 8208 4187 8208 3577
+4 0 0 50 -1 16 24 0.0000 4 304 518 8360 4033 lxc\001
+-6
+6 8208 4339 10646 4948
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 4339 10646 4339 10646 4948 8208 4948 8208 4339
+4 0 0 50 -1 16 24 0.0000 4 274 670 8360 4795 test\001
+-6
+6 8208 5100 10646 5710
+2 2 0 1 0 7 50 -1 -1 4.000 0 0 7 0 0 5
+	 8208 5100 10646 5100 10646 5710 8208 5710 8208 5100
+4 0 0 50 -1 16 24 0.0000 4 274 1219 8360 5557 remote\001
+-6
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 1200 2206 3637 2206 3637 3424 1200 3424 1200 2206
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 2
+	0 0 1.00 121.88 243.75
+	 3637 2815 6075 2815
+2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 1 0 4
+	0 0 1.00 121.88 243.75
+	 6075 2815 7294 2815 7598 3881 8208 3881
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 6075 987 10950 987 10950 6014 6075 6014 6075 987
+2 1 0 5 0 7 50 -1 -1 12.000 0 0 -1 0 0 2
+	 6075 987 6075 6014
+2 1 2 5 0 7 50 -1 -1 3.000 0 0 -1 0 0 2
+	 7294 987 7294 6014
+4 0 0 50 -1 16 24 0.0000 4 395 1950 1352 2815 Application\001
+4 0 0 50 -1 16 20 0.0000 4 244 579 4246 2662 URI\001
+4 0 0 50 -1 16 20 0.0000 4 244 792 4246 3272 lxc:///\001
+4 0 0 50 -1 16 24 5.3233 4 304 1828 7142 6472 Driver API\001
+4 0 0 50 -1 16 24 5.3233 4 304 1889 6075 6472 Public API\001
+4 0 0 50 -1 16 24 5.3233 4 395 1920 9121 6472 Driver Impl\001
+4 0 0 50 -1 16 28 0.0000 4 366 1157 7142 682 libvirt\001
+-6
--- a/docs/libvirt-driver-arch.png
+++ b/docs/libvirt-driver-arch.png
--- a/docs/libvirt-object-model.fig
+++ b/docs/libvirt-object-model.fig
@ -0,0 +1,61 @@
+#FIG 3.2  Produced by xfig version 3.2.5
+Landscape
+Center
+Inches
+Letter  
+100.00
+Single
+-2
+1200 2
+6 1200 1200 10274 6975
+6 4500 1200 6974 2025
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 4500 1200 6974 1200 6974 2025 4500 2025 4500 1200
+4 0 0 50 -1 16 17 0.0000 4 202 1679 4603 1613 virConnectPtr\001
+-6
+6 1200 3675 3675 4500
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 1200 3675 3675 3675 3675 4500 1200 4500 1200 3675
+4 0 0 50 -1 16 17 0.0000 4 202 1595 1303 4087 virDomainPtr\001
+-6
+6 1200 6150 3675 6975
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 1200 6150 3675 6150 3675 6975 1200 6975 1200 6150
+4 0 0 50 -1 16 17 0.0000 4 202 1667 1303 6562 virNetworkPtr\001
+-6
+6 7799 3675 10274 4500
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 7799 3675 10274 3675 10274 4500 7799 4500 7799 3675
+4 0 0 50 -1 16 17 0.0000 4 262 2155 7902 4087 virStoragePoolPtr\001
+-6
+6 7799 6150 10274 6975
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 7799 6150 10274 6150 10274 6975 7799 6975 7799 6150
+4 0 0 50 -1 16 17 0.0000 4 262 2000 7902 6562 virStorageVolPtr\001
+-6
+3 0 0 1 0 7 50 -1 -1 0.000 0 1 0 3
+	0 0 1.00 82.50 164.99
+	 4706 2025 4706 4087 3675 4087
+	 0.000 1.000 0.000
+3 0 0 1 0 7 50 -1 -1 0.000 0 1 0 3
+	0 0 1.00 82.50 164.99
+	 6768 2025 6768 4087 7799 4087
+	 0.000 1.000 0.000
+3 0 0 1 0 7 50 -1 -1 0.000 0 1 0 3
+	0 0 1.00 82.50 164.99
+	 6562 2025 6562 6562 7799 6562
+	 0.000 1.000 0.000
+3 0 0 1 0 7 50 -1 -1 0.000 0 1 0 3
+	0 0 1.00 82.50 164.99
+	 4912 2025 4912 6562 3675 6562
+	 0.000 1.000 0.000
+3 0 0 1 0 7 50 -1 -1 0.000 0 1 0 2
+	0 0 1.00 82.50 164.99
+	 8933 4500 8933 6150
+	 0.000 0.000
+4 0 0 50 -1 16 17 0.0000 4 143 155 3881 3985 n\001
+4 0 0 50 -1 16 17 0.0000 4 143 155 3881 6459 n\001
+4 0 0 50 -1 16 17 0.0000 4 143 155 7387 6459 n\001
+4 0 0 50 -1 16 17 0.0000 4 143 155 7387 3985 n\001
+4 0 0 50 -1 16 17 0.0000 4 143 155 8727 5944 n\001
+-6
--- a/docs/libvirt-object-model.png
+++ b/docs/libvirt-object-model.png
--- a/docs/libvirt-refs.xml
+++ b/docs/libvirt-refs.xml
@ -132,6 +132,7 @@
    <reference name='VIR_FROM_STORAGE' href='html/libvirt-virterror.html#VIR_FROM_STORAGE'/>
    <reference name='VIR_FROM_TEST' href='html/libvirt-virterror.html#VIR_FROM_TEST'/>
    <reference name='VIR_FROM_UML' href='html/libvirt-virterror.html#VIR_FROM_UML'/>
+    <reference name='VIR_FROM_VBOX' href='html/libvirt-virterror.html#VIR_FROM_VBOX'/>
    <reference name='VIR_FROM_XEN' href='html/libvirt-virterror.html#VIR_FROM_XEN'/>
    <reference name='VIR_FROM_XEND' href='html/libvirt-virterror.html#VIR_FROM_XEND'/>
    <reference name='VIR_FROM_XENSTORE' href='html/libvirt-virterror.html#VIR_FROM_XENSTORE'/>
@ -333,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'/>
@ -553,6 +556,7 @@
      <ref name='VIR_FROM_STORAGE'/>
      <ref name='VIR_FROM_TEST'/>
      <ref name='VIR_FROM_UML'/>
+      <ref name='VIR_FROM_VBOX'/>
      <ref name='VIR_FROM_XEN'/>
      <ref name='VIR_FROM_XEND'/>
      <ref name='VIR_FROM_XENSTORE'/>
@ -758,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'/>
@ -886,6 +892,7 @@
      <ref name='virNetworkLookupByUUIDString'/>
    </type>
    <type name='virNodeDevicePtr'>
+      <ref name='virNodeDeviceCreateXML'/>
      <ref name='virNodeDeviceLookupByName'/>
    </type>
    <type name='virStoragePoolPtr'>
@ -950,6 +957,7 @@
      <ref name='virDomainPinVcpu'/>
      <ref name='virDomainReboot'/>
      <ref name='virDomainSetVcpus'/>
+      <ref name='virNodeDeviceCreateXML'/>
      <ref name='virNodeDeviceGetXMLDesc'/>
      <ref name='virNodeListDevices'/>
      <ref name='virNodeNumOfDevices'/>
@ -1033,6 +1041,7 @@
      <ref name='virNetworkLookupByName'/>
      <ref name='virNetworkLookupByUUID'/>
      <ref name='virNetworkLookupByUUIDString'/>
+      <ref name='virNodeDeviceCreateXML'/>
      <ref name='virNodeDeviceLookupByName'/>
      <ref name='virNodeGetCellsFreeMemory'/>
      <ref name='virNodeGetFreeMemory'/>
@ -1156,6 +1165,7 @@
      <ref name='virNetworkUndefine'/>
    </type>
    <type name='virNodeDevicePtr'>
+      <ref name='virNodeDeviceDestroy'/>
      <ref name='virNodeDeviceDettach'/>
      <ref name='virNodeDeviceFree'/>
      <ref name='virNodeDeviceGetName'/>
@ -1475,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'/>
@ -1631,6 +1643,7 @@
      <ref name='VIR_FROM_STORAGE'/>
      <ref name='VIR_FROM_TEST'/>
      <ref name='VIR_FROM_UML'/>
+      <ref name='VIR_FROM_VBOX'/>
      <ref name='VIR_FROM_XEN'/>
      <ref name='VIR_FROM_XEND'/>
      <ref name='VIR_FROM_XENSTORE'/>
@ -1679,6 +1692,7 @@
          <ref name='VIR_COPY_CPUMAP'/>
          <ref name='VIR_GET_CPUMAP'/>
          <ref name='virConnectOpenReadOnly'/>
+          <ref name='virNodeGetFreeMemory'/>
        </word>
        <word name='Accessor'>
          <ref name='virNodeDeviceGetParent'/>
@ -1779,6 +1793,7 @@
          <ref name='virDomainAttachDevice'/>
          <ref name='virNetworkCreate'/>
          <ref name='virNetworkCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
          <ref name='virStoragePoolCreateXML'/>
          <ref name='virStorageVolCreateXML'/>
        </word>
@ -1810,6 +1825,7 @@
          <ref name='virStorageVolDelete'/>
        </word>
        <word name='Depending'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virStorageVolGetPath'/>
        </word>
@ -1820,8 +1836,15 @@
          <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>
        <word name='Does'>
          <ref name='virStoragePoolFree'/>
        </word>
@ -1945,6 +1968,9 @@
        </word>
      </letter>
      <letter name='H'>
+        <word name='HBAs'>
+          <ref name='virNodeDeviceCreateXML'/>
+        </word>
        <word name='Hence'>
          <ref name='virDomainBlockPeek'/>
        </word>
@ -2025,6 +2051,8 @@
          <ref name='virNodeDeviceLookupByName'/>
        </word>
      </letter>
+    </chunk>
+    <chunk name='chunk1'>
      <letter name='M'>
        <word name='Macro'>
          <ref name='LIBVIR_VERSION_NUMBER'/>
@ -2049,8 +2077,6 @@
          <ref name='virDomainMigrate'/>
        </word>
      </letter>
-    </chunk>
-    <chunk name='chunk1'>
      <letter name='N'>
        <word name='NFS'>
          <ref name='VIR_SECURITY_LABEL_BUFLEN'/>
@ -2083,6 +2109,9 @@
          <ref name='virDomainSetVcpus'/>
          <ref name='virDomainShutdown'/>
        </word>
+        <word name='Note:'>
+          <ref name='virNodeGetFreeMemory'/>
+        </word>
      </letter>
      <letter name='O'>
        <word name='OUT'>
@ -2091,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'/>
@ -2381,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'/>
@ -2443,6 +2455,7 @@
          <ref name='virDomainSuspend'/>
          <ref name='virGetLastError'/>
          <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
          <ref name='virResetLastError'/>
        </word>
        <word name='accessed'>
@ -2558,6 +2571,7 @@
          <ref name='virDomainMemoryPeek'/>
        </word>
        <word name='already'>
+          <ref name='virDomainDefineXML'/>
          <ref name='virDomainDestroy'/>
          <ref name='virNetworkDestroy'/>
        </word>
@ -2575,6 +2589,7 @@
          <ref name='virDomainBlockPeek'/>
          <ref name='virDomainCreateLinux'/>
          <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
        </word>
        <word name='amount'>
          <ref name='virDomainGetMaxMemory'/>
@ -2586,6 +2601,7 @@
          <ref name='virDomainCoreDump'/>
        </word>
        <word name='any'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virStoragePoolDestroy'/>
        </word>
        <word name='anymore'>
@ -2661,6 +2677,7 @@
          <ref name='virStorageVolGetXMLDesc'/>
        </word>
        <word name='assigned'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virStorageVolGetPath'/>
        </word>
        <word name='assigning'>
@ -2806,6 +2823,7 @@
          <ref name='virDomainMigrate'/>
        </word>
        <word name='binding'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
        </word>
        <word name='bindings'>
@ -2878,6 +2896,7 @@
          <ref name='virNetworkDefineXML'/>
          <ref name='virNetworkUndefine'/>
          <ref name='virNodeDeviceReset'/>
+          <ref name='virNodeGetFreeMemory'/>
          <ref name='virStoragePoolDestroy'/>
        </word>
        <word name='byte'>
@ -2925,6 +2944,7 @@
        <word name='callers'>
          <ref name='virDomainCreateLinux'/>
          <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
        </word>
        <word name='calling'>
          <ref name='virConnectDomainEventRegister'/>
@ -3113,6 +3133,7 @@
          <ref name='virConnectFindStoragePoolSources'/>
          <ref name='virDomainCreateLinux'/>
          <ref name='virDomainCreateXML'/>
+          <ref name='virNodeDeviceCreateXML'/>
        </word>
        <word name='contains'>
          <ref name='virStoragePoolLookupByVolume'/>
@ -3209,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'/>
@ -3225,6 +3249,7 @@
        </word>
        <word name='currently'>
          <ref name='virDomainCoreDump'/>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virNodeDeviceReset'/>
          <ref name='virStoragePoolRefresh'/>
@ -3321,6 +3346,7 @@
          <ref name='virNetworkCreateXML'/>
          <ref name='virNetworkDefineXML'/>
          <ref name='virNetworkGetXMLDesc'/>
+          <ref name='virNodeDeviceCreateXML'/>
          <ref name='virStoragePoolCreateXML'/>
          <ref name='virStoragePoolDefineXML'/>
          <ref name='virStorageVolCreateXML'/>
@ -3463,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'>
@ -3570,6 +3601,7 @@
        <word name='example'>
          <ref name='virDomainBlockStats'/>
          <ref name='virDomainMigrate'/>
+          <ref name='virNodeDeviceCreateXML'/>
          <ref name='virNodeDeviceReset'/>
        </word>
        <word name='execution'>
@ -3582,6 +3614,7 @@
          <ref name='virDomainCreateLinux'/>
        </word>
        <word name='exists'>
+          <ref name='virDomainDefineXML'/>
          <ref name='virDomainMigrate'/>
        </word>
        <word name='expected'>
@ -3621,6 +3654,7 @@
        </word>
        <word name='fail'>
          <ref name='virDomainSetVcpus'/>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virNodeDeviceReset'/>
        </word>
@ -3825,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'/>
@ -3917,6 +3953,7 @@
          <ref name='virDomainGetMaxVcpus'/>
          <ref name='virDomainReboot'/>
          <ref name='virDomainShutdown'/>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virNodeDeviceReset'/>
        </word>
@ -3982,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'/>
@ -3992,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'/>
@ -4184,6 +4228,7 @@
          <ref name='virEventRemoveTimeoutFunc'/>
        </word>
        <word name='involve'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virStoragePoolRefresh'/>
        </word>
@ -4216,6 +4261,7 @@
          <ref name='virStorageVolLookupByPath'/>
        </word>
        <word name='itself'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virStoragePoolDelete'/>
        </word>
      </letter>
@ -4355,6 +4401,7 @@
          <ref name='virDomainGetConnect'/>
          <ref name='virDomainMigrate'/>
          <ref name='virNetworkGetConnect'/>
+          <ref name='virNodeGetFreeMemory'/>
          <ref name='virStoragePoolGetConnect'/>
          <ref name='virStorageVolGetConnect'/>
        </word>
@ -4468,6 +4515,7 @@
          <ref name='virDomainSetAutostart'/>
          <ref name='virNetworkGetAutostart'/>
          <ref name='virNetworkSetAutostart'/>
+          <ref name='virNodeDeviceCreateXML'/>
        </word>
        <word name='macro'>
          <ref name='VIR_COPY_CPUMAP'/>
@ -4570,6 +4618,7 @@
          <ref name='virDomainRestore'/>
          <ref name='virDomainSave'/>
          <ref name='virNetworkRef'/>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virNodeDeviceRef'/>
          <ref name='virStoragePoolGetXMLDesc'/>
@ -4631,6 +4680,7 @@
          <ref name='virNodeGetCellsFreeMemory'/>
        </word>
        <word name='most'>
+          <ref name='virNodeGetFreeMemory'/>
          <ref name='virStoragePoolListVolumes'/>
        </word>
        <word name='moves'>
@ -4703,6 +4753,7 @@
        <word name='necessary'>
          <ref name='VIR_NODEINFO_MAXCPUS'/>
          <ref name='virConnectOpenAuth'/>
+          <ref name='virNodeGetFreeMemory'/>
        </word>
        <word name='need'>
          <ref name='virConnCopyLastError'/>
@ -4734,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'/>
@ -4864,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'/>
@ -4872,6 +4928,7 @@
          <ref name='virStoragePoolDelete'/>
        </word>
        <word name='operations'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
        </word>
        <word name='option'>
@ -4931,6 +4988,9 @@
          <ref name='virDomainBlockPeek'/>
          <ref name='virDomainMemoryPeek'/>
        </word>
+        <word name='overriden'>
+          <ref name='virDomainDefineXML'/>
+        </word>
        <word name='own'>
          <ref name='virResetLastError'/>
        </word>
@ -4978,6 +5038,7 @@
          <ref name='virDomainCreateXML'/>
          <ref name='virEventAddHandleFunc'/>
          <ref name='virEventAddTimeoutFunc'/>
+          <ref name='virNodeDeviceCreateXML'/>
          <ref name='virNodeDeviceGetXMLDesc'/>
          <ref name='virNodeListDevices'/>
          <ref name='virNodeNumOfDevices'/>
@ -5074,6 +5135,9 @@
          <ref name='virDomainDefineXML'/>
          <ref name='virNetworkDefineXML'/>
        </word>
+        <word name='previous'>
+          <ref name='virDomainDefineXML'/>
+        </word>
        <word name='previously'>
          <ref name='cpumap'/>
          <ref name='virNodeDeviceReAttach'/>
@ -5093,6 +5157,7 @@
          <ref name='virDomainSetVcpus'/>
          <ref name='virDomainSuspend'/>
          <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
        </word>
        <word name='problem'>
          <ref name='virDomainSave'/>
@ -5113,6 +5178,9 @@
          <ref name='virConnCopyLastError'/>
          <ref name='virConnGetLastError'/>
        </word>
+        <word name='provide'>
+          <ref name='virNodeGetFreeMemory'/>
+        </word>
        <word name='provided'>
          <ref name='virConnSetErrorFunc'/>
          <ref name='virConnectListDefinedDomains'/>
@ -5171,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>
@ -5277,6 +5348,9 @@
        <word name='remove'>
          <ref name='virEventRemoveTimeoutFunc'/>
        </word>
+        <word name='removed'>
+          <ref name='virNodeDeviceDestroy'/>
+        </word>
        <word name='removes'>
          <ref name='virEventRemoveTimeoutFunc'/>
        </word>
@ -5312,6 +5386,7 @@
        <word name='require'>
          <ref name='virDomainDestroy'/>
          <ref name='virNetworkDestroy'/>
+          <ref name='virNodeDeviceDestroy'/>
        </word>
        <word name='required'>
          <ref name='VIR_CPU_MAPLEN'/>
@ -5349,6 +5424,7 @@
          <ref name='virSetErrorFunc'/>
        </word>
        <word name='resetting'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virResetLastError'/>
        </word>
@ -5420,6 +5496,7 @@
          <ref name='virNetworkGetBridgeName'/>
          <ref name='virNetworkGetXMLDesc'/>
          <ref name='virNodeGetCellsFreeMemory'/>
+          <ref name='virNodeGetFreeMemory'/>
        </word>
        <word name='returns'>
          <ref name='VIR_CPU_MAPLEN'/>
@ -5464,6 +5541,8 @@
          <ref name='virDomainSetMemory'/>
        </word>
      </letter>
+    </chunk>
+    <chunk name='chunk9'>
      <letter name='s'>
        <word name='safe'>
          <ref name='virEventRemoveHandleFunc'/>
@ -5575,6 +5654,7 @@
          <ref name='virDomainShutdown'/>
          <ref name='virNetworkFree'/>
          <ref name='virNetworkSetAutostart'/>
+          <ref name='virNodeDeviceCreateXML'/>
        </word>
        <word name='show'>
          <ref name='_virConnectCredential'/>
@ -5598,6 +5678,9 @@
        <word name='single'>
          <ref name='VIR_CPU_MAPLEN'/>
        </word>
+        <word name='sizes'>
+          <ref name='virNodeGetFreeMemory'/>
+        </word>
        <word name='smaller'>
          <ref name='virNodeGetCellsFreeMemory'/>
        </word>
@ -5761,6 +5844,7 @@
          <ref name='virNetworkGetName'/>
          <ref name='virNetworkGetUUIDString'/>
          <ref name='virNetworkLookupByUUIDString'/>
+          <ref name='virNodeDeviceCreateXML'/>
          <ref name='virStoragePoolGetUUIDString'/>
        </word>
        <word name='structure'>
@ -5785,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'/>
@ -5841,10 +5927,11 @@
          <ref name='virDomainGetOSType'/>
          <ref name='virDomainGetVcpus'/>
          <ref name='virDomainPinVcpu'/>
+          <ref name='virNodeDeviceDestroy'/>
        </word>
      </letter>
    </chunk>
-    <chunk name='chunk9'>
+    <chunk name='chunk10'>
      <letter name='t'>
        <word name='take'>
          <ref name='virConnectDomainEventRegister'/>
@ -6036,6 +6123,7 @@
      </letter>
      <letter name='u'>
        <word name='unbinding'>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
        </word>
        <word name='undefined'>
@ -6141,6 +6229,7 @@
          <ref name='virDomainGetConnect'/>
          <ref name='virErrorFunc'/>
          <ref name='virNetworkGetConnect'/>
+          <ref name='virNodeDeviceDettach'/>
          <ref name='virNodeDeviceReAttach'/>
          <ref name='virNodeDeviceReset'/>
          <ref name='virStoragePoolBuild'/>
@ -6219,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'/>
@ -6228,7 +6319,7 @@
        </word>
      </letter>
    </chunk>
-    <chunk name='chunk10'>
+    <chunk name='chunk11'>
      <letter name='v'>
        <word name='valid'>
          <ref name='virConnectDomainEventRegister'/>
@ -6250,6 +6341,7 @@
          <ref name='virNetworkGetAutostart'/>
          <ref name='virNetworkGetBridgeName'/>
          <ref name='virNetworkGetXMLDesc'/>
+          <ref name='virNodeGetFreeMemory'/>
          <ref name='virStoragePoolGetAutostart'/>
        </word>
        <word name='values'>
@ -6412,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'/>
@ -6484,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'/>
@ -6502,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'>
@ -6608,6 +6708,7 @@
          <ref name='virConnectFindStoragePoolSources'/>
          <ref name='virConnectRef'/>
          <ref name='virDomainBlockPeek'/>
+          <ref name='virDomainDefineXML'/>
          <ref name='virDomainMemoryPeek'/>
          <ref name='virDomainRef'/>
          <ref name='virNetworkRef'/>
@ -6633,7 +6734,7 @@
        </word>
      </letter>
    </chunk>
-    <chunk name='chunk11'>
+    <chunk name='chunk12'>
      <letter name='x'>
        <word name='xen'>
          <ref name='virConnectOpen'/>
@ -6671,18 +6772,19 @@
      </letter>
    </chunk>
    <chunks>
-      <chunk name='chunk0' start='A' end='M'/>
-      <chunk name='chunk1' start='N' end='a'/>
+      <chunk name='chunk0' start='A' end='L'/>
+      <chunk name='chunk1' start='M' end='a'/>
      <chunk name='chunk2' start='b' end='c'/>
      <chunk name='chunk3' start='d' end='e'/>
      <chunk name='chunk4' start='f' end='g'/>
      <chunk name='chunk5' start='h' end='k'/>
      <chunk name='chunk6' start='l' end='m'/>
      <chunk name='chunk7' start='n' end='p'/>
-      <chunk name='chunk8' start='q' end='s'/>
-      <chunk name='chunk9' start='t' end='u'/>
-      <chunk name='chunk10' start='v' end='w'/>
-      <chunk name='chunk11' start='x' end='z'/>
+      <chunk name='chunk8' start='q' end='r'/>
+      <chunk name='chunk9' start='s' end='s'/>
+      <chunk name='chunk10' start='t' end='u'/>
+      <chunk name='chunk11' start='v' end='w'/>
+      <chunk name='chunk12' start='x' end='z'/>
    </chunks>
  </index>
 </apirefs>
--- a/docs/news.html
+++ b/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 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),
          memory ballooning in QEMU (Daniel Berrange), SCSI HBA storage pool
--- a/docs/news.html.in
+++ b/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),
--- a/docs/page.xsl
+++ b/docs/page.xsl
@ -8,6 +8,22 @@
  <!-- The sitemap.html.in page contains the master navigation structure -->
  <xsl:variable name="sitemap" select="document('sitemap.html.in')/html/body/div[@id='sitemap']"/>

+  <xsl:template match="code[@class='docref']" mode="content">
+    <xsl:variable name="name"><xsl:value-of select="."/></xsl:variable>
+    <a href="html/libvirt-libvirt.html#{$name}"><code><xsl:value-of select="$name"/></code></a>
+  </xsl:template>
+
+  <xsl:template match="node() | @*" mode="content">
+    <xsl:copy>
+      <xsl:apply-templates select="node() | @*" mode="content"/>
+    </xsl:copy>
+  </xsl:template>
+
+
+  <xsl:template match="ul[@id='toc']" mode="content">
+    <xsl:call-template name="toc"/>
+  </xsl:template>
+
  <!-- This processes the sitemap to form a context sensitive
       navigation menu for the current page -->
  <xsl:template match="ul" mode="menu">
@ -143,16 +159,7 @@
            </xsl:apply-templates>
          </div>
          <div id="content">
-            <xsl:for-each select="html/body/*">
-              <xsl:choose>
-                <xsl:when test="name() = 'ul' and @id = 'toc'">
-                  <xsl:call-template name="toc"/>
-                </xsl:when>
-                <xsl:otherwise>
-                  <xsl:copy-of select="."/>
-                </xsl:otherwise>
-              </xsl:choose>
-            </xsl:for-each>
+            <xsl:apply-templates select="/html/body/*" mode="content"/>
          </div>
        </div>
        <div id="footer">
--- a/docs/sitemap.html
+++ b/docs/sitemap.html
@ -108,6 +108,9 @@
            <ul><li>
                <a href="goals.html">Goals</a>
                <span>Terminology and goals of libvirt API</span>
+              </li><li>
+                <a href="api.html">API concepts</a>
+                <span>The libvirt API concepts</span>
              </li><li>
                <a href="archdomain.html">Domains</a>
                <span>Managing virtual machines</span>
@ -165,6 +168,9 @@
              </li><li>
                <a href="storage.html">Storage</a>
                <span>Driver for the storage management APIs</span>
+              </li><li>
+                <a href="drvvbox.html">VirtualBox</a>
+                <span>Driver for VirtualBox</span>
              </li></ul></li><li>
            <a href="html/index.html">API reference</a>
            <span>Reference manual for the C public API</span>
--- a/docs/sitemap.html.in
+++ b/docs/sitemap.html.in
@ -60,6 +60,10 @@
                <a href="goals.html">Goals</a>
                <span>Terminology and goals of libvirt API</span>
              </li>
+              <li>
+                <a href="api.html">API concepts</a>
+                <span>The libvirt API concepts</span>
+              </li>
              <li>
                <a href="archdomain.html">Domains</a>
                <span>Managing virtual machines</span>
@ -140,6 +144,10 @@
                <a href="storage.html">Storage</a>
                <span>Driver for the storage management APIs</span>
              </li>
+              <li>
+                <a href="drvvbox.html">VirtualBox</a>
+                <span>Driver for VirtualBox</span>
+              </li>
            </ul>
          </li>
          <li>
--- a/docs/storage.html
+++ b/docs/storage.html
@ -86,6 +86,10 @@
                        <div>
                          <span class="active">Storage</span>
                        </div>
+                      </li><li>
+                        <div>
+                          <a title="Driver for VirtualBox" class="inactive" href="drvvbox.html">VirtualBox</a>
+                        </div>
                      </li></ul>
                  </div>
                </li><li>
--- a/docs/virsh.pod
+++ b/docs/virsh.pod
@ -34,7 +34,7 @@ the program.

 All B<virsh> operations rely upon the libvirt library.
 For any virsh commands to run xend/qemu, or what ever virtual library that libvirt supports.  For this reason you should start xend/qemu as a service when your system first boots using xen/qemu. This can usually be done using the command
-B<service start libvirtd> .
+B<service libvirtd start> .

 Most B<virsh> commands require root privileges to run due to the
 communications channels used to talk to the hypervisor.  Running as
@ -150,13 +150,13 @@ B<virsh> list
 Name is the name of the domain.  ID the domain numeric id.
 State is the run state (see below).

-=over 4
-
 B<STATES>

 The State field lists 6 states for a domain, and which ones the
 current domain is in.

+=over 4
+
 =item B<running>

 The domain is currently running on a CPU
@ -198,12 +198,16 @@ crashed.
 Prints the available amount of memory on the machine or within a
 NUMA cell if I<cellno> is provided.

+=back
+
 =head1 DOMAIN COMMANDS

 The following commands manipulate domains directly, as stated
 previously most commands take domain-id as the first parameter. The
 I<domain-id> can be specified as an short integer, a name or a full UUID.

+=over 4
+
 =item B<autostart> optional I<--disable> I<domain-id>

 Configure a domain to be automatically started at boot.
@ -401,7 +405,9 @@ and I<cpulist> is a comma separated list of physical CPU numbers.
 Output the IP address and port number for the VNC display. If the information
 is not available the processes will provide an exit code of 1.

-=head1 DEVICES COMMANDS
+=back
+
+=head1 DEVICE COMMANDS

 The following commands manipulate devices associated to domains.
 The domain-id can be specified as an short integer, a name or a full UUID.
@ -409,6 +415,8 @@ To better understand the values allowed as options for the command
 reading the documentation at L<http://libvirt.org/format.html> on the
 format of the device sections to get the most accurate set of accepted values.

+=over 4
+
 =item B<attach-device> I<domain-id> I<FILE>

 Attach a device to the domain, using a device definition in an XML file.
@ -449,7 +457,9 @@ I<type> can be either I<network> to indicate a physical network device or I<brid
 It is recommended to use the I<mac> option to distinguish between the interfaces
 if more than one are present on the domain.

-=head1 VIRTUAL NETWORKS COMMANDS
+=back
+
+=head1 VIRTUAL NETWORK COMMANDS

 The following commands manipulate networks. Libvirt has the capability to
 define virtual networks which can then be used by domains and linked to
@ -458,6 +468,8 @@ see the documentation at L<http://libvirt.org/format.html#Net1> . A lot
 of the command for virtual networks are similar to the one used for domains,
 but the way to name a virtual network is either by its name or UUID.

+=over 4
+
 =item B<net-autostart> I<network> optional I<--disable>

 Configure a virtual network to be automatically started at boot.
@ -517,18 +529,55 @@ Undefine the configuration for an inactive network.

 Convert a network name to network UUID.

+=back
+
 =head1 ENVIRONMENT

+The following environment variables can be set to alter the behaviour
+of C<virsh>
+
+=over 4
+
 =item VIRSH_DEFAULT_CONNECT_URI

 The hypervisor to connect to by default. Set this to a URI, in the same
 format as accepted by the B<connect> option.

-=head1 SEE ALSO
+=item LIBVIRT_DEBUG=LEVEL

-L<virt-install(1)>, L<xm(1)>, L<virt-top(1)>, L<virt-mem(1)>, L<virt-df(1)>, L<http://www.libvirt.org/>
+Turn on verbose debugging of all libvirt API calls. Valid levels are

-=head1 AUTHOR
+=over 4
+
+=item * LIBVIRT_DEBUG=1
+
+Messages at level DEBUG or above
+
+=item * LIBVIRT_DEBUG=2
+
+Messages at level INFO or above
+
+=item * LIBVIRT_DEBUG=3
+
+Messages at level WARNING or above
+
+=item * LIBVIRT_DEBUG=4
+
+Messages at level ERROR or above
+
+=back
+
+For further information about debugging options consult C<http://libvirt.org/logging.html>
+
+=back
+
+=head1 BUGS
+
+Report any bugs discovered to the libvirt community via the mailing
+list C<http://libvirt.org/contact.html> or bug tracker C<http://libvirt.org/bugs.html>.
+Alternatively report bugs to your software distributor / vendor.
+
+=head1 AUTHORS

  Andrew Puch <apuch @ redhat.com>
  Daniel Veillard <veillard @ redhat.com>
@ -537,12 +586,19 @@ L<virt-install(1)>, L<xm(1)>, L<virt-top(1)>, L<virt-mem(1)>, L<virt-df(1)>, L<h
  Sean Dague <sean at dague dot net>
  Daniel Stekloff <dsteklof at us dot ibm dot com>

+=head1 COPYRIGHT

-=head1 BUGS
+Copyright (C) 2005, 2007-2009 Red Hat, Inc.

-Bugs can be filed in Red Hat bugzilla under the Virtualization Tools/libvirt
-L<https://bugzilla.redhat.com/>
+=head1 LICENSE

-L<https://bugzilla.redhat.com/buglist.cgi?product=Virtualization+Tools&component=libvirt&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED>
+virsh is distributed under the terms of the GNU LGPL v2+.
+This is free software; see the source for copying conditions. There
+is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
+PURPOSE

-=end
+=head1 SEE ALSO
+
+L<virt-install(1)>, L<virt-xml-validate(1)>, L<virt-top(1)>, L<virt-mem(1)>, L<virt-df(1)>, L<http://www.libvirt.org/>
+
+=cut
--- a/include/libvirt/libvirt.h
+++ b/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,
@ -1124,6 +1124,12 @@ int                     virNodeDeviceDettach    (virNodeDevicePtr dev);
 int                     virNodeDeviceReAttach   (virNodeDevicePtr dev);
 int                     virNodeDeviceReset      (virNodeDevicePtr dev);

+virNodeDevicePtr        virNodeDeviceCreateXML  (virConnectPtr conn,
+                                                 const char *xmlDesc,
+                                                 unsigned int flags);
+
+int                     virNodeDeviceDestroy    (virNodeDevicePtr dev);
+
 /*
 * Domain Event Notification
 */
--- a/include/libvirt/libvirt.h.in
+++ b/include/libvirt/libvirt.h.in
@ -1124,6 +1124,12 @@ int                     virNodeDeviceDettach    (virNodeDevicePtr dev);
 int                     virNodeDeviceReAttach   (virNodeDevicePtr dev);
 int                     virNodeDeviceReset      (virNodeDevicePtr dev);

+virNodeDevicePtr        virNodeDeviceCreateXML  (virConnectPtr conn,
+                                                 const char *xmlDesc,
+                                                 unsigned int flags);
+
+int                     virNodeDeviceDestroy    (virNodeDevicePtr dev);
+
 /*
 * Domain Event Notification
 */
--- a/include/libvirt/virterror.h
+++ b/include/libvirt/virterror.h
@ -62,6 +62,7 @@ typedef enum {
    VIR_FROM_NODEDEV, /* Error from node device monitor */
    VIR_FROM_XEN_INOTIFY, /* Error from xen inotify layer */
    VIR_FROM_SECURITY,  /* Error from security framework */
+    VIR_FROM_VBOX,    /* Error from VirtualBox driver */
 } virErrorDomain;


--- a/libvirt.spec.in
+++ b/libvirt.spec.in
@ -46,6 +46,7 @@
 %define with_rhel5 0
 %else
 %define with_rhel5 1
+%define with_polkit 0
 %endif


@ -372,8 +373,10 @@ fi
 %defattr(-, root, root)

 %doc AUTHORS ChangeLog NEWS README COPYING.LIB TODO
-%doc %{_mandir}/man1/virsh.1*
+%{_mandir}/man1/virsh.1*
+%{_mandir}/man1/virt-xml-validate.1*
 %{_bindir}/virsh
+%{_bindir}/virt-xml-validate
 %{_libdir}/lib*.so.*
 %dir %attr(0700, root, root) %{_sysconfdir}/libvirt/

@ -503,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

--- a/mingw32-libvirt.spec.in
+++ b/mingw32-libvirt.spec.in
@ -50,6 +50,7 @@ MinGW Windows libvirt virtualization library.
  --without-qemu \
  --without-lxc \
  --without-uml \
+  --without-vbox \
  --without-openvz \
  --without-libvirtd
 make
@ -75,6 +76,7 @@ rm -rf $RPM_BUILD_ROOT
 %defattr(-,root,root)
 %{_mingw32_bindir}/libvirt-0.dll
 %{_mingw32_bindir}/virsh.exe
+%{_mingw32_bindir}/virt-xml-validate

 %{_mingw32_libdir}/libvirt.dll.a
 %{_mingw32_libdir}/libvirt.la
@ -96,6 +98,7 @@ rm -rf $RPM_BUILD_ROOT
 %{_mingw32_includedir}/libvirt/virterror.h

 %{_mingw32_mandir}/man1/virsh.1*
+%{_mingw32_mandir}/man1/virt-xml-validate.1*


 %changelog
--- a/po/POTFILES.in
+++ b/po/POTFILES.in
@ -38,6 +38,7 @@ src/uml_conf.c
 src/uml_driver.c
 src/util.c
 src/uuid.c
+src/vbox/vbox_tmpl.c
 src/virsh.c
 src/virterror.c
 src/xen_inotify.c
--- a/po/af.po
+++ b/po/af.po
--- a/po/am.po
+++ b/po/am.po
--- a/po/ar.po
+++ b/po/ar.po
--- a/po/as.po
+++ b/po/as.po
--- a/po/be.po
+++ b/po/be.po
--- a/po/bg.po
+++ b/po/bg.po
--- a/po/bn.po
+++ b/po/bn.po
--- a/po/bn_IN.po
+++ b/po/bn_IN.po
--- a/po/bs.po
+++ b/po/bs.po
--- a/po/ca.po
+++ b/po/ca.po
--- a/po/cs.po
+++ b/po/cs.po
--- a/po/cy.po
+++ b/po/cy.po
--- a/po/da.po
+++ b/po/da.po
--- a/po/de.po
+++ b/po/de.po
--- a/po/el.po
+++ b/po/el.po
--- a/po/en_GB.po
+++ b/po/en_GB.po
--- a/po/es.po
+++ b/po/es.po
--- a/po/et.po
+++ b/po/et.po
--- a/po/eu_ES.po
+++ b/po/eu_ES.po
--- a/po/fa.po
+++ b/po/fa.po
--- a/po/fi.po
+++ b/po/fi.po
--- a/po/fr.po
+++ b/po/fr.po
--- a/po/gl.po
+++ b/po/gl.po
--- a/po/gu.po
+++ b/po/gu.po
--- a/po/he.po
+++ b/po/he.po
--- a/po/hi.po
+++ b/po/hi.po
--- a/po/hr.po
+++ b/po/hr.po
--- a/po/hu.po
+++ b/po/hu.po
--- a/po/hy.po
+++ b/po/hy.po
--- a/po/id.po
+++ b/po/id.po
--- a/po/is.po
+++ b/po/is.po
--- a/po/it.po
+++ b/po/it.po
--- a/po/ja.po
+++ b/po/ja.po
--- a/po/ka.po
+++ b/po/ka.po
--- a/po/kn.po
+++ b/po/kn.po
--- a/po/ko.po
+++ b/po/ko.po
--- a/po/ku.po
+++ b/po/ku.po
--- a/po/libvirt.pot
+++ b/po/libvirt.pot
--- a/po/lo.po
+++ b/po/lo.po
--- a/po/lt.po
+++ b/po/lt.po
--- a/po/lv.po
+++ b/po/lv.po
--- a/po/mk.po
+++ b/po/mk.po
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Daniel Veillard	9cae1d5ed6	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	2009-04-24 14:04:54 +00:00
Daniel P. Berrange	62aa1b56d6	Add virNodeDeviceCreateXML / virNodeDeviceDestroy boilerplate public API and remote protocol impl	2009-04-24 13:11:23 +00:00
Daniel P. Berrange	1aac8114ae	Fix Xen dlopen module missing export	2009-04-24 12:19:00 +00:00
Daniel P. Berrange	1fbee8dadf	Fix XM driver VIF config creation	2009-04-24 12:17:50 +00:00
Daniel Veillard	741fecedaa	Update of localizations and XML descriptions * po/: updated a could of locale, regenerated docs/libvirt-api.xml docs/libvirt-refs.xml: regenerated too daniel	2009-04-24 10:09:24 +00:00
Daniel P. Berrange	d83ded2dba	Avoid compile warnings about assignment/conditional/truthvalue	2009-04-22 14:28:25 +00:00
Daniel P. Berrange	220bcb0535	Use a private /dev/pts instance in containers if kernel is new enough	2009-04-22 14:26:50 +00:00
Daniel P. Berrange	9c19a898f9	Remove stale QEMU pidfiles	2009-04-21 19:14:50 +00:00
Daniel P. Berrange	7a367cca30	Ensure VirtualBox domain IDs start from 1 instead of 0	2009-04-21 19:13:23 +00:00
Daniel Veillard	4c3f3b4d46	* src/network_conf.c src/network_conf.h: add dynamic bridge names support, patch by Soren Hansen * AUTHORS: add Soren daniel	2009-04-21 19:00:06 +00:00
Daniel Veillard	ec4e379125	* src/xend_internal.c: let xend try vcpu pinning operation even if the domain is not running, patch by Takahashi Tomohiro daniel	2009-04-21 15:10:23 +00:00
Daniel Veillard	5237c2b847	* docs/drvvbox.html[.in]: tiny fixes to VirtualBox docs Daniel	2009-04-21 13:39:40 +00:00
Daniel Veillard	b4ee10dfde	VirtualBox Documentation * docs/drvvbox.html.in docs/hvsupport.html.in docs/drivers.html.in docs/sitemap.html.in docs/*.html: VirtualBox Documentation by Pritesh Kothari Daniel	2009-04-21 12:24:14 +00:00
Daniel Veillard	bfc48afa14	cope with kernels where CLONE_NEWUSER is not supported * src/lxc_container.c src/lxc_container.h: cope with kernels where CLONE_NEWUSER is not supported, patch by Serge Hallyn daniel	2009-04-20 12:27:12 +00:00
Mark McLoughlin	a4b1c0977a	Fix typo in manpage It's "service libvirtd start", not "service start libvirtd". Reported-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Mark McLoughlin <markmc@redhat.com>	2009-04-20 11:55:53 +00:00
Daniel Veillard	55671efe80	* po/*: merge in a lot of localization updates and regenerate daniel	2009-04-20 09:25:44 +00:00
Daniel Veillard	943a2f2b60	* src/bridge.c: fix a compilation breakage raised by Anton Protopopov daniel	2009-04-20 09:18:26 +00:00
Daniel P. Berrange	fd9a55254f	Added new virt-xml-validate tool to mingw specfile	2009-04-19 16:47:43 +00:00
Daniel P. Berrange	969209ce07	Disable vbox driver for mingw32 builds	2009-04-19 16:37:15 +00:00
Daniel P. Berrange	89626e8d69	Add another vbox file to EXTRA_DIST	2009-04-19 16:36:22 +00:00
Daniel P. Berrange	ac6797b28c	Add missing break in error code	2009-04-19 15:49:00 +00:00
Daniel P. Berrange	cfa30de3b8	Improve error reporting for lookup failures on inactive domains	2009-04-19 15:30:50 +00:00
Daniel P. Berrange	c881b32215	Fix 2 domain ID handling bugs in remote driver	2009-04-19 15:21:54 +00:00
Daniel P. Berrange	cb43623acd	Switch over todo domain lookup based on UUID in virDomainAssignDef	2009-04-19 15:16:43 +00:00
Daniel P. Berrange	8372a8c127	Regenerate API docs to pull in vbox driver error codes	2009-04-19 15:14:44 +00:00
Daniel P. Berrange	26eb2feedd	Add tools/ directory (missed from previous commit)	2009-04-19 15:12:33 +00:00
Daniel P. Berrange	001390a684	Add 2 missing vbox files to EXTRA_DIST	2009-04-19 15:12:01 +00:00
Daniel P. Berrange	fa4126087b	Add tool for validating XML & fix misc bugs in virsh POD docs	2009-04-19 15:10:45 +00:00
Daniel P. Berrange	9a15c48d2d	Switch to using virDomainDefPtr for building command line in QEMU driver	2009-04-19 14:50:01 +00:00
Daniel Veillard	2cd9b2d8ee	drop the pool lock when allocating fs volumes * src/libvirt_private.syms src/storage_backend.h src/storage_backend_fs.c src/storage_conf.h src/storage_driver.c: drop the pool lock when allocating fs volumes, patch by Cole Robinson daniel	2009-04-17 19:12:37 +00:00
Daniel Veillard	10d1650843	integration of the VirtualBox support * configure.in include/libvirt/virterror.h src/Makefile.am src/domain_conf.[ch] src/driver.h src/virterror.c src/vbox/README src/vbox/vbox_CAPI_v2_2.h src/vbox/vbox_V2_2.c src/vbox/vbox_XPCOMCGlue.[ch] src/vbox/vbox_driver.[ch] src/vbox/vbox_tmpl.c: integration of the VirtualBox support patches by Pritesh Kothari Daniel	2009-04-17 16:09:07 +00:00
Daniel Veillard	81e6a22192	Small doc fixes * src/libvirt.c: fix the doc of virNodeGetFreeMemory to say bytes * docs/drvlxc.html.in docs/drvlxc.html: fix command used in examples daniel	2009-04-17 15:34:53 +00:00
Guido Günther	d24f6aabbb	fix "make syntax-check"	2009-04-17 08:21:40 +00:00
Guido Günther	5caa1e0eb0	Don't log monitor output to domain log file. It's logged via the logging system already. Prefix monitor debug output with vm name.	2009-04-16 15:56:27 +00:00
Guido Günther	a6c612a4ad	don't hardcode buffer for getgrnam_r to 1024 bytes and increase it on ERANGE.	2009-04-16 14:53:19 +00:00
Mark McLoughlin	9fa79000ec	qemu -drive takes format= not fmt= Seems like a simple typo - it has been "format=" since the flag was introduced, but we added it as "fmt=". Signed-off-by: Mark McLoughlin <markmc@redhat.com>	2009-04-16 14:21:35 +00:00
Mark McLoughlin	169afbe9aa	Fix lxc syntax-check failure Fixes: CHECK: avoid_if_before_free src/lxc_container.c: if (oldroot) VIR_FREE(oldroot) src/lxc_container.c: if (newroot) VIR_FREE(newroot) Makefile.maint: found useless "if" before "free" above and: src/lxc_container.c:317: Makefile.maint: found trailing blank(s) Signed-off-by: Mark McLoughlin <markmc@redhat.com>	2009-04-16 13:08:03 +00:00
Daniel Veillard	316befbb0c	Api documentation * docs/Makefile.am docs/api.html docs/api.html.in docs/archdomain.html docs/archnetwork.html docs/archnode.html docs/archstorage.html docs/goals.html docs/intro.html docs/libvirt-daemon-arch.fig docs/libvirt-daemon-arch.png docs/libvirt-driver-arch.fig docs/libvirt-driver-arch.png docs/libvirt-object-model.fig docs/libvirt-object-model.png docs/page.xsl docs/sitemap.html docs/sitemap.html.in: adding a new api page, extending the stylesheet to allow references and including images from Dan Berrange daniel	2009-04-15 20:42:50 +00:00
Daniel Veillard	f61208bde9	* src/virsh.c: fix for virsh ttyconsole return value bug #495954 daniel	2009-04-15 20:09:09 +00:00
Daniel Veillard	1951b95cb2	Adding Serge E. Hallyn to the authors list, Daniel	2009-04-15 20:04:22 +00:00
Daniel Veillard	a28a644680	* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel	2009-04-15 20:00:29 +00:00
Daniel Veillard	14687aad81	* src/xm_internal.c: fix a crash on vcpupin to inactive Xen domains, as raised by Takahashi Tomohiro daniel	2009-04-15 09:53:34 +00:00
Daniel Veillard	cab9eed62e	* src/lxc_driver.c: adds the getHostname method to the lxc driver patch by Dan Smith daniel	2009-04-15 09:34:56 +00:00
Dan Smith	06e43a8f2c	Commit patches by Serge Hallyn from 6-Apr and 7-Apr	2009-04-14 17:51:12 +00:00
Daniel Veillard	4fb341d741	* libvirt.spec.in: fix build on RHEL and Centos 5.x daniel	2009-04-14 12:47:34 +00:00
Daniel Veillard	b2df3510b7	* src/storage_backend_scsi.[ch]: add SCSI storage rescan support, patch by David Allan daniel	2009-04-07 12:50:17 +00:00