BullseyeCoverage Up Contents Search

covselect - Select Regions

covselect -a|--add [options] region ...
covselect -d|--deleteAll [options]
covselect -ePath|--export Path [options]
covselect -h|--help [options]
covselect -iPath|--import Path [options]
covselect -l|--list [options]
covselect -r|--remove [options] region ...

Description

covselect adds and removes source region selections (exclusions and inclusions) that are stored in the coverage file. Changes immediately affect covc, the Coverage Browser and reporting commands.

Action -a (--add) adds to the coverage file the specified region selections on the command line. It is strongly recommended to avoid using this action whenever possible and instead use the Coverage Browser to manage exclusions. If you must add exclusions from the command line, use -i (--import) to import exclusions created in the Coverage Browser. If you must use -a (--add), first use the Coverage Browser to create an example exclusion similar to the one desired, then use -l (--list) to see how it is formatted.

Action -d (--deleteAll) removes all region selections from the coverage file. If you specify -v (--verbose), covselect shows the regions, in human-readable format.

Action -e (--export) writes the list of selections in the coverage file to a new plain text file with the specified Path. The list is written in the same format as -l (--list).

Action -h (--help) displays a summary of options.

Action -i (--import) reads the list of selections from the file named by Path and adds them into the coverage file. Selections already in the coverage file are not removed. To replace the selections in the coverage file you must first perform action -d (--deleteAll). The expected file format is that written by action -e (--export) or -l (--list). In the file named by Path, text beginning with the # character up to the end of line is discarded.

Action -l (--list) prints all region selections in the coverage file. If you specify -v (--verbose), covselect shows the regions in a more human-readable format.

Action -r (--remove) removes from the coverage file the specified region selections on the command line. It is strongly recommended to avoid using this action whenever possible and instead use the Coverage Browser to manage exclusions.

Options

`-d`Dir	`--srcdir` Dir	Store source file names relative to source directory Dir rather than relative to the directory where the coverage file is located.
`-f`Path	`--file` Path	The coverage file is specified by Path. The default is `test.cov`.
`-q`	`--quiet`	Suppress warnings and the copyright message.
`-v`	`--verbose`	Show informational messages.
`--no-banner`		Suppress startup banner

Environment Variables

`COVSELECTCFG`	Configuration file. See FILES.
`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/covselect.cfg
home-directory/covselect.cfg

Updated: 7 Nov 2023