libvirt/src/vbox
Peter Krempa 4f9907cd11 conf: Replace access to def->mem.max_balloon with accessor functions
As there are two possible approaches to define a domain's memory size -
one used with legacy, non-NUMA VMs configured in the <memory> element
and per-node based approach on NUMA machines - the user needs to make
sure that both are specified correctly in the NUMA case.

To avoid this burden on the user I'd like to replace the NUMA case with
automatic totaling of the memory size. To achieve this I need to replace
direct access to the virDomainMemtune's 'max_balloon' field with
two separate getters depending on the desired size.

The two sizes are needed as:
1) Startup memory size doesn't include memory modules in some
hypervisors.
2) After startup these count as the usable memory size.

Note that the comments for the functions are future aware and document
state that will be present after a few later patches.
2015-03-16 14:26:51 +01:00
..
README
vbox_CAPI_v2_2.h
vbox_CAPI_v3_0.h
vbox_CAPI_v3_1.h
vbox_CAPI_v3_2.h
vbox_CAPI_v4_0.h
vbox_CAPI_v4_1.h
vbox_CAPI_v4_2_20.h
vbox_CAPI_v4_2.h
vbox_CAPI_v4_3_4.h
vbox_CAPI_v4_3.h
vbox_common.c conf: Replace access to def->mem.max_balloon with accessor functions 2015-03-16 14:26:51 +01:00
vbox_common.h vbox: Rewrite vboxStorageVolCreateXML 2014-10-29 01:21:40 +01:00
vbox_driver.c Removing probing of secondary drivers 2015-01-27 12:02:04 +00:00
vbox_driver.h
vbox_get_driver.h vbox: New storage driver 2014-10-29 01:21:41 +01:00
vbox_glue.c
vbox_glue.h
vbox_MSCOMGlue.c Remove unnecessary curly brackets in src/vbox/ 2014-11-14 17:13:35 +01:00
vbox_MSCOMGlue.h
vbox_network.c Removing probing of secondary drivers 2015-01-27 12:02:04 +00:00
vbox_snapshot_conf.c Remove unnecessary curly brackets in src/vbox/ 2014-11-14 17:13:35 +01:00
vbox_snapshot_conf.h
vbox_storage.c Add flags argument to virStorageVolDefParse* 2015-03-02 08:07:11 +01:00
vbox_tmpl.c vbox: fix a bug in _machineStateInactive 2014-11-19 14:35:33 +01:00
vbox_uniformed_api.h vbox: New storage driver 2014-10-29 01:21:41 +01:00
vbox_V2_2.c
vbox_V3_0.c
vbox_V3_1.c
vbox_V3_2.c
vbox_V4_0.c
vbox_V4_1.c
vbox_V4_2_20.c
vbox_V4_2.c
vbox_V4_3_4.c
vbox_V4_3.c
vbox_XPCOMCGlue.c Remove unnecessary curly brackets in src/vbox/ 2014-11-14 17:13:35 +01:00
vbox_XPCOMCGlue.h

    Licensing

Note that much of the vbox in this directory is LGPLv2-only.  Thus, it
cannot be linked into any software that also wants to use GPLv3+ code.
This readme file is:

Copyright (C) 2009, 2013 Red Hat, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without warranty of any kind.

    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 contains all version specified codes. It implements the
vboxUniformedAPI for each vbox version.

vbox_common.c
The file implement the common driver, with the uniformed api which
defined in vbox_uniformed_api.h and implemented in vbox_tmpl.c

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.