index.html revision af4d1619089310f8f292c4240b0e522244a6ce1e
1d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 2bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant "http://www.w3.org/TR/html4/strict.dtd"> 3bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<!-- Material used from: HTML 4.01 specs: http://www.w3.org/TR/html401/ --> 4bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<html> 5bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<head> 6bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 7bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <title>"libc++" C++ Standard Library</title> 8bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <link type="text/css" rel="stylesheet" href="menu.css"> 9bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <link type="text/css" rel="stylesheet" href="content.css"> 10bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant</head> 11bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 12bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<body> 13bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<div id="menu"> 14bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <div> 15bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <a href="http://llvm.org/">LLVM Home</a> 16bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </div> 17d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 18bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <div class="submenu"> 19bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <label>libc++ Info</label> 20bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <a href="/index.html">About</a> 21bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </div> 22bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 23bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <div class="submenu"> 24bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <label>Quick Links</label> 25a535ffd99d3702ab065647e28e83c2b7d720be3dChris Lattner <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">cfe-dev</a> 26a535ffd99d3702ab065647e28e83c2b7d720be3dChris Lattner <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits">cfe-commits</a> 27bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <a href="http://llvm.org/bugs/">Bug Reports</a> 2876e1ffc6036a7e772827228e4626280caddbc354Howard Hinnant <a href="http://llvm.org/svn/llvm-project/libcxx/trunk/">Browse SVN</a> 2976e1ffc6036a7e772827228e4626280caddbc354Howard Hinnant <a href="http://llvm.org/viewvc/llvm-project/libcxx/trunk/">Browse ViewVC</a> 30bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </div> 31bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant</div> 32bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 33bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant<div id="content"> 34bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--*********************************************************************--> 35bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <h1>"libc++" C++ Standard Library</h1> 36bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--*********************************************************************--> 37d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 38bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <p>libc++ is a new implementation of the C++ standard library, targeting 39af3473404e13e758ac482a1fd59d7dad2bb0d612Howard Hinnant C++11.</p> 40bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 41f38bc6efc52ff2c773582d5b62dd53aaa92c186cChris Lattner <p>All of the code in libc++ is <a 42f38bc6efc52ff2c773582d5b62dd53aaa92c186cChris Lattner href="http://llvm.org/docs/DeveloperPolicy.html#license">dual licensed</a> 43f38bc6efc52ff2c773582d5b62dd53aaa92c186cChris Lattner under the MIT license and the UIUC License (a BSD-like license).</p> 44d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 45bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 46bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <h2 id="goals">Features and Goals</h2> 47bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 48d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 49bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <ul> 50af3473404e13e758ac482a1fd59d7dad2bb0d612Howard Hinnant <li>Correctness as defined by the C++11 standard.</li> 51bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Fast execution.</li> 52bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Minimal memory use.</li> 53bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Fast compile times.</li> 54bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>ABI compatibility with gcc's libstdc++ for some low-level features 55bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant such as exception objects, rtti and memory allocation.</li> 56bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Extensive unit tests.</li> 57bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </ul> 58bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 59bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 60faa17162e91c615378c38d7dc4a22699cf4cf0cfMarshall Clow <h2 id="why">Why a new C++ Standard Library for C++11?</h2> 6124173b81dd527a38b32e037082f7d1578213d626Chris Lattner <!--=====================================================================--> 62d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 6324173b81dd527a38b32e037082f7d1578213d626Chris Lattner <p>After its initial introduction, many people have asked "why start a new 6424173b81dd527a38b32e037082f7d1578213d626Chris Lattner library instead of contributing to an existing library?" (like Apache's 6524173b81dd527a38b32e037082f7d1578213d626Chris Lattner libstdcxx, GNU's libstdc++, STLport, etc). There are many contributing 6624173b81dd527a38b32e037082f7d1578213d626Chris Lattner reasons, but some of the major ones are:</p> 67d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 6824173b81dd527a38b32e037082f7d1578213d626Chris Lattner <ul> 6924173b81dd527a38b32e037082f7d1578213d626Chris Lattner <li><p>From years of experience (including having implemented the standard 7024173b81dd527a38b32e037082f7d1578213d626Chris Lattner library before), we've learned many things about implementing 7124173b81dd527a38b32e037082f7d1578213d626Chris Lattner the standard containers which require ABI breakage and fundamental changes 7224173b81dd527a38b32e037082f7d1578213d626Chris Lattner to how they are implemented. For example, it is generally accepted that 7324173b81dd527a38b32e037082f7d1578213d626Chris Lattner building std::string using the "short string optimization" instead of 7424173b81dd527a38b32e037082f7d1578213d626Chris Lattner using Copy On Write (COW) is a superior approach for multicore 75faa17162e91c615378c38d7dc4a22699cf4cf0cfMarshall Clow machines (particularly in C++11, which has rvalue references). Breaking 76a5058d9a0d5e60adcd9118dfe7f886effd6a6206Chris Lattner ABI compatibility with old versions of the library was 7724173b81dd527a38b32e037082f7d1578213d626Chris Lattner determined to be critical to achieving the performance goals of 7824173b81dd527a38b32e037082f7d1578213d626Chris Lattner libc++.</p></li> 79d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 8024173b81dd527a38b32e037082f7d1578213d626Chris Lattner <li><p>Mainline libstdc++ has switched to GPL3, a license which the developers 8124173b81dd527a38b32e037082f7d1578213d626Chris Lattner of libc++ cannot use. libstdc++ 4.2 (the last GPL2 version) could be 82faa17162e91c615378c38d7dc4a22699cf4cf0cfMarshall Clow independently extended to support C++11, but this would be a fork of the 83f33824922812487c1e7f24852975b0e06792eb7eChris Lattner codebase (which is often seen as worse for a project than starting a new 84f33824922812487c1e7f24852975b0e06792eb7eChris Lattner independent one). Another problem with libstdc++ is that it is tightly 85f33824922812487c1e7f24852975b0e06792eb7eChris Lattner integrated with G++ development, tending to be tied fairly closely to the 86f33824922812487c1e7f24852975b0e06792eb7eChris Lattner matching version of G++.</p> 8724173b81dd527a38b32e037082f7d1578213d626Chris Lattner </li> 8824173b81dd527a38b32e037082f7d1578213d626Chris Lattner 8924173b81dd527a38b32e037082f7d1578213d626Chris Lattner <li><p>STLport and the Apache libstdcxx library are two other popular 90faa17162e91c615378c38d7dc4a22699cf4cf0cfMarshall Clow candidates, but both lack C++11 support. Our experience (and the 91af3473404e13e758ac482a1fd59d7dad2bb0d612Howard Hinnant experience of libstdc++ developers) is that adding support for C++11 (in 9224173b81dd527a38b32e037082f7d1578213d626Chris Lattner particular rvalue references and move-only types) requires changes to 9324173b81dd527a38b32e037082f7d1578213d626Chris Lattner almost every class and function, essentially amounting to a rewrite. 94bfa808e093b1bd53832a9aa245d27b1b95827bbfChris Lattner Faced with a rewrite, we decided to start from scratch and evaluate every 95bfa808e093b1bd53832a9aa245d27b1b95827bbfChris Lattner design decision from first principles based on experience.</p> 96d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 9724173b81dd527a38b32e037082f7d1578213d626Chris Lattner <p>Further, both projects are apparently abandoned: STLport 5.2.1 was 9824173b81dd527a38b32e037082f7d1578213d626Chris Lattner released in Oct'08, and STDCXX 4.2.1 in May'08.</p> 9924173b81dd527a38b32e037082f7d1578213d626Chris Lattner 10024173b81dd527a38b32e037082f7d1578213d626Chris Lattner </ul> 10124173b81dd527a38b32e037082f7d1578213d626Chris Lattner 10224173b81dd527a38b32e037082f7d1578213d626Chris Lattner <!--=====================================================================--> 103bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <h2 id="requirements">Platform Support</h2> 104bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 105bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 106bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <p>libc++ is known to work on the following platforms, using g++-4.2 and 107af3473404e13e758ac482a1fd59d7dad2bb0d612Howard Hinnant clang (lack of C++11 language support disables some functionality).</p> 108bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 109bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <ul> 110bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Mac OS X i386</li> 111bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li>Mac OS X x86_64</li> 112bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </ul> 113bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 114bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 115bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <h2 id="dir-structure">Current Status</h2> 116bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 117bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 118b0895ff8aee82d79986e1cc61e66870d48244d90Howard Hinnant <p>libc++ is a 100% complete C++11 implementation on Apple's OS X. </p> 119db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p>LLVM and Clang can self host in C++ and C++11 mode with libc++ on Linux.</p> 120d0e811a37d2c263a602ace05648f9ecaf8b59663Howard Hinnant 1210cbb3a16e258e2cebcb827af310ffe43ecaee508Howard Hinnant <p> 122ee7a0bf265499a87948e152e9d3a1bedcb9e896cHoward Hinnant Ports to other platforms are underway. Here are recent test 123ee7a0bf265499a87948e152e9d3a1bedcb9e896cHoward Hinnant results for <a href="results.Windows.html">Windows</a> 124ee7a0bf265499a87948e152e9d3a1bedcb9e896cHoward Hinnant and <a href="results.Linux.html">Linux</a>. 1250cbb3a16e258e2cebcb827af310ffe43ecaee508Howard Hinnant </p> 1260cbb3a16e258e2cebcb827af310ffe43ecaee508Howard Hinnant 127bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 128bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <h2>Get it and get involved!</h2> 129bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <!--=====================================================================--> 130d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 1312481cba8b7eb98b939a0b36d85f552917a63816dHoward Hinnant <p>First please review our 1322481cba8b7eb98b939a0b36d85f552917a63816dHoward Hinnant <a href="http://llvm.org/docs/DeveloperPolicy.html">Developer's Policy</a>. 1332481cba8b7eb98b939a0b36d85f552917a63816dHoward Hinnant 134bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <p>To check out the code, use:</p> 135d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant 136bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <ul> 1374b748953a2d51c34127aa9c593477966242e1898Chris Lattner <li><code>svn co http://llvm.org/svn/llvm-project/libcxx/trunk libcxx</code></li> 13865451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </ul> 13965451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 140704f09b21245cee8a775fdb9962ed40de0f94b04Howard Hinnant <p> 14122b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant On Mac OS 10.7 (Lion) and later, the easiest way to get this library is to install 142704f09b21245cee8a775fdb9962ed40de0f94b04Howard Hinnant Xcode 4.2 or later. However if you want to install tip-of-trunk from here 143271a1c03c309f20bb8cdbb0b0af7ad563bdc866dHoward Hinnant (getting the bleeding edge), read on. However, be warned that Mac OS 144271a1c03c309f20bb8cdbb0b0af7ad563bdc866dHoward Hinnant 10.7 will not boot without a valid copy of <code>libc++.1.dylib</code> in 145271a1c03c309f20bb8cdbb0b0af7ad563bdc866dHoward Hinnant <code>/usr/lib</code>. 146704f09b21245cee8a775fdb9962ed40de0f94b04Howard Hinnant </p> 147704f09b21245cee8a775fdb9962ed40de0f94b04Howard Hinnant 14865451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <p> 14965451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant Next: 15065451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </p> 15165451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 15265451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <ul> 15365451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <li><code>cd libcxx/lib</code></li> 15465451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <li><code>export TRIPLE=-apple-</code></li> 15565451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <li><code>/buildit</code></li> 15622b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li><code>ln -sf libc++.1.dylib libc++.dylib</code></li> 15765451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </ul> 15865451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 15965451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <p> 16022b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant That should result in a libc++.1.dylib and libc++.dylib. The safest thing 16122b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant to do is to use it from where your libcxx is installed instead of replacing 16222b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant these in your Mac OS. 16322b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant </p> 16422b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant 16522b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <p> 16622b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant To use your system-installed libc++ with clang you can: 16765451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </p> 16865451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 16965451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <ul> 17022b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li><code>clang++ -stdlib=libc++ test.cpp</code></li> 17122b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li><code>clang++ -std=c++11 -stdlib=libc++ test.cpp</code></li> 17265451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </ul> 17365451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 17465451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <p> 17522b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant To use your tip-of-trunk libc++ on Mac OS with clang you can: 17665451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant </p> 17765451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant 17865451f15493a16a541d82f0591ba27506f2793b1Howard Hinnant <ul> 17922b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li><code>export DYLD_LIBRARY_PATH=<path-to-libcxx>/lib</code> 18022b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li><code>clang++ -std=c++11 -stdlib=libc++ -nostdinc++ 18122b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant -I<path-to-libcxx>/include -L<path-to-libcxx>/lib 18222b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant test.cpp</code></li> 183bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </ul> 184bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 18508a0b48c094ae76c3c9fb082bf0f17738a3fd7ceMarshall Clow <p>To run the libc++ test suite (recommended):</p> 186bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 187bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <ul> 1884b748953a2d51c34127aa9c593477966242e1898Chris Lattner <li><code>cd libcxx/test</code></li> 189bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant <li><code>/testit</code></li> 190f5d76a7afce1d593634004566066c8e593a14adeHoward Hinnant <ul> 19122b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant <li>You can alter the command line options <code>testit</code> uses 19222b781bf0c49857e1d0e2f1873cf8c3869e8246bHoward Hinnant with <code>export OPTIONS="whatever you need"</code></li> 193f5d76a7afce1d593634004566066c8e593a14adeHoward Hinnant </ul> 194bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant </ul> 195bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant 19651065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant <!--=====================================================================--> 19751065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant <h3>Notes</h3> 19851065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant <!--=====================================================================--> 19951065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant 20051065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant<p> 20151065657aa5d421b8e41d16d66da707a7237adb0Howard HinnantBuilding libc++ with <code>-fno-rtti</code> is not supported. However linking 20251065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnantagainst it with <code>-fno-rtti</code> is supported. 20351065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant</p> 20451065657aa5d421b8e41d16d66da707a7237adb0Howard Hinnant 205d2bb03207523e55aa2423570bcaaad03e779450cHoward Hinnant <p>Send discussions to the 2068c21737c03f3b266d8679d56faa6b6d091e7f2f1Howard Hinnant (<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev">clang mailing list</a>).</p> 2078c21737c03f3b266d8679d56faa6b6d091e7f2f1Howard Hinnant 20856f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant <!--=====================================================================--> 209db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <h2>Build on Linux using CMake and libsupc++.</h2> 210db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <!--=====================================================================--> 211db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 212db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p> 213db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer You will need libstdc++ in order to provide libsupc++. 214db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </p> 215db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 216db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p> 217db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer Figure out where the libsupc++ headers are on your system. On Ubuntu this 218db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer is <code>/usr/include/c++/<version></code> and 219db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <code>/usr/include/c++/<version>/<target-triple></code> 220db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </p> 221db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 222db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p> 223db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer You can also figure this out by running 224db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <pre> 225db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer$ echo | g++ -Wp,-v -x c++ - -fsyntax-only 226db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencerignoring nonexistent directory "/usr/local/include/x86_64-linux-gnu" 227db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencerignoring nonexistent directory "/usr/x86_64-linux-gnu/include" 228db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer#include "..." search starts here: 229db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer#include <...> search starts here: 230db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/include/c++/4.7 231db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/include/c++/4.7/x86_64-linux-gnu 232db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/include/c++/4.7/backward 233db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/lib/gcc/x86_64-linux-gnu/4.7/include 234db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/local/include 235db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/lib/gcc/x86_64-linux-gnu/4.7/include-fixed 236db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/include/x86_64-linux-gnu 237db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer /usr/include 238db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. SpencerEnd of search list. 239db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </pre> 240db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 241db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer Note the first two entries happen to be what we are looking for. This 242db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer may not be correct on other platforms. 243db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </p> 244db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 245db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p> 246db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer We can now run CMake: 247db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <ul> 248db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <li><code>CC=clang CXX=clang++ cmake -G "Unix Makefiles" 249db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer -DLIBCXX_CXX_ABI=libsupc++ 250db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer -DLIBCXX_LIBSUPCXX_INCLUDE_PATHS="/usr/include/c++/4.7/;/usr/include/c++/4.7/x86_64-linux-gnu/" 251db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer -DCMAKE_BUILD_TYPE=Release 252db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer -DCMAKE_INSTALL_PREFIX=/usr 253db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <libc++-source-dir></code></li> 254db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <li><code>make</code></li> 255db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <li><code>sudo make install</code></li> 256db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </ul> 257db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <p> 258db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer You can now run clang with -stdlib=libc++. 259db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </p> 260db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer </p> 261db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer 262db8a030bd3d8260c3def1d7710f34ec0b6ec7a89Michael J. Spencer <!--=====================================================================--> 263af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <h2>Build on Linux using CMake and libc++abi.</h2> 264af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <!--=====================================================================--> 265af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 266af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 267af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant You will need to keep the source tree of <a href="http://libcxxabi.llvm.org">libc++abi</a> 268af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant available on your build machine and your copy of the libc++abi shared library must 269af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant be placed where your linker will find it. 270af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 271af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 272af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 273af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant We can now run CMake: 274af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 275af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>CC=clang CXX=clang++ cmake -G "Unix Makefiles" 276af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DLIBCXX_CXX_ABI=libcxxabi 277af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DLIBCXX_LIBCXXABI_INCLUDE_PATHS="<libc++abi-source-dir>/include" 278af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DCMAKE_BUILD_TYPE=Release 279af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DCMAKE_INSTALL_PREFIX=/usr 280af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <libc++-source-dir></code></li> 281af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>make</code></li> 282af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>sudo make install</code></li> 283af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 284af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 285af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant Unfortunately you can't simply run clang with "-stdlib=libc++" at this point, as 286af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant clang is set up to link for libc++ linked to libsupc++. To get around this 287af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant you'll have to set up your linker yourself (or patch clang). For example, 288af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 289af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>clang++ -stdlib=libc++ helloworld.cpp -nodefaultlibs -lc++ -lc++abi -lm -lc -lgcc_s -lgcc</code></li> 290af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 291af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant Alternately, you could just add libc++abi to your libraries list, which in most 292af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant situations will give the same result: 293af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 294af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>clang++ -stdlib=libc++ helloworld.cpp -lc++abi</code></li> 295af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 296af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 297af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 298af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 299af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <!--=====================================================================--> 300af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <h2>Build on Linux using CMake and libcxxrt.</h2> 301af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <!--=====================================================================--> 302af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 303af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 304af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant You will need to keep the source tree of 305af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <a href="https://github.com/pathscale/libcxxrt/">libcxxrt</a> available 306af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant on your build machine and your copy of the libcxxrt shared library must 307af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant be placed where your linker will find it. 308af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 309af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 310af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 311af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant We can now run CMake: 312af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 313af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>CC=clang CXX=clang++ cmake -G "Unix Makefiles" 314af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DLIBCXX_CXX_ABI=libcxxrt 315af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DLIBCXX_LIBCXXABI_INCLUDE_PATHS="<libcxxrt-source-dir>/src" 316af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DCMAKE_BUILD_TYPE=Release 317af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant -DCMAKE_INSTALL_PREFIX=/usr 318af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <libc++-source-dir></code></li> 319af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>make</code></li> 320af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>sudo make install</code></li> 321af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 322af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <p> 323af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant Unfortunately you can't simply run clang with "-stdlib=libc++" at this point, as 324af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant clang is set up to link for libc++ linked to libsupc++. To get around this 325af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant you'll have to set up your linker yourself (or patch clang). For example, 326af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 327af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>clang++ -stdlib=libc++ helloworld.cpp -nodefaultlibs -lc++ -lcxxrt -lm -lc -lgcc_s -lgcc</code></li> 328af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 329af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant Alternately, you could just add libcxxrt to your libraries list, which in most 330af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant situations will give the same result: 331af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <ul> 332af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <li><code>clang++ -stdlib=libc++ helloworld.cpp -lcxxrt</code></li> 333af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </ul> 334af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 335af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant </p> 336af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant 337af4d1619089310f8f292c4240b0e522244a6ce1eHoward Hinnant <!--=====================================================================--> 33856f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant <h2>Design Documents</h2> 33956f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant <!--=====================================================================--> 34056f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant 34156f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant<ul> 34256f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant<li><a href="atomic_design.html"><tt><atomic></tt></a></li> 3439835d761695b7d54e7d231dd1fe682597f249349Howard Hinnant<li><a href="type_traits_design.html"><tt><type_traits></tt></a></li> 344820e00755aa68e10badd62c78ab6defec5b3c64dHoward Hinnant<li><a href="http://marshall.calepin.co/llvmclang-and-standard-libraries-on-mac-os-x.html">Excellent notes by Marshall Clow</a></li> 34556f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant</ul> 34656f0d5be064ed82f439e1596a272237697077ec3Howard Hinnant 347bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant</div> 348bc8d3f97eb5c958007f2713238472e0c1c8fe02Howard Hinnant</body> 3494b748953a2d51c34127aa9c593477966242e1898Chris Lattner</html> 350