//! Implementation of panics via stack unwinding //! //! This crate is an implementation of panics in Rust using "most native" stack //! unwinding mechanism of the platform this is being compiled for. This //! essentially gets categorized into three buckets currently: //! //! 1. MSVC targets use SEH in the `seh.rs` file. //! 2. Emscripten uses C++ exceptions in the `emcc.rs` file. //! 3. All other targets use libunwind/libgcc in the `gcc.rs` file. //! //! More documentation about each implementation can be found in the respective //! module. #![no_std] #![unstable(feature = "panic_unwind", issue = "32837")] #![doc( html_root_url = "https://doc.rust-lang.org/nightly/", issue_tracker_base_url = "https://github.com/rust-lang/rust/issues/" )] #![feature(core_intrinsics)] #![feature(lang_items)] #![feature(libc)] #![feature(nll)] #![feature(panic_unwind)] #![feature(raw)] #![feature(staged_api)] #![feature(std_internals)] #![feature(unwind_attributes)] #![feature(abi_thiscall)] #![panic_runtime] #![feature(panic_runtime)] use alloc::boxed::Box; use core::intrinsics; use core::mem; use core::panic::BoxMeUp; use core::raw; cfg_if::cfg_if! { if #[cfg(target_os = "emscripten")] { #[path = "emcc.rs"] mod imp; } else if #[cfg(target_arch = "wasm32")] { #[path = "dummy.rs"] mod imp; } else if #[cfg(target_os = "hermit")] { #[path = "hermit.rs"] mod imp; } else if #[cfg(all(target_env = "msvc", target_arch = "aarch64"))] { #[path = "dummy.rs"] mod imp; } else if #[cfg(target_env = "msvc")] { #[path = "seh.rs"] mod imp; } else { // Rust runtime's startup objects depend on these symbols, so make them public. #[cfg(all(target_os="windows", target_arch = "x86", target_env="gnu"))] pub use imp::eh_frame_registry::*; #[path = "gcc.rs"] mod imp; } } mod dwarf; // Entry point for catching an exception, implemented using the `try` intrinsic // in the compiler. // // The interaction between the `payload` function and the compiler is pretty // hairy and tightly coupled, for more information see the compiler's // implementation of this. #[no_mangle] pub unsafe extern "C" fn __rust_maybe_catch_panic( f: fn(*mut u8), data: *mut u8, data_ptr: *mut usize, vtable_ptr: *mut usize, ) -> u32 { let mut payload = imp::payload(); if intrinsics::r#try(f, data, &mut payload as *mut _ as *mut _) == 0 { 0 } else { let obj = mem::transmute::<_, raw::TraitObject>(imp::cleanup(payload)); *data_ptr = obj.data as usize; *vtable_ptr = obj.vtable as usize; 1 } } // Entry point for raising an exception, just delegates to the platform-specific // implementation. #[no_mangle] #[unwind(allowed)] pub unsafe extern "C" fn __rust_start_panic(payload: usize) -> u32 { let payload = payload as *mut &mut dyn BoxMeUp; let payload = (*payload).take_box(); // Miri panic support: cfg'd out of normal builds just to be sure. // When going through normal codegen, `miri_start_panic` is a NOP, so the // Miri-enabled sysroot still supports normal unwinding. But when executed in // Miri, this line initiates unwinding. #[cfg(miri)] core::intrinsics::miri_start_panic(payload); imp::panic(Box::from_raw(payload)) }