Lines Matching +full:build +full:- +full:benchmarks

12 libc++ tests is by using make check-libcxx. However since libc++ can be used
22 --------------------------
30    .. code-block:: bash
34 #. Tell LIT where to find your build configuration.
36    .. code-block:: bash
38      $ export LIBCXX_SITE_CONFIG=path/to/build-libcxx/test/lit.site.cfg
41 -------------
47 .. code-block:: bash
50   $ lit -sv test/std/re # Run all of the std::regex tests
51   $ lit -sv test/std/depr/depr.c.headers/stdlib_h.pass.cpp # Run a single test
52   $ lit -sv test/std/atomics test/std/threads # Test std::thread and std::atomic
55 can be specified using the `--param=<name>=<val>` flag. The most common option
56 you'll want to change is the standard dialect (ie -std=c++XX). By default the
60 .. code-block:: bash
62   $ lit -sv test/std/containers # Run the tests with the newest -std
63   $ lit -sv --param=std=c++03 test/std/containers # Run the tests in C++03
68 .. code-block:: bash
70   $ lit -sv --param=compile_flags='-Wcustom-warning'
71   $ lit -sv --param=link_flags='-L/custom/library/path'
75 .. code-block:: bash
78   $ lit -sv --param=cxx_under_test=/opt/bin/g++ test/std
81   $ lit -sv --param=enable_warnings=true test/std
84   $ lit -sv --param=use_sanitizer=Undefined
93 --------------------
95 To use these options you pass them on the LIT command line as --param NAME or
96 --param NAME=VALUE. Some options have default values specified during CMake's
103   Specify the compiler used to build the tests.
132   library folder of the build directory is used. This option cannot be used
157 .. option:: compile_flags="<list-of-args>"
162 .. option:: link_flags="<list-of-args>"
188 ---------------------
201 Benchmarks  chapter
205 The benchmarks are written using the `Google Benchmark`_ library, a copy of which
213 Building Benchmarks
214 -------------------
216 The benchmark tests are not built by default. The benchmarks can be built using
217 the ``cxx-benchmarks`` target.
219 An example build would look like:
221 .. code-block:: bash
223   $ cd build
225   $ make cxx-benchmarks
227 This will build all of the benchmarks under ``<libcxx-src>/benchmarks`` to be
228 built against the just-built libc++. The compiled tests are output into
229 ``build/benchmarks``.
231 The benchmarks can also be built against the platforms native standard library
232 using the ``-DLIBCXX_BUILD_BENCHMARKS_NATIVE_STDLIB=ON`` CMake option. This
234 The compiled benchmarks are named ``<test>.libcxx.out`` if they test libc++ and
239   * :ref:`Building Libc++ <build instructions>`
242 Running Benchmarks
243 ------------------
245 The benchmarks must be run manually by the user. Currently there is no way
246 to run them as part of the build.
250 .. code-block:: bash
252   $ cd build/benchmarks
253   $ make cxx-benchmarks
254   $ ./algorithms.libcxx.out # Runs all the benchmarks
255   $ ./algorithms.libcxx.out --benchmark_filter=BM_Sort.* # Only runs the sort benchmarks
257 For more information about running benchmarks see `Google Benchmark`_.