1
0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-22 17:34:18 +03:00
libvirt/src/vbox
Michal Privoznik b76b6a6169 vbox: Stop reporting RC in error messages
As shown in the commit that introduced vboxReportError(), we are
appending the retval of a failed VirtualBox API onto our error
messages. Well, this is no longer needed because
vboxReportError() already appends the VirtualBox error in plain
text.

Signed-off-by: Michal Privoznik <mprivozn@redhat.com>
Reviewed-by: Martin Kletzander <mkletzan@redhat.com>
2023-01-24 10:45:48 +01:00
..
meson.build vbox: Add support for version 7.0 SDK 2023-01-24 10:24:23 +01:00
README
vbox_CAPI_v6_1.h vbox: Rename #include guard macro in header files 2023-01-24 10:24:13 +01:00
vbox_CAPI_v7_0.h vbox: add version 7.0 CAPI header 2023-01-24 10:24:18 +01:00
vbox_common.c vbox: Stop reporting RC in error messages 2023-01-24 10:45:48 +01:00
vbox_common.h vbox: Introduce vboxUniformedPFN::GetException() 2023-01-24 10:45:33 +01:00
vbox_driver.c vbox: Remove unused includes 2022-06-16 06:43:57 +02:00
vbox_driver.h src/vbox: use #pragma once in headers 2019-06-19 17:12:33 +02:00
vbox_get_driver.h lib: Drop internal virXXXPtr typedefs 2021-04-13 17:00:38 +02:00
vbox_network.c vbox: Drop @networkName from UIDHCPServer::Start() 2023-01-24 10:24:10 +01:00
vbox_snapshot_conf.c virVBoxSnapshotConfGet(RW|RO)DisksPathsFromLibvirtXML: Refactor 2022-10-06 10:54:24 +02:00
vbox_snapshot_conf.h lib: Drop internal virXXXPtr typedefs 2021-04-13 17:00:38 +02:00
vbox_storage.c vbox: Add support for version 7.0 SDK 2023-01-24 10:24:23 +01:00
vbox_tmpl.c vbox: Introduce vboxUniformedPFN::ClearException() 2023-01-24 10:45:35 +01:00
vbox_uniformed_api.h vbox: Introduce vboxUniformedPFN::ClearException() 2023-01-24 10:45:35 +01:00
vbox_V6_1.c vbox: add support for version 6.1 SDK 2020-04-20 11:34:59 +01:00
vbox_V7_0.c vbox: Add support for version 7.0 SDK 2023-01-24 10:24:23 +01:00
vbox_XPCOMCGlue.c vbox: Remove unused includes 2022-06-16 06:43:57 +02:00
vbox_XPCOMCGlue.h vbox: Drop support for virtualbox-6.0.0 2023-01-24 10:24:07 +01:00
virtvboxd.init.in configure: Provide OpenRC scripts for sub-daemons 2019-12-16 10:11:22 +01:00
virtvboxd.service.in systemd: Use correct man page name in modular daemon service files 2022-02-01 13:20:11 +01:00

    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.