ebd9ca8dec
This fixes a segfault when the allocated stack is just one page long. This also refactors the fringe::os module to use Result consistently. close #22 |
||
---|---|---|
.travis/docs | ||
benches | ||
src | ||
tests | ||
.editorconfig | ||
.gitignore | ||
.travis.yml | ||
Cargo.toml | ||
LICENSE | ||
README.md |
README.md
libfringe
libfringe is a low-level green threading library for Rust. It's usable in freestanding environments (like kernels), but it can also provide an easy-to-use stack allocator using your operating system's memory mapping facility.
Performance
libfringe does context switches in 2.5ns flat on x86_64!
test swap ... bench: 5 ns/iter (+/- 1)
…and on x86:
test swap ... bench: 5 ns/iter (+/- 1)
Limitations
libfringe currently doesn't work on anything but x86 and x86_64, and is untested on anything but Linux.
Installation
libfringe is a Cargo package.
It's not stable software yet, so you'll have to use it as a git dependency.
Add this to your Cargo.toml
:
[dependencies.fringe]
git = "https://github.com/edef1c/libfringe.git"
Feature flags
libfringe provides some optional features through Cargo's feature flags. Currently, all of them are enabled by default.
valgrind
Valgrind integration. libfringe will register context stacks with Valgrind.