43 releases (13 breaking)
|new 0.13.6||Sep 26, 2023|
|0.12.1||Aug 31, 2023|
|0.9.0||Jul 1, 2023|
|0.8.1||Mar 31, 2023|
|0.3.0||Nov 18, 2021|
#26 in No standard library
1,361 downloads per month
Used in 6 crates (3 directly)
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. And thread startup and
shutdown are traditionally implemented in libpthread functions
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 used by Mustang and Eyra in their libc implementations, and in the Origin Studio project in its std implementation, which are three different ways to support building Rust programs written entirely in Rust.
Origin can also be used on its own, in several different configurations:
The basic example shows a simple example of using Origin as a simple library. In this configuration, libc is doing most of the work.
The no-std example uses
no_stdand starts the program using Rust's
#[start]feature, and then hands control to Origin. libc is still doing most of the work here.
The external-start example uses
no_main, and starts the program by taking over control from libc as soon as possible, and then hands control to Origin. Origin handles program and thread startup and shutdown once it takes control.
The origin-start example uses
no_main, and lets Origin start the program using its own program entrypoint. Origin handles program and thread startup and shutdown and no part of libc is used. This is the approach that Origin Studio uses.
The origin-start-no-alloc example is like origin-start, but disables the "alloc" and "thread" features, since Origin's "thread" feature currently depends on "alloc". Without "alloc", functions that return owned strings or
Vecs are not available. In this mode, Origin avoids using a global allocator entirely.
The origin-start-lto example is like origin-start, but builds with LTO.
The tiny example is like origin-start, but builds with optimization flags, disables features, and adds an objcopy trick to produce a very small binary—408 bytes on x86-64!
Fully static linking
The resulting executables in the origin-start, origin-start-no-alloc, and origin-start-lto examples don't depend on any dynamic libraries, however by default they do still depend on a dynamic linker.
For fully static linking, there are two options:
RUSTFLAGS=-C target-feature=+crt-static -C relocation-model=static. This disables PIE mode, which is safer in terms of Origin's code, but loses the security benefits of Address-Space Layout Randomization (ASLR).
RUSTFLAGS=-C target-feature=+crt-staticand enable Origin's
experimental-relocatefeature. This allows PIE mode to work, however it does so by enabling some highly experimental code in origin for performing relocations.