BullseyeCoverage Up Contents Search

covhtml - Create HTML Report

covhtml [options] directory

Description

Creates an HTML presentation of all the data in a coverage file, providing a navigatable view similar to that shown by the Coverage Browser. covhtml creates directory if it does not exist. The main page is directory/index.html.

This command searches for source files in the directories maintained by the Coverage Browser menu commands Region Locate Source and Region Source Locations. If covhtml cannot find a source file, a message is written to the standard error and the resulting HTML contains no annotated source level information for that source file.

The file directory/map.txt contains a mapping of each region to an HTML file.

Options

`-a`	`--allNum`	Show all numbers. In addition to the uncovered events, show the total possible events and the covered events.
`-d`Dir	`--srcdir` Dir	Look for source files relative to directory Dir rather than relative to the directory where the coverage file is located.
`-e`N	`--tab` N	Expand tabs to every Nth column. The default is N=8.
`-f`Path	`--file` Path	The coverage file is specified by Path. The default is `test.cov`.
`-h`	`--help`	Display a summary of options.
`-n`	`--no-annotate`	Omit annotated source files.
`-q`	`--quiet`	Suppress warnings and the copyright message.
`-v`	`--verbose`	Show progress and informational messages.
`--decision`		Show decision coverage rather than condition/decision coverage. This option is not recommended; decision coverage may report uncovered code as covered. Use this option only to compare results with other projects or other tools which cannot provide condition/decision coverage.
`--no-banner`		Suppress startup banner

Environment Variables

`COVFILE`	The coverage file. Option `-f` (`--file`) overrides this setting.
`COVSRCDIR`	The source file directory. Option `-d` (`--srcdir`) overrides this setting.

Files

If the files listed below exist, they contain initial options separated by white space. Within these files, $NAME is replaced by the value of the environment variable named NAME.

BullseyeCoverage/bin/covhtml.cfg
home-directory/covhtml.cfg

Notes

On Windows, you may see a significant performance improvement if the output directory of this command is excluded from malware scanning. In particular, Windows Real-time protection is known to greatly impact the performance of this command.

Updated: 20 Mar 2024