4.4 Commands

The code coverage feature comes with a set of commands to aid the collection of coverage, post processing of the collected data, and report generation. Here follows a short summary of the commands, for a more in depth description see the built-in help.

collect-coverage
Start collecting code coverage.
load-coverage
Load a code coverage report.
<code_coverage>.save
Save the current code coverage state into a raw code coverage report.
<code_coverage>.add-report
Load a raw code coverage report into the internal state.
<code_coverage>.add-functions
Add function information to the internal data structures.
<code_coverage>.add-source-info
Builds source line information to the internal data structures.
<code_coverage>.disassemble
Build disassembly information for all mappings that has been found by the code coverage system.
<code_coverage>.stop
Will stop code coverage collection, existing data will be kept in order to support report generation.
<code_coverage>.html-report
Create an HTML code coverage report.
<code_coverage>.lcov-output
Output report in LCOV tracefile format.
<code_coverage>.csv-output
Output report as CSV where each line is on the format:
source file,total executable lines,lines executed
<code_coverage>.add-path-map
Add a path map that will be used when locating binaries and source files while building the code coverage data and report.
<code_coverage>.clear-path-maps
Remove all path maps that has been added with the <code_coverage>.add-path-map command.
<code_coverage>.list-mappings
List all mappings known to the code coverage object.
<code_coverage>.filter-mappings
Filter memory mappings to make it possible to only show some of them in the reports.
<code_coverage>.combine-mappings
Combine mappings in the report that have the same symbol file, but are located at different addresses.