PMDBG(1)                   General Commands Manual                  PMDBG(1)

NAME         top

       pmdbg - translate Performance Co-Pilot debug control flags

SYNOPSIS         top

       pmdbg code ...
       pmdbg -l
       pmdbg -D name[,name ...]

DESCRIPTION         top

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

SEE ALSO         top

       PCPIntro(1), pcp.conf(5) and pcp.env(5).

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨git://⟩ on 2017-03-13.  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

Performance Co-Pilot                 PCP                            PMDBG(1)