|
HTML rendering created 2026-09-09 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
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 pcp@groups.io. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2026-08-04.
(At that time, the date of the most recent commit that was found
in the repository was 2026-08-04.) 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
man-pages@man7.org
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), pcp2opentelemetry(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), pmdabtrfs(1), pmdacifs(1), pmdacisco(1), pmdadarwin(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), pmdaopentelemetry(1), pmdaoverhead(1), pmdapipe(1), pmdapodman(1), pmdaproc(1), pmdaresctrl(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)
|
HTML rendering created 2026-09-09 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|