NAME | SYNOPSIS | DESCRIPTION | PCP ENVIRONMENT | COMPATIBILITY | SEE ALSO | COLOPHON |
|
|
PMDBG(1) General Commands Manual PMDBG(1)
pmdbg - report Performance Co-Pilot debug options
pmdbg [-l]
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.
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).
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 │ └───────────────────────┴────────────┴────────────┴─────────────┘
PCPIntro(1), PMAPI(3), pmClearDebug(3), pmGetDebug(3), pmGetOptions(3), pmSetDebug(3), pcp.conf(5) and pcp.env(5).
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)