Crate origin

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 an C-ABI-compatible interface to this functionality, see c-scape.

This is part of the Mustang project, building Rust programs written entirely in Rust.

Structs

Thread

Data associated with a thread. This is not repr(C) and not ABI-exposed.

Functions

at_exit

Register a function to be called when exit is called.

at_fork

Register functions to be called when fork is called.

at_thread_exit

Registers a function to call when the current thread exits.

create_thread

Creates a new thread.

current_thread

Return a raw pointer to the data associated with the current thread.

current_thread_id

Return the current thread id.

current_thread_tls_addr

Return the TLS entry for the current thread.

default_guard_size

Return the default guard size for new threads.

default_stack_size

Return the default stack size for new threads.

detach_thread^⚠

Marks a thread as “detached”.

exit

Call all the functions registered with at_exit and .fini_array, and exit the program.

exit_immediately

Exit the program without calling functions registered with at_exit or .fini_array.

fork^⚠

Creates a new process by duplicating the calling process.

join_thread^⚠

Waits for a thread to finish.

thread_stack^⚠

Return the current thread’s stack address (lowest address), size, and guard size.