pmdbg - Man Page
report Performance Co-Pilot debug options
Synopsis
pmdbg [-l]
Description
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
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
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
PCPIntro(1), PMAPI(3), pmClearDebug(3), pmGetDebug(3), pmGetOptions(3), pmSetDebug(3), pcp.conf(5) and pcp.env(5).
Referenced By
chkhelp(1), collectl2pcp(1), dbpmda(1), ganglia2pcp(1), KERNEL_PMDAS(1), newhelp(1), pcp(1), pcp2arrow(1), pcp2elasticsearch(1), pcp2graphite(1), pcp2influxdb(1), pcp2json(1), pcp2openmetrics(1), pcp2opentelemetry(1), pcp2spark(1), pcp2xml(1), pcp2zabbix(1), pcp-atop(1), pcp-atopsar(1), PCPIntro(1), pcp-tapestat(1), pcp-verify(1), pcp-vmstat(1), pmcd(1), pmcd_wait(1), pmchart(1), __pmCheckAttribute(3), __pmCleanMapDir(3), pmclient(1), PMDA(3), pmdaamdgpu(1), pmdaapache(1), pmdabash(1), pmdabpf(1), pmdacifs(1), pmdacisco(1), pmdadenki(1), pmdadm(1), pmdadocker(1), pmdafarm(1), pmdaGetOpt(3), pmdagfs2(1), pmdahacluster(1), pmdaib(1), pmdajbd2(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), pmiostat(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), pmprintf(3), pmprobe(1), pmproxy(1), pmRegisterDerived(3), pmrep(1), pmrepconf(1), pmsearch(1), pmseries(1), pmSetDebug(3), pmstore(1), pmtime(1), pmval(1), pmview(1), runaspcp(1).