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 StyleNew Style
Symbolic NameMaskValueName
DBG_TRACE_PDU0x000000011pdu
DBG_TRACE_FETCH0x000000022fetch
DBG_TRACE_PROFILE0x000000044profile
DBG_TRACE_VALUE0x000000088value
DBG_TRACE_CONTEXT0x0000001016context
DBG_TRACE_INDOM0x0000002032indom
DBG_TRACE_PDUBUF0x0000004064pdubuf
DBG_TRACE_LOG0x00000080128log
DBG_TRACE_LOGMETA0x00000100256logmeta
DBG_TRACE_OPTFETCH0x00000200512optfetch
DBG_TRACE_AF0x000004001024af
DBG_TRACE_APPL00x000008002048appl0
DBG_TRACE_APPL10x000010004096appl1
DBG_TRACE_APPL20x000020008192appl2
DBG_TRACE_PMNS0x0000400016384pmns
DBG_TRACE_LIBPMDA0x0000800032768libpmda
DBG_TRACE_TIMECONTROL0x0000100065536timecontrol
DBG_TRACE_PMC0x00002000131072pmc
DBG_TRACE_DERIVE0x00004000262144derive
DBG_TRACE_LOCK0x00008000524288lock
DBG_TRACE_INTERP0x000100001048576interp
DBG_TRACE_CONFIG0x000200002097152config
DBG_TRACE_PMAPI0x000400004194304pmapi
DBG_TRACE_FAULT0x000800008388608fault
DBG_TRACE_AUTH0x0010000016777216auth
DBG_TRACE_DISCOVERY0x0020000033554432discovery
DBG_TRACE_ATTR0x0040000067108864attr
DBG_TRACE_HTTP0x00800000134217728http
DBG_TRACE_DESPERATE0x040000001073741824desperate

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).

PCP Performance Co-Pilot