xenial (1) pmdbg.1.gz

NAME

       pmdbg - translate Performance Co-Pilot debug control flags

SYNOPSIS

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

DESCRIPTION

       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.

PCP ENVIRONMENT

       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

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