Skip to content

README.md

Latest commit

 

History

History
58 lines (43 loc) · 1.31 KB

README.md

File metadata and controls

58 lines (43 loc) · 1.31 KB

Arca

Installation

Runtime

Arca is currently paravirtualized within a custom hypervisor; it requires a Linux AMD64 machine with KVM enabled.

Toolchain

Arca is written in nightly Rust. You should install Rust and Cargo via rustup. Arca requires the x86_64-unknown-none target. Arca expects Rust version 1.85+.

Instructions for Debian- and RHEL-based distributions:

sudo [apt|dnf] install rustup
# rustup toolchain install stable # (optional)
rustup toolchain install nightly
rustup target install x86_64-unknown-none

You can update Rust and Cargo using:

rustup update

Fix Compilation

Building Fix-on-Arca additionally requires installing the GCC multilib package (gcc-multilib) on Debian-based distributions.

Running

Arca's general test suite can be run using the standard Cargo build commands.

cargo build
cargo test

Kernel-specific tests can be run using:

cargo test -p kernel --target=x86_64-unknown-none

Arca-powered kernels (such as Fix) can be run using:

cargo run -p kernel --bin hello --target=x86_64-unknown-none

for small demo kernels (located in kernel/src/bin), or using:

cargo run -p fix --target=x86_64-unknown-none

for standalone kernels.