.. 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.6-win64-x64.zip
共2000个文件
txt:1282个
html:718个
需积分: 1 0 下载量 196 浏览量
2024-02-04
23:59:58
上传
评论
收藏 34.47MB ZIP 举报
温馨提示
cmake安装包
资源推荐
资源详情
资源评论
收起资源包目录
cmake-3.19.6-win64-x64.zip (2000个子文件)
genindex.html 2.06MB
ctest.1.html 186KB
cmake-buildsystem.7.html 150KB
index.html 142KB
cmake-generator-expressions.7.html 125KB
cmake-file-api.7.html 107KB
index.html 107KB
cmake-variables.7.html 96KB
cmake.1.html 95KB
cmake-toolchains.7.html 88KB
cmake-packages.7.html 85KB
rpm.html 84KB
index.html 74KB
cmake-properties.7.html 72KB
cmake-language.7.html 61KB
deb.html 56KB
cmake-qt.7.html 48KB
cmake-compile-features.7.html 47KB
cmake-server.7.html 46KB
cmake-developer.7.html 40KB
cmake-policies.7.html 40KB
cmake-presets.7.html 39KB
cmake-modules.7.html 38KB
ifw.html 37KB
external.html 36KB
ccmake.1.html 28KB
cpack.1.html 28KB
index.html 27KB
nuget.html 24KB
wix.html 23KB
cmake-commands.7.html 21KB
cmake-gui.1.html 19KB
nsis.html 19KB
FIXTURES_REQUIRED.html 18KB
index.html 18KB
freebsd.html 18KB
productbuild.html 17KB
cmake-generators.7.html 15KB
dmg.html 15KB
cmake-env-variables.7.html 14KB
archive.html 13KB
CMAKE_GENERATOR_TOOLSET.html 13KB
packagemaker.html 13KB
CMAKE_SYSTEM_PREFIX_PATH.html 13KB
CMAKE_MAKE_PROGRAM.html 12KB
RESOURCE_GROUPS.html 11KB
CMAKE_FIND_USE_PACKAGE_REGISTRY.html 11KB
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY.html 11KB
CMAKE_MESSAGE_CONTEXT.html 11KB
CMAKE_POLICY_WARNING_CMPNNNN.html 11KB
bundle.html 11KB
CMAKE_MSVC_RUNTIME_LIBRARY.html 10KB
CTEST_COVERAGE_COMMAND.html 10KB
CMAKE_VERSION.html 10KB
INCLUDE_DIRECTORIES.html 10KB
CMAKE_LANG_LINKER_WRAPPER_FLAG.html 10KB
CMAKE_MAXIMUM_RECURSION_DEPTH.html 10KB
CMAKE_FIND_USE_PACKAGE_ROOT_PATH.html 10KB
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH.html 10KB
CMAKE_DEFAULT_CONFIGS.html 10KB
CMAKE_FIND_USE_CMAKE_PATH.html 10KB
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH.html 9KB
CMAKE_GLOBAL_AUTOGEN_TARGET.html 9KB
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH.html 9KB
TIMEOUT_AFTER_MATCH.html 9KB
CMAKE_PROJECT_HOMEPAGE_URL.html 9KB
CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY.html 9KB
CMAKE_INSTALL_PREFIX.html 9KB
CMAKE_PROJECT_DESCRIPTION.html 9KB
FIXTURES_SETUP.html 9KB
COMPILE_DEFINITIONS.html 9KB
CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY.html 9KB
CMAKE_PROJECT_VERSION.html 9KB
CMAKE_CROSSCOMPILING.html 9KB
CMAKE_CURRENT_FUNCTION_LIST_DIR.html 9KB
FIXTURES_CLEANUP.html 9KB
CMAKE_HOST_SYSTEM_PROCESSOR.html 9KB
CMAKE_DEBUG_TARGET_PROPERTIES.html 9KB
CMAKE_CFG_INTDIR.html 9KB
CPACK_SET_DESTDIR.html 9KB
CMAKE_GENERATOR_PLATFORM.html 9KB
CMAKE_PREFIX_PATH.html 9KB
REQUIRED_FILES.html 8KB
CMAKE_SYSTEM_IGNORE_PATH.html 8KB
CMAKE_CUDA_RUNTIME_LIBRARY.html 8KB
CMAKE_USER_MAKE_RULES_OVERRIDE.html 8KB
CMAKE_EXPORT_COMPILE_COMMANDS.html 8KB
CMAKE_PROJECT_NAME.html 8KB
CMAKE_IGNORE_PATH.html 8KB
CMAKE_CUDA_HOST_COMPILER.html 8KB
CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS.html 8KB
CMAKE_FIND_PACKAGE_WARN_NO_MODULE.html 8KB
CMAKE_FIND_NO_INSTALL_PREFIX.html 8KB
CMAKE_FIND_PACKAGE_PREFER_CONFIG.html 8KB
CMAKE_SYSTEM_VERSION.html 8KB
CMAKE_FIND_PACKAGE_SORT_ORDER.html 8KB
CMAKE_ANDROID_STL_TYPE.html 8KB
CMAKE_TRY_COMPILE_PLATFORM_VARIABLES.html 8KB
CMAKE_BUILD_TYPE.html 8KB
CMAKE_GLOBAL_AUTORCC_TARGET.html 8KB
共 2000 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
程序员Chino的日记
- 粉丝: 2876
- 资源: 4万+
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- 实验二:IP协议分析.zip
- 驱动代码驱动代码驱动代码驱动代码
- SVID_20240523_141155_1.mp4
- Code for the complete guide to tkinter tutorial
- 关于百货中心供应链管理系统.zip
- SimpleFolderIcon-master 修改Unity的Project下的文件夹图标
- A python Tkinter widget to display tile based maps
- A pure Python library for adding tables to a Tkinter application
- Vector资源文件.zip
- MobaXterm-Installer
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功