Merge branch 'main' of github.com:performancecopilot/pcp

debian/libpcp3-dev.install

@@ -20,6 +20,10 @@ usr/lib/pcp/bin/install-sh
 usr/lib/pkgconfig/libpcp.pc
 usr/share/man/man3/LOGIMPORT.3.gz
 usr/share/man/man3/PCPIntro.3.gz
+usr/share/man/man3/PM_FAULT_CHECK.3.gz
+usr/share/man/man3/PM_FAULT_CLEAR.3.gz
+usr/share/man/man3/PM_FAULT_POINT.3.gz
+usr/share/man/man3/PM_FAULT_RETURN.3.gz
 usr/share/man/man3/PMAPI.3.gz
 usr/share/man/man3/PMAPI_INTERNAL.3.gz
 usr/share/man/man3/PMWEBAPI.3.gz
@@ -36,15 +40,15 @@ usr/share/man/man3/__pmAFregister.3.gz
 usr/share/man/man3/__pmAFsetup.3.gz
 usr/share/man/man3/__pmAFunblock.3.gz
 usr/share/man/man3/__pmAFunregister.3.gz
-usr/share/man/man3/__pmAddIPC.3.gz
 usr/share/man/man3/__pmConnectLogger.3.gz
 usr/share/man/man3/__pmCleanMapDir.3.gz
 usr/share/man/man3/__pmControlLog.3.gz
 usr/share/man/man3/__pmConvertHighResTime.3.gz
 usr/share/man/man3/__pmConvertTime.3.gz
 usr/share/man/man3/__pmDiscoverServicesWithOptions.3.gz
 usr/share/man/man3/__pmEquivInDom.3.gz
-usr/share/man/man3/__pmFdLookupIPC.3.gz
+usr/share/man/man3/__pmFaultInject.3.gz
+usr/share/man/man3/__pmFaultSummary.3.gz
 usr/share/man/man3/__pmFreeAttrsSpec.3.gz
 usr/share/man/man3/__pmFreeHostAttrsSpec.3.gz
 usr/share/man/man3/__pmFreeHostSpec.3.gz
@@ -53,7 +57,6 @@ usr/share/man/man3/__pmLocalPMDA.3.gz
 usr/share/man/man3/__pmLogMetaTypeStr.3.gz
 usr/share/man/man3/__pmLogMetaTypeStr_r.3.gz
 usr/share/man/man3/__pmLogWriteMark.3.gz
-usr/share/man/man3/__pmLookupIPC.3.gz
 usr/share/man/man3/__pmMktime.3.gz
 usr/share/man/man3/__pmOverrideLastFd.3.gz
 usr/share/man/man3/__pmParseCtime.3.gz
@@ -276,6 +279,7 @@ usr/share/man/man3/pmdaEventArray.3.gz
 usr/share/man/man3/pmdaEventClient.3.gz
 usr/share/man/man3/pmdaEventQueue.3.gz
 usr/share/man/man3/pmdaHelp.3.gz
+usr/share/man/man3/pmfault.3.gz
 usr/share/man/man3/pmflush.3.gz
 usr/share/man/man3/pmfstring.3.gz
 usr/share/man/man3/pmgetopt_r.3.gz

man/man1/collectl2pcp.1

@@ -77,4 +77,4 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ gz [from .gz suffix] gzipped
+.\" +ok+ gzipped

man/man1/dbpmda.1

@@ -607,5 +607,5 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ AUTH Getdesc Getiname PCP_ATTR_XXXX Sep attr dbpmdarc desc
-.\" +ok+ desc getdesc getiname inst int libpmda logfile num numfetch numpmid
-.\" +ok+ numval ol [from -ol] pmda_simple simple_init tanya userid valfmt vlist
+.\" +ok+ getdesc getiname libpmda logfile num numfetch numpmid
+.\" +ok+ ol {from -ol} pmda_simple simple_init tanya userid valfmt vlist

man/man1/ganglia2pcp.1

@@ -51,7 +51,7 @@ If any of these files exists already,
 then \fBsar2pcp\fR will \fBnot\fR overwrite them and will exit with an error
 message of the form
 .PP
-\&__pmLogNewFile: ``blah.0'' already exists, not over-written
+__pmLogNewFile: ``blah.0'' already exists, not over-written
 .PP
 \&\fBganglia2pcp\fR is a Perl script that uses the PCP::LogImport Perl wrapper
 around the \s-1PCP\s0 \fIlibpcp_import\fR
@@ -136,5 +136,5 @@ and
 .BR LOGIMPORT (3).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ EST HHMM Posix RRDs __pmLogNewFile achive aka rrd
-.\" +ok+ str #from str2time#
+.\" +ok+ EST HHMM RRDs achive aka rrd
+.\" +ok+ str {from str2time}

man/man1/genpmda.1

@@ -137,5 +137,5 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ briefhelptext cp [from atom->cp] endmetric
+.\" +ok+ briefhelptext endmetric
 .\" +ok+ example_string_fetch_callback helptext

man/man1/indomcachectl.1

@@ -147,6 +147,4 @@ and
 .BR passwd (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ uid gid chmod
-.\" +ok+ virbr ens sp [from network interfaces]
-.\" +ok+ pmda [from /var/lib/pcp/config/pmda]
+.\" +ok+ virbr ens sp {from network interfaces}

man/man1/iostat2pcp.1

@@ -172,6 +172,6 @@ and
 .BR LOGIMPORT (3).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ DD EST HH HHMM LC_TIME LOGIMPORT LogImport Posix SS S_TIME_FORMAT
+.\" +ok+ DD EST HH HHMM LC_TIME SS S_TIME_FORMAT
 .\" +ok+ aka de_AT de_BE de_LU eXtended en_AU en_DK en_GB en_IE en_NZ en_SG
-.\" +ok+ en_US en_ZA es_AR es_ES es_MX freshmeat iostat utf zoneinfo
+.\" +ok+ en_US en_ZA es_AR es_ES es_MX freshmeat utf

man/man1/mrtg2pcp.1

@@ -61,4 +61,4 @@ and
 .BR PCP::LogImport (3).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ MRTG [from MRTG2PCP] mrtg [from mrtg2pcp]
+.\" +ok+ MRTG {from MRTG2PCP}

man/man1/newhelp.1

@@ -166,4 +166,4 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+  kernel.all.cpu.idle NNN dir outout pag
+.\" +ok+  NNN dir outout pag

man/man1/pcp-kube-pods.1

@@ -91,4 +91,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ Kubenetes PCP_KUBE_PODS PODs kube kubectl podIP
+.\" +ok+ Kubenetes PCP_KUBE_PODS PODs kubectl podIP

man/man1/pcp-shping.1

@@ -87,6 +87,3 @@ configuration file, as described in \fBpcp.conf\fP(5).
 .BR pcp (1)
 and
 .BR pmdashping (1).
-
-.\" control lines for scripts/man-spell
-.\" +ok+ shping [from pcp-shping]

man/man1/pcp.1

@@ -229,4 +229,4 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ Mem dtT [from pminfo -dtT] numastat [from pcp-numstat]
+.\" +ok+ Mem dtT {from pminfo -dtT} numastat {from pcp-numstat}

man/man1/pcpcompat.1

@@ -257,8 +257,8 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ COLLECTL IOSTAT IRIX NSS OpenSSL PCPCompat PMLOGCONF PMMGR
-.\" +ok+ PMWEBAPI PMWEBD SAR WEBAPPS bpftrace dm github grafana iostat
-.\" +ok+ sadf testsuite
-.\" +ok+ mmv_stats_register performancecopilot pmdabpftrace pmmgr pmwebd
-.\" +ok+ sD sc sd sm sn [from pmrep -args]
+.\" +ok+ PMWEBD SAR WEBAPPS bpftrace dm github grafana
+.\" +ok+ testsuite
+.\" +ok+ mmv_stats_register pmmgr pmwebd
+.\" +ok+ sD sc sd sm sn {from pmrep -args}
 

man/man1/pcpintro.1

@@ -1395,25 +1395,17 @@ wrapped once in the interval between consecutive samples.
 This ``wrapping'' behavior was the default in earlier PCP versions, but
 by default has been disabled in PCP release from version 1.3 on.
 .TP
-.B PMDA_PATH
+.B PCP_PMDAS_DIR
 The
-.B PMDA_PATH
+.B PCP_PMDAS_DIR
 environment variable
-may be used to modify the search path used by
+may be used to modify the directory used by
 .BR pmcd (1)
 and
 .BR pmNewContext (3)
 (for
 .B PM_CONTEXT_LOCAL
 contexts) when searching for a daemon or DSO PMDA.
-The syntax follows that for
-.B PATH
-in
-.BR sh (1),
-i.e. a colon separated list of directories,
-and the default search path is ``/var/pcp/lib:/usr/pcp/lib'',
-(or ``/var/lib/pcp/lib'' on Linux, depending on the value
-of the $PCP_VAR_DIR environment variable).
 .TP
 .B PMCD_PORT
 The TCP/IP port(s) used by
@@ -1591,13 +1583,12 @@ which can be found at
 
 .\" control lines for scripts/man-spell
 .\" +ok+ ACLs AuthenticatedConnections DD EST EncryptedConnections
-.\" +ok+ HH Inet LOGARCHIVE MacOSX OpenSSL PCP_ALLOW_BAD_CERT_DOMAIN
+.\" +ok+ HH Inet MacOSX OpenSSL PCP_ALLOW_BAD_CERT_DOMAIN
 .\" +ok+ PCP_ALLOW_SERVER_SELF_CERT PCP_CONSOLE PCP_COUNTER_WRAP
-.\" +ok+ PCP_IGNORE_MARK_RECORDS PCP_SECURE_SOCKETS PCP_STDERR
-.\" +ok+ PMCD_CONNECT_TIMEOUT PMCD_PORT PMCD_RECONNECT_TIMEOUT
-.\" +ok+ PMCD_REQUEST_TIMEOUT PMCD_WAIT_TIMEOUT PMDA_LOCAL_PROC
-.\" +ok+ PMDA_LOCAL_SAMPLE PMDA_PATH PMIECONF_PATH PMLOGGER_PORT
-.\" +ok+ PMLOGGER_REQUEST_TIMEOUT PMPROXY_HOST PMPROXY_PORT QG SASL SS SSL
-.\" +ok+ TLS YY YYYY \f2datetime\f1 app cae credentialed datetime debugspec
-.\" +ok+ edc endtime fe ff gssapi gz myarchive myarchives nas openssl pcps
-.\" +ok+ prev proc rc sha starttime syscall tanya tzselect
+.\" +ok+ PCP_IGNORE_MARK_RECORDS PCP_SECURE_SOCKETS
+.\" +ok+ PMDA_LOCAL_PROC
+.\" +ok+ PMDA_LOCAL_SAMPLE PMLOGGER_PORT
+.\" +ok+ QG SASL SS SSL
+.\" +ok+ TLS YY YYYY app cae credentialed debugspec datetime
+.\" +ok+ edc endtime fe ff gssapi myarchive myarchives nas openssl pcps
+.\" +ok+ prev rc sha starttime syscall tanya tzselect

man/man1/perfalloc.1

@@ -78,4 +78,4 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ EXIT_FAILURE perf_event_paranoid perfevent
-.\" +ok+ perflock [from PCP_PMDAS_DIR/perfevent/perflock]
+.\" +ok+ perflock {from PCP_PMDAS_DIR/perfevent/perflock}

man/man1/pmafm.1

@@ -209,4 +209,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ hel [from help abbreviation]
+.\" +ok+ hel {from help abbreviation}

man/man1/pmcd.1

@@ -1381,13 +1381,13 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ Avahi PMCD_CREDS_TIMEOUT HUP IPv JSONB PMCD_MAXPENDING
-.\" +ok+ SASL SD addr_family appl behaviour boing com creds
-.\" +ok+ OpenRequestSocket PMCD_CONNECT_TIMEOUT
-.\" +ok+ PMCD_LOCAL PMCD_PATH PMCD_PORT PMCD_REQUEST_TIMEOUT
+.\" +ok+ Avahi PMCD_CREDS_TIMEOUT PMCD_MAXPENDING
+.\" +ok+ SASL SD addr_family appl boing
+.\" +ok+ OpenRequestSocket
+.\" +ok+ PMCD_LOCAL PMCD_PATH
 .\" +ok+ PMCD_RESTART_AGENTS PMCD_ROOT_AGENT PMCD_SOCKET PMCD_VARIABLE
-.\" +ok+ OpenSSL \.?melbourne TIME_WAIT creds_required dumptrace
-.\" +ok+ fe feaf ff [all from IPv6 addr like fe80::223:14ff:feaf:*]
-.\" +ok+ grouplist helptext hostlist inet ipc_prot
-.\" +ok+ userlist postgresql remotecert reqauth simabi
-.\" +ok+ tracebufs traceconn tracenobuf tracepdu uniqnames
+.\" +ok+ OpenSSL \.melbourne melbourne TIME_WAIT creds_required dumptrace
+.\" +ok+ fe feaf ff {all from IPv6 addr like fe80::223:14ff:feaf:*}
+.\" +ok+ grouplist hostlist inet ipc_prot
+.\" +ok+ userlist postgresql simabi
+.\" +ok+ tracebufs traceconn tracenobuf tracepdu

man/man1/pmchart.1

@@ -746,8 +746,8 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ BMP Netbytes PNG PostScript Serif WxH Xcolor autoscaled bmp
-.\" +ok+ rrggbb rrrgggbbb rrrrggggbbbb rr gg bb [from <colorspec>]
+.\" +ok+ rrggbb rrrgggbbb rrrrggggbbbb rr gg bb {from <colorspec>}
 .\" +ok+ colorspec hostspec
-.\" +ok+ inet inst jpeg jpg kmchart metricname onoff png ppm rgb rgbi
+.\" +ok+ inet jpeg jpg kmchart metricname onoff png ppm rgb rgbi
 .\" +ok+ showrgb steelblue tif xbm xpm
 .\" +ok+ xpos ymax ymin ypos

man/man1/pmcheck.1

@@ -457,5 +457,5 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ _ctl_pmda _ctl_svc _do_args aflag checkproc dflag
-.\" +ok+ gt [from test -gt]  lflag pre prog rc [from ``rc'' script]
+.\" +ok+ gt {from test -gt}  lflag pre prog rc {from ``rc'' script}
 .\" +ok+ sflag show_me tmp

man/man1/pmcpp.1

@@ -393,6 +393,6 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ MYDOMAIN cpu_freq cpu_pfx dk_freq expr infile linemarker
+.\" +ok+ MYDOMAIN cpu_freq cpu_pfx dk_freq infile linemarker
 .\" +ok+ lineno pre sys want_cpu
 

man/man1/pmdacisco.1

@@ -346,7 +346,7 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ BRI Ciscos FDDI FastEthernet Fddi GigabitEthernet HSSI ISDN
-.\" +ok+ Vl [from protocol Vl]
-.\" +ok+ Vlan appl cisco int mycisco mylogin mypassword myprompt somecisco
+.\" +ok+ Vl {from protocol Vl}
+.\" +ok+ Vlan appl cisco mycisco mylogin mypassword myprompt somecisco
 .\" +ok+ subinterface trust_me wancisco yourcisco yourlogin
 .\" +ok+ yourpassword

man/man1/pmdakernel.1

@@ -173,6 +173,6 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ CVE KERNEL_PMDAS aix darwin filesys freebsd hinv linux mem netbsd
-.\" +ok+ platfrom pmda pmdaaix pmdadarwin pmdafreebsd pmdalinux pmdanetbsd
+.\" +ok+ CVE KERNEL_PMDAS aix darwin filesys freebsd hinv linux netbsd
+.\" +ok+ platfrom pmdaaix pmdadarwin pmdafreebsd pmdalinux pmdanetbsd
 .\" +ok+ pmdasolaris pmdawindows procfs solaris sysfs

man/man1/pmdamailq.1

@@ -189,4 +189,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ df [from sendmail filename prefix] hr [from hours] mailq mqueue
+.\" +ok+ df {from sendmail filename prefix} mailq mqueue

man/man1/pmdammv.1

@@ -225,4 +225,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ GoLang MMV mmv mmv_stats_init newgrp setgid tmp
+.\" +ok+ GoLang MMV newgrp setgid tmp

man/man1/pmdaoverhead.1

@@ -273,4 +273,4 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ cmd ident pmdaproc proc psinfo
+.\" +ok+ cmd ident psinfo

man/man1/pmdaperfevent.1

@@ -223,4 +223,4 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ MSR PMU RAPL event_source libpfm makerewrite perf_event
-.\" +ok+ perf_event_paranoid perfevent pl [from .pl suffix] sys uncore
+.\" +ok+ perf_event_paranoid perfevent pl {from .pl suffix} sys uncore

man/man1/pmdapipe.1

@@ -317,5 +317,5 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ WS [from example output] bdev_trace btrace firehose groupname
+.\" +ok+ WS {from example output} bdev_trace btrace firehose groupname
 .\" +ok+ jane kvm maxsize perf qemu rw  rw_syscalls sda

man/man1/pmdasendmail.1

@@ -157,4 +157,4 @@ and
 .BR sendmail (1).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ StatusFile cf [from sendmail.cf suffix]
+.\" +ok+ StatusFile cf {from sendmail.cf suffix}

man/man1/pmdashping.1

@@ -214,4 +214,3 @@ and
 
 .\" control lines for scripts/man-spell
 .\" +ok+ NNTP YP expn listgroup portmapper rpcbind ypcat
-.\" +ok+ shping [from PCP_PMDAS_DIR/shping/pmdashping]

man/man1/pmdasimple.1

@@ -194,4 +194,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ pmda_simple txmon [from txmon PMDA x-ref]
+.\" +ok+ pmda_simple txmon {from txmon PMDA x-ref}

man/man1/pmdaweblog.1

@@ -585,7 +585,7 @@ and
 .\" +ok+ accessFile accessRegex client_status errorFile errorRegex
 .\" +ok+ ftpd gp nX pcpweb perserver pmdawebping regexName regex_posix regexp
 .\" +ok+ regexp_posix rfc serverName server_status sproc sprocs
-.\" +ok+ stdpmid weblogvis webvis
-.\" +ok+ weblog [from PCP_PMDAS_DIR/weblog/pmdaweblog]
-.\" +ok+ _A Za zA [from regex examples]
-.\" +ok+ de [from de-installation]
+.\" +ok+ weblogvis webvis
+.\" +ok+ weblog {from PCP_PMDAS_DIR/weblog/pmdaweblog}
+.\" +ok+ _A Za zA {from regex examples}
+.\" +ok+ de {from de-installation}

man/man1/pmdbg.1

@@ -151,6 +151,3 @@ configuration file, as described in \fBpcp.conf\fP(5).
 .BR pcp.conf (5)
 and
 .BR pcp.env (5).
-
-.\" control lines for scripts/man-spell
-.\" +ok+ __pmParseDebug pmDebug

man/man1/pmdumptext.1

@@ -534,6 +534,6 @@ and
 .BR environ (7).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ Jul _clean _dirty dd explict filesys fs_ctl mem
-.\" +ok+ myarchive myhost outfile util [from mem,util]
-.\" +ok+ il [from -il] imu [from -imu] lmNu [from -lmNu]
+.\" +ok+ Jul _clean _dirty dd explict filesys fs_ctl
+.\" +ok+ myarchive myhost outfile
+.\" +ok+ il {from -il} imu {from -imu} lmNu {from -lmNu}

man/man1/pmfind.1

@@ -205,4 +205,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ CMD DIR FD_SETSIZE Inet avahi kube mDNS maxThreads
+.\" +ok+ CMD DIR FD_SETSIZE Inet avahi mDNS maxThreads

man/man1/pmfind_check.1

@@ -262,4 +262,4 @@ and
 .BR cron (8).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ prev [from .prev suffix] \* [dopey ispell]
+.\" +ok+ prev {from .prev suffix} \* {dopey ispell}

man/man1/pmgenmap.1

@@ -265,11 +265,10 @@ and
 .BR PMNS (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ EST MAX_PMID NCPU SYS hinv ing [from #include -ing]
-.\" +ok+ ncpu [from hinv.ncpu]
-.\" +ok+ sys [from kernel.percpu.cpu.sys]
-.\" +ok+ yy zz [from xx.yy.zz]
-.\" +ok+ [all below are variables from C code example]
-.\" +ok+ int listname lval metricname mystats
+.\" +ok+ EST MAX_PMID NCPU SYS hinv ing {from #include -ing}
+.\" +ok+ ncpu {from hinv.ncpu}
+.\" +ok+ yy zz {from xx.yy.zz}
+.\" +ok+ {all below are variables from C code example}
+.\" +ok+ listname lval metricname mystats
 .\" +ok+ numpmid pmidlist prev
 .\" +ok+ resp sizeof symbolname sys vlist vset

man/man1/pmgetopt.1

@@ -213,4 +213,4 @@ and
 .BR pcp.env (5).
 
 .\" control lines for scripts/man-spell
-.\" +ok+ INST clusterstat sp [from .sp in troff macro]
+.\" +ok+ INST clusterstat sp {from .sp in troff macro}