Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sunfishcode/origin

Program startup and thread support written in Rust
https://github.com/sunfishcode/origin

linux rust

Last synced: 27 days ago
JSON representation

Program startup and thread support written in Rust

Host: GitHub
URL: https://github.com/sunfishcode/origin
Owner: sunfishcode
License: other
Created: 2023-08-21T15:50:40.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-10-13T13:37:36.000Z (about 1 month ago)
Last Synced: 2024-10-13T15:12:12.543Z (about 1 month ago)
Topics: linux, rust
Language: Rust
Homepage:
Size: 449 KB
Stars: 163
Watchers: 10
Forks: 11
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


  Origin


  


    Program and thread startup and shutdown in Rust

  


  


    

    

    

    

  



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

It works with both stable (currently Rust >= 1.78) and nightly Rust. If you're

using nightly Rust, enable the feature "nightly" to let origin use nightly-only

features, which include proper support for unwinding, better safety checks, and

better optimizations.

## Example crates

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_std]` and 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_std]` and `#![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_std]` and `#![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

   `Vec`s 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:

 - Build with

   `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).

 - Build with `RUSTFLAGS=-C target-feature=+crt-static` and enable Origin's

   `experimental-relocate` feature. This allows PIE mode to work, however it

   does so by enabling some experimental code in Origin for performing

   relocations.

[basic example]: https://github.com/sunfishcode/origin/blob/main/example-crates/basic/README.md

[no-std example]: https://github.com/sunfishcode/origin/blob/main/example-crates/no-std/README.md

[external-start example]: https://github.com/sunfishcode/origin/blob/main/example-crates/external-start/README.md

[origin-start example]: https://github.com/sunfishcode/origin/blob/main/example-crates/origin-start/README.md

[origin-start-no-alloc example]: https://github.com/sunfishcode/origin/blob/main/example-crates/origin-start-no-alloc/README.md

[origin-start-lto example]: https://github.com/sunfishcode/origin/blob/main/example-crates/origin-start-lto/README.md

[tiny example]: https://github.com/sunfishcode/origin/blob/main/example-crates/tiny/README.md

[Mustang]: https://github.com/sunfishcode/mustang#readme

[Eyra]: https://github.com/sunfishcode/eyra#readme

[Origin Studio]: https://github.com/sunfishcode/origin-studio#readme

[c-scape]: https://github.com/sunfishcode/c-ward/tree/main/c-scape#readme