TCA - Manpage

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

LIMITATIONS

FILES

`tca` - Display coverage analysis reports

SYNOPSIS

    tca [--] [-a[n] |b|f|F|l|o]

         [-rF filename] [-rf funcname]

         [-sxy|-sx] [-c] [-M mapfile]

         [logfile1 [logfile2 ...]]

The tca command produces reports of test coverage information for programs compiled with Insure++. In order to operate successfully, at least two data files must be present when the tca command is executed

"log" file: Contains the results of one ore more test case executions. This file is created during execution and by default has the name "tca.log"
"map" file: Contains a description of the basic blocks, functions and files which make up the application. The file is created during application compilation, usually with the name "tca.map".

Which map file tca uses can be controlled with the -M command line switch. This is usually not necessary, as the log file contains information on how to find the relevant map file.

If several log files are specified, the data is combined before any information is displayed. If there is a conflict between the data stored in the map file and the log file(s), conflicting log file data will be discarded (this will be indicated by an error message). This usually indicates that the respective log file corresponds to an earlier compilation.

If blocks are being displayed, the symbol '!' means "not executed" and the symbol '.' means "executed". This is important for lines which may have multiple blocks on them.

OPTIONS

There are six mutually exclusive display modes, selectable via the following switches (-o is the default):

`-a[n]`	Display uncovered blocks/counts by source file (annotated format). `n` is the indentation level desired - the default is 12 if `-c` is present, otherwise 8.
`-b`	Display a list of all untested blocks together with their source line numbers. If the '`-c`' switch is also specified, all blocks are displayed together with their call counts.
`-f`	Display coverage summarized by function.
`-F`	Display coverage summarized by both file and function name.
`-l`	Display coverage summarized by filename.
`-o`	Summarize coverage data for the entire application. (This is the default)

The following switches may also be used:

`-e`	Unmangle names with extended attributes.
`-m`	Leave C++ names mangled.
`-rf function`	Display summary only for `function` (in mode `-b`).
`-rF filename`	Display summary only for `filename` (modes `-b, -f, -F`).
`-sx\|-sxy`	Sort the output according to the values of the '`x`' and '`y`' key letters. If sorting by either file or function name, but not both, only one key letter is required. If sorting by both file and function name is performed, both '`x`' and '`y`' must be specified, in which case '`x`' refers to the function and '`y`' refers to the filename. Allowed key values are: `c` - sort by percentage covered `n` - sort by file or function `p` - sort by position in file (functions only)
`-c`	Normally data is displayed only for objects which have not been fully covered. With this switch, data is displayed for both tested and untested blocks, or files and functions which have not been fully (100%) tested. This mode also displays how many times each block was executed, if that information was recorded in the log file.
`-M mapfile`	Specify an alternate mapfile name. (Default is read from the log file)
`--`	Display a summary of available command line switches.