occheung
/
libfringe
forked from M-Labs/libfringe
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
A Rust library implementing safe, lightweight context switches, without relying on kernel services
136 Commits 2 Branches 0 Tags 376 KiB
Rust 99.4%
Shell 0.6%
Go to file
edef 026f7b9925 update benchmarks: 2.5ns on x86_64! 2016-04-03 12:04:46 +02:00
.travis/docs run on Travis CI container infra 2015-04-19 15:40:43 -04:00
benches remove copyright years 2016-03-22 08:25:23 +01:00
examples remove copyright years 2016-03-22 08:25:23 +01:00
src coerce rust_trampoline to a function pointer properly 2016-04-03 12:00:21 +02:00
.editorconfig add .editorconfig 2015-04-16 04:17:55 -04:00
.gitignore initial commit 2014-12-23 04:27:28 +01:00
.travis.yml run Cargo in verbose mode on Travis CI 2016-03-16 09:09:36 +01:00
Cargo.toml void: 0.0.5 -> 1.0.0 2016-04-03 08:54:56 +02:00
LICENSE remove copyright years 2016-03-22 08:25:23 +01:00
README.md update benchmarks: 2.5ns on x86_64! 2016-04-03 12:04:46 +02:00

README.md

travis rustdoc

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 several 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.

os

Built-in stack allocator using your your operating system's anonymous memory mapping facility. Currently only available for Unix.