libstdc++
|
00001 // ABI Support -*- C++ -*- 00002 00003 // Copyright (C) 2000-2019 Free Software Foundation, Inc. 00004 // 00005 // This file is part of GCC. 00006 // 00007 // GCC is free software; you can redistribute it and/or modify 00008 // it under the terms of the GNU General Public License as published by 00009 // the Free Software Foundation; either version 3, or (at your option) 00010 // any later version. 00011 // 00012 // GCC is distributed in the hope that it will be useful, 00013 // but WITHOUT ANY WARRANTY; without even the implied warranty of 00014 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00015 // GNU General Public License for more details. 00016 // 00017 // Under Section 7 of GPL version 3, you are granted additional 00018 // permissions described in the GCC Runtime Library Exception, version 00019 // 3.1, as published by the Free Software Foundation. 00020 00021 // You should have received a copy of the GNU General Public License and 00022 // a copy of the GCC Runtime Library Exception along with this program; 00023 // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see 00024 // <http://www.gnu.org/licenses/>. 00025 00026 // Written by Nathan Sidwell, Codesourcery LLC, <nathan@codesourcery.com> 00027 00028 /* This file declares the new abi entry points into the runtime. It is not 00029 normally necessary for user programs to include this header, or use the 00030 entry points directly. However, this header is available should that be 00031 needed. 00032 00033 Some of the entry points are intended for both C and C++, thus this header 00034 is includable from both C and C++. Though the C++ specific parts are not 00035 available in C, naturally enough. */ 00036 00037 /** @file cxxabi.h 00038 * The header provides an interface to the C++ ABI. 00039 */ 00040 00041 #ifndef _CXXABI_H 00042 #define _CXXABI_H 1 00043 00044 #pragma GCC system_header 00045 00046 #pragma GCC visibility push(default) 00047 00048 #include <stddef.h> 00049 #include <bits/c++config.h> 00050 #include <bits/cxxabi_tweaks.h> 00051 #include <bits/cxxabi_forced.h> 00052 #include <bits/cxxabi_init_exception.h> 00053 00054 #ifdef __cplusplus 00055 namespace __cxxabiv1 00056 { 00057 extern "C" 00058 { 00059 #endif 00060 00061 typedef __cxa_cdtor_return_type (*__cxa_cdtor_type)(void *); 00062 00063 // Allocate array. 00064 void* 00065 __cxa_vec_new(size_t __element_count, size_t __element_size, 00066 size_t __padding_size, __cxa_cdtor_type __constructor, 00067 __cxa_cdtor_type __destructor); 00068 00069 void* 00070 __cxa_vec_new2(size_t __element_count, size_t __element_size, 00071 size_t __padding_size, __cxa_cdtor_type __constructor, 00072 __cxa_cdtor_type __destructor, void *(*__alloc) (size_t), 00073 void (*__dealloc) (void*)); 00074 00075 void* 00076 __cxa_vec_new3(size_t __element_count, size_t __element_size, 00077 size_t __padding_size, __cxa_cdtor_type __constructor, 00078 __cxa_cdtor_type __destructor, void *(*__alloc) (size_t), 00079 void (*__dealloc) (void*, size_t)); 00080 00081 // Construct array. 00082 __cxa_vec_ctor_return_type 00083 __cxa_vec_ctor(void* __array_address, size_t __element_count, 00084 size_t __element_size, __cxa_cdtor_type __constructor, 00085 __cxa_cdtor_type __destructor); 00086 00087 __cxa_vec_ctor_return_type 00088 __cxa_vec_cctor(void* __dest_array, void* __src_array, 00089 size_t __element_count, size_t __element_size, 00090 __cxa_cdtor_return_type (*__constructor) (void*, void*), 00091 __cxa_cdtor_type __destructor); 00092 00093 // Destruct array. 00094 void 00095 __cxa_vec_dtor(void* __array_address, size_t __element_count, 00096 size_t __element_size, __cxa_cdtor_type __destructor); 00097 00098 void 00099 __cxa_vec_cleanup(void* __array_address, size_t __element_count, size_t __s, 00100 __cxa_cdtor_type __destructor) _GLIBCXX_NOTHROW; 00101 00102 // Destruct and release array. 00103 void 00104 __cxa_vec_delete(void* __array_address, size_t __element_size, 00105 size_t __padding_size, __cxa_cdtor_type __destructor); 00106 00107 void 00108 __cxa_vec_delete2(void* __array_address, size_t __element_size, 00109 size_t __padding_size, __cxa_cdtor_type __destructor, 00110 void (*__dealloc) (void*)); 00111 00112 void 00113 __cxa_vec_delete3(void* __array_address, size_t __element_size, 00114 size_t __padding_size, __cxa_cdtor_type __destructor, 00115 void (*__dealloc) (void*, size_t)); 00116 00117 int 00118 __cxa_guard_acquire(__guard*); 00119 00120 void 00121 __cxa_guard_release(__guard*) _GLIBCXX_NOTHROW; 00122 00123 void 00124 __cxa_guard_abort(__guard*) _GLIBCXX_NOTHROW; 00125 00126 // DSO destruction. 00127 int 00128 __cxa_atexit(void (*)(void*), void*, void*) _GLIBCXX_NOTHROW; 00129 00130 int 00131 __cxa_finalize(void*); 00132 00133 // TLS destruction. 00134 int 00135 __cxa_thread_atexit(void (*)(void*), void*, void *) _GLIBCXX_NOTHROW; 00136 00137 // Pure virtual functions. 00138 void 00139 __cxa_pure_virtual(void) __attribute__ ((__noreturn__)); 00140 00141 void 00142 __cxa_deleted_virtual(void) __attribute__ ((__noreturn__)); 00143 00144 // Exception handling auxiliary. 00145 void 00146 __cxa_bad_cast() __attribute__((__noreturn__)); 00147 00148 void 00149 __cxa_bad_typeid() __attribute__((__noreturn__)); 00150 00151 void 00152 __cxa_throw_bad_array_new_length() __attribute__((__noreturn__)); 00153 00154 /** 00155 * @brief Demangling routine. 00156 * ABI-mandated entry point in the C++ runtime library for demangling. 00157 * 00158 * @param __mangled_name A NUL-terminated character string 00159 * containing the name to be demangled. 00160 * 00161 * @param __output_buffer A region of memory, allocated with 00162 * malloc, of @a *__length bytes, into which the demangled name is 00163 * stored. If @a __output_buffer is not long enough, it is 00164 * expanded using realloc. @a __output_buffer may instead be NULL; 00165 * in that case, the demangled name is placed in a region of memory 00166 * allocated with malloc. 00167 * 00168 * @param __length If @a __length is non-null, the length of the 00169 * buffer containing the demangled name is placed in @a *__length. 00170 * 00171 * @param __status If @a __status is non-null, @a *__status is set to 00172 * one of the following values: 00173 * 0: The demangling operation succeeded. 00174 * -1: A memory allocation failure occurred. 00175 * -2: @a mangled_name is not a valid name under the C++ ABI mangling rules. 00176 * -3: One of the arguments is invalid. 00177 * 00178 * @return A pointer to the start of the NUL-terminated demangled 00179 * name, or NULL if the demangling fails. The caller is 00180 * responsible for deallocating this memory using @c free. 00181 * 00182 * The demangling is performed using the C++ ABI mangling rules, 00183 * with GNU extensions. For example, this function is used in 00184 * __gnu_cxx::__verbose_terminate_handler. 00185 * 00186 * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/ext_demangling.html 00187 * for other examples of use. 00188 * 00189 * @note The same demangling functionality is available via 00190 * libiberty (@c <libiberty/demangle.h> and @c libiberty.a) in GCC 00191 * 3.1 and later, but that requires explicit installation (@c 00192 * --enable-install-libiberty) and uses a different API, although 00193 * the ABI is unchanged. 00194 */ 00195 char* 00196 __cxa_demangle(const char* __mangled_name, char* __output_buffer, 00197 size_t* __length, int* __status); 00198 00199 #ifdef __cplusplus 00200 } 00201 } // namespace __cxxabiv1 00202 #endif 00203 00204 #ifdef __cplusplus 00205 00206 #include <typeinfo> 00207 00208 namespace __cxxabiv1 00209 { 00210 // Type information for int, float etc. 00211 class __fundamental_type_info : public std::type_info 00212 { 00213 public: 00214 explicit 00215 __fundamental_type_info(const char* __n) : std::type_info(__n) { } 00216 00217 virtual 00218 ~__fundamental_type_info(); 00219 }; 00220 00221 // Type information for array objects. 00222 class __array_type_info : public std::type_info 00223 { 00224 public: 00225 explicit 00226 __array_type_info(const char* __n) : std::type_info(__n) { } 00227 00228 virtual 00229 ~__array_type_info(); 00230 }; 00231 00232 // Type information for functions (both member and non-member). 00233 class __function_type_info : public std::type_info 00234 { 00235 public: 00236 explicit 00237 __function_type_info(const char* __n) : std::type_info(__n) { } 00238 00239 virtual 00240 ~__function_type_info(); 00241 00242 protected: 00243 // Implementation defined member function. 00244 virtual bool 00245 __is_function_p() const; 00246 }; 00247 00248 // Type information for enumerations. 00249 class __enum_type_info : public std::type_info 00250 { 00251 public: 00252 explicit 00253 __enum_type_info(const char* __n) : std::type_info(__n) { } 00254 00255 virtual 00256 ~__enum_type_info(); 00257 }; 00258 00259 // Common type information for simple pointers and pointers to member. 00260 class __pbase_type_info : public std::type_info 00261 { 00262 public: 00263 unsigned int __flags; // Qualification of the target object. 00264 const std::type_info* __pointee; // Type of pointed to object. 00265 00266 explicit 00267 __pbase_type_info(const char* __n, int __quals, 00268 const std::type_info* __type) 00269 : std::type_info(__n), __flags(__quals), __pointee(__type) 00270 { } 00271 00272 virtual 00273 ~__pbase_type_info(); 00274 00275 // Implementation defined type. 00276 enum __masks 00277 { 00278 __const_mask = 0x1, 00279 __volatile_mask = 0x2, 00280 __restrict_mask = 0x4, 00281 __incomplete_mask = 0x8, 00282 __incomplete_class_mask = 0x10, 00283 __transaction_safe_mask = 0x20, 00284 __noexcept_mask = 0x40 00285 }; 00286 00287 protected: 00288 __pbase_type_info(const __pbase_type_info&); 00289 00290 __pbase_type_info& 00291 operator=(const __pbase_type_info&); 00292 00293 // Implementation defined member functions. 00294 virtual bool 00295 __do_catch(const std::type_info* __thr_type, void** __thr_obj, 00296 unsigned int __outer) const; 00297 00298 inline virtual bool 00299 __pointer_catch(const __pbase_type_info* __thr_type, void** __thr_obj, 00300 unsigned __outer) const; 00301 }; 00302 00303 inline bool __pbase_type_info:: 00304 __pointer_catch (const __pbase_type_info *thrown_type, 00305 void **thr_obj, 00306 unsigned outer) const 00307 { 00308 return __pointee->__do_catch (thrown_type->__pointee, thr_obj, outer + 2); 00309 } 00310 00311 // Type information for simple pointers. 00312 class __pointer_type_info : public __pbase_type_info 00313 { 00314 public: 00315 explicit 00316 __pointer_type_info(const char* __n, int __quals, 00317 const std::type_info* __type) 00318 : __pbase_type_info (__n, __quals, __type) { } 00319 00320 00321 virtual 00322 ~__pointer_type_info(); 00323 00324 protected: 00325 // Implementation defined member functions. 00326 virtual bool 00327 __is_pointer_p() const; 00328 00329 virtual bool 00330 __pointer_catch(const __pbase_type_info* __thr_type, void** __thr_obj, 00331 unsigned __outer) const; 00332 }; 00333 00334 class __class_type_info; 00335 00336 // Type information for a pointer to member variable. 00337 class __pointer_to_member_type_info : public __pbase_type_info 00338 { 00339 public: 00340 __class_type_info* __context; // Class of the member. 00341 00342 explicit 00343 __pointer_to_member_type_info(const char* __n, int __quals, 00344 const std::type_info* __type, 00345 __class_type_info* __klass) 00346 : __pbase_type_info(__n, __quals, __type), __context(__klass) { } 00347 00348 virtual 00349 ~__pointer_to_member_type_info(); 00350 00351 protected: 00352 __pointer_to_member_type_info(const __pointer_to_member_type_info&); 00353 00354 __pointer_to_member_type_info& 00355 operator=(const __pointer_to_member_type_info&); 00356 00357 // Implementation defined member function. 00358 virtual bool 00359 __pointer_catch(const __pbase_type_info* __thr_type, void** __thr_obj, 00360 unsigned __outer) const; 00361 }; 00362 00363 // Helper class for __vmi_class_type. 00364 class __base_class_type_info 00365 { 00366 public: 00367 const __class_type_info* __base_type; // Base class type. 00368 #ifdef _GLIBCXX_LLP64 00369 long long __offset_flags; // Offset and info. 00370 #else 00371 long __offset_flags; // Offset and info. 00372 #endif 00373 00374 enum __offset_flags_masks 00375 { 00376 __virtual_mask = 0x1, 00377 __public_mask = 0x2, 00378 __hwm_bit = 2, 00379 __offset_shift = 8 // Bits to shift offset. 00380 }; 00381 00382 // Implementation defined member functions. 00383 bool 00384 __is_virtual_p() const 00385 { return __offset_flags & __virtual_mask; } 00386 00387 bool 00388 __is_public_p() const 00389 { return __offset_flags & __public_mask; } 00390 00391 ptrdiff_t 00392 __offset() const 00393 { 00394 // This shift, being of a signed type, is implementation 00395 // defined. GCC implements such shifts as arithmetic, which is 00396 // what we want. 00397 return static_cast<ptrdiff_t>(__offset_flags) >> __offset_shift; 00398 } 00399 }; 00400 00401 // Type information for a class. 00402 class __class_type_info : public std::type_info 00403 { 00404 public: 00405 explicit 00406 __class_type_info (const char *__n) : type_info(__n) { } 00407 00408 virtual 00409 ~__class_type_info (); 00410 00411 // Implementation defined types. 00412 // The type sub_kind tells us about how a base object is contained 00413 // within a derived object. We often do this lazily, hence the 00414 // UNKNOWN value. At other times we may use NOT_CONTAINED to mean 00415 // not publicly contained. 00416 enum __sub_kind 00417 { 00418 // We have no idea. 00419 __unknown = 0, 00420 00421 // Not contained within us (in some circumstances this might 00422 // mean not contained publicly) 00423 __not_contained, 00424 00425 // Contained ambiguously. 00426 __contained_ambig, 00427 00428 // Via a virtual path. 00429 __contained_virtual_mask = __base_class_type_info::__virtual_mask, 00430 00431 // Via a public path. 00432 __contained_public_mask = __base_class_type_info::__public_mask, 00433 00434 // Contained within us. 00435 __contained_mask = 1 << __base_class_type_info::__hwm_bit, 00436 00437 __contained_private = __contained_mask, 00438 __contained_public = __contained_mask | __contained_public_mask 00439 }; 00440 00441 struct __upcast_result; 00442 struct __dyncast_result; 00443 00444 protected: 00445 // Implementation defined member functions. 00446 virtual bool 00447 __do_upcast(const __class_type_info* __dst_type, void**__obj_ptr) const; 00448 00449 virtual bool 00450 __do_catch(const type_info* __thr_type, void** __thr_obj, 00451 unsigned __outer) const; 00452 00453 public: 00454 // Helper for upcast. See if DST is us, or one of our bases. 00455 // Return false if not found, true if found. 00456 virtual bool 00457 __do_upcast(const __class_type_info* __dst, const void* __obj, 00458 __upcast_result& __restrict __result) const; 00459 00460 // Indicate whether SRC_PTR of type SRC_TYPE is contained publicly 00461 // within OBJ_PTR. OBJ_PTR points to a base object of our type, 00462 // which is the destination type. SRC2DST indicates how SRC 00463 // objects might be contained within this type. If SRC_PTR is one 00464 // of our SRC_TYPE bases, indicate the virtuality. Returns 00465 // not_contained for non containment or private containment. 00466 inline __sub_kind 00467 __find_public_src(ptrdiff_t __src2dst, const void* __obj_ptr, 00468 const __class_type_info* __src_type, 00469 const void* __src_ptr) const; 00470 00471 // Helper for dynamic cast. ACCESS_PATH gives the access from the 00472 // most derived object to this base. DST_TYPE indicates the 00473 // desired type we want. OBJ_PTR points to a base of our type 00474 // within the complete object. SRC_TYPE indicates the static type 00475 // started from and SRC_PTR points to that base within the most 00476 // derived object. Fill in RESULT with what we find. Return true 00477 // if we have located an ambiguous match. 00478 virtual bool 00479 __do_dyncast(ptrdiff_t __src2dst, __sub_kind __access_path, 00480 const __class_type_info* __dst_type, const void* __obj_ptr, 00481 const __class_type_info* __src_type, const void* __src_ptr, 00482 __dyncast_result& __result) const; 00483 00484 // Helper for find_public_subobj. SRC2DST indicates how SRC_TYPE 00485 // bases are inherited by the type started from -- which is not 00486 // necessarily the current type. The current type will be a base 00487 // of the destination type. OBJ_PTR points to the current base. 00488 virtual __sub_kind 00489 __do_find_public_src(ptrdiff_t __src2dst, const void* __obj_ptr, 00490 const __class_type_info* __src_type, 00491 const void* __src_ptr) const; 00492 }; 00493 00494 // Type information for a class with a single non-virtual base. 00495 class __si_class_type_info : public __class_type_info 00496 { 00497 public: 00498 const __class_type_info* __base_type; 00499 00500 explicit 00501 __si_class_type_info(const char *__n, const __class_type_info *__base) 00502 : __class_type_info(__n), __base_type(__base) { } 00503 00504 virtual 00505 ~__si_class_type_info(); 00506 00507 protected: 00508 __si_class_type_info(const __si_class_type_info&); 00509 00510 __si_class_type_info& 00511 operator=(const __si_class_type_info&); 00512 00513 // Implementation defined member functions. 00514 virtual bool 00515 __do_dyncast(ptrdiff_t __src2dst, __sub_kind __access_path, 00516 const __class_type_info* __dst_type, const void* __obj_ptr, 00517 const __class_type_info* __src_type, const void* __src_ptr, 00518 __dyncast_result& __result) const; 00519 00520 virtual __sub_kind 00521 __do_find_public_src(ptrdiff_t __src2dst, const void* __obj_ptr, 00522 const __class_type_info* __src_type, 00523 const void* __sub_ptr) const; 00524 00525 virtual bool 00526 __do_upcast(const __class_type_info*__dst, const void*__obj, 00527 __upcast_result& __restrict __result) const; 00528 }; 00529 00530 // Type information for a class with multiple and/or virtual bases. 00531 class __vmi_class_type_info : public __class_type_info 00532 { 00533 public: 00534 unsigned int __flags; // Details about the class hierarchy. 00535 unsigned int __base_count; // Number of direct bases. 00536 00537 // The array of bases uses the trailing array struct hack so this 00538 // class is not constructable with a normal constructor. It is 00539 // internally generated by the compiler. 00540 __base_class_type_info __base_info[1]; // Array of bases. 00541 00542 explicit 00543 __vmi_class_type_info(const char* __n, int ___flags) 00544 : __class_type_info(__n), __flags(___flags), __base_count(0) { } 00545 00546 virtual 00547 ~__vmi_class_type_info(); 00548 00549 // Implementation defined types. 00550 enum __flags_masks 00551 { 00552 __non_diamond_repeat_mask = 0x1, // Distinct instance of repeated base. 00553 __diamond_shaped_mask = 0x2, // Diamond shaped multiple inheritance. 00554 __flags_unknown_mask = 0x10 00555 }; 00556 00557 protected: 00558 // Implementation defined member functions. 00559 virtual bool 00560 __do_dyncast(ptrdiff_t __src2dst, __sub_kind __access_path, 00561 const __class_type_info* __dst_type, const void* __obj_ptr, 00562 const __class_type_info* __src_type, const void* __src_ptr, 00563 __dyncast_result& __result) const; 00564 00565 virtual __sub_kind 00566 __do_find_public_src(ptrdiff_t __src2dst, const void* __obj_ptr, 00567 const __class_type_info* __src_type, 00568 const void* __src_ptr) const; 00569 00570 virtual bool 00571 __do_upcast(const __class_type_info* __dst, const void* __obj, 00572 __upcast_result& __restrict __result) const; 00573 }; 00574 00575 // Exception handling forward declarations. 00576 struct __cxa_exception; 00577 struct __cxa_refcounted_exception; 00578 struct __cxa_dependent_exception; 00579 struct __cxa_eh_globals; 00580 00581 extern "C" 00582 { 00583 // Dynamic cast runtime. 00584 00585 // src2dst has the following possible values 00586 // >-1: src_type is a unique public non-virtual base of dst_type 00587 // dst_ptr + src2dst == src_ptr 00588 // -1: unspecified relationship 00589 // -2: src_type is not a public base of dst_type 00590 // -3: src_type is a multiple public non-virtual base of dst_type 00591 void* 00592 __dynamic_cast(const void* __src_ptr, // Starting object. 00593 const __class_type_info* __src_type, // Static type of object. 00594 const __class_type_info* __dst_type, // Desired target type. 00595 ptrdiff_t __src2dst); // How src and dst are related. 00596 00597 00598 // Exception handling runtime. 00599 00600 // The __cxa_eh_globals for the current thread can be obtained by using 00601 // either of the following functions. The "fast" version assumes at least 00602 // one prior call of __cxa_get_globals has been made from the current 00603 // thread, so no initialization is necessary. 00604 __cxa_eh_globals* 00605 __cxa_get_globals() _GLIBCXX_NOTHROW __attribute__ ((__const__)); 00606 00607 __cxa_eh_globals* 00608 __cxa_get_globals_fast() _GLIBCXX_NOTHROW __attribute__ ((__const__)); 00609 00610 // Free the space allocated for the primary exception. 00611 void 00612 __cxa_free_exception(void*) _GLIBCXX_NOTHROW; 00613 00614 // Throw the exception. 00615 void 00616 __cxa_throw(void*, std::type_info*, void (_GLIBCXX_CDTOR_CALLABI *) (void *)) 00617 __attribute__((__noreturn__)); 00618 00619 // Used to implement exception handlers. 00620 void* 00621 __cxa_get_exception_ptr(void*) _GLIBCXX_NOTHROW __attribute__ ((__pure__)); 00622 00623 void* 00624 __cxa_begin_catch(void*) _GLIBCXX_NOTHROW; 00625 00626 void 00627 __cxa_end_catch(); 00628 00629 void 00630 __cxa_rethrow() __attribute__((__noreturn__)); 00631 00632 // Returns the type_info for the currently handled exception [15.3/8], or 00633 // null if there is none. 00634 std::type_info* 00635 __cxa_current_exception_type() _GLIBCXX_NOTHROW __attribute__ ((__pure__)); 00636 00637 // GNU Extensions. 00638 00639 // Allocate memory for a dependent exception. 00640 __cxa_dependent_exception* 00641 __cxa_allocate_dependent_exception() _GLIBCXX_NOTHROW; 00642 00643 // Free the space allocated for the dependent exception. 00644 void 00645 __cxa_free_dependent_exception(__cxa_dependent_exception*) _GLIBCXX_NOTHROW; 00646 00647 } // extern "C" 00648 00649 // A magic placeholder class that can be caught by reference 00650 // to recognize foreign exceptions. 00651 class __foreign_exception 00652 { 00653 virtual ~__foreign_exception() throw(); 00654 virtual void __pure_dummy() = 0; // prevent catch by value 00655 }; 00656 00657 } // namespace __cxxabiv1 00658 00659 /** @namespace abi 00660 * @brief The cross-vendor C++ Application Binary Interface. A 00661 * namespace alias to __cxxabiv1, but user programs should use the 00662 * alias 'abi'. 00663 * 00664 * A brief overview of an ABI is given in the libstdc++ FAQ, question 00665 * 5.8 (you may have a copy of the FAQ locally, or you can view the online 00666 * version at http://gcc.gnu.org/onlinedocs/libstdc++/faq.html#5_8 ). 00667 * 00668 * GCC subscribes to a cross-vendor ABI for C++, sometimes 00669 * called the IA64 ABI because it happens to be the native ABI for that 00670 * platform. It is summarized at http://www.codesourcery.com/cxx-abi/ 00671 * along with the current specification. 00672 * 00673 * For users of GCC greater than or equal to 3.x, entry points are 00674 * available in <cxxabi.h>, which notes, <em>'It is not normally 00675 * necessary for user programs to include this header, or use the 00676 * entry points directly. However, this header is available should 00677 * that be needed.'</em> 00678 */ 00679 namespace abi = __cxxabiv1; 00680 00681 namespace __gnu_cxx 00682 { 00683 /** 00684 * @brief Exception thrown by __cxa_guard_acquire. 00685 * @ingroup exceptions 00686 * 00687 * 6.7[stmt.dcl]/4: If control re-enters the declaration (recursively) 00688 * while the object is being initialized, the behavior is undefined. 00689 * 00690 * Since we already have a library function to handle locking, we might 00691 * as well check for this situation and throw an exception. 00692 * We use the second byte of the guard variable to remember that we're 00693 * in the middle of an initialization. 00694 */ 00695 class recursive_init_error: public std::exception 00696 { 00697 public: 00698 recursive_init_error() throw() { } 00699 virtual ~recursive_init_error() throw (); 00700 }; 00701 } 00702 #endif // __cplusplus 00703 00704 #pragma GCC visibility pop 00705 00706 #endif // __CXXABI_H