 |
» |
|
|
|
|
|
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.
|
|
