pmdbg(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | PCP ENVIRONMENT | COMPATIBILITY | SEE ALSO | COLOPHON

PMDBG(1)                 General Commands Manual                 PMDBG(1)

NAME         top

       pmdbg - report Performance Co-Pilot debug options

SYNOPSIS         top

       pmdbg [-l]

DESCRIPTION         top

       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         top

       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         top

       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         top

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

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨http://www.pcp.io/⟩.  If you have a bug report for this manual
       page, send it to [email protected].  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/performancecopilot/pcp.git⟩ on 2025-08-11.
       (At that time, the date of the most recent commit that was found
       in the repository was 2025-08-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

Performance Co-Pilot               PCP                           PMDBG(1)

Pages that refer to this page: chkhelp(1)collectl2pcp(1)dbpmda(1)ganglia2pcp(1)newhelp(1)pcp(1)pcp2arrow(1)pcp2elasticsearch(1)pcp2graphite(1)pcp2influxdb(1)pcp2json(1)pcp2openmetrics(1)pcp2spark(1)pcp2template(1)pcp2xml(1)pcp2zabbix(1)pcp-atop(1)pcp-atopsar(1)pcpintro(1)pcp-iostat(1)pcp-tapestat(1)pcp-verify(1)pmcd(1)pmcd_wait(1)pmchart(1)pmclient(1)pmdaamdgpu(1)pmdaapache(1)pmdabash(1)pmdabpf(1)pmdacifs(1)pmdacisco(1)pmdadenki(1)pmdadm(1)pmdadocker(1)pmdafarm(1)pmdagfs2(1)pmdahacluster(1)pmdaib(1)pmdajbd2(1)pmdakernel(1)pmdakvm(1)pmdalogger(1)pmdalustrecomm(1)pmdamailq(1)pmdammv(1)pmdamounts(1)pmdanvidia(1)pmdaoverhead(1)pmdapipe(1)pmdapodman(1)pmdaproc(1)pmdaresctrl(1)pmdaroomtemp(1)pmdaroot(1)pmdasample(1)pmdasendmail(1)pmdashping(1)pmdasimple(1)pmdasmart(1)pmdasockets(1)pmdastatsd(1)pmdasummary(1)pmdasystemd(1)pmdatrace(1)pmdatrivial(1)pmdatxmon(1)pmdaweblog(1)pmdaxfs(1)pmdazfs(1)pmdumptext(1)pmfind(1)pmgetopt(1)pmhostname(1)pmie(1)pminfo(1)pmjson(1)pmlc(1)pmlogbasename(1)pmlogcheck(1)pmlogconf(1)pmlogdump(1)pmlogextract(1)pmlogger(1)pmloglabel(1)pmlogmv(1)pmlogpush(1)pmlogredact(1)pmlogreduce(1)pmlogrewrite(1)pmlogsize(1)pmlogsummary(1)pmnsdel(1)pmnsmerge(1)pmpost(1)pmprobe(1)pmproxy(1)pmrep(1)pmrepconf(1)pmsearch(1)pmseries(1)pmstat(1)pmstore(1)pmtime(1)pmval(1)pmview(1)runaspcp(1)__pmcheckattribute(3)__pmcleanmapdir(3)pmda(3)pmdagetoptions(3)pmprintf(3)pmregisterderived(3)pmsetdebug(3)