origin 0.8.6

Program startup and thread support written in Rust
Documentation

Origin implements program startup and shutdown, as well as thread startup and shutdown, for Linux, implemented in Rust.

Program startup and shutdown for Linux is traditionally implemented in crt1.o, and the libc functions exit, atexit, and _exit. And thread startup and shutdown are traditionally implemented in libpthread functions pthread_create, pthread_join, pthread_detach, and so on. Origin provides its own implementations of this functionality, written in Rust.

For a C-ABI-compatible interface to this functionality, see c-scape.

This is part of the Mustang project, building Rust programs written entirely in Rust. When compiled for non-mustang targets, this library uses the system crt and libpthread libraries.

Using origin in non-mustang programs

Origin can also be used as an orginary library, when compiled in non-mustang targets, provided you're using nightly Rust. In this configuration, origin disables its own program startup and thread implementations and lets libc handle those parts. Its API is then implemented in terms of system libc calls, including pthread calls.

See the origin-as-just-a-library example for more details.