1PMSETDEBUG(3)              Library Functions Manual              PMSETDEBUG(3)
2
3
4

NAME

6       pmSetDebug, pmClearDebug - manipulate PCP debugging control options
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int pmSetDebug(const char *spec);
12       int pmClearDebug(const char *spec);
13
14       cc ... -lpcp
15

DESCRIPTION

17       Within the libraries and applications of the Performance Co-Pilot (PCP)
18       there is an extensive set of debugging options that may be  enabled  or
19       disabled at run-time.
20
21       Both  pmSetDebug  and pmClearDebug parse spec assuming it to be a comma
22       separated list of PCP debug option names.
23
24       The names of the available options may be found using the  -l  argument
25       to pmdbg(1).
26
27       As a special case, the name ``all'' is treated as a synonym for identi‐
28       fying all option names.
29
30       pmSetDebug will set the corresponding options, while pmClearDebug  will
31       clear the corresponding options.
32
33       Consecutive  calls to either routine will be additive.  For example the
34       following code fragments are equivalent in terms of the final  configu‐
35       ration of the debug options.
36
37            sts = pmClearDebug("all");
38            sts = pmSetDebug("appl0");
39            sts = pmSetDebug("pdu,fetch");
40            sts = pmSetDebug("fetch,profile,context");
41            sts = pmClearDebug("appl0");
42
43            sts = pmClearDebug("all");
44            sts = pmSetDebug("pdu,fetch,profile,context");
45
46       An earlier implementation of the PCP debug facilities used a bit-vector
47       and for backwards compatibility the elements of spec may include  deci‐
48       mal  values  corresponding  to those bit-values.  Refer to pmdbg(1) for
49       more details of this deprecated format.
50

DIAGNOSTICS

52       If successful,  these  routines  return  0,  otherwise  the  return  is
53       PM_ERR_CONV to indicate a parsing error.
54

SEE ALSO

56       pmdbg(1)
57
58
59
60Performance Co-Pilot                  PCP                        PMSETDEBUG(3)
Impressum