1 //! Unwinding for *emscripten* target.
3 //! Whereas Rust's usual unwinding implementation for Unix platforms
4 //! calls into the libunwind APIs directly, on Emscripten we instead
5 //! call into the C++ unwinding APIs. This is just an expedience since
6 //! Emscripten's runtime always implements those APIs and does not
7 //! implement libunwind.
9 #![allow(private_no_mangle_fns)]
14 use alloc::boxed::Box;
15 use libc::{self, c_int};
18 // This matches the layout of std::type_info in C++
24 unsafe impl Sync for TypeInfo {}
27 // The leading `\x01` byte here is actually a magical signal to LLVM to
28 // *not* apply any other mangling like prefixing with a `_` character.
30 // This symbol is the vtable used by C++'s `std::type_info`. Objects of type
31 // `std::type_info`, type descriptors, have a pointer to this table. Type
32 // descriptors are referenced by the C++ EH structures defined above and
33 // that we construct below.
35 // Note that the real size is larger than 3 usize, but we only need our
36 // vtable to point to the third element.
37 #[link_name = "\x01_ZTVN10__cxxabiv117__class_type_infoE"]
38 static CLASS_TYPE_INFO_VTABLE: [usize; 3];
41 // std::type_info for a rust_panic class
42 #[lang = "eh_catch_typeinfo"]
43 static EXCEPTION_TYPE_INFO: TypeInfo = TypeInfo {
44 // Normally we would use .as_ptr().add(2) but this doesn't work in a const context.
45 vtable: unsafe { &CLASS_TYPE_INFO_VTABLE[2] },
46 // This intentionally doesn't use the normal name mangling scheme because
47 // we don't want C++ to be able to produce or catch Rust panics.
48 name: b"rust_panic\0".as_ptr(),
51 pub fn payload() -> *mut u8 {
55 pub unsafe fn cleanup(ptr: *mut u8) -> Box<dyn Any + Send> {
56 assert!(!ptr.is_null());
57 let adjusted_ptr = __cxa_begin_catch(ptr as *mut libc::c_void);
58 let ex = ptr::read(adjusted_ptr as *mut _);
63 pub unsafe fn panic(data: Box<dyn Any + Send>) -> u32 {
64 let sz = mem::size_of_val(&data);
65 let exception = __cxa_allocate_exception(sz);
66 if exception == ptr::null_mut() {
67 return uw::_URC_FATAL_PHASE1_ERROR as u32;
69 ptr::write(exception as *mut _, data);
70 __cxa_throw(exception as *mut _, &EXCEPTION_TYPE_INFO, ptr::null_mut());
73 #[lang = "eh_personality"]
75 unsafe extern "C" fn rust_eh_personality(version: c_int,
76 actions: uw::_Unwind_Action,
77 exception_class: uw::_Unwind_Exception_Class,
78 exception_object: *mut uw::_Unwind_Exception,
79 context: *mut uw::_Unwind_Context)
80 -> uw::_Unwind_Reason_Code {
81 __gxx_personality_v0(version, actions, exception_class, exception_object, context)
85 fn __cxa_allocate_exception(thrown_size: libc::size_t) -> *mut libc::c_void;
86 fn __cxa_begin_catch(thrown_exception: *mut libc::c_void) -> *mut libc::c_void;
88 fn __cxa_throw(thrown_exception: *mut libc::c_void,
89 tinfo: *const TypeInfo,
90 dest: *mut libc::c_void) -> !;
91 fn __gxx_personality_v0(version: c_int,
92 actions: uw::_Unwind_Action,
93 exception_class: uw::_Unwind_Exception_Class,
94 exception_object: *mut uw::_Unwind_Exception,
95 context: *mut uw::_Unwind_Context)
96 -> uw::_Unwind_Reason_Code;