1//===----------------------------------------------------------------------===// 2// 3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4// See https://llvm.org/LICENSE.txt for license information. 5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6// 7// 8// C++ ABI Level 1 ABI documented at: 9// https://itanium-cxx-abi.github.io/cxx-abi/abi-eh.html 10// 11//===----------------------------------------------------------------------===// 12 13#ifndef __ITANIUM_UNWIND_H__ 14#define __ITANIUM_UNWIND_H__ 15 16struct _Unwind_Context; // opaque 17struct _Unwind_Exception; // forward declaration 18typedef struct _Unwind_Exception _Unwind_Exception; 19typedef uint64_t _Unwind_Exception_Class; 20 21struct _Unwind_Exception { 22 _Unwind_Exception_Class exception_class; 23 void (*exception_cleanup)(_Unwind_Reason_Code reason, 24 _Unwind_Exception *exc); 25#if defined(__SEH__) && !defined(__USING_SJLJ_EXCEPTIONS__) 26 uintptr_t private_[6]; 27#else 28 uintptr_t private_1; // non-zero means forced unwind 29 uintptr_t private_2; // holds sp that phase1 found for phase2 to use 30#endif 31#if __SIZEOF_POINTER__ == 4 32 // The implementation of _Unwind_Exception uses an attribute mode on the 33 // above fields which has the side effect of causing this whole struct to 34 // round up to 32 bytes in size (48 with SEH). To be more explicit, we add 35 // pad fields added for binary compatibility. 36 uint32_t reserved[3]; 37#endif 38 // The Itanium ABI requires that _Unwind_Exception objects are "double-word 39 // aligned". GCC has interpreted this to mean "use the maximum useful 40 // alignment for the target"; so do we. 41} __attribute__((__aligned__)); 42 43typedef _Unwind_Reason_Code (*_Unwind_Personality_Fn)( 44 int version, _Unwind_Action actions, uint64_t exceptionClass, 45 _Unwind_Exception *exceptionObject, struct _Unwind_Context *context); 46 47#ifdef __cplusplus 48extern "C" { 49#endif 50 51// 52// The following are the base functions documented by the C++ ABI 53// 54#ifdef __USING_SJLJ_EXCEPTIONS__ 55extern _Unwind_Reason_Code 56 _Unwind_SjLj_RaiseException(_Unwind_Exception *exception_object); 57extern void _Unwind_SjLj_Resume(_Unwind_Exception *exception_object); 58#else 59extern _Unwind_Reason_Code 60 _Unwind_RaiseException(_Unwind_Exception *exception_object); 61extern void _Unwind_Resume(_Unwind_Exception *exception_object); 62#endif 63extern void _Unwind_DeleteException(_Unwind_Exception *exception_object); 64 65 66extern uintptr_t _Unwind_GetGR(struct _Unwind_Context *context, int index); 67extern void _Unwind_SetGR(struct _Unwind_Context *context, int index, 68 uintptr_t new_value); 69extern uintptr_t _Unwind_GetIP(struct _Unwind_Context *context); 70extern void _Unwind_SetIP(struct _Unwind_Context *, uintptr_t new_value); 71 72#ifdef __cplusplus 73} 74#endif 75 76#endif // __ITANIUM_UNWIND_H__ 77