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 structured as a client application that sends a message to the dcpid(1) daemon.

SEE ALSO

dcpi(1), dcpiflow(1), dcpiprof(1), dcpilist(1), dcpidis(1), dcpiscan(1), dcpiepoch(1), dcpiflush(1), dcpicalc(1), dcpi2ps(1), dcpicat(1), dcpiquit(1), dcpidiff(1), dcpitopstalls(1), dcpiwhatcg(1), dcpictl(1), dcpisource(1), dcpicc(1), dcpiversion(1), dcpiuninstall(1), dcpi2pix(1), dcpikdiff(1), dcpix(1), dcpisumxct(1), dcpistats(1), dcpid(1), dcpiformat(4), dcpiloader(5)

For more information, see the DIGITAL Continuous Profiling Infrastructure project home page (http://www.research.digital.com/SRC/dcpi/ from outside DIGITAL).

COPYRIGHT

Copyright 1996-97, Digital Equipment Corporation.

AUTHOR

Sanjay Ghemawat