BullseyeCoverage Up Contents Search

covmerge - Merge Measurements

covmerge [options] input.cov ...

Description

covmerge combines measurements and metadata in each of the coverage files input.cov into a result coverage file. You can use this command to combine measurements obtained when testing a program on separate computers with separate copies of a coverage file.

You can specify multiple coverage files separated by commas. This allows specifying the value of the COVFILELIST environment variable directly on the command line.

Merging is performed function by function. When data exists for more than one version of a function, only the data for the newest version is kept. Functions are deleted from the coverage information due to the reasons listed below.

The function was deleted from the source code.
The function was modified. A newer version of the function exists, with a different name or body.
The function is conditionally included (with #if) but the function was not built with instrumentation after the source file was modified.

You can specify command line arguments in a file using the syntax @filename.

Options

`-c`	`--create`	Create a new result coverage file rather than merging with the current coverage file.
`-f`Path	`--file` Path	The coverage file is specified by Path. The default is `test.cov`.
`-h`	`--help`	Display a summary of options.
`-q`	`--quiet`	Suppress warnings and the copyright message.
`-v`	`--verbose`	Show progress and informational messages.
`--mp`		Allow creating multiple processes to simultaneously merge coverage files, which can significantly reduce the total time needed. The number of processes created depends on the number of coverage files and the number of processors in the computer.
`--no-banner`		Suppress startup banner

Examples

The command below combines measurements obtained by two different testers into a new a coverage file.

covmerge -c -ftotal.cov cathy.cov paul.cov

The commands below show how you can merge all the files specified by COVFILELIST, in Bourne-compatible shell syntax.

export COVFILELIST=file1.cov,file2.cov,file3.cov
covmerge -c -ftotal $COVFILELIST

Environment Variables

`COVFILE`	The coverage file. Option `-f` (`--file`) overrides this setting.
`COVMERGECFG`	Configuration file. See FILES.

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/covmerge.cfg
home-directory/covmerge.cfg

Updated: 27 Sep 2023