HP DCPI tool

dcpiexclusions(4)

NAME

dcpiexclusions - DCPI DADD mode exclusions file format.

DESCRIPTION

The dcpiexclusions file allows administrators who are running DCPI in DADD mode to specify images and/or processes for which no samples are to be collected. It is provided as a means to deal with memory consumption problems arising from the need for the daemon to collect and retain samples for long-running processes which may be of no interest to the DADD user. The dcpiexclusions file is named "dcpiexclusions" and is stored in the /usr/lib/dcpi directory. The syntax used to specify exclusions is as follows:

• To exclude an image, add a line containing the "short name" of the image to the dcpiexclusions file.

• To exclude a process, add a line such as:

  PID xxxx

  where xxxx is the ID of the process to be excluded.

• To exclude a range of processes, add a line such as:

  PID xxxx-yyyy

  where xxxx and yyyy are process IDs.

• Lines beginning with a # are treated as comments.

DCPI/DADD is distributed with an initial dcpiexclusions file in /usr/lib/dcpi. The distributed file contains one line with an entry indicating that no samples should be collected for the DCPI daemon, dcpid. Exclusions should be used carefully since it is possible to exclude processes or images for which performance information is needed. The dcpiexclusions file has no effect when DCPI is not run in DADD mode.

SEE ALSO

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

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.