dcpictl - Control operation of dcpid daemon.
dcpictl command
- 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 (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 YYMMDDHHMM format. For example, the epoch 9612042334 corresponds to December 4, 1996 at 23:34 GMT (or December 4, 1996 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).
- 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.)
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.
Dcpictl provides control over the operation of the dcpid(1) daemon. It is structured as a client application that causes a command to be invoked at 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(1), dcpiepoch(1), and dcpiquit(1), commands are invoked synchronously by dcpictl; dcpictl does not exit until a reply is received from the daemon.
dcpi(1), dcpiflow(1), dcpiprof(1), dcpilist(1), dcpidis(1), dcpiscan(1), dcpiepoch(1), dcpiflush(1), dcpicalc(1), dcpilabel(1), dcpi2ps(1), dcpicat(1), dcpiquit(1), dcpidiff(1), dcpitopstalls(1), dcpiwhatcg(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).
This page was generated automatically by mtex software.Carl Waldspurger and Sanjay Ghemawat