summaryrefslogtreecommitdiffstats
path: root/Help/command/ctest_test.rst
blob: 5f280838109013cfc16cf332872d503783d6ec6f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
ctest_test
----------

Run tests in the project build tree.

::

  ctest_test([BUILD build_dir] [APPEND]
             [START start number] [END end number]
             [STRIDE stride number] [EXCLUDE exclude regex ]
             [INCLUDE include regex] [RETURN_VALUE res]
             [EXCLUDE_LABEL exclude regex]
             [INCLUDE_LABEL label regex]
             [PARALLEL_LEVEL level]
             [SCHEDULE_RANDOM on]
             [STOP_TIME time of day])

Tests the given build directory and stores results in Test.xml.  The
second argument is a variable that will hold value.  Optionally, you
can specify the starting test number START, the ending test number
END, the number of tests to skip between each test STRIDE, a regular
expression for tests to run INCLUDE, or a regular expression for tests
to not run EXCLUDE.  EXCLUDE_LABEL and INCLUDE_LABEL are regular
expression for test to be included or excluded by the test property
LABEL.  PARALLEL_LEVEL should be set to a positive number representing
the number of tests to be run in parallel.  SCHEDULE_RANDOM will
launch tests in a random order, and is typically used to detect
implicit test dependencies.  STOP_TIME is the time of day at which the
tests should all stop running.

The APPEND option marks results for append to those previously
submitted to a dashboard server since the last ctest_start.  Append
semantics are defined by the dashboard server in use.