.. 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.19.1-win64-x64.msi 2020年12月1日 最新版 (6368个子文件)
ctest.1 70KB
cmake.1 41KB
cpack.1 10KB
cmake-gui.1 7KB
cmake-modules.7 719KB
cmake-commands.7 442KB
cmake-properties.7 326KB
cmake-variables.7 256KB
cmake-policies.7 171KB
cpack-generators.7 127KB
cmake-file-api.7 44KB
cmake-buildsystem.7 41KB
cmake-generator-expressions.7 37KB
cmake-generators.7 33KB
cmake-packages.7 30KB
cmake-env-variables.7 27KB
cmake-toolchains.7 26KB
cmake-server.7 26KB
cmake-language.7 21KB
cmake-presets.7 18KB
cmake-developer.7 17KB
cmake-compile-features.7 15KB
cmake-qt.7 11KB
Squish4RunTestCase.bat 648B
SquishRunTestCase.bat 219B
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
mymodule_.c 28B
MY_MODULE.c 28B
MYMODULE.c 27B
Support.cmake 159KB
ExternalProject.cmake 133KB
FindBoost.cmake 114KB
FindMPI.cmake 89KB
FindCUDA.cmake 87KB
CPackRPM.cmake 79KB
FindMatlab.cmake 64KB
FindQt4.cmake 54KB
UseJava.cmake 53KB
FetchContent.cmake 48KB
FindHDF5.cmake 46KB
FindwxWidgets.cmake 44KB
CMakeDetermineCompilerId.cmake 44KB
ExternalData.cmake 43KB
FindDoxygen.cmake 42KB
BundleUtilities.cmake 42KB
UseSWIG.cmake 38KB
FindGTK2.cmake 37KB
FindX11.cmake 35KB
CPack.cmake 35KB
GetPrerequisites.cmake 34KB
CPackDeb.cmake 34KB
FindPkgConfig.cmake 33KB
FindCUDAToolkit.cmake 32KB
InstallRequiredSystemLibraries.cmake 30KB
FindBLAS.cmake 29KB
FeatureSummary.cmake 28KB
CMakeDetermineCUDACompiler.cmake 28KB
WriteCompilerDetectionHeader.cmake 27KB
CPackIFW.cmake 26KB
FindOpenMP.cmake 25KB
FindwxWindows.cmake 25KB
FindIce.cmake 24KB
FindProtobuf.cmake 24KB
GoogleTest.cmake 23KB
FindOpenSSL.cmake 23KB
FindPackageHandleStandardArgs.cmake 23KB
Android-Determine.cmake 22KB
CPackComponent.cmake 21KB
FindOpenGL.cmake 20KB
Qt4Macros.cmake 19KB
Windows-MSVC.cmake 19KB
FindPython.cmake 19KB
FindRuby.cmake 18KB
FindLAPACK.cmake 16KB
FindPythonLibs.cmake 16KB
FindICU.cmake 15KB
GNUInstallDirs.cmake 15KB
GenerateExportHeader.cmake 15KB
FindPython3.cmake 15KB
CPackNuGet.cmake 14KB
FortranCInterface.cmake 14KB
CMakePackageConfigHelpers.cmake 14KB
FindJNI.cmake 14KB
Determine-Compiler-NDK.cmake 13KB
DeployQt4.cmake 13KB
FindPython2.cmake 13KB
FindJava.cmake 13KB
KDE3Macros.cmake 13KB
FindSDL_sound.cmake 13KB
共 6368 条
- 1
- 2
- 3
- 4
- 5
- 6
- 64
资源评论
- Ben82882021-01-28不是msi是压缩包
小菜同学
- 粉丝: 5
- 资源: 16
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功