package mirage-runtime

  1. Overview
  2. Docs
The base MirageOS runtime library, part of every MirageOS unikernel

Install

Dune Dependency

Authors

Maintainers

Sources

mirage-4.0.0.beta1.tbz
sha256=3d3ea9d35a475210eb9212b43a9e9516ec977f53365053402977b964255a3fec
sha512=4889e143d9c4e4082e23fbccc577e73b4849b8b4e01d42d58a1a1bf2b7f55a4ae2d00cd39ff2fafc4067d37c8e0bc8df26257e1d50127e026e61a23682df0589

Description

A bundle of useful runtime functions for applications built with MirageOS

Tags

org:mirage org:xapi-project

Published: 29 Jan 2022

README

MirageOS

MirageOS is a library operating system that constructs unikernels for secure, high-performance network applications across a variety of cloud computing and mobile platforms. Code can be developed on a traditional OS such as Linux or MacOS X, and then compiled into a fully-standalone, specialised unikernel that runs under the Xen or KVM hypervisors as well as lightweight hypervisors like FreeBSD's BHyve, OpenBSD's VMM. Xen and KVM power many public clouds; MirageOS unikernels are currently running on Amazon's Elastic Compute Cloud and Google Compute Engine, and maybe others!

The most up-to-date documentation can be found at the homepage. The site is a Xen hosted unikernel. Simpler skeleton applications are also available online.

This repository

This repository includes:

  • a command-line tool to create and deploy applications with MirageOS; and

  • in types/, a library of type signatures that compliant applications use.

There are several diverse backends in MirageOS that require rather specialised build steps (from Xen to KVM unikernels), and this complexity is wrapped up in the tool.

To work with mirage, you'll need to either install prerequisites locally.

Local install

You will need the following:

  • a working OCaml compiler (4.05.0 or higher).

  • the OPAM source package manager (2.0.0 or higher).

  • an x86_64 or armel Linux host to compile Xen kernels, or FreeBSD, OpenBSD or MacOS X for the solo5 and userlevel versions.

Using mirage

There are two stages to using mirage:

  • a configure phase where necessary code is generated and dependencies are determined.

  • an optional depends phase where OPAM package dependencies are satisfied.

  • a build phase where the compiler and any support scripts are run.

You can find documentation, walkthroughs and tutorials over on the MirageOS website. The install instructions are a good place to begin!

Dependencies (7)

  1. lwt >= "4.0.0"
  2. logs
  3. fmt >= "0.8.4"
  4. functoria-runtime = version
  5. ipaddr >= "5.0.0"
  6. dune >= "2.8.0"
  7. ocaml >= "4.08.0"

Dev Dependencies (1)

  1. alcotest with-test

Used by (10)

  1. conan >= "0.0.2"
  2. conan-cli >= "0.0.2"
  3. mirage = "4.0.0~beta1"
  4. mirage-crypto-pk >= "0.10.3" & < "0.11.0"
  5. mirage-crypto-rng-mirage
  6. mirage-entropy = "0.5.0"
  7. mirage-monitoring < "0.0.3"
  8. mirage-solo5 >= "0.6.1"
  9. mirage-unix >= "4.0.0"
  10. mirage-xen >= "5.0.0"

Conflicts (1)

  1. ppxlib = "0.29.0"
OCaml

Innovation. Community. Security.