https://github.com/hermit-os/hermit-entry

Hermit's loading and entry API.
https://github.com/hermit-os/hermit-entry

hermit rust unikernel

Last synced: 5 months ago
JSON representation

Hermit's loading and entry API.

• Host: GitHub
• URL: https://github.com/hermit-os/hermit-entry
• Owner: hermit-os
• License: apache-2.0
• Created: 2022-06-11T13:15:02.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2026-01-20T14:31:39.000Z (5 months ago)
• Last Synced: 2026-01-20T22:53:18.283Z (5 months ago)
• Topics: hermit, rust, unikernel
• Language: Rust
• Homepage: https://crates.io/crates/hermit-entry
• Size: 185 KB
• Stars: 5
• Watchers: 3
• Forks: 7
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

          
# hermit-entry

[![Crates.io](https://img.shields.io/crates/v/hermit-entry)](https://crates.io/crates/hermit-entry)

[![docs.rs](https://img.shields.io/badge/docs.rs-documentation-green.svg)](https://docs.rs/hermit-entry/latest/hermit_entry/)

[![CI](https://github.com/hermitcore/hermit-entry/actions/workflows/ci.yml/badge.svg)](https://github.com/hermitcore/hermit-entry/actions/workflows/ci.yml)

Hermit's loading and entry API.

## License

Licensed under either of

 * Apache License, Version 2.0

   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license

   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

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.

## Hermit images

This Rust crate also implements a basic reader for Hermit images.

Overall, these are just `.tar.gz` (i.e. gzipped tar) files.

They contain at least 2 special entries:

* The config file (in TOML format), at `hermit.toml` in the image root.

  The expected entries are described in the crate documentation in `hermit_entry::config::Config` (requires enabling the `config` feature).

* A Hermit Kernel ELF file, whose path is specified in the config.

All subdirectories of the image itself are mapped

(from the Hermit kernel perspective) into `/`.