4 releases
0.1.9 | Sep 6, 2024 |
---|---|
0.1.8 | Jun 20, 2024 |
0.1.3 |
|
#561 in Rust patterns
24KB
301 lines
libabort
An implementation of the abort
function that works without the standard library.
Provides an AbortGuard
type to abort the process unless explicitly "defused".
This can prevent panics from unwinding in the middle of unsafe
code,
which trivially makes the code exception safe.
Available implementations
The library offers multiple possible implementations, which can be controlled by using feature flags.
- Using the Rust standard library
std::process::abort
function. This is enabled by using the "std" feature (disabled by default). - Using the C standard library
abort
function from thelibc
crate. This requires linking against the C standard library, but not the Rust one. This is enabled by using the "libc" feature (disabled by default). - If the
panic!
implementation is known to abort instead of unwinding, then theabort
function simply triggers a panic. This requires a recent version of Rust (1.60) in order to detect whether panics unwind or abort. - If no other implementations are available,
then the
abort
function triggers a double-panic. This always triggers an abort regardless of the rust version or compiler settings.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.