pmdbg - Online in the Cloud

PROGRAM:

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

Use pmdbg online using onworks.net services