diff options
author | Eric Fiselier <eric@efcs.ca> | 2018-10-30 21:44:53 +0000 |
---|---|---|
committer | Eric Fiselier <eric@efcs.ca> | 2018-10-30 21:44:53 +0000 |
commit | b6d41b10f6f0acd2cd85f104aacc8435a0aa6b0b (patch) | |
tree | e456b27f92f4bdeea35540fbb94c87b49e98021b /libcxx/docs | |
parent | e6d3cd94c2c80628576b2c8f2bb44622ce892c6d (diff) |
Make libc++'s versioning namespace customizable
Summary:
This patch makes the versioning namespace libc++ uses customizable by the user using `-DLIBCXX_ABI_NAMESPACE=__foo`.
This allows users to build custom versions of libc++ which can be linked into binaries with other libc++ versions without causing symbol conflicts or ODR issues.
Reviewers: mclow.lists, ldionne
Reviewed By: ldionne
Subscribers: kristina, smeenai, mgorny, phosek, libcxx-commits
Differential Revision: https://reviews.llvm.org/D53879
Diffstat (limited to 'libcxx/docs')
-rw-r--r-- | libcxx/docs/BuildingLibcxx.rst | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/libcxx/docs/BuildingLibcxx.rst b/libcxx/docs/BuildingLibcxx.rst index daf9229a0d0..66cfb7b21ea 100644 --- a/libcxx/docs/BuildingLibcxx.rst +++ b/libcxx/docs/BuildingLibcxx.rst @@ -360,6 +360,18 @@ The following options allow building libc++ for a different ABI version. Build the "unstable" ABI version of libc++. Includes all ABI changing features on top of the current stable version. +.. option:: LIBCXX_ABI_NAMESPACE:STRING + + **Default**: ``__n`` where ``n`` is the current ABI version. + + This option defines the name of the inline ABI versioning namespace. It can be used for building + custom versions of libc++ with unique symbol names in order to prevent conflicts or ODR issues + with other libc++ versions. + + .. warning:: + When providing a custom namespace, it's the users responsibility to ensure the name won't cause + conflicts with other names defined by libc++, both now and in the future. + .. option:: LIBCXX_ABI_DEFINES:STRING **Default**: ``""`` |