|
| -a
| Display all unexecuted code even if not covered by a weaker measure. All measures
are considered equal except that function entry is weaker than all others; all
are weaker than decision except c-use and p-use; and all are weaker than c-use and
p-use. By default, only code whose components are covered by a weaker measure
are displayed. (For example, an unexecuted block is not displayed if the function
containing that block was never entered.)
|
|
| -c test-name
|
|
|
| Present a comparison of coverage with that of named test cases. Code is considered
covered only if it is not also covered by the named test cases. Wild cards may
be used in the test case name. On UNIX, wild cards are the same as those used for
file names by sh (*, ?, and [...]). Quote marks may be needed to prevent the
shell from expanding the test name as file names. Multiple test-cases may also be
specified by repeating the -c option.
|
|
| -C
| Present execution counts.
|
|
| -D
| Generate debugging output.
|
|
| -f
| Present coverage summary on a per function basis
(implies -s).
|
|
| -F function
|
|
|
| Present coverage for C subroutine named function. Wild cards may be used in the
function name (see -c option). Multiple functions may also be specified by repeating
the -F option.
|
|
| -g
| Present coverage summary on a per source file basis (implies -s).
|
|
| -h
| Suppress column headings (used with -s, and -C).
|
|
| -K
| Include test cost in coverage summary (implies -s and -p).
|
|
| -i
| Ignore time stamps on source files and .atac files. By default, atac issues an error
if source files have been
modified since execution of a test represented in the .trace file.
| |
|
| -I
| Include code ATAC considers unreachable. By default, this code is not counted
nor highlighted in displays.
|
|
| -J
| Include code embedded in a preprocessor macro expansion. By default, this code
is not counted nor highlighted in displays.
|
|
| -m{bBcdefIJprRTuUY}...
|
|
|
| Specifies the coverage measures to be used:
|
|
|
| b
| Block - code fragments not containing control flow branching or function calls.
|
|
|
| B
| Basic Block - code fragments not containing control flow branching.
|
|
|
| c
| C-use - (computational use) pairs of blocks for which the first block contains an
assignment to a variable and the second block contains a use of that variable in a
computation.
|
|
|
| d
| Decision - pairs of blocks for which the first block ends at a control flow branch
and the second block is a target of one of these branches.
|
|
|
| e
| Function entry - covered when the function is entered at least once.
|
|
|
| f
| Function call - individual function calls.
|
|
|
| Ffunction
|
|
|
|
| Named function call - function calls
matching function. Wild cards may be used
in the function name (see -c option). Multiple test cases may
also be specified by repeating the -mF option.
|
|
|
| I
| Infeasible code - code ATAC considers unreachable.
|
|
|
| J
| Macro internals - code embedded in a preprocessor macro expansion.
|
|
|
| p
| P-use - (predicate use) triples of blocks for which the first block contains an assignment
to a variable, the second block ends at a control flow branch based on a
predicate containing that variable, and the third block is a target of one of these
branches.
|
|
|
| r
| Return - explicit or implicit function return or call to _exit, _longjmp, abort, exit,
longjmp, siglongjmp, if available.
|
|
|
| R
| Not reached - code marked with /*NOTREACHED*/.
|
|
|
| T
| Not tested - code marked with /*NOTTESTED:reason*/.
|
|
|
| u
| All-uses - sum of p-use and c-use.
|
|
|
| U
| Not instrumented - uninstrumented code (not normally present).
|
|
|
| Y
| Performance critical - code marked with /*TIMECRITICAL*/.
|
|
|
| -M
| Present a minimal cost set of test cases that achieves the same coverage, for the
specified coverage measure, as all cases together (implies -s and -p).
|
|
| -n test-name
|
|
|
| Present coverage for named test cases only. (See also -x option.) Wild cards may
be used in the function name (see -c option). Multiple test cases may also be specified
by repeating the -n option.
|
|
| -p
| Present coverage summary on a per test case basis (implies -s).
|
|
| -q
| Present cumulative coverage per test case (implies -s and -p).
|
|
| -Q
| Sort test cases in order of increasing cost per additional coverage. Present cumulative
coverage per test case. Include test cost in coverage summary. Same as
-qSK (implies -s and -p).
|
|
| -r
| Reverse the display criteria; display only covered code.
|
|
| -R
| Include code marked with /*NOTREACHED*/. By default, this code is not counted
nor highlighted in displays.
|
|
| -s
| Present coverage summary.
|
|
| -S
| Sort test cases in
order of decreasing additional coverage per unit cost (implies -s and -p).
|
|
| -t
| Present coverage summary on a per test case basis - non zero only.
|
|
| -T
| Include code marked with /*NOTTESTED:reason*/. By default, this code is not
counted nor highlighted in displays.
|
|
| -u
| Use underscoring instead of other standout mode for source code highlighting.
|
|
| -U
| Include uninstrumented code. In unusual situations some code may not be instrumented.
By default, this code is not counted nor highlighted in displays.
|
|
| -v
| Display Toolsuite release number.
|
|
| -x
| Exclude test cases specified by -c and -n options. Include all unspecified test cases.
|
|
| -Y
| Exclude code marked /*TIMECRITICAL*/. This code is not instrumented so that
instrumentation will not interfere with performance. By default, this code is counted
as not covered and highlighted in displays.
|