llvm-project/libcxx/lib/abi
Louis Dionne f3966eaf86 [libc++] Make the Debug mode a configuration-time only option
The debug mode has been broken pretty much ever since it was shipped
because it was possible to enable the debug mode in user code without
actually enabling it in the dylib, leading to ODR violations that
caused various kinds of failures.

This commit makes the debug mode a knob that is configured when
building the library and which can't be changed afterwards. This is
less flexible for users, however it will actually work as intended
and it will allow us, in the future, to add various kinds of checks
that do not assume the same ABI as the normal library. Furthermore,
this will make the debug mode more robust, which means that vendors
might be more tempted to support it properly, which hasn't been the
case with the current debug mode.

This patch shouldn't break any user code, except folks who are building
against a library that doesn't have the debug mode enabled and who try
to enable the debug mode in their code. Such users will get a compile-time
error explaining that this configuration isn't supported anymore.

In the future, we should further increase the granularity of the debug
mode checks so that we can cherry-pick which checks to enable, like we
do for unspecified behavior randomization.

Differential Revision: https://reviews.llvm.org/D122941
2022-06-07 16:33:53 -04:00
..
CHANGELOG.TXT [libc++][NFC] Refactor the ABI changelog 2022-03-24 10:24:43 -04:00
CMakeLists.txt [libc++] Make the Debug mode a configuration-time only option 2022-06-07 16:33:53 -04:00
README.TXT [libc++] Make it easier to re-generate the ABI lists 2020-11-02 11:36:35 -05:00
arm64-apple-darwin.libcxxabi.v1.stable.exceptions.nonew.debug.incomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
arm64-apple-darwin.libcxxabi.v1.stable.exceptions.nonew.nodebug.noincomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-apple-darwin.libcxxabi.v1.stable.exceptions.nonew.debug.incomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-apple-darwin.libcxxabi.v1.stable.exceptions.nonew.nodebug.noincomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-unknown-linux-gnu.libcxxabi.v1.stable.exceptions.nonew.debug.incomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-unknown-linux-gnu.libcxxabi.v1.stable.exceptions.nonew.debug.noincomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-unknown-linux-gnu.libcxxabi.v1.stable.exceptions.nonew.nodebug.incomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00
x86_64-unknown-linux-gnu.libcxxabi.v1.stable.noexceptions.nonew.debug.incomplete.abilist [libc++] Add a lightweight overridable assertion handler 2022-03-23 15:35:46 -04:00

README.TXT

This directory contains abi lists representing the symbols exported
by the libc++ library. The lists are generated using libcxx/utils/generate_abi_list.py.

Every time a symbol is added or removed from the libc++ library, each of the
lists *MUST* be updated to reflect the changes. This can be done by using the
`generate-cxx-abilist` CMake target.

We do not keep an up-to-date ABI list for all the build configurations of libc++.
Currently, only the default configuration on MacOS and Linux are supported.