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