This is a read-only copy of the MariaDB Knowledgebase generated on 2024-11-14. For the latest, interactive version please visit https://mariadb.com/kb/.

Code Coverage with dgcov

The dgcov tool helps you check the coverage for new code. The dgcov.pl script is part of the mariadb-test framework (and any packages that include mariadb-test).

Overview

The dgcov program runs gcov for code coverage analysis, aggregates the coverage data, and (optionally) reports coverage only for those lines that are changed by the commit(s). Commits are specified in the git diff format.

If no commits are specified, the default is to work on all uncommitted changes, if any, otherwise on the last commit (in other words, on git diff HEAD or git diff HEAD^).

It's recommended that a developer runs dgcov on their new code before pushing it into a MariaDB repository.

Usage

./dgcov.pl --help
./dgcov.pl [options] [<commit> [<commit>]]

Options and Variables

Short OptionLong OptionDescription
-h--helpPrint help and exit
-v--verboseShow commands run.
-p--purgeDelete all test coverage information, to prepare for a new coverage test.
-o--only-gcovStop after running gcov, don't run git
-s--skip-gcovDo not run gcov, assume .gcov files are already in place
-g--generateCreate .dgcov files for all source files

How to Prepare the Code for dgcov

Prior to running this tool, MariaDB should be built with

  cmake -DENABLE_GCOV=ON

and the testsuite should be run. dgcov will report the coverage for all lines modified in the specified commits.

Output

Output .dgcov files have a conventional gcov format: lines not covered are prefixed with #####, lines without generated code are prefixed with -, and other lines are prefixed with the number of times they were executed. See info gcov for more information.

The patch-like coverage for commits uses gcov format (as above) for lines, changed in these commits, and no prefix at all for lines that were not changed.

Examples

Checking the coverage for all unpushed commits:

dgcov.pl @{u} HEAD

Checking the coverate for all uncommitted changes:

dgcov.pl HEAD

Checking the coverage for a specific commit 1234567:

dgcov.pl 1234567^ 1234567

mariadb-test-run can invoke dgcov automatically:

./mtr --gcov

in the latter case the coverate for the uncommitted changes (or the last commit) will be not printed to the stdout, but will be put into var/last_changes.dgcov file.

Caveats

Note that to be able to run gcov with the mariadb-test framework you need to have gcc version 4.8 or newer.

References

  • dgcov was created by Kristian Nielsen and was first announced here.
  • dgcov was re-implemented to aggregate the data and to work for git and cmake by Sergei Golubchik.
Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.