PMDBG

Section: User Commands (1)
Index Return to Main Contents

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


Index

NAME
SYNOPSIS
DESCRIPTION
PCP ENVIRONMENT
SEE ALSO