cosmopolitan/third_party/libcxxabi/README.cosmo

DESCRIPTION

  libcxxabi - C++ Standard Library Support

ORIGIN

  Obtained from the LLVM monorepo, release 17.0.6.

  https://github.com/llvm/llvm-project/tree/llvmorg-17.0.6/libunwind
  commit 6009708b4367171ccdbf4b5905cb6a803753fe18
  Author: Tobias Hieta <tobias@hieta.se>
  Date:   Tue, 28 Nov 2023 09:52:28 +0100

LOCAL CHANGES

  - Add <__memory/aligned_alloc.h> (contains a few inline functions) from
  upstream libcxx.
  - Add <test/support/make_test_thread.hh> and <test/support/test_macros.hh>
  from upstream libcxx.
  - Enable __cxa_thread_atexit for Cosmopolitan.
Add LLVM libcxxabi (#1063) * third_party: Add libcxxabi Added libcxxabi from LLVM 17.0.6 The library implements the Itanium C++ exception handling ABI. * third_party/libcxxabi: Enable __cxa_thread_atexit Enable `__cxa_thread_atexit` from libcxxabi. `__cxa_thread_atexit_impl` is still implemented by the cosmo libc. The original `__cxa_thread_atexit` has been removed. * third_party/libcxx: Build with exceptions Build libcxx with exceptions enabled. - Removed `_LIBCPP_NO_EXCEPTIONS` from `__config`. - Switched the exception implementation to `libcxxabi`. These two files are taken from the same `libcxx` version as mentioned in `README.cosmo`. - Removed `new_handler_fallback` in favor of `libcxxabi` implementation. - Enable `-fexceptions` and `-frtti` for `libcxx`. - Removed `THIRD_PARTY_LIBCXX` dependency from `libcxxabi` and `libunwind`. These libraries do not use any runtime `libcxx` functions, just headers. * libc: Remove remaining redundant cxa functions - `__cxa_pure_virtual` in `libcxxabi` is also a stub similar to the existing one. - `__cxa_guard_*` from `libcxxabi` is used instead of the ones from Android. Now there should be no more duplicate implementations. `__cxa_thread_atexit_impl`, `__cxa_atexit`, and related supporting functions, are still left to other libraries as in `libcxxabi`. `libcxxabi` is also now added to `cosmopolitan.a` to make up for the removed functions. Affected in-tree libraries (`third_party/double-conversion`) have been updated. 2024-01-08 16:45:10 +00:00			`DESCRIPTION`

			`libcxxabi - C++ Standard Library Support`

			`ORIGIN`

			`Obtained from the LLVM monorepo, release 17.0.6.`

			`https://github.com/llvm/llvm-project/tree/llvmorg-17.0.6/libunwind`
			`commit 6009708b4367171ccdbf4b5905cb6a803753fe18`
			`Author: Tobias Hieta <tobias@hieta.se>`
			`Date: Tue, 28 Nov 2023 09:52:28 +0100`

			`LOCAL CHANGES`

			`- Add <__memory/aligned_alloc.h> (contains a few inline functions) from`
			`upstream libcxx.`
third_party/libcxxabi: Add test suite (#1076) Added the `libcxxabi` test suite as found in LLVM 17.0.6. Some tests that do not apply to the current configuration of comsopolitan are not added. These include: - `backtrace_test`, `forced_unwind`: Use unwind function unsupported in SjLj mode. - `noexception`: Designed to test `libcxxabi` in no exceptions mode. Some tests are added but not enabled due to bugs specific to GCC or cosmopolitan. These are clearly indicated in the `BUILD.mk` file. 2024-01-08 18:50:06 +00:00			`- Add <test/support/make_test_thread.hh> and <test/support/test_macros.hh>`
			`from upstream libcxx.`
Add LLVM libcxxabi (#1063) * third_party: Add libcxxabi Added libcxxabi from LLVM 17.0.6 The library implements the Itanium C++ exception handling ABI. * third_party/libcxxabi: Enable __cxa_thread_atexit Enable `__cxa_thread_atexit` from libcxxabi. `__cxa_thread_atexit_impl` is still implemented by the cosmo libc. The original `__cxa_thread_atexit` has been removed. * third_party/libcxx: Build with exceptions Build libcxx with exceptions enabled. - Removed `_LIBCPP_NO_EXCEPTIONS` from `__config`. - Switched the exception implementation to `libcxxabi`. These two files are taken from the same `libcxx` version as mentioned in `README.cosmo`. - Removed `new_handler_fallback` in favor of `libcxxabi` implementation. - Enable `-fexceptions` and `-frtti` for `libcxx`. - Removed `THIRD_PARTY_LIBCXX` dependency from `libcxxabi` and `libunwind`. These libraries do not use any runtime `libcxx` functions, just headers. * libc: Remove remaining redundant cxa functions - `__cxa_pure_virtual` in `libcxxabi` is also a stub similar to the existing one. - `__cxa_guard_*` from `libcxxabi` is used instead of the ones from Android. Now there should be no more duplicate implementations. `__cxa_thread_atexit_impl`, `__cxa_atexit`, and related supporting functions, are still left to other libraries as in `libcxxabi`. `libcxxabi` is also now added to `cosmopolitan.a` to make up for the removed functions. Affected in-tree libraries (`third_party/double-conversion`) have been updated. 2024-01-08 16:45:10 +00:00			`- Enable __cxa_thread_atexit for Cosmopolitan.`