libvirt/src/vbox
Daniel Veillard 67cc35ade9 Finish hostonly networks support in vbox
* src/vbox/vbox_driver.c src/vbox/vbox_tmpl.c: last patch for
  hostonly networks support in vbox driver, patch by Pritesh Kothari
daniel
2009-05-15 14:00:50 +00:00
..
README integration of the VirtualBox support 2009-04-17 16:09:07 +00:00
vbox_CAPI_v2_2.h integration of the VirtualBox support 2009-04-17 16:09:07 +00:00
vbox_driver.c Finish hostonly networks support in vbox 2009-05-15 14:00:50 +00:00
vbox_driver.h integration of the VirtualBox support 2009-04-17 16:09:07 +00:00
vbox_tmpl.c Finish hostonly networks support in vbox 2009-05-15 14:00:50 +00:00
vbox_V2_2.c integration of the VirtualBox support 2009-04-17 16:09:07 +00:00
vbox_XPCOMCGlue.c * src/vbox/vbox_XPCOMCGlue.[ch]: improve VirtualBox path detection 2009-05-06 13:23:44 +00:00
vbox_XPCOMCGlue.h * src/vbox/vbox_XPCOMCGlue.[ch]: improve VirtualBox path detection 2009-05-06 13:23:44 +00:00

    Explanation about the how multi-version support
    for VirtualBox libvirt driver is implemented.

Since VirtualBox adds multiple new features for each release, it is but
natural that the C API which VirtualBox exposes is volatile across
versions and thus needs a good mechanism to handle multiple versions
during runtime. The solution was something like this:

Firstly the file structure is as below:

vbox_CAPI_v2_2.h
vbox_XPCOMCGlue.h
vbox_XPCOMCGlue.c
These files are C API/glue code files directly taken from the
VirtualBox OSE source and is needed for C API to work as expected.

vbox_driver.h
vbox_driver.c
These files have the main logic for registering the virtualbox driver
with libvirt.

vbox_V2_2.c
The file which has version dependent changes and includes the template
file for given below for all of its functionality.

vbox_tmpl.c
The file where all the real driver implementation code exists.

Now there would be a vbox_V*.c file (for eg: vbox_V2_2.c for V2.2) for
each major virtualbox version which would do some preprocessor magic
and include the template file (vbox_tmpl.c) in it for the functionality
it offers.