CTestCoverageCollectGCOV¶
This module provides the ctest_coverage_collect_gcov function.
This function runs gcov on all .gcda files found in the binary tree and packages the resulting .gcov files into a tar file. This tarball also contains the following:
- data.json defines the source and build directories for use by CDash.
- Labels.json indicates any
LABELSthat have been set on the source files. - The uncovered directory holds any uncovered files found by
CTEST_EXTRA_COVERAGE_GLOB.
After generating this tar file, it can be sent to CDash for display with the
ctest_submit(CDASH_UPLOAD) command.
-
ctest_coverage_collect_gcov¶ ctest_coverage_collect_gcov(TARBALL <tarfile> [SOURCE <source_dir>][BUILD <build_dir>] [GCOV_COMMAND <gcov_command>] [GCOV_OPTIONS <options>...] )
Run gcov and package a tar file for CDash. The options are:
TARBALL <tarfile>- Specify the location of the
.tarfile to be created for later upload to CDash. Relative paths will be interpreted with respect to the top-level build directory. SOURCE <source_dir>- Specify the top-level source directory for the build.
Default is the value of
CTEST_SOURCE_DIRECTORY. BUILD <build_dir>- Specify the top-level build directory for the build.
Default is the value of
CTEST_BINARY_DIRECTORY. GCOV_COMMAND <gcov_command>- Specify the full path to the
gcovcommand on the machine. Default is the value ofCTEST_COVERAGE_COMMAND. GCOV_OPTIONS <options>...- Specify options to be passed to gcov. The
gcovcommand is run asgcov <options>... -o <gcov-dir> <file>.gcda. If not specified, the default option is just-b -x. GLOB- Recursively search for .gcda files in build_dir rather than determining search locations by reading TargetDirectories.txt.
DELETE- Delete coverage files after they’ve been packaged into the .tar.
QUIET- Suppress non-error messages that otherwise would have been printed out by this function.