HP DCPI tool



Site information

» Send us your comments


» Download DCPI
» Installing DCPI

Product information

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



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


dcpilabel label command...


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.


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 1996-2004, Hewlett-Packard Company. All rights reserved.