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 compiler wrappers for the current user. When coverage build is enabled, the wrappers pass control to covc. When coverage build is disabled, the wrappers pass control to the real compiler with the same name as the wrapper.

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 wrappers 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: 26 Aug 2025