dcpictl - Control operation of dcpid daemon.
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
and dcpiquit(1) are now
implemented as shell scripts that simply invoke dcpictl with the
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.
- 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.
- 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).
- 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
- label label command_line
- Starts a
for the new
- 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.
For more information, see the DCPI project home page
Hewlett-Packard Company. All rights reserved.