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