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

dcpilabel(1)

NAME

dcpilabel - Assign a label to the profiles for a command.

SYNOPSIS

dcpilabel label command...

DESCRIPTION

Dcpilabel starts a new process that runs the specified command. All profiles collected for the new process are assigned the specified label. The assigned labels can be used to distinguish between different runs of the same program. For example, the following two commands will generate two set of profiles labeled "run1" and "run2" respectively.

    dcpilabel run1 sum /usr/dict/words
    dcpilabel run2 sum /etc/services
If "dcpilabel" is invoked several times with the same label, all of the resulting profiles will be aggregated under the specified label.

The -label option can be supplied to the downstream analysis tools to restrict analysis to profiles with the specified label(s). For example, the following command will give a breakdown of the time spent by the first run above within the kernel, the C library, and the application code.

    dcpiprof -i -label run1
Dcpilabel is implemented as a shell script that invokes dcpictl(1) with the label command.

SEE ALSO

dcpi(1), dcpi2bb(1), dcpi2pix(1), dcpi2ps(1), dcpicalc(1), dcpicat(1), dcpicc(1), dcpicoverage(1), dcpictl(1), dcpid(1), dcpidiff(1), dcpidis(1), dcpiepoch(1), dcpiflow(1), dcpiflush(1), dcpikdiff(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.