Perform the CTest Test Step as a Dashboard Client.
ctest_test([BUILD <build-dir>] [APPEND] [START <start-number>] [END <end-number>] [STRIDE <stride-number>] [EXCLUDE <exclude-regex>] [INCLUDE <include-regex>] [EXCLUDE_LABEL <label-exclude-regex>] [INCLUDE_LABEL <label-include-regex>] [EXCLUDE_FIXTURE <regex>] [EXCLUDE_FIXTURE_SETUP <regex>] [EXCLUDE_FIXTURE_CLEANUP <regex>] [PARALLEL_LEVEL <level>] [TEST_LOAD <threshold>] [SCHEDULE_RANDOM <ON|OFF>] [STOP_TIME <time-of-day>] [RETURN_VALUE <result-var>] [CAPTURE_CMAKE_ERROR <result-var>] [QUIET] )
Run tests in the project build tree and store results in Test.xml
for submission with the ctest_submit()
command.
The options are:
BUILD <build-dir>
CTEST_BINARY_DIRECTORY
variable is used.APPEND
Test.xml
for append to results previously submitted to a dashboard server since the last ctest_start()
call. Append semantics are defined by the dashboard server in use. This does not cause results to be appended to a .xml
file produced by a previous call to this command.START <start-number>
END <end-number>
STRIDE <stride-number>
EXCLUDE <exclude-regex>
INCLUDE <include-regex>
EXCLUDE_LABEL <label-exclude-regex>
INCLUDE_LABEL <label-include-regex>
EXCLUDE_FIXTURE <regex>
<regex>
. Note that all other fixture behavior is retained, including test dependencies and skipping tests that have fixture setup tests that fail.EXCLUDE_FIXTURE_SETUP <regex>
EXCLUDE_FIXTURE
except only matching setup tests are excluded.EXCLUDE_FIXTURE_CLEANUP <regex>
EXCLUDE_FIXTURE
except only matching cleanup tests are excluded.PARALLEL_LEVEL <level>
TEST_LOAD <threshold>
CTEST_TEST_LOAD
variable will be checked, and then the --test-load
command-line argument to ctest(1)
. See also the TestLoad
setting in the CTest Test Step.SCHEDULE_RANDOM <ON|OFF>
STOP_TIME <time-of-day>
RETURN_VALUE <result-var>
<result-var>
variable 0
if all tests passed. Store non-zero if anything went wrong.CAPTURE_CMAKE_ERROR <result-var>
<result-var>
variable -1 if there are any errors running the command and prevent ctest from returning non-zero if an error occurs.QUIET
QUIET
option.See also the CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE
and CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE
variables.
© 2000–2018 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.12/command/ctest_test.html