HP DCPI tool

»

DCPI

Site information

» Send us your comments

Installation

» Download DCPI
» Installing DCPI

Product information

» Frequently asked questions
» Documentation
» Publications
customer times newsletter link

dcpicoverage(1)

NAME

dcpicoverage - List an image's unexecuted source lines

SYNOPSIS

dcpicoverage [ -V | -help ] [ -one_line ] [ -no_header ] [image-names...]

DESCRIPTION

Given an image and a profile database, dcpicoverage shows which source lines were not executed.

If one or more image names are specified on the command line, then only the profile files corresponding to the named images are used to generate the output. If no image names are listed on the command line, then dcpicoverage reads all profile files found in the profile database.

For each image, the output listing is ordered by source file and line number. For each procedure, either a list of lines (or ranges of lines) which were not executed or a summary annotation such as "No lines executed" or "All lines executed" is generated. Lines which have only partially executed are annotated with (P). An instance of partial execution is a line containing a "C" language conditional expression using the ternary operator "?:" where one of the two possible paths is never executed. Compiler optimizations may be responsible for others. A summary annotation of "No source file found" is used to denote cases where no line number to source file correlation can be made, as is the case for code inserted into the image by post-compilation tools. Output lines are 132 characters wide by default and wrap as necessary.

Despite the use of control-flow heuristics, dcpicoverage, as a sampling-based tool, is conservative in its identification of those lines which have executed. As a result, it tends to overstate the number of unexecuted lines. This behavior preserves its usefulness as a test coverage analysis tool.

FLAGS

-one_line
Do not wrap output lines. Generate one line of output per procedure. This option may be useful for programs that parse the output of dcpicoverage.

-no_header
Do not print any header in the output. This option may be useful for programs that parse the output of dcpicoverage.

-V
Print version number and exit.

-help
Print a summary of command-line flags.

PROFILE SELECTION FLAGS

By default, this command automatically finds all of the relevant profile files. The following options can be used to guide the search for the profile files.

-db <directory name>
Search for profile files in the specified profile database directory. The directory name should be the same name as the one specified when dcpid was started. If this option is not specified, the directory name is obtained from the DCPIDB environment variable. If neither this option, nor the DCPIDB environment variable are set, the name of the directory used by the last invocation of dcpid on this machine is used. If none of these methods succeed in finding the appropriate directory, and no explicit set of profile files is provided via the -profiles option, then the command fails.

-epoch latest
Search for profile files in the latest epoch. This is the default.

-epoch latest-k
Search for profile files in the "k+1"th oldest epoch. For example, search in the third oldest epoch if -epoch latest-2 is specified.

-epoch <name>
Search for profile files in the named epoch. The epoch name should be the name of a subdirectory corresponding to a single epoch within the profile database directory. Epoch subdirectory names usually take the form YYYYMMDDHHMM (year-month-day-hours-minutes). For example, an epoch started on June 11, 2002 at 22:33 would be named 200206112233. If an epoch is given a symbolic name by creating a symbol link to the actual epoch directory, then the symbolic name can also be used as an argument to the -epoch option.

-epoch all
Search for profile files in all epochs.

-ihost <hostnames...> --

Include just those profile files associated with the specified host names. The list of host names must be terminated either via -- or by the end of the option list. The command prints an error message and fails if both the -ihost and -ehost options are specified.

-ehost <hostnames...> --

Exclude any profile files associated with the specified host names. The list of host names must be terminated either via -- or by the end of the option list. The command prints an error message and fails if both the -ihost and -ehost options are specified.

-label <label>
Search for profile files with the specified label(s) (see dcpilabel(1)). This option can be repeated multiple times. If no labels are specified on the command line, profile file labels are ignored entirely. If any labels are specified on the command line, only profile files that have one of the specified labels are used.

-profiles <file names...> --
Use just the profile files named by the specified file names. The list of profile file names can be terminated either via --, or by the end of the option list. The command prints an error message and fails if the -profiles option is used in conjunction with any of the earlier automatic profile finding options. (Use the automatic profile lookup mechanism, or explicitly name the profile file with the -profile option; but don't do both.)

SEE ALSO

dcpi(1), dcpi2bb(1), dcpi2pix(1), dcpi2ps(1), dcpicalc(1), dcpicat(1), dcpicc(1), dcpictl(1), dcpid(1), dcpidiff(1), dcpidis(1), dcpiepoch(1), dcpiflow(1), dcpiflush(1), dcpikdiff(1), dcpilabel(1), dcpildlatency(1), dcpilist(1), dcpiprof(1), dcpiprofileme(1), dcpiquit(1), dcpiscan(1), dcpisource(1), dcpistats(1), dcpisumxct(1), dcpitar(1), dcpitopcounts(1), dcpitopstalls(1), dcpiuninstall(1), dcpiupcalls(1), dcpivarg(1), dcpivcat(1), dcpiversion(1), dcpivlst(1), dcpivprofiler(1), dcpiwhatcg(1), dcpix(1), dcpiformat(4), dcpiexclusions(4)

For more information, see the DCPI project home page http://h30097.www3.hp.com/dcpi.

COPYRIGHT

Copyright 1996-2004, Hewlett-Packard Company. All rights reserved.