uhyve is designed to improve the performance and the scalability of HermitCore / RustyHermit applications. In contrast to QEMU, uhyve directly boots in 64 bit mode and does not rely on inter-processor interrupts to boot additional cores. The hypervisor is uses KVM and requires Linux as host system.
To build uhyve you need following tools:
- x86-based Linux systems
- Recent host compiler such as GCC
- CMake
- git
Please make sure that you use the correct branch of this repository.
The master branch is designed for HermitCore, whereas the branch path2rs is required for RustyHermit.
As a first step please clone this repository. This will clone the uhyve version used for RustyHermit
git clone -b path2rs https://github.com/hermitcore/hermit-caves.gitThe build process itself is identical for both uhyve versions:
cd hermit-caves
mkdir build
cd build
cmake ..
makeThis will create an application uhyve in the working directory. Use this application to start the RustyHermit applications.
uhyve is configured by environment variables.
The variable HERMIT_CPUS specifies the number of cores the RustyHermit application can use and HERMIT_MEM defines the maximum amount of memory available to the application. The suffixes M and G can be used to specify a value in megabytes or gigabytes, respectively.
By default, uhyve will use one core and 512 MiB RAM.
For instance, the following command starts the demo application with 4 cores and 8 GiB memory:
HERMIT_CPUS=4 HERMIT_MEM=8G ./uhyve ../../hello_world/target/x86_64-unknown-hermit/debug/hello_worldSetting the environment variable HERMIT_VERBOSE to 1 will have uhyve print kernel log messages to the terminal.
HERMIT_VERBOSE=1 ./uhyve ../../hello_world/target/x86_64-unknown-hermit/debug/hello_worldLicensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.