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 //  This file implements the "Exception Handling APIs"
9 //  https://itanium-cxx-abi.github.io/cxx-abi/abi-eh.html
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "cxxabi.h"
14 
15 #include <exception>        // for std::terminate
16 #include <string.h>         // for memset
17 #include "cxa_exception.h"
18 #include "cxa_handlers.h"
19 #include "fallback_malloc.h"
20 #include "include/atomic_support.h" // from libc++
21 
22 #if __has_feature(address_sanitizer)
23 #include <sanitizer/asan_interface.h>
24 #endif
25 
26 // +---------------------------+-----------------------------+---------------+
27 // | __cxa_exception           | _Unwind_Exception CLNGC++\0 | thrown object |
28 // +---------------------------+-----------------------------+---------------+
29 //                                                           ^
30 //                                                           |
31 //   +-------------------------------------------------------+
32 //   |
33 // +---------------------------+-----------------------------+
34 // | __cxa_dependent_exception | _Unwind_Exception CLNGC++\1 |
35 // +---------------------------+-----------------------------+
36 
37 namespace __cxxabiv1 {
38 
39 //  Utility routines
40 static
41 inline
42 __cxa_exception*
43 cxa_exception_from_thrown_object(void* thrown_object)
44 {
45     return static_cast<__cxa_exception*>(thrown_object) - 1;
46 }
47 
48 // Note:  This is never called when exception_header is masquerading as a
49 //        __cxa_dependent_exception.
50 static
51 inline
52 void*
53 thrown_object_from_cxa_exception(__cxa_exception* exception_header)
54 {
55     return static_cast<void*>(exception_header + 1);
56 }
57 
58 //  Get the exception object from the unwind pointer.
59 //  Relies on the structure layout, where the unwind pointer is right in
60 //  front of the user's exception object
61 static
62 inline
63 __cxa_exception*
64 cxa_exception_from_exception_unwind_exception(_Unwind_Exception* unwind_exception)
65 {
66     return cxa_exception_from_thrown_object(unwind_exception + 1 );
67 }
68 
69 // Round s up to next multiple of a.
70 static inline
71 size_t aligned_allocation_size(size_t s, size_t a) {
72     return (s + a - 1) & ~(a - 1);
73 }
74 
75 static inline
76 size_t cxa_exception_size_from_exception_thrown_size(size_t size) {
77     return aligned_allocation_size(size + sizeof (__cxa_exception),
78                                    alignof(__cxa_exception));
79 }
80 
81 void __setExceptionClass(_Unwind_Exception* unwind_exception, uint64_t newValue) {
82     ::memcpy(&unwind_exception->exception_class, &newValue, sizeof(newValue));
83 }
84 
85 
86 static void setOurExceptionClass(_Unwind_Exception* unwind_exception) {
87     __setExceptionClass(unwind_exception, kOurExceptionClass);
88 }
89 
90 static void setDependentExceptionClass(_Unwind_Exception* unwind_exception) {
91     __setExceptionClass(unwind_exception, kOurDependentExceptionClass);
92 }
93 
94 //  Is it one of ours?
95 uint64_t __getExceptionClass(const _Unwind_Exception* unwind_exception) {
96     // On x86 and some ARM unwinders, unwind_exception->exception_class is
97     // a uint64_t. On other ARM unwinders, it is a char[8].
98     // See: http://infocenter.arm.com/help/topic/com.arm.doc.ihi0038b/IHI0038B_ehabi.pdf
99     // So we just copy it into a uint64_t to be sure.
100     uint64_t exClass;
101     ::memcpy(&exClass, &unwind_exception->exception_class, sizeof(exClass));
102     return exClass;
103 }
104 
105 bool __isOurExceptionClass(const _Unwind_Exception* unwind_exception) {
106     return (__getExceptionClass(unwind_exception) & get_vendor_and_language) ==
107            (kOurExceptionClass                    & get_vendor_and_language);
108 }
109 
110 static bool isDependentException(_Unwind_Exception* unwind_exception) {
111     return (__getExceptionClass(unwind_exception) & 0xFF) == 0x01;
112 }
113 
114 //  This does not need to be atomic
115 static inline int incrementHandlerCount(__cxa_exception *exception) {
116     return ++exception->handlerCount;
117 }
118 
119 //  This does not need to be atomic
120 static inline  int decrementHandlerCount(__cxa_exception *exception) {
121     return --exception->handlerCount;
122 }
123 
124 /*
125     If reason isn't _URC_FOREIGN_EXCEPTION_CAUGHT, then the terminateHandler
126     stored in exc is called.  Otherwise the exceptionDestructor stored in
127     exc is called, and then the memory for the exception is deallocated.
128 
129     This is never called for a __cxa_dependent_exception.
130 */
131 static
132 void
133 exception_cleanup_func(_Unwind_Reason_Code reason, _Unwind_Exception* unwind_exception)
134 {
135     __cxa_exception* exception_header = cxa_exception_from_exception_unwind_exception(unwind_exception);
136     if (_URC_FOREIGN_EXCEPTION_CAUGHT != reason)
137         std::__terminate(exception_header->terminateHandler);
138     // Just in case there exists a dependent exception that is pointing to this,
139     //    check the reference count and only destroy this if that count goes to zero.
140     __cxa_decrement_exception_refcount(unwind_exception + 1);
141 }
142 
143 static _LIBCXXABI_NORETURN void failed_throw(__cxa_exception* exception_header) {
144 //  Section 2.5.3 says:
145 //      * For purposes of this ABI, several things are considered exception handlers:
146 //      ** A terminate() call due to a throw.
147 //  and
148 //      * Upon entry, Following initialization of the catch parameter,
149 //          a handler must call:
150 //      * void *__cxa_begin_catch(void *exceptionObject );
151     (void) __cxa_begin_catch(&exception_header->unwindHeader);
152     std::__terminate(exception_header->terminateHandler);
153 }
154 
155 // Return the offset of the __cxa_exception header from the start of the
156 // allocated buffer. If __cxa_exception's alignment is smaller than the maximum
157 // useful alignment for the target machine, padding has to be inserted before
158 // the header to ensure the thrown object that follows the header is
159 // sufficiently aligned. This happens if _Unwind_exception isn't double-word
160 // aligned (on Darwin, for example).
161 static size_t get_cxa_exception_offset() {
162   struct S {
163   } __attribute__((aligned));
164 
165   // Compute the maximum alignment for the target machine.
166   constexpr size_t alignment = alignof(S);
167   constexpr size_t excp_size = sizeof(__cxa_exception);
168   constexpr size_t aligned_size =
169       (excp_size + alignment - 1) / alignment * alignment;
170   constexpr size_t offset = aligned_size - excp_size;
171   static_assert((offset == 0 || alignof(_Unwind_Exception) < alignment),
172                 "offset is non-zero only if _Unwind_Exception isn't aligned");
173   return offset;
174 }
175 
176 extern "C" {
177 
178 //  Allocate a __cxa_exception object, and zero-fill it.
179 //  Reserve "thrown_size" bytes on the end for the user's exception
180 //  object. Zero-fill the object. If memory can't be allocated, call
181 //  std::terminate. Return a pointer to the memory to be used for the
182 //  user's exception object.
183 void *__cxa_allocate_exception(size_t thrown_size) throw() {
184     size_t actual_size = cxa_exception_size_from_exception_thrown_size(thrown_size);
185 
186     // Allocate extra space before the __cxa_exception header to ensure the
187     // start of the thrown object is sufficiently aligned.
188     size_t header_offset = get_cxa_exception_offset();
189     char *raw_buffer =
190         (char *)__aligned_malloc_with_fallback(header_offset + actual_size);
191     if (NULL == raw_buffer)
192         std::terminate();
193     __cxa_exception *exception_header =
194         static_cast<__cxa_exception *>((void *)(raw_buffer + header_offset));
195     ::memset(exception_header, 0, actual_size);
196     return thrown_object_from_cxa_exception(exception_header);
197 }
198 
199 
200 //  Free a __cxa_exception object allocated with __cxa_allocate_exception.
201 void __cxa_free_exception(void *thrown_object) throw() {
202     // Compute the size of the padding before the header.
203     size_t header_offset = get_cxa_exception_offset();
204     char *raw_buffer =
205         ((char *)cxa_exception_from_thrown_object(thrown_object)) - header_offset;
206     __aligned_free_with_fallback((void *)raw_buffer);
207 }
208 
209 
210 //  This function shall allocate a __cxa_dependent_exception and
211 //  return a pointer to it. (Really to the object, not past its' end).
212 //  Otherwise, it will work like __cxa_allocate_exception.
213 void * __cxa_allocate_dependent_exception () {
214     size_t actual_size = sizeof(__cxa_dependent_exception);
215     void *ptr = __aligned_malloc_with_fallback(actual_size);
216     if (NULL == ptr)
217         std::terminate();
218     ::memset(ptr, 0, actual_size);
219     return ptr;
220 }
221 
222 
223 //  This function shall free a dependent_exception.
224 //  It does not affect the reference count of the primary exception.
225 void __cxa_free_dependent_exception (void * dependent_exception) {
226     __aligned_free_with_fallback(dependent_exception);
227 }
228 
229 
230 // 2.4.3 Throwing the Exception Object
231 /*
232 After constructing the exception object with the throw argument value,
233 the generated code calls the __cxa_throw runtime library routine. This
234 routine never returns.
235 
236 The __cxa_throw routine will do the following:
237 
238 * Obtain the __cxa_exception header from the thrown exception object address,
239 which can be computed as follows:
240  __cxa_exception *header = ((__cxa_exception *) thrown_exception - 1);
241 * Save the current unexpected_handler and terminate_handler in the __cxa_exception header.
242 * Save the tinfo and dest arguments in the __cxa_exception header.
243 * Set the exception_class field in the unwind header. This is a 64-bit value
244 representing the ASCII string "XXXXC++\0", where "XXXX" is a
245 vendor-dependent string. That is, for implementations conforming to this
246 ABI, the low-order 4 bytes of this 64-bit value will be "C++\0".
247 * Increment the uncaught_exception flag.
248 * Call _Unwind_RaiseException in the system unwind library, Its argument is the
249 pointer to the thrown exception, which __cxa_throw itself received as an argument.
250 __Unwind_RaiseException begins the process of stack unwinding, described
251 in Section 2.5. In special cases, such as an inability to find a
252 handler, _Unwind_RaiseException may return. In that case, __cxa_throw
253 will call terminate, assuming that there was no handler for the
254 exception.
255 */
256 void
257 __cxa_throw(void *thrown_object, std::type_info *tinfo, void (*dest)(void *)) {
258     __cxa_eh_globals *globals = __cxa_get_globals();
259     __cxa_exception* exception_header = cxa_exception_from_thrown_object(thrown_object);
260 
261     exception_header->unexpectedHandler = std::get_unexpected();
262     exception_header->terminateHandler  = std::get_terminate();
263     exception_header->exceptionType = tinfo;
264     exception_header->exceptionDestructor = dest;
265     setOurExceptionClass(&exception_header->unwindHeader);
266     exception_header->referenceCount = 1;  // This is a newly allocated exception, no need for thread safety.
267     globals->uncaughtExceptions += 1;   // Not atomically, since globals are thread-local
268 
269     exception_header->unwindHeader.exception_cleanup = exception_cleanup_func;
270 
271 #if __has_feature(address_sanitizer)
272     // Inform the ASan runtime that now might be a good time to clean stuff up.
273     __asan_handle_no_return();
274 #endif
275 
276 #ifdef __USING_SJLJ_EXCEPTIONS__
277     _Unwind_SjLj_RaiseException(&exception_header->unwindHeader);
278 #else
279     _Unwind_RaiseException(&exception_header->unwindHeader);
280 #endif
281     //  This only happens when there is no handler, or some unexpected unwinding
282     //     error happens.
283     failed_throw(exception_header);
284 }
285 
286 
287 // 2.5.3 Exception Handlers
288 /*
289 The adjusted pointer is computed by the personality routine during phase 1
290   and saved in the exception header (either __cxa_exception or
291   __cxa_dependent_exception).
292 
293   Requires:  exception is native
294 */
295 void *__cxa_get_exception_ptr(void *unwind_exception) throw() {
296 #if defined(_LIBCXXABI_ARM_EHABI)
297     return reinterpret_cast<void*>(
298         static_cast<_Unwind_Control_Block*>(unwind_exception)->barrier_cache.bitpattern[0]);
299 #else
300     return cxa_exception_from_exception_unwind_exception(
301         static_cast<_Unwind_Exception*>(unwind_exception))->adjustedPtr;
302 #endif
303 }
304 
305 #if defined(_LIBCXXABI_ARM_EHABI)
306 /*
307 The routine to be called before the cleanup.  This will save __cxa_exception in
308 __cxa_eh_globals, so that __cxa_end_cleanup() can recover later.
309 */
310 bool __cxa_begin_cleanup(void *unwind_arg) throw() {
311     _Unwind_Exception* unwind_exception = static_cast<_Unwind_Exception*>(unwind_arg);
312     __cxa_eh_globals* globals = __cxa_get_globals();
313     __cxa_exception* exception_header =
314         cxa_exception_from_exception_unwind_exception(unwind_exception);
315 
316     if (__isOurExceptionClass(unwind_exception))
317     {
318         if (0 == exception_header->propagationCount)
319         {
320             exception_header->nextPropagatingException = globals->propagatingExceptions;
321             globals->propagatingExceptions = exception_header;
322         }
323         ++exception_header->propagationCount;
324     }
325     else
326     {
327         // If the propagatingExceptions stack is not empty, since we can't
328         // chain the foreign exception, terminate it.
329         if (NULL != globals->propagatingExceptions)
330             std::terminate();
331         globals->propagatingExceptions = exception_header;
332     }
333     return true;
334 }
335 
336 /*
337 The routine to be called after the cleanup has been performed.  It will get the
338 propagating __cxa_exception from __cxa_eh_globals, and continue the stack
339 unwinding with _Unwind_Resume.
340 
341 According to ARM EHABI 8.4.1, __cxa_end_cleanup() should not clobber any
342 register, thus we have to write this function in assembly so that we can save
343 {r1, r2, r3}.  We don't have to save r0 because it is the return value and the
344 first argument to _Unwind_Resume().  In addition, we are saving lr in order to
345 align the stack to 16 bytes and lr will be used to identify the caller and its
346 frame information. _Unwind_Resume never return and we need to keep the original
347 lr so just branch to it.
348 */
349 __attribute__((used)) static _Unwind_Exception *
350 __cxa_end_cleanup_impl()
351 {
352     __cxa_eh_globals* globals = __cxa_get_globals();
353     __cxa_exception* exception_header = globals->propagatingExceptions;
354     if (NULL == exception_header)
355     {
356         // It seems that __cxa_begin_cleanup() is not called properly.
357         // We have no choice but terminate the program now.
358         std::terminate();
359     }
360 
361     if (__isOurExceptionClass(&exception_header->unwindHeader))
362     {
363         --exception_header->propagationCount;
364         if (0 == exception_header->propagationCount)
365         {
366             globals->propagatingExceptions = exception_header->nextPropagatingException;
367             exception_header->nextPropagatingException = NULL;
368         }
369     }
370     else
371     {
372         globals->propagatingExceptions = NULL;
373     }
374     return &exception_header->unwindHeader;
375 }
376 
377 asm("	.pushsection	.text.__cxa_end_cleanup,\"ax\",%progbits\n"
378     "	.globl	__cxa_end_cleanup\n"
379     "	.type	__cxa_end_cleanup,%function\n"
380     "__cxa_end_cleanup:\n"
381     "	push	{r1, r2, r3, lr}\n"
382     "	bl	__cxa_end_cleanup_impl\n"
383     "	pop	{r1, r2, r3, r4}\n"
384     "	mov	lr, r4\n"
385 #if defined(LIBCXXABI_BAREMETAL)
386     "	ldr	r4,	=_Unwind_Resume\n"
387     "	bx	r4\n"
388 #else
389     "   b _Unwind_Resume\n"
390 #endif
391     "	.popsection");
392 #endif // defined(_LIBCXXABI_ARM_EHABI)
393 
394 /*
395 This routine can catch foreign or native exceptions.  If native, the exception
396 can be a primary or dependent variety.  This routine may remain blissfully
397 ignorant of whether the native exception is primary or dependent.
398 
399 If the exception is native:
400 * Increment's the exception's handler count.
401 * Push the exception on the stack of currently-caught exceptions if it is not
402   already there (from a rethrow).
403 * Decrements the uncaught_exception count.
404 * Returns the adjusted pointer to the exception object, which is stored in
405   the __cxa_exception by the personality routine.
406 
407 If the exception is foreign, this means it did not originate from one of throw
408 routines.  The foreign exception does not necessarily have a __cxa_exception
409 header.  However we can catch it here with a catch (...), or with a call
410 to terminate or unexpected during unwinding.
411 * Do not try to increment the exception's handler count, we don't know where
412   it is.
413 * Push the exception on the stack of currently-caught exceptions only if the
414   stack is empty.  The foreign exception has no way to link to the current
415   top of stack.  If the stack is not empty, call terminate.  Even with an
416   empty stack, this is hacked in by pushing a pointer to an imaginary
417   __cxa_exception block in front of the foreign exception.  It would be better
418   if the __cxa_eh_globals structure had a stack of _Unwind_Exception, but it
419   doesn't.  It has a stack of __cxa_exception (which has a next* in it).
420 * Do not decrement the uncaught_exception count because we didn't increment it
421   in __cxa_throw (or one of our rethrow functions).
422 * If we haven't terminated, assume the exception object is just past the
423   _Unwind_Exception and return a pointer to that.
424 */
425 void*
426 __cxa_begin_catch(void* unwind_arg) throw()
427 {
428     _Unwind_Exception* unwind_exception = static_cast<_Unwind_Exception*>(unwind_arg);
429     bool native_exception = __isOurExceptionClass(unwind_exception);
430     __cxa_eh_globals* globals = __cxa_get_globals();
431     // exception_header is a hackish offset from a foreign exception, but it
432     //   works as long as we're careful not to try to access any __cxa_exception
433     //   parts.
434     __cxa_exception* exception_header =
435             cxa_exception_from_exception_unwind_exception
436             (
437                 static_cast<_Unwind_Exception*>(unwind_exception)
438             );
439     if (native_exception)
440     {
441         // Increment the handler count, removing the flag about being rethrown
442         exception_header->handlerCount = exception_header->handlerCount < 0 ?
443             -exception_header->handlerCount + 1 : exception_header->handlerCount + 1;
444         //  place the exception on the top of the stack if it's not already
445         //    there by a previous rethrow
446         if (exception_header != globals->caughtExceptions)
447         {
448             exception_header->nextException = globals->caughtExceptions;
449             globals->caughtExceptions = exception_header;
450         }
451         globals->uncaughtExceptions -= 1;   // Not atomically, since globals are thread-local
452 #if defined(_LIBCXXABI_ARM_EHABI)
453         return reinterpret_cast<void*>(exception_header->unwindHeader.barrier_cache.bitpattern[0]);
454 #else
455         return exception_header->adjustedPtr;
456 #endif
457     }
458     // Else this is a foreign exception
459     // If the caughtExceptions stack is not empty, terminate
460     if (globals->caughtExceptions != 0)
461         std::terminate();
462     // Push the foreign exception on to the stack
463     globals->caughtExceptions = exception_header;
464     return unwind_exception + 1;
465 }
466 
467 
468 /*
469 Upon exit for any reason, a handler must call:
470     void __cxa_end_catch ();
471 
472 This routine can be called for either a native or foreign exception.
473 For a native exception:
474 * Locates the most recently caught exception and decrements its handler count.
475 * Removes the exception from the caught exception stack, if the handler count goes to zero.
476 * If the handler count goes down to zero, and the exception was not re-thrown
477   by throw, it locates the primary exception (which may be the same as the one
478   it's handling) and decrements its reference count. If that reference count
479   goes to zero, the function destroys the exception. In any case, if the current
480   exception is a dependent exception, it destroys that.
481 
482 For a foreign exception:
483 * If it has been rethrown, there is nothing to do.
484 * Otherwise delete the exception and pop the catch stack to empty.
485 */
486 void __cxa_end_catch() {
487   static_assert(sizeof(__cxa_exception) == sizeof(__cxa_dependent_exception),
488                 "sizeof(__cxa_exception) must be equal to "
489                 "sizeof(__cxa_dependent_exception)");
490   static_assert(__builtin_offsetof(__cxa_exception, referenceCount) ==
491                     __builtin_offsetof(__cxa_dependent_exception,
492                                        primaryException),
493                 "the layout of __cxa_exception must match the layout of "
494                 "__cxa_dependent_exception");
495   static_assert(__builtin_offsetof(__cxa_exception, handlerCount) ==
496                     __builtin_offsetof(__cxa_dependent_exception, handlerCount),
497                 "the layout of __cxa_exception must match the layout of "
498                 "__cxa_dependent_exception");
499     __cxa_eh_globals* globals = __cxa_get_globals_fast(); // __cxa_get_globals called in __cxa_begin_catch
500     __cxa_exception* exception_header = globals->caughtExceptions;
501     // If we've rethrown a foreign exception, then globals->caughtExceptions
502     //    will have been made an empty stack by __cxa_rethrow() and there is
503     //    nothing more to be done.  Do nothing!
504     if (NULL != exception_header)
505     {
506         bool native_exception = __isOurExceptionClass(&exception_header->unwindHeader);
507         if (native_exception)
508         {
509             // This is a native exception
510             if (exception_header->handlerCount < 0)
511             {
512                 //  The exception has been rethrown by __cxa_rethrow, so don't delete it
513                 if (0 == incrementHandlerCount(exception_header))
514                 {
515                     //  Remove from the chain of uncaught exceptions
516                     globals->caughtExceptions = exception_header->nextException;
517                     // but don't destroy
518                 }
519                 // Keep handlerCount negative in case there are nested catch's
520                 //   that need to be told that this exception is rethrown.  Don't
521                 //   erase this rethrow flag until the exception is recaught.
522             }
523             else
524             {
525                 // The native exception has not been rethrown
526                 if (0 == decrementHandlerCount(exception_header))
527                 {
528                     //  Remove from the chain of uncaught exceptions
529                     globals->caughtExceptions = exception_header->nextException;
530                     // Destroy this exception, being careful to distinguish
531                     //    between dependent and primary exceptions
532                     if (isDependentException(&exception_header->unwindHeader))
533                     {
534                         // Reset exception_header to primaryException and deallocate the dependent exception
535                         __cxa_dependent_exception* dep_exception_header =
536                             reinterpret_cast<__cxa_dependent_exception*>(exception_header);
537                         exception_header =
538                             cxa_exception_from_thrown_object(dep_exception_header->primaryException);
539                         __cxa_free_dependent_exception(dep_exception_header);
540                     }
541                     // Destroy the primary exception only if its referenceCount goes to 0
542                     //    (this decrement must be atomic)
543                     __cxa_decrement_exception_refcount(thrown_object_from_cxa_exception(exception_header));
544                 }
545             }
546         }
547         else
548         {
549             // The foreign exception has not been rethrown.  Pop the stack
550             //    and delete it.  If there are nested catch's and they try
551             //    to touch a foreign exception in any way, that is undefined
552             //     behavior.  They likely can't since the only way to catch
553             //     a foreign exception is with catch (...)!
554             _Unwind_DeleteException(&globals->caughtExceptions->unwindHeader);
555             globals->caughtExceptions = 0;
556         }
557     }
558 }
559 
560 // Note:  exception_header may be masquerading as a __cxa_dependent_exception
561 //        and that's ok.  exceptionType is there too.
562 //        However watch out for foreign exceptions.  Return null for them.
563 std::type_info *__cxa_current_exception_type() {
564 //  get the current exception
565     __cxa_eh_globals *globals = __cxa_get_globals_fast();
566     if (NULL == globals)
567         return NULL;     //  If there have never been any exceptions, there are none now.
568     __cxa_exception *exception_header = globals->caughtExceptions;
569     if (NULL == exception_header)
570         return NULL;        //  No current exception
571     if (!__isOurExceptionClass(&exception_header->unwindHeader))
572         return NULL;
573     return exception_header->exceptionType;
574 }
575 
576 // 2.5.4 Rethrowing Exceptions
577 /*  This routine can rethrow native or foreign exceptions.
578 If the exception is native:
579 * marks the exception object on top of the caughtExceptions stack
580   (in an implementation-defined way) as being rethrown.
581 * If the caughtExceptions stack is empty, it calls terminate()
582   (see [C++FDIS] [except.throw], 15.1.8).
583 * It then calls _Unwind_RaiseException which should not return
584    (terminate if it does).
585   Note:  exception_header may be masquerading as a __cxa_dependent_exception
586          and that's ok.
587 */
588 void __cxa_rethrow() {
589     __cxa_eh_globals* globals = __cxa_get_globals();
590     __cxa_exception* exception_header = globals->caughtExceptions;
591     if (NULL == exception_header)
592         std::terminate();      // throw; called outside of a exception handler
593     bool native_exception = __isOurExceptionClass(&exception_header->unwindHeader);
594     if (native_exception)
595     {
596         //  Mark the exception as being rethrown (reverse the effects of __cxa_begin_catch)
597         exception_header->handlerCount = -exception_header->handlerCount;
598         globals->uncaughtExceptions += 1;
599         //  __cxa_end_catch will remove this exception from the caughtExceptions stack if necessary
600     }
601     else  // this is a foreign exception
602     {
603         // The only way to communicate to __cxa_end_catch that we've rethrown
604         //   a foreign exception, so don't delete us, is to pop the stack here
605         //   which must be empty afterwards.  Then __cxa_end_catch will do
606         //   nothing
607         globals->caughtExceptions = 0;
608     }
609 #ifdef __USING_SJLJ_EXCEPTIONS__
610     _Unwind_SjLj_RaiseException(&exception_header->unwindHeader);
611 #else
612     _Unwind_RaiseException(&exception_header->unwindHeader);
613 #endif
614 
615     //  If we get here, some kind of unwinding error has occurred.
616     //  There is some weird code generation bug happening with
617     //     Apple clang version 4.0 (tags/Apple/clang-418.0.2) (based on LLVM 3.1svn)
618     //     If we call failed_throw here.  Turns up with -O2 or higher, and -Os.
619     __cxa_begin_catch(&exception_header->unwindHeader);
620     if (native_exception)
621         std::__terminate(exception_header->terminateHandler);
622     // Foreign exception: can't get exception_header->terminateHandler
623     std::terminate();
624 }
625 
626 /*
627     If thrown_object is not null, atomically increment the referenceCount field
628     of the __cxa_exception header associated with the thrown object referred to
629     by thrown_object.
630 
631     Requires:  If thrown_object is not NULL, it is a native exception.
632 */
633 void
634 __cxa_increment_exception_refcount(void *thrown_object) throw() {
635     if (thrown_object != NULL )
636     {
637         __cxa_exception* exception_header = cxa_exception_from_thrown_object(thrown_object);
638         std::__libcpp_atomic_add(&exception_header->referenceCount, size_t(1));
639     }
640 }
641 
642 /*
643     If thrown_object is not null, atomically decrement the referenceCount field
644     of the __cxa_exception header associated with the thrown object referred to
645     by thrown_object.  If the referenceCount drops to zero, destroy and
646     deallocate the exception.
647 
648     Requires:  If thrown_object is not NULL, it is a native exception.
649 */
650 _LIBCXXABI_NO_CFI
651 void __cxa_decrement_exception_refcount(void *thrown_object) throw() {
652     if (thrown_object != NULL )
653     {
654         __cxa_exception* exception_header = cxa_exception_from_thrown_object(thrown_object);
655         if (std::__libcpp_atomic_add(&exception_header->referenceCount, size_t(-1)) == 0)
656         {
657             if (NULL != exception_header->exceptionDestructor)
658                 exception_header->exceptionDestructor(thrown_object);
659             __cxa_free_exception(thrown_object);
660         }
661     }
662 }
663 
664 /*
665     Returns a pointer to the thrown object (if any) at the top of the
666     caughtExceptions stack.  Atomically increment the exception's referenceCount.
667     If there is no such thrown object or if the thrown object is foreign,
668     returns null.
669 
670     We can use __cxa_get_globals_fast here to get the globals because if there have
671     been no exceptions thrown, ever, on this thread, we can return NULL without
672     the need to allocate the exception-handling globals.
673 */
674 void *__cxa_current_primary_exception() throw() {
675 //  get the current exception
676     __cxa_eh_globals* globals = __cxa_get_globals_fast();
677     if (NULL == globals)
678         return NULL;        //  If there are no globals, there is no exception
679     __cxa_exception* exception_header = globals->caughtExceptions;
680     if (NULL == exception_header)
681         return NULL;        //  No current exception
682     if (!__isOurExceptionClass(&exception_header->unwindHeader))
683         return NULL;        // Can't capture a foreign exception (no way to refcount it)
684     if (isDependentException(&exception_header->unwindHeader)) {
685         __cxa_dependent_exception* dep_exception_header =
686             reinterpret_cast<__cxa_dependent_exception*>(exception_header);
687         exception_header = cxa_exception_from_thrown_object(dep_exception_header->primaryException);
688     }
689     void* thrown_object = thrown_object_from_cxa_exception(exception_header);
690     __cxa_increment_exception_refcount(thrown_object);
691     return thrown_object;
692 }
693 
694 /*
695     If reason isn't _URC_FOREIGN_EXCEPTION_CAUGHT, then the terminateHandler
696     stored in exc is called.  Otherwise the referenceCount stored in the
697     primary exception is decremented, destroying the primary if necessary.
698     Finally the dependent exception is destroyed.
699 */
700 static
701 void
702 dependent_exception_cleanup(_Unwind_Reason_Code reason, _Unwind_Exception* unwind_exception)
703 {
704     __cxa_dependent_exception* dep_exception_header =
705                       reinterpret_cast<__cxa_dependent_exception*>(unwind_exception + 1) - 1;
706     if (_URC_FOREIGN_EXCEPTION_CAUGHT != reason)
707         std::__terminate(dep_exception_header->terminateHandler);
708     __cxa_decrement_exception_refcount(dep_exception_header->primaryException);
709     __cxa_free_dependent_exception(dep_exception_header);
710 }
711 
712 /*
713     If thrown_object is not null, allocate, initialize and throw a dependent
714     exception.
715 */
716 void
717 __cxa_rethrow_primary_exception(void* thrown_object)
718 {
719     if ( thrown_object != NULL )
720     {
721         // thrown_object guaranteed to be native because
722         //   __cxa_current_primary_exception returns NULL for foreign exceptions
723         __cxa_exception* exception_header = cxa_exception_from_thrown_object(thrown_object);
724         __cxa_dependent_exception* dep_exception_header =
725             static_cast<__cxa_dependent_exception*>(__cxa_allocate_dependent_exception());
726         dep_exception_header->primaryException = thrown_object;
727         __cxa_increment_exception_refcount(thrown_object);
728         dep_exception_header->exceptionType = exception_header->exceptionType;
729         dep_exception_header->unexpectedHandler = std::get_unexpected();
730         dep_exception_header->terminateHandler = std::get_terminate();
731         setDependentExceptionClass(&dep_exception_header->unwindHeader);
732         __cxa_get_globals()->uncaughtExceptions += 1;
733         dep_exception_header->unwindHeader.exception_cleanup = dependent_exception_cleanup;
734 #ifdef __USING_SJLJ_EXCEPTIONS__
735         _Unwind_SjLj_RaiseException(&dep_exception_header->unwindHeader);
736 #else
737         _Unwind_RaiseException(&dep_exception_header->unwindHeader);
738 #endif
739         // Some sort of unwinding error.  Note that terminate is a handler.
740         __cxa_begin_catch(&dep_exception_header->unwindHeader);
741     }
742     // If we return client will call terminate()
743 }
744 
745 bool
746 __cxa_uncaught_exception() throw() { return __cxa_uncaught_exceptions() != 0; }
747 
748 unsigned int
749 __cxa_uncaught_exceptions() throw()
750 {
751     // This does not report foreign exceptions in flight
752     __cxa_eh_globals* globals = __cxa_get_globals_fast();
753     if (globals == 0)
754         return 0;
755     return globals->uncaughtExceptions;
756 }
757 
758 }  // extern "C"
759 
760 }  // abi
761