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

dcpictl(1)

NAME

dcpictl - Control operation of dcpid daemon.

SYNOPSIS

dcpictl command

DESCRIPTION

Dcpictl provides control over the operation of the dcpid(1) daemon. It is structured as a client application that causes a command to be issued to the daemon. The programs dcpiflush(1), dcpiepoch(1), and dcpiquit(1) are now implemented as shell scripts that simply invoke dcpictl with the appropriate options.

In contrast to earlier implementations of dcpiflush, dcpiepoch, and dcpiquit, commands are now invoked synchronously by dcpictl -- dcpictl does not exit until a reply is received from the daemon.

COMMANDS

flush

Flush all unsaved in-memory samples to their associated profiles in the on-disk profile database. This command is useful for immediately forcing all samples to nonvolatile storage.

Samples are normally saved to disk periodically (e.g. every few minutes), or when driver buffer space is running low. The quit and epoch commands also flush all unsaved samples to disk.

epoch

Starts a new profiling epoch after flushing all unsaved in-memory samples to their associated profiles in the on-disk profile database. The flush command can be used to flush unsaved samples without starting a new epoch.

Epochs are designed to capture relatively coarse time intervals measured in minutes. An epoch is represented by a GMT (Greenwich Mean Time) timestamp for the start of the epoch, in YYYYMMDDHHMM format. For example, the epoch 200212042334 corresponds to December 4, 2002 at 23:34 GMT (or December 4, 2002 at 15:34 PST).

quit

Terminates the active dcpid(1) daemon after flushing all unsaved in-memory samples to their associated profiles in the on-disk profile database. The flush command can be used to flush unsaved samples without terminating dcpid(1).

label label command_line

Starts a new process that runs the specified command_line. All profiles collected for the new process are assigned the specified label. See dcpilabel(1).

register pid [start size imageid] image name

Notifies dcpid(1) that the named image is loaded into the process named by pid. If the optional start, size, and imageid parameters are not specified, their values are read from the named image. Start specifies the address at which the text section of the image is mapped into the process. Size is the size of the image text section in bytes. Imageid is the image identifier for the image -- see dcpiscan(1).

This facility is useful only in unusual circumstances: for example, when the image is loaded into the process via mmap instead of by the image loader or the dlopen library call.

SEE ALSO

dcpi(1), dcpi2bb(1), dcpi2pix(1), dcpi2ps(1), dcpicalc(1), dcpicat(1), dcpicc(1), dcpicoverage(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.