 |
» |
|
|
|
dcpictl(1)
NAME
dcpictl - Controls operation of dcpid daemon
SYNOPSIS
dcpictl command
FLAGS
- -q
- Suppresses informational messages from dcpictl.
COMMANDS
- flush
- Flush all unsaved in-memory samples to their associated profiles in the
on-disk profile database. This command is useful for explicitly forcing all
samples to nonvolatile storage.
Samples are normally only saved to disk periodically (for example, 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 200202042334 corresponds to February 4, 2002 at 23:34 GMT (or
February 4,
2002 at 15:34 PST).
- label
- The label command starts a new process that runs the
specified command. All profiles collected for the new process are
assigned the specified label. Assigned labels can be used to
distinguish between different runs of the same program. For example, the
following two commands generate two sets of profiles labeled
"run1" and "run2" respectively:
- dcpictl label run1 sum /usr/dict/words
- dcpictl label 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.
- labelpid
-
Creates labeled profiles for specific process IDs. It takes two parameters, label and
pid.
- 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).
-
DESCRIPTION
The dcpictl command does not
exit until a reply is received from the daemon.
SEE ALSO
dcpi(1),
dcpi2ps(1),
dcpicat(1),
dcpictl(1),
dcpid(1), dcpidiff(1), dcpiformat(4), dcpilist(1),
dcpiprof(1),
dcpitopstalls(1),
dcpiwhatcg(1)
For more information, see the HP Digital Continuous Profiling Infrastructure
project home page
(http://h30097.www3.hp.com/dcpi).
Comments
Last modified: April 8, 2004
|
