Chapter 13. The exclude Command

Table of Contents

13.1. Usage
13.2. Options

The exclude command allows the user to exclude uncovered coverage points from coverage (effectively turning the uncovered points into covered points) or include coverage points that were previously excluded. Additionally, the exclude command allows the user to specify a reason why the coverage point is being excluded. This capability allows for good documentation of these coverage points for later evaluation and can be output into various report formats to go along with a verification testplan.

13.1. Usage

The exclude command is specified with the given call:

covered [global options] exclude [options] exclusion ID+ CDD file

The exclusion ID information can be obtained via a Covered report command call with the -d (d|v) and -e options. Exclusion IDs consist of an alphanumeric value that will be specified with parenthesis prior to a coverage point.

You may specify one or more exclusion IDs per call to the exclude command. If the -m option is specified, a prompt will be specified for each exclusion ID, individually. If a coverage point is currently included in the CDD prior to an exclude call, the coverage point will be toggled to be excluded and a user message can be attached to the coverage point, specifying the reason for exclusion. If a coverage point is currently excluded in the CDD prior to an exclude call, the coverage point will be toggled to be included and any previouly assigned user message will be forgotten.

13.2. Options

Table 13.1. Options to the exclude command

Option Description
-f filename Allows the user to specify a file that contains additional exclude command options to parse. This option may be specified more than once for a single call to the exclude command.
-h Displays help information for the exclude command.
-m Allows a user message specifying the reason for excluding any coverage points being excluded on the command-line. An interactive prompt will be specified in the shell. Simply enter your reason at the prompt, hit return and specify a single period (.) character followed by a return to end the user input for a coverage point. You may use as many lines of text that you would like; however, all formatting characters (i.e., newlines, tabs, extra spaces, etc.) will be removed when reporting the information.
-p Outputs the current exclusion status of the specified exclusion ID(s) and displays any exclusion reason messages associated with the specified exclusion ID(s) to standard output.