From c445d128720e96adcdd12db9849f19fd60fca353 Mon Sep 17 00:00:00 2001 From: johannst Date: Tue, 29 Sep 2020 21:20:43 +0200 Subject: updated README --- README.md | 39 +++++++++++++++++++++++++++++++++++---- 1 file changed, 35 insertions(+), 4 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index cf865d0..f4702ac 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,43 @@ # matcha-threads -A simple and unsafe implementation of cooperative-multitasking in userspace -(see [fibers][fiber_wiki]). +A simple and unsafe implementation of `cooperative-multitasking` in userspace +(see [`fibers`][fiber_wiki]). -`matcha-threads` were born after being bored and feeling low-"levelish". +This implementation should not be used for anything serious, it was just +created to type some lines of `asm` and filll a few evenings. + +Supported platforms are `Linux` running on +- `x86_64` +- `arm64` + +### Setup development environment +This project provides a [`Dockerfile`](docker/Dockerfile) with all the required +tools pre-installed. + +To build and launch a container instance run +```bash +make docker +``` +> On the fist invocation this takes some minutes as it needs to build the +> docker image. + +Additionally the locally cloned repository will be mounted into the container +instance. This allows to use editors/tools installed on the host and to reduce +the image disk footprint. + +### Build and run demo +The `x86_64` demo can be run as +```bash +make demo1 +``` +The `arm64` demo can be run as +```bash +make ARCH=arm64 demo1 +``` +> Before starting to compile & run for a different architecture the the current +> build artifacts should be removed via `make clean`. ## License This project is licensed under the [MIT](LICENSE) license. - [fiber_wiki]: https://en.wikipedia.org/wiki/Fiber_(computer_science) -- cgit v1.2.3