.. cmake-manual-description: CTest Command-Line Reference
ctest(1)
********
.. contents::
Synopsis
========
.. parsed-literal::
ctest [<options>]
ctest <path-to-source> <path-to-build> --build-generator <generator>
[<options>...] [-- <build-options>...] [--test-command <test>]
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
ENABLE_TESTING and 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
``-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`_.
``--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 log file.
``-N,--show-only``
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.
``-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 `Dashboard Client`_.
``-SP <script>, --script-new-process <script>``
Execute a dashboard for a configuration.
This option does the same operations as ``-S`` but it will do them in a
separate process. This is primarily useful in cases where the
script may modify the environment and you do not want the modified
environment to impact other ``-S`` scripts.
See `Dashboard Client`_.
``-I [Start,End,Stride,test#,test#|Test file], --tests-information``
Run a specific number of tests by number.
This option causes CTest to run tests starting at number Start,
ending at number End, and incrementing by Stride. Any additional
numbers after Stride are considered individual test numbers. Start,
End,or stride can be empty. Optionally a file can be given that
contains the same syntax as the command line.
``-U, --union``
Take the Union of ``-I`` and ``-R``.
When both ``-R`` and ``-I`` are specified by default the intersection of
tests are run. By specifying ``-U`` the union of tests is run instead.
``--rerun-failed``
Run only the tests
cmake-3.13.1-win32-x86.zip （2000个子文件） 
genindex.html 1.52MB ctest.1.html 141KB cmake-buildsystem.7.html 133KB cmake-variables.7.html 81KB rpm.html 80KB cmake-developer.7.html 78KB cmake-packages.7.html 76KB cmake-toolchains.7.html 70KB cmake-properties.7.html 62KB cmake-language.7.html 57KB cmake.1.html 54KB deb.html 52KB cmake-generator-expressions.7.html 52KB cmake-server.7.html 44KB cmake-compile-features.7.html 44KB cmake-qt.7.html 43KB external.html 34KB cmake-modules.7.html 33KB ifw.html 32KB cmake-policies.7.html 31KB cpack.1.html 27KB ccmake.1.html 27KB nuget.html 23KB wix.html 22KB cmake-commands.7.html 21KB cmake-gui.1.html 18KB FIXTURES_REQUIRED.html 16KB freebsd.html 16KB cmake-generators.7.html 15KB nsis.html 15KB dmg.html 14KB CMAKE_XCODE_GENERATE_SCHEME.html 13KB CMAKE_MAKE_PROGRAM.html 13KB productbuild.html 11KB CMAKE_GENERATOR_TOOLSET.html 11KB bundle.html 10KB CTEST_COVERAGE_COMMAND.html 10KB INCLUDE_DIRECTORIES.html 10KB CMAKE_VERSION.html 10KB cmake-env-variables.7.html 10KB CMAKE_SYSTEM_PREFIX_PATH.html 10KB CMAKE_LANG_LINKER_WRAPPER_FLAG.html 9KB CMAKE_INSTALL_PREFIX.html 9KB TIMEOUT_AFTER_MATCH.html 9KB COMPILE_DEFINITIONS.html 9KB CMAKE_POLICY_WARNING_CMPNNNN.html 9KB CMAKE_PROJECT_HOMEPAGE_URL.html 9KB CMAKE_PROJECT_DESCRIPTION.html 9KB CMAKE_DEBUG_TARGET_PROPERTIES.html 9KB CMAKE_CROSSCOMPILING.html 9KB CPACK_SET_DESTDIR.html 9KB CMAKE_PROJECT_VERSION.html 9KB FIXTURES_SETUP.html 9KB CMAKE_PREFIX_PATH.html 9KB CMAKE_SYSTEM_IGNORE_PATH.html 8KB CMAKE_USER_MAKE_RULES_OVERRIDE.html 8KB FIXTURES_CLEANUP.html 8KB CMAKE_IGNORE_PATH.html 8KB CMAKE_PROJECT_NAME.html 8KB CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS.html 8KB CMAKE_FIND_NO_INSTALL_PREFIX.html 8KB CMAKE_GENERATOR_PLATFORM.html 8KB CMAKE_SYSTEM_VERSION.html 8KB CMAKE_BUILD_TYPE.html 8KB CMAKE_FIND_PACKAGE_WARN_NO_MODULE.html 8KB CMAKE_CFG_INTDIR.html 8KB CMAKE_FIND_PACKAGE_SORT_ORDER.html 8KB CMAKE_ANDROID_STL_TYPE.html 8KB CMAKE_TRY_COMPILE_PLATFORM_VARIABLES.html 8KB CMAKE_FIND_ROOT_PATH_MODE_INCLUDE.html 8KB CMAKE_FIND_ROOT_PATH_MODE_PACKAGE.html 8KB CMAKE_FIND_ROOT_PATH_MODE_LIBRARY.html 8KB CMAKE_SYSTEM_NAME.html 7KB CMAKE_FIND_ROOT_PATH_MODE_PROGRAM.html 7KB CMAKE_INSTALL_MESSAGE.html 7KB CMAKE_POLICY_DEFAULT_CMPNNNN.html 7KB CMAKE_EXPORT_COMPILE_COMMANDS.html 7KB cpack-generators.7.html 7KB archive.html 7KB CMAKE_LANG_FLAGS.html 7KB CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY.html 7KB CMAKE_LINK_SEARCH_START_STATIC.html 7KB CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY.html 7KB CMAKE_LANG_IMPLICIT_LINK_DIRECTORIES.html 7KB CMAKE_OSX_SYSROOT.html 7KB PROJECT-NAME_VERSION.html 7KB CMAKE_OSX_DEPLOYMENT_TARGET.html 7KB COMPILE_DEFINITIONS_CONFIG.html 7KB CMAKE_VS_GLOBALS.html 7KB CMAKE_LINK_SEARCH_END_STATIC.html 7KB CMAKE_XCODE_ATTRIBUTE_an-attribute.html 7KB CMAKE_VS_DEVENV_COMMAND.html 7KB CMAKE_AUTOMOC_MACRO_NAMES.html 7KB CMAKE_DISABLE_FIND_PACKAGE_PackageName.html 7KB CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE.html 7KB CMAKE_NINJA_OUTPUT_PATH_PREFIX.html 7KB CMAKE_AUTOGEN_VERBOSE.html 7KB CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX.html 7KB CMAKE_CURRENT_BINARY_DIR.html 7KB CPACK_INCLUDE_TOPLEVEL_DIRECTORY.html 7KB共 2000 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
