| Chapter 13. The exclude Command | ||
|---|---|---|
 | Part III. Command-line Usage |  |
Table of Contents
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.
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.
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. |
| |  | |
| Chapter 12. The rank Command |  | Chapter 14. Reading the Report |