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
9#ifndef __CXXABI_H
10#define __CXXABI_H
11
12/*
13 * This header provides the interface to the C++ ABI as defined at:
14 * https://itanium-cxx-abi.github.io/cxx-abi/
15 */
16
17#include <stddef.h>
18#include <stdint.h>
19
20#include <__cxxabi_config.h>
21
22#define _LIBCPPABI_VERSION 15000
23#define _LIBCXXABI_NORETURN __attribute__((noreturn))
24#define _LIBCXXABI_ALWAYS_COLD __attribute__((cold))
25
26#ifdef __cplusplus
27
28namespace std {
29#if defined(_WIN32)
30class _LIBCXXABI_TYPE_VIS type_info; // forward declaration
31#else
32class type_info; // forward declaration
33#endif
34}
35
36
37// runtime routines use C calling conventions, but are in __cxxabiv1 namespace
38namespace __cxxabiv1 {
39
40struct __cxa_exception;
41
42extern "C" {
43
44// 2.4.2 Allocating the Exception Object
45extern _LIBCXXABI_FUNC_VIS void *
46__cxa_allocate_exception(size_t thrown_size) throw();
47extern _LIBCXXABI_FUNC_VIS void
48__cxa_free_exception(void *thrown_exception) throw();
49// This function is an LLVM extension, which mirrors the same extension in libsupc++ and libcxxrt
50extern _LIBCXXABI_FUNC_VIS __cxa_exception*
51#ifdef __wasm__
52// In Wasm, a destructor returns its argument
53__cxa_init_primary_exception(void* object, std::type_info* tinfo, void*(_LIBCXXABI_DTOR_FUNC* dest)(void*)) throw();
54#else
55__cxa_init_primary_exception(void* object, std::type_info* tinfo, void(_LIBCXXABI_DTOR_FUNC* dest)(void*)) throw();
56#endif
57
58// 2.4.3 Throwing the Exception Object
59extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void
60__cxa_throw(void *thrown_exception, std::type_info *tinfo,
61#ifdef __wasm__
62 void *(_LIBCXXABI_DTOR_FUNC *dest)(void *));
63#else
64 void (_LIBCXXABI_DTOR_FUNC *dest)(void *));
65#endif
66
67// 2.5.3 Exception Handlers
68extern _LIBCXXABI_FUNC_VIS void *
69__cxa_get_exception_ptr(void *exceptionObject) throw();
70extern _LIBCXXABI_FUNC_VIS void *
71__cxa_begin_catch(void *exceptionObject) throw();
72extern _LIBCXXABI_FUNC_VIS void __cxa_end_catch();
73#if defined(_LIBCXXABI_ARM_EHABI)
74extern _LIBCXXABI_FUNC_VIS bool
75__cxa_begin_cleanup(void *exceptionObject) throw();
76extern _LIBCXXABI_FUNC_VIS void __cxa_end_cleanup();
77#endif
78extern _LIBCXXABI_FUNC_VIS std::type_info *__cxa_current_exception_type();
79
80// GNU extension
81// Calls `terminate` with the current exception being caught. This function is used by GCC when a `noexcept` function
82// throws an exception inside a try/catch block and doesn't catch it.
83extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_call_terminate(void*) throw();
84
85// 2.5.4 Rethrowing Exceptions
86extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_rethrow();
87
88// 2.6 Auxiliary Runtime APIs
89extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_bad_cast(void);
90extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_bad_typeid(void);
91extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void
92__cxa_throw_bad_array_new_length(void);
93
94// 3.2.6 Pure Virtual Function API
95extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_pure_virtual(void);
96
97// 3.2.7 Deleted Virtual Function API
98extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_NORETURN void __cxa_deleted_virtual(void);
99
100// 3.3.2 One-time Construction API
101#if defined(_LIBCXXABI_GUARD_ABI_ARM)
102extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD int __cxa_guard_acquire(uint32_t *);
103extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD void __cxa_guard_release(uint32_t *);
104extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD void __cxa_guard_abort(uint32_t *);
105#else
106extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD int __cxa_guard_acquire(uint64_t *);
107extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD void __cxa_guard_release(uint64_t *);
108extern _LIBCXXABI_FUNC_VIS _LIBCXXABI_ALWAYS_COLD void __cxa_guard_abort(uint64_t *);
109#endif
110
111// 3.3.3 Array Construction and Destruction API
112extern _LIBCXXABI_FUNC_VIS void *
113__cxa_vec_new(size_t element_count, size_t element_size, size_t padding_size,
114 void (*constructor)(void *), void (*destructor)(void *));
115
116extern _LIBCXXABI_FUNC_VIS void *
117__cxa_vec_new2(size_t element_count, size_t element_size, size_t padding_size,
118 void (*constructor)(void *), void (*destructor)(void *),
119 void *(*alloc)(size_t), void (*dealloc)(void *));
120
121extern _LIBCXXABI_FUNC_VIS void *
122__cxa_vec_new3(size_t element_count, size_t element_size, size_t padding_size,
123 void (*constructor)(void *), void (*destructor)(void *),
124 void *(*alloc)(size_t), void (*dealloc)(void *, size_t));
125
126extern _LIBCXXABI_FUNC_VIS void
127__cxa_vec_ctor(void *array_address, size_t element_count, size_t element_size,
128 void (*constructor)(void *), void (*destructor)(void *));
129
130extern _LIBCXXABI_FUNC_VIS void __cxa_vec_dtor(void *array_address,
131 size_t element_count,
132 size_t element_size,
133 void (*destructor)(void *));
134
135extern _LIBCXXABI_FUNC_VIS void __cxa_vec_cleanup(void *array_address,
136 size_t element_count,
137 size_t element_size,
138 void (*destructor)(void *));
139
140extern _LIBCXXABI_FUNC_VIS void __cxa_vec_delete(void *array_address,
141 size_t element_size,
142 size_t padding_size,
143 void (*destructor)(void *));
144
145extern _LIBCXXABI_FUNC_VIS void
146__cxa_vec_delete2(void *array_address, size_t element_size, size_t padding_size,
147 void (*destructor)(void *), void (*dealloc)(void *));
148
149extern _LIBCXXABI_FUNC_VIS void
150__cxa_vec_delete3(void *__array_address, size_t element_size,
151 size_t padding_size, void (*destructor)(void *),
152 void (*dealloc)(void *, size_t));
153
154extern _LIBCXXABI_FUNC_VIS void
155__cxa_vec_cctor(void *dest_array, void *src_array, size_t element_count,
156 size_t element_size, void (*constructor)(void *, void *),
157 void (*destructor)(void *));
158
159// 3.3.5.3 Runtime API
160// These functions are part of the C++ ABI, but they are not defined in libc++abi:
161// int __cxa_atexit(void (*)(void *), void *, void *);
162// void __cxa_finalize(void *);
163
164// 3.4 Demangler API
165extern _LIBCXXABI_FUNC_VIS char *__cxa_demangle(const char *mangled_name,
166 char *output_buffer,
167 size_t *length, int *status);
168
169// Apple additions to support C++ 0x exception_ptr class
170// These are primitives to wrap a smart pointer around an exception object
171extern _LIBCXXABI_FUNC_VIS void *__cxa_current_primary_exception() throw();
172extern _LIBCXXABI_FUNC_VIS void
173__cxa_rethrow_primary_exception(void *primary_exception);
174extern _LIBCXXABI_FUNC_VIS void
175__cxa_increment_exception_refcount(void *primary_exception) throw();
176extern _LIBCXXABI_FUNC_VIS void
177__cxa_decrement_exception_refcount(void *primary_exception) throw();
178
179// Apple extension to support std::uncaught_exception()
180extern _LIBCXXABI_FUNC_VIS bool __cxa_uncaught_exception() throw();
181extern _LIBCXXABI_FUNC_VIS unsigned int __cxa_uncaught_exceptions() throw();
182
183#if defined(__linux__) || defined(__Fuchsia__)
184// Linux and Fuchsia TLS support. Not yet an official part of the Itanium ABI.
185// https://sourceware.org/glibc/wiki/Destructor%20support%20for%20thread_local%20variables
186extern _LIBCXXABI_FUNC_VIS int __cxa_thread_atexit(void (*)(void *), void *,
187 void *) throw();
188#endif
189
190} // extern "C"
191} // namespace __cxxabiv1
192
193namespace abi = __cxxabiv1;
194
195#endif // __cplusplus
196
197#endif // __CXXABI_H
198