-
Notifications
You must be signed in to change notification settings - Fork 201
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
New VMM extension integration mechanism
1) New vmm_extension() macro for registering bareflank extensions to the build system from build configuration file 2) New VMM extension-specific config variables and extension-specific macros 3) Added vmm_ex.cmake to be included by all Bareflank extensions 4) Updated build system documentation [RFC] #545 Signed-off-by: JaredWright <jared.wright12@gmail.com>
- Loading branch information
1 parent
23d8295
commit 98282e8
Showing
12 changed files
with
1,000 additions
and
95 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| # | ||
| # Bareflank Hypervisor | ||
| # Copyright (C) 2015 Assured Information Security, Inc. | ||
| # | ||
| # This library is free software; you can redistribute it and/or | ||
| # modify it under the terms of the GNU Lesser General Public | ||
| # License as published by the Free Software Foundation; either | ||
| # version 2.1 of the License, or (at your option) any later version. | ||
| # | ||
| # This library is distributed in the hope that it will be useful, | ||
| # but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
| # Lesser General Public License for more details. | ||
| # | ||
| # You should have received a copy of the GNU Lesser General Public | ||
| # License along with this library; if not, write to the Free Software | ||
| # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # Bareflank Build Configurations | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| # set(BUILD_TYPE Debug) | ||
| # set(BUILD_VMM_STATIC ON) | ||
| # set(ENABLE_DEVELOPER_MODE ON) | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # Bareflank Extensions | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| # vmm_extension( | ||
| # extended_apis | ||
| # GIT_REPOSITORY https://github.com/bareflank/extended_apis.git | ||
| # GIT_TAG dev | ||
| # ) | ||
|
|
||
| # vmm_extension( | ||
| # extended_apis | ||
| # SOURCE_DIR ~/bareflank/my_extension | ||
| # DEPENDS extended_apis | ||
| # ) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,129 @@ | ||
| # | ||
| # Bareflank Hypervisor | ||
| # Copyright (C) 2015 Assured Information Security, Inc. | ||
| # | ||
| # This library is free software; you can redistribute it and/or | ||
| # modify it under the terms of the GNU Lesser General Public | ||
| # License as published by the Free Software Foundation; either | ||
| # version 2.1 of the License, or (at your option) any later version. | ||
| # | ||
| # This library is distributed in the hope that it will be useful, | ||
| # but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
| # Lesser General Public License for more details. | ||
| # | ||
| # You should have received a copy of the GNU Lesser General Public | ||
| # License along with this library; if not, write to the Free Software | ||
| # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # README | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| # This file defines all configurable cmake variables available to Barefank | ||
| # VMM extensions, set to their default value. These configuration are NOT | ||
| # available to base Bareflank hypervisor projects. VMM extension projects | ||
| # can use both these configurations PLUS the base hypervisor configurations. | ||
|
|
||
| # Each configuration here indicates the Bareflank suggested convention as | ||
| # a default value. The goal is to encourage a "convention over configuration" | ||
| # mindset for extension developers. If extension developers choose not follow | ||
| # a suggested convention, they can override a configuration using two methods: | ||
| # | ||
| # 1) Specify each configuration as CMAKE_ARGS to the vmm_extension() macro. Ex: | ||
| # | ||
| # vmm_extension( | ||
| # extension_name | ||
| # CMAKE_ARGS -DVMM_EX_BUILD_RULES=/path/to/build_rules.cmake | ||
| # ) | ||
| # | ||
| # 2) Override a configuration in the extension's CMakeLists.txt file BEFORE | ||
| # calling include(${VMM_EXTENSION}). Ex: | ||
| # | ||
| # set(VMM_EX_BUILD_RULES "/path/to/build_rules.cmake") | ||
| # set(VMM_EX_UNITTEST_PATH "/path/to/the/unit/tests") | ||
| # include(${VMM_EXTENSION}) | ||
| # | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # Source tree structure | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_TOP_DIR | ||
| CONFIG_TYPE PATH | ||
| DEFAULT_VAL ${CMAKE_CURRENT_SOURCE_DIR} | ||
| DESCRIPTION "Path to the top directory for this VMM extension" | ||
| ) | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_SOURCE_DIR | ||
| CONFIG_TYPE PATH | ||
| DEFAULT_VAL ${VMM_EX_TOP_DIR}/src | ||
| DESCRIPTION "Path to the source code directory for this VMM extension" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_INCLUDE_DIR | ||
| CONFIG_TYPE PATH | ||
| DEFAULT_VAL ${VMM_EX_TOP_DIR}/include | ||
| DESCRIPTION "Path to the header include directory for this VMM extension" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_UNITTEST_DIR | ||
| CONFIG_TYPE PATH | ||
| DEFAULT_VAL ${VMM_EX_TOP_DIR}/test | ||
| DESCRIPTION "Path to the unit test directory for this VMM extension" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # Build system features | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_CONFIGS | ||
| CONFIG_TYPE FILE | ||
| DEFAULT_VAL ${VMM_EX_TOP_DIR}/configs.cmake | ||
| DESCRIPTION "Path to extention-specific build configurations to be added " | ||
| "for this VMM extension" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_BUILD_RULES | ||
| CONFIG_TYPE FILE | ||
| DEFAULT_VAL ${VMM_EX_TOP_DIR}/build_rules.cmake | ||
| DESCRIPTION "Path to a build rules file to be validated before building " | ||
| "this VMM extension" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| # ------------------------------------------------------------------------------ | ||
| # Read-only variables | ||
| # ------------------------------------------------------------------------------ | ||
|
|
||
| add_config( | ||
| CONFIG_NAME VMM_EX_IS_UNITTEST_BUILD | ||
| CONFIG_TYPE INTERNAL | ||
| DEFAULT_VAL OFF | ||
| DESCRIPTION "The build system sets this variable to ON if this extension's " | ||
| "unit tests are currently being built, rather than it's source" | ||
| SKIP_VALIDATION | ||
| ) | ||
|
|
||
| if(VMM_EX_IS_UNTTEST_BUILD) | ||
| set(_VMM_EX_SYSROOT_DEFAULT ${BUILD_SYSROOT_TEST}) | ||
| else() | ||
| set(_VMM_EX_SYSROOT_DEFAULT ${BUILD_SYSROOT_VMM}) | ||
| endif() | ||
| add_config( | ||
| CONFIG_NAME VMM_EX_SYSROOT | ||
| CONFIG_TYPE INTERNAL | ||
| DEFAULT_VAL ${_VMM_EX_SYSROOT_DEFAULT} | ||
| DESCRIPTION "Path to this VMM extension's sysroot" | ||
| SKIP_VALIDATION | ||
| ) |
Oops, something went wrong.