|
NAME | SYNOPSIS | DESCRIPTION | PCP ENVIRONMENT | SEE ALSO | COLOPHON |
PMDBG(1) General Commands Manual PMDBG(1)
pmdbg - translate Performance Co-Pilot debug control flags
pmdbg code ...
pmdbg -l
pmdbg -D name[,name ...]
The components of the Performance Co-Pilot (PCP) use a global vector
of bit-fields to control diagnostic and debug output.
pmdbg with a -l argument prints out the mnemonic and decimal values
of all the bit-fields in the debug control vector.
pmdbg with a -D argument parses the list of names(s) using
__pmParseDebug(3) and reports the corresponding decimal value. This
is most useful when debugging and wanting to set the internal value
of the control vector (pmDebug) via a debugger, e.g. gdb(1).
In the alternative usage, the code arguments are values for the debug
vector, and the bit-fields that are enabled by each of these values
is listed.
Each code may be an integer, a hexadecimal value or a hexadecimal
value prefixed by either ``0x'' or ``0X''.
Most applications using the facilities of the PCP support a -DN
command-line syntax to enable debug control. pmdbg is designed to
help choose an appropriate value for N.
Alternatively the initial value of the debug control flags may be set
to a value N using the environment variable $PCP_DEBUG. If both
mechanisms are used the effect is additive, so the resultant flags
are those set via $PCP_DEBUG combined with those set via any -D
command line options.
Environment variables with the prefix PCP_ are used to parameterize
the file and directory names used by PCP. On each installation, the
file /etc/pcp.conf contains the local values for these variables.
The $PCP_CONF variable may be used to specify an alternative
configuration file, as described in pcp.conf(5).
PCPIntro(1), pcp.conf(5) and pcp.env(5).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at ⟨http://www.pcp.io/⟩.
If you have a bug report for this manual page, send it to
pcp@oss.sgi.com. This page was obtained from the project's upstream
Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05. If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
Performance Co-Pilot PCP PMDBG(1)
Pages that refer to this page: dbpmda(1), pcpintro(1), pmcd(1), pmdaib(1), pmproxy(1), pmda(3), pmdagetoptions(3), pmparsedebug(3), pmprintf(3)