Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sorpaas/sputnikvm-on-rux

SputnikVM for embedded devices.
https://github.com/sorpaas/sputnikvm-on-rux

Last synced: 25 days ago
JSON representation

SputnikVM for embedded devices.

Awesome Lists containing this project

README

        

# SputnikVM on Rux

This `no_std` version of SputnikVM allows you to run it on the [Rux
microkernel](https://source.that.world/source/rux/).

## Get Started

To build and run `sputnikvm_nostd`, it needs to be bundled with the
Rux microkernel and be executed together. First, initialize the
submodules which points to a revision of
[Rux](https://source.that.world/source/rux/).

```lang=bash
git submodule init --recursive --update
```

After that, install [Nix](https://nixos.org/nix/). Then run:

```lang=bash
nix-shell
```

This will install all the dependencies you need to build the kernel
and SputnikVM in a specialized Nix location without any modification
to your actual system.

After that, to run the kernel with SputnikVM init program, run:

```lang=bash
make sinit-sputnikvm
```

Under the hook, the script will start a QEMU virtual machine,
bootstrap the kernel, which will then load the init program and run a
simple SputnikVM transaction.

## Bug Reports and Contributing

For bug reports and pull requests related to Rux, please use this
[Phabricator instance](https://source.that.world/). Bug reports can be
submitted to [Maniphest](https://source.that.world/maniphest/) and
refer to [Rux](https://source.that.world/source/rux/)'s contributing
guide for sending pull requests.