Lines Matching refs:libc

4 Building libc++
19 The basic steps needed to build libc++ are:
26 #. Checkout libc++:
32 #. Checkout libc++abi:
38 #. Configure and build libc++ with libc++abi:
42    Clang is the preferred compiler when building and using libc++.
49    For more information about configuring libc++ see :ref:`CMake Options`.
51    * ``make cxx`` --- will build libc++ and libc++abi.
54    Shared libraries for libc++ and libc++ abi should now be present in llvm/build/lib.
55    See :ref:`using an alternate libc++ installation <alternate libcxx>`
57 #. **Optional**: Install libc++ and libc++abi
59    If your system already provides a libc++ installation it is important to be
61    select a safe place to install libc++.
66      * Replacing your systems libc++ installation could render the system non-functional.
67      * Mac OS X will not boot without a valid copy of ``libc++.1.dylib`` in ``/usr/lib``.
70 The instructions are for building libc++ on
71 FreeBSD, Linux, or Mac using `libc++abi`_ as the C++ ABI library.
80   $ # Check out llvm, libc++ and libc++abi.
146 .. _`libc++abi`: http://libcxxabi.llvm.org/
168   The C++ compiler to use when building and testing libc++.
173 libc++ specific options
180   Toggle the installation of the library portion of libc++.
186   Toggle the installation of the libc++ headers.
192   Build libc++ with assertions enabled.
198   Build libc++ as a 32 bit library. Also see `LLVM_BUILD_32_BITS`.
204   Build libc++ as a shared library. Either `LIBCXX_ENABLE_SHARED` or
211   Build libc++ as a static library. Either `LIBCXX_ENABLE_SHARED` or
222 libc++experimental Specific Options
229   Build and test libc++experimental.a.
235   Install libc++experimental.a alongside libc++.
242   Build filesystem as part of libc++experimental.a. This allows filesystem
255   Select the ABI library to build libc++ against.
263   Provide the path to the ABI library that libc++ should link against.
269   If this option is enabled, libc++ will try and link the selected ABI library
277   This option generate and installs a linker script as ``libc++.so`` which
285   libc++abi is the C++ ABI library used.
288 libc++ Feature Options
295   Build libc++ with exception support.
301   Build libc++ with run time type information.
307   Build the libc++ benchmark tests and the Google Benchmark library needed
314   **Values**:: ``libc++``, ``libstdc++``
316   Build the libc++ benchmark tests and Google Benchmark library against the
318   compare libc++ to libstdc++ by building the benchmark tests against both
327 libc++ ABI Feature Options
330 The following options allow building libc++ for a different ABI version.
336   Defines the target ABI version of libc++.
342   Build the "unstable" ABI version of libc++. Includes all ABI changing features
412     <libc++-source-dir>
418 never need to link against libstdc++ in the same executable as libc++.
428 You can now run clang with -stdlib=libc++.
449                 <libc++-source-directory>
453 Unfortunately you can't simply run clang with "-stdlib=libc++" at this point, as
454 clang is set up to link for libc++ linked to libsupc++.  To get around this
459   $ clang++ -stdlib=libc++ helloworld.cpp \
467   $ clang++ -stdlib=libc++ helloworld.cpp -lcxxrt
480 Normally you must link libc++ against a ABI shared library that the
481 linker can find.  If you want to build and test libc++ against an ABI
485 An example build using libc++abi would look like:
490               -DLIBCXX_CXX_ABI=libc++abi  \
496 When testing libc++ LIT will automatically link against the proper ABI