BullseyeCoverage Up Contents Search

cov01 - Coverage Build Enable/Disable

cov01 -0|--off [options]
cov01 -1|--on [options]
cov01 -s|--status [options]
cov01 --push [options]
cov01 --pop [options]

Description

cov01 enables, disables, and displays the current status of BullseyeCoverage compiler interceptors for the current user. When coverage build is enabled, compiler interceptors pass control to covc. When coverage build is disabled, compiler interceptors pass control to your compiler with the same name as the compiler interceptor.

Action -0 (--off) disables coverage build. Action -1 (--on) enables coverage build. Action --push saves the current setting. Action --pop restores the most recently pushed setting. When these actions succeed, cov01 normally displays no messages.

Action -s (--status) displays the current coverage build setting. If coverage build is enabled, the active interceptors are listed.

Options

`-h`	`--help`	Display a summary of options.
`-q`	`--quiet`	Suppress warnings and the copyright message.
`-v`	`--verbose`	Show informational messages.
`--no-banner`		Suppress startup banner

Environment Variables

COVAPPDATADIR This environment variable applies to Unix-like systems only and specifies the location for settings and cached information. The default is $HOME/.BullseyeCoverage, or /tmp/BullseyeCoverage if the home directory is not writable.

COVBUILDZONE

Use this environment variable to allow changing the coverage build status without affecting other simultaneous builds done with the same user account on the same computer. BullseyeCoverage stores a separate coverage build status for each unique value of COVBUILDZONE. For example, if you have a session A with COVBUILDZONE=A and a session B with COVBUILDZONE=B, running cov01 in session A does not affect session B.

The recommended method of setting this environment variable is:

set COVBUILDZONE=%RANDOM%      ← Windows
export COVBUILDZONE=$$         ← Unix-like shell

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

Notes

You can change the coverage build setting using the Coverage Browser toolbar command .

In Visual Studio, you can change the coverage build setting using menu command Tools Enable/Disable BullseyeCoverage Build.

Updated: 5 Sep 2024