nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2024-12-23 14:05:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document that process::abort will not call the panic hook

Browse Source
This commit is contained in:
Pirh 2017-10-02 19:59:50 +01:00
parent 7ab20c850e
commit 28ef0d1085
1 changed files with 3 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/libstd/process.rs
View File

@ -1129,7 +1129,8 @@ pub fn exit(code: i32) -> ! {
/// This is in contrast to the default behaviour of [`panic!`] which unwinds /// This is in contrast to the default behaviour of [`panic!`] which unwinds
/// the current thread's stack and calls all destructors. /// the current thread's stack and calls all destructors.
/// When `panic="abort"` is set, either as an argument to `rustc` or in a /// When `panic="abort"` is set, either as an argument to `rustc` or in a
/// crate's Cargo.toml, [`panic!`] and `abort` are equivalent. /// crate's Cargo.toml, [`panic!`] and `abort` are similar. However,
/// [`panic!`] will still call the [panic hook] while `abort` will not.
/// ///
/// If a clean shutdown is needed it is recommended to only call /// If a clean shutdown is needed it is recommended to only call
/// this function at a known point where there are no more destructors left /// this function at a known point where there are no more destructors left
@ -1171,6 +1172,7 @@ pub fn exit(code: i32) -> ! {
/// ``` /// ```
/// ///
/// [`panic!`]: ../../std/macro.panic.html /// [`panic!`]: ../../std/macro.panic.html
/// [panic hook]: ../../std/panic/fn.set_hook.html
#[stable(feature = "process_abort", since = "1.17.0")] #[stable(feature = "process_abort", since = "1.17.0")]
pub fn abort() -> ! { pub fn abort() -> ! {
unsafe { ::sys::abort_internal() }; unsafe { ::sys::abort_internal() };