Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jasonyu1996/elasticlave
https://github.com/jasonyu1996/elasticlave
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/jasonyu1996/elasticlave
- Owner: jasonyu1996
- License: other
- Created: 2021-10-14T10:46:00.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-09-01T09:53:08.000Z (over 1 year ago)
- Last Synced: 2024-08-03T01:25:44.185Z (4 months ago)
- Language: C
- Size: 1.13 MB
- Stars: 21
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- Awesome-SGX-Open-Source - https://github.com/jasonyu1996/elasticlave
README
# Elasticlave
**Elasticlave** is a Trusted Execution Environment (TEE) design which enables efficient cross-enclave data sharing.
This repository contains the prototype implementation based on [Keystone](https://keystone-enclave.org/) as described in ["Elasticlave : An Efficient Memory Model for Enclaves"](https://www.usenix.org/conference/usenixsecurity22/presentation/yu-jason) at Usenix Security Symposium 2022). For simplicity, we directly refer to this prototype implementation as Elasticlave in this document.
We support two options for running Elasticlave:
1. On a RISC-V SoC simulated with [FireSim](https://fires.im/). This can give accurate performance data and is therefore suitable for performance benchmarking. However, it is generally much slower than the second option.
2. On a system emulated with QEMU. It cannot provide accurate performance data but runs fast and is great for testing the functionality.
The setup of Elasticlave differs depending on the option chosen.
## On FireSim
### Requirements and Dependencies
You need to set up FireSim on AWS EC2. Elasticlave and the associated scripts in this repository
have been tested on FireSim 1.9.0, which is included as a submodule in `firesim/` along with the
Elasticlave-specific configuration files.
Please refer to the [FireSim documentation](https://docs.fires.im/en/1.9.0/) for instructions.
We have dockerised the remaining software dependencies.
See the [official website of Docker](https://www.docker.com/) for instructions on installing Docker on your system.
### Building
```bash
git clone https://github.com/jasonyu1996/elasticlave.git --recursive --shallow-submodules
cd elasticlave
git submodule update --init --recursive
./docker.sh MAKE_FIRESIM=1
```
### Launching
```bash
./run-firesim.sh
```
By default, this uses FireSim in `firesim/`. If you have set up FireSim in a different directory,
specify the `FIRESIM_HOME` environment variable:
```bash
FIRESIM_HOME= ./run-firesim.sh
```
## On QEMU
### Requirements and Dependencies
We have dockerised most of the software dependencies, so there should be little problem running Elasticlave on any x86-64 Linux distribution with **Docker** installed.
See the [official website of Docker](https://www.docker.com/) for instructions on installing Docker on your system.
### Building
```bash
git clone https://github.com/jasonyu1996/elasticlave.git
cd elasticlave
git submodule update --init --recursive
./docker.sh
```
### Launching
```bash
./docker-run.sh ./run.sh
```
When prompted for the login, enter `root`. The corresponding password is `sifive`.
## Benchmarks
### Configuration
You can configure which benchmarks to include in the built file system. To achieve this, edit the file ``KEYSTONE_FOLDER/tests/tests/mkconfig.mk`` and uncomment the names of the benchmarks you want to include.
### Available Benchmarks
Below are lists of the benchmarks included in this repository.
#### Synthetic Benchmarks
##### Thread Synchronisation
| Benchmark set | Elasticlave (spinlock) | Elasticlave (futex) | Spatial isolation | Native non-TEE |
| ------------- | ---------------------- | ------------------- | ----------------- | --------------- |
| Lock | ``lock`` | ``lock-futex`` | ``lock-spatial`` | ``lock-native`` |
##### Data Sharing Patterns
| Benchmark set | Elasticlave | Elasticlave (no lock bit) | Spatial isolation |
| ----------------- | ------------------ | ------------------------- | --------------------------- |
| Producer-consumer | ``icall-consumer`` | ``icall-consumer-ne`` | ``icall-consumer-baseline`` |
| Client-server | ``icall-server`` | ``icall-server-ne`` | ``icall-server-baseline`` |
| Proxy | ``icall-proxy-3`` | ``icall-proxy-3-ne`` | ``icall-proxy-3-baseline`` |
#### IOZone
| Benchmark set | Elasticlave | Spatial isolation | Native non-TEE |
| ------------- | ----------- | ------------------- | ----------------- |
| IOZone | ``iozone`` | ``iozone-baseline`` | ``iozone-native`` |
## Third-Party Components
The implementation provided in this repository is based on [Keystone](https://keystone-enclave.org/).
This repository includes the third-party benchmark [IOZone](https://www.iozone.org/). The licence is included in its source files.
---------
Below is the original README from Keystone, which can also be valuable fo reference.
# Keystone: An Open-Source Secure Enclave Framework for RISC-V Processors
[](https://travis-ci.org/keystone-enclave/keystone/)
Visit [Project Website](https://keystone-enclave.org) for more information.
`master` branch is for public releases.
`dev` branch is for development use (up-to-date but may not fully documented until merged into `master`).
# Documentation
See [docs](http://docs.keystone-enclave.org) for getting started.
# Contributing
See CONTRIBUTING.md