.. cmake-manual-description: CTest Command-Line Reference
ctest(1)
********
.. contents::
Synopsis
========
.. parsed-literal::
ctest [<options>]
ctest --build-and-test <path-to-source> <path-to-build>
--build-generator <generator> [<options>...]
[--build-options <opts>...] [--test-command <command> [<args>...]]
ctest {-D <dashboard> | -M <model> -T <action> | -S <script> | -SP <script>}
[-- <dashboard-options>...]
Description
===========
The **ctest** executable is the CMake test driver program.
CMake-generated build trees created for projects that use the
:command:`enable_testing` and :command:`add_test` commands have testing support.
This program will run the tests and report results.
Options
=======
``-C <cfg>, --build-config <cfg>``
Choose configuration to test.
Some CMake-generated build trees can have multiple build
configurations in the same tree. This option can be used to specify
which one should be tested. Example configurations are ``Debug`` and
``Release``.
``--progress``
Enable short progress output from tests.
When the output of **ctest** is being sent directly to a terminal, the
progress through the set of tests is reported by updating the same line
rather than printing start and end messages for each test on new lines.
This can significantly reduce the verbosity of the test output.
Test completion messages are still output on their own line for failed
tests and the final test summary will also still be logged.
This option can also be enabled by setting the environment variable
:envvar:`CTEST_PROGRESS_OUTPUT`.
``-V,--verbose``
Enable verbose output from tests.
Test output is normally suppressed and only summary information is
displayed. This option will show all test output.
``-VV,--extra-verbose``
Enable more verbose output from tests.
Test output is normally suppressed and only summary information is
displayed. This option will show even more test output.
``--debug``
Displaying more verbose internals of CTest.
This feature will result in a large number of output that is mostly
useful for debugging dashboard problems.
``--output-on-failure``
Output anything outputted by the test program if the test should fail.
This option can also be enabled by setting the
:envvar:`CTEST_OUTPUT_ON_FAILURE` environment variable
``--stop-on-failure``
Stop running the tests when the first failure happens.
``-F``
Enable failover.
This option allows CTest to resume a test set execution that was
previously interrupted. If no interruption occurred, the ``-F`` option
will have no effect.
``-j <jobs>, --parallel <jobs>``
Run the tests in parallel using the given number of jobs.
This option tells CTest to run the tests in parallel using given
number of jobs. This option can also be set by setting the
:envvar:`CTEST_PARALLEL_LEVEL` environment variable.
This option can be used with the :prop_test:`PROCESSORS` test property.
See `Label and Subproject Summary`_.
``--resource-spec-file <file>``
Run CTest with :ref:`resource allocation <ctest-resource-allocation>` enabled,
using the
:ref:`resource specification file <ctest-resource-specification-file>`
specified in ``<file>``.
When ``ctest`` is run as a `Dashboard Client`_ this sets the
``ResourceSpecFile`` option of the `CTest Test Step`_.
``--test-load <level>``
While running tests in parallel (e.g. with ``-j``), try not to start
tests when they may cause the CPU load to pass above a given threshold.
When ``ctest`` is run as a `Dashboard Client`_ this sets the
``TestLoad`` option of the `CTest Test Step`_.
``-Q,--quiet``
Make CTest quiet.
This option will suppress all the output. The output log file will
still be generated if the ``--output-log`` is specified. Options such
as ``--verbose``, ``--extra-verbose``, and ``--debug`` are ignored
if ``--quiet`` is specified.
``-O <file>, --output-log <file>``
Output to log file.
This option tells CTest to write all its output to a ``<file>`` log file.
``-N,--show-only[=<format>]``
Disable actual execution of tests.
This option tells CTest to list the tests that would be run but not
actually run them. Useful in conjunction with the ``-R`` and ``-E``
options.
``<format>`` can be one of the following values.
``human``
Human-friendly output. This is not guaranteed to be stable.
This is the default.
``json-v1``
Dump the test information in JSON format.
See `Show as JSON Object Model`_.
``-L <regex>, --label-regex <regex>``
Run tests with labels matching regular expression.
This option tells CTest to run only the tests whose labels match the
given regular expression.
``-R <regex>, --tests-regex <regex>``
Run tests matching regular expression.
This option tells CTest to run only the tests whose names match the
given regular expression.
``-E <regex>, --exclude-regex <regex>``
Exclude tests matching regular expression.
This option tells CTest to NOT run the tests whose names match the
given regular expression.
``-LE <regex>, --label-exclude <regex>``
Exclude tests with labels matching regular expression.
This option tells CTest to NOT run the tests whose labels match the
given regular expression.
``-FA <regex>, --fixture-exclude-any <regex>``
Exclude fixtures matching ``<regex>`` from automatically adding any tests to
the test set.
If a test in the set of tests to be executed requires a particular fixture,
that fixture's setup and cleanup tests would normally be added to the test set
automatically. This option prevents adding setup or cleanup tests for fixtures
matching the ``<regex>``. Note that all other fixture behavior is retained,
including test dependencies and skipping tests that have fixture setup tests
that fail.
``-FS <regex>, --fixture-exclude-setup <regex>``
Same as ``-FA`` except only matching setup tests are excluded.
``-FC <regex>, --fixture-exclude-cleanup <regex>``
Same as ``-FA`` except only matching cleanup tests are excluded.
``-D <dashboard>, --dashboard <dashboard>``
Execute dashboard test.
This option tells CTest to act as a CDash client and perform a
dashboard test. All tests are ``<Mode><Test>``, where ``<Mode>`` can be
``Experimental``, ``Nightly``, and ``Continuous``, and ``<Test>`` can be
``Start``, ``Update``, ``Configure``, ``Build``, ``Test``,
``Coverage``, and ``Submit``.
See `Dashboard Client`_.
``-D <var>:<type>=<value>``
Define a variable for script mode.
Pass in variable values on the command line. Use in conjunction
with ``-S`` to pass variable values to a dashboard script. Parsing ``-D``
arguments as variable values is only attempted if the value
following ``-D`` does not match any of the known dashboard types.
``-M <model>, --test-model <model>``
Sets the model for a dashboard.
This option tells CTest to act as a CDash client where the ``<model>``
can be ``Experimental``, ``Nightly``, and ``Continuous``.
Combining ``-M`` and ``-T`` is similar to ``-D``.
See `Dashboard Client`_.
``-T <action>, --test-action <action>``
Sets the dashboard action to perform.
This option tells CTest to act as a CDash client and perform some
action such as ``start``, ``build``, ``test`` etc. See
`Dashboard Client Steps`_ for the full list of actions.
Combining ``-M`` and ``-T`` is similar to ``-D``.
See `Dashboard Client`_.
``-S <script>, --script <script>``
Execute a dashboard for a configuration.
This option tells CTest to load in a configuration script which sets
a number of parameters such as the binary and source directories.
Then CTest will do what is required to create and run a dashboard.
This option basically sets up a dashboard and then runs ``ctest -D``
with the appropriate options.
See `Dash
cmake-3.18.0-rc2-win64-x64.zip （2000个子文件） 
test_mpi.c 895B CheckFunctionExists.c 461B CMakeCCompilerABI.c 439B CheckVariableExists.c 406B libver_mpi.c 377B CheckForPthreads.c 288B main.c 261B CMakeTestGNU.c 184B VerifyC.c 70B main.c 49B foo.c 33B my_module_.c 29B MY_MODULE.c 28B mymodule_.c 28B MYMODULE.c 27B CMakeCXXCompilerABI.cpp 307B main.cpp 49B foo.cpp 33B basic.css 13KB classic.css 4KB pygments.css 3KB cmake.css 502B default.css 28B cmCPluginAPI.h 12KB CMakeCompilerABI.h 1KB
genindex.html 1.98MB ctest.1.html 182KB cmake-buildsystem.7.html 149KB index.html 138KB cmake-generator-expressions.7.html 118KB cmake-file-api.7.html 106KB ExternalProject.html 100KB file.html 97KB install.html 97KB cmake-variables.7.html 94KB cmake.1.html 90KB cmake-toolchains.7.html 88KB cmake-packages.7.html 85KB rpm.html 84KB 3.0.html 83KB 3.8.html 81KB 3.14.html 77KB cmake-properties.7.html 71KB 3.1.html 71KB FetchContent.html 70KB index.html 67KB 3.15.html 66KB 3.17.html 64KB 3.9.html 64KB find_package.html 61KB cmake-language.7.html 61KB 3.11.html 60KB 3.16.html 60KB 3.7.html 59KB 3.18.html 56KB 3.6.html 56KB deb.html 56KB 3.12.html 56KB 3.4.html 53KB CPack.html 51KB 3.3.html 49KB 3.10.html 48KB cmake-qt.7.html 48KB string.html 47KB cmake-compile-features.7.html 47KB 3.13.html 47KB target_link_libraries.html 46KB cmake-server.7.html 46KB 3.2.html 45KB UseJava.html 43KB FindMatlab.html 42KB cmake-developer.7.html 40KB FindPython.html 39KB FindPython3.html 39KB try_compile.html 39KB cmake-policies.7.html 38KB cmake-modules.7.html 37KB ExternalData.html 37KB ifw.html 36KB find_library.html 36KB FeatureSummary.html 35KB AUTOMOC.html 35KB external.html 35KB add_custom_command.html 35KB FindPython2.html 34KB list.html 34KB FindDoxygen.html 33KB 3.5.html 33KB FindCUDAToolkit.html 33KB add_library.html 33KB UseSWIG.html 33KB if.html 32KB WriteCompilerDetectionHeader.html 32KB FindCUDA.html 30KB find_path.html 30KB find_file.html 29KB FindMPI.html 29KB CMakePackageConfigHelpers.html 29KB ccmake.1.html 28KB GoogleTest.html 28KB共 2000 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
