1ctest_memcheck
2--------------
3
4Perform the :ref:`CTest MemCheck Step` as a :ref:`Dashboard Client`.
5
6::
7
8  ctest_memcheck([BUILD <build-dir>] [APPEND]
9                 [START <start-number>]
10                 [END <end-number>]
11                 [STRIDE <stride-number>]
12                 [EXCLUDE <exclude-regex>]
13                 [INCLUDE <include-regex>]
14                 [EXCLUDE_LABEL <label-exclude-regex>]
15                 [INCLUDE_LABEL <label-include-regex>]
16                 [EXCLUDE_FIXTURE <regex>]
17                 [EXCLUDE_FIXTURE_SETUP <regex>]
18                 [EXCLUDE_FIXTURE_CLEANUP <regex>]
19                 [PARALLEL_LEVEL <level>]
20                 [RESOURCE_SPEC_FILE <file>]
21                 [TEST_LOAD <threshold>]
22                 [SCHEDULE_RANDOM <ON|OFF>]
23                 [STOP_ON_FAILURE]
24                 [STOP_TIME <time-of-day>]
25                 [RETURN_VALUE <result-var>]
26                 [CAPTURE_CMAKE_ERROR <result-var>]
27                 [REPEAT <mode>:<n>]
28                 [OUTPUT_JUNIT <file>]
29                 [DEFECT_COUNT <defect-count-var>]
30                 [QUIET]
31                 )
32
33
34Run tests with a dynamic analysis tool and store results in
35``MemCheck.xml`` for submission with the :command:`ctest_submit`
36command.
37
38Most options are the same as those for the :command:`ctest_test` command.
39
40The options unique to this command are:
41
42``DEFECT_COUNT <defect-count-var>``
43  .. versionadded:: 3.8
44
45  Store in the ``<defect-count-var>`` the number of defects found.
46