PMDBG(1)

NAME
pmdbg - report Performance Co-Pilot debug options

SYNOPSIS
pmdbg [-l]

DESCRIPTION
The components of the Performance Co-Pilot (PCP) use a global mechanism to control diagnostic and debug output.

pmdbg prints out all the available debug options with the name of the option and some descriptive text.

The -l option does nothing, but is included for backwards compatibility with older versions of pmdbg.

Most applications using the facilities of the PCP support a -D name[,name ...] command-line syntax to enable debug control using the name(s) of the desired debug options.

Alternatively the initial value of the debug control flags may be set to a comma-separated list if option name(s) using the environment variable $PCP_DEBUG, provided the applications use pmGetOptions(3) to process command line options and arguments. 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).

COMPATIBILITY
Prior to PCP 7.0 debug options were maintained in a dual state with an old-style binary encoded integer (plus macro name for programmers), and a new-style character string name for each debug option.

In PCP 7.0 support for the the old-style was dropped.

The table below documents the equivalence for those debugging options that appeared in both the the old and the new styles.
Old Style | New Style
Symbolic Name | Mask | Value | Name
DBG_TRACE_PDU | 0x00000001 | 1 | pdu
DBG_TRACE_FETCH | 0x00000002 | 2 | fetch
DBG_TRACE_PROFILE | 0x00000004 | 4 | profile
DBG_TRACE_VALUE | 0x00000008 | 8 | value
DBG_TRACE_CONTEXT | 0x00000010 | 16 | context
DBG_TRACE_INDOM | 0x00000020 | 32 | indom
DBG_TRACE_PDUBUF | 0x00000040 | 64 | pdubuf
DBG_TRACE_LOG | 0x00000080 | 128 | log
DBG_TRACE_LOGMETA | 0x00000100 | 256 | logmeta
DBG_TRACE_OPTFETCH | 0x00000200 | 512 | optfetch
DBG_TRACE_AF | 0x00000400 | 1024 | af
DBG_TRACE_APPL0 | 0x00000800 | 2048 | appl0
DBG_TRACE_APPL1 | 0x00001000 | 4096 | appl1
DBG_TRACE_APPL2 | 0x00002000 | 8192 | appl2
DBG_TRACE_PMNS | 0x00004000 | 16384 | pmns
DBG_TRACE_LIBPMDA | 0x00008000 | 32768 | libpmda
DBG_TRACE_TIMECONTROL | 0x00001000 | 65536 | timecontrol
DBG_TRACE_PMC | 0x00002000 | 131072 | pmc
DBG_TRACE_DERIVE | 0x00004000 | 262144 | derive
DBG_TRACE_LOCK | 0x00008000 | 524288 | lock
DBG_TRACE_INTERP | 0x00010000 | 1048576 | interp
DBG_TRACE_CONFIG | 0x00020000 | 2097152 | config
DBG_TRACE_PMAPI | 0x00040000 | 4194304 | pmapi
DBG_TRACE_FAULT | 0x00080000 | 8388608 | fault
DBG_TRACE_AUTH | 0x00100000 | 16777216 | auth
DBG_TRACE_DISCOVERY | 0x00200000 | 33554432 | discovery
DBG_TRACE_ATTR | 0x00400000 | 67108864 | attr
DBG_TRACE_HTTP | 0x00800000 | 134217728 | http
DBG_TRACE_DESPERATE | 0x04000000 | 1073741824 | desperate

SEE ALSO
PCPIntro(1), PMAPI(3), pmClearDebug(3), pmGetDebug(3), pmGetOptions(3), pmSetDebug(3), pcp.conf(5) and pcp.env(5).