BullseyeCoverage Up Contents Search

covmgr - Coverage File Manager

covmgr -h|--help
covmgr -dDir|--srcdir Dir
covmgr -l|--list [options]
covmgr -m|--compact [options]
covmgr -n|--version [options]
covmgr -o|--copy [options] destination
covmgr -p|--properties [options]
covmgr -r|--remove [options] object ...
covmgr -s|--rmsub
covmgr -t|--comment [options] [comment]
covmgr -u|--lssub

Description

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

Action -dDir (--srcdir Dir) creates a new coverage file with the specified source directory. The default setting is the directory where the coverage file is located.

Action -l (--list) displays a list of the filenames stored in the coverage file, one per line. The list shows each object file followed by its constituent header and source files. Option -v (--verbose) shows column headings and the following additional information. For objects, the internal identifier number and the compile time are shown. For sources, the number of probes and the file modification time are shown. File paths are not adjusted for the location of the coverage file.

Action -m (--compact) reads and rewrites the coverage file to remove unused space and convert the file to the latest format. This action repairs some of the data file structure. Usually this operation makes the file slightly smaller, but not always.

Action -n (--version) prints the startup banner only, regardless of options.

Action -o (--copy) copies the coverage file to the destination filename specified. The coverage file is locked for exclusive access during the copy operation, ensuring data consistency of the copy.

Action -p (--properties) displays information from the coverage file in the form shown below. The file-id uniquely identifies the coverage file. The build-id identifies the last change made as a result of building, including the time of the last change.

File-id: file-id
Build-id: build-id
name1=value1
name2=value2
…

Action -r (--remove) deletes object file entries from the coverage file. Rather than use this action, it is recommended to to delete source file entries using the Coverage Browser menu command Region Delete. To exclude code without deleting it, see Excluding Code.

Action -s (--rmsub) removes from the coverage file any directory substitutions introduced by the Coverage Browser command Region Locate Source.

Action -t (--comment) displays or stores user-defined text in the coverage file. This information is displayed by action -p (--properties).

Action -u (--lssub) lists the directory substitutions introduced by the Coverage Browser command Region Locate Source.

Options

`-c`	`--create`	Create the coverage file if it does not exist.
`-d`Dir	`--srcdir` Dir	Source file names are relative to Dir rather than relative to the directory where the coverage file is located.
`-f`Path	`--file` Path	The result 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
`--function`		Also list functions. This option only takes affect with `-l`/`--list`

Environment Variables

`COVFILE`	The coverage file. Option `-f` (`--file`) overrides this setting.
`COVSRCDIR`	The source file directory. Option `-d` (`--srcdir`) overrides this setting.
`COVMGRCFG`	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/covmgr.cfg
home-directory/covmgr.cfg

Updated: 6 Apr 2021