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.