pmiPutResult – add a data record to a LOGIMPORT archive C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiPutResult(const pmResult *result); cc … -lpcp_import -lpcp Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiPutResult provides an interface for developers familiar with the internal PCP data structures to create output archives…
pmiPutMark – write a <mark> record to a PCP archive C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiPutMark(void); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; pmiPutMark(); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiPutMark writes a <mark> record to the current PCP output archive. This is required…
pmiUnits, pmiID, pmiInDom – construct core metric data structures C Synopsis #include <pcp/pmapi.h> #include <pcp/import.h> pmID pmiID(int domain, int cluster, int item); pmInDom pmiInDom(int domain, int serial); pmUnits pmiUnits(int dimSpace, int dimTime, int dimCount, int scaleSpace, int scaleTime, int scaleCount); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; $pmid = pmiID($domain, $cluster, $item); $indom = pmiInDom($domain, $serial); $units…
pmiGetHandle – define a handle for a metric-instance pair C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiGetHandle(const char *name, const char *instance); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; $handle = pmiGetHandle($name, $instance); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiGetHandle creates a handle for a given…
pmiErrStr – convert a LOGIMPORT error code into a string C Synopsis #include <pcp/pmapi.h> #include <pcp/import.h> const char *pmiErrStr(int code); char *pmiErrStr_r(int code, char buf, int buflen); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; pmiErrStr($code); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiErrStr translates error codes returned from the…
pmiEnd – finish up a LOGIMPORT archive C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiEnd(void); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; pmiEnd(); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiEnd closes the current context, forcing the trailer records to be written to the PCP archive files,…
pmiAddMetric – add a new metric definition to a LOGIMPORT context C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiAddMetric(const char *name, pmID pmid, int type, pmInDom indom, int sem, pmUnits units); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; pmiAddMetric($name, $pmid, $type, $indom, $sem, $units); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)),…
pmiAddInstance – add an element to an instance domain in a LOGIMPORT context C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/import.h> int pmiAddInstance(pmInDom indom, const char *instance, int inst); cc … -lpcp_import -lpcp Perl SYNOPSIS use PCP::LogImport; pmiAddInstance($indom, $instance, $inst); Description As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiAddInstance adds a…
pmprintf, pmflush – print formatted output in a window or to standard error C Synopsis #include <pcp/pmapi.h> int pmprintf(const char *fmt, … /*args*/); int pmflush(void); cc … -lpcp Description The combination of pmprintf and pmflush produces output in either an xconfirm(1) window, on the standard error stream, or to a file in a manner similar…
pmtracebegin, pmtraceend, pmtraceabort, pmtracepoint, pmtraceobs, pmtracecounter, pmtracestate, pmtraceerrstr – application-level performance instrumentation services C Synopsis #include <pcp/trace.h> int pmtracebegin(const char *tag); int pmtraceend(const char *tag); int pmtraceabort(const char *tag); int pmtracepoint(const char *tag); int pmtraceobs(const char *tag, double value); int pmtracecounter(const char *tag, double value); char *pmtraceerrstr(int code); int pmtracestate(int flags); cc … -lpcp_trace Fortran…
pmdaText – extract metric help text for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaText(int ident, int type, char **buffer, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaText uses the standard PMDA(3) data structures to return the help text…
pmdaStore – store a value into a metric for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaStore(pmResult *result, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaStore is the generic callback for storing a value into a metric. pmdaStore is…
pmdaRootConnect, pmdaRootShutdown, pmdaRootContainerHostName, pmdaRootContainerProcessID, pmdaRootContainerCGroupName, pmdaRootProcessStart, pmdaRootProcessWait, pmdaRootProcessTerminate – privileged PCP collector services C Synopsis #include <pcp/pmapi.h> #include <pcp/pmda.h> int pmdaRootConnect(void); void pmdaRootShutdown(int fd); int pmdaRootContainerHostName(int fd, char *name, int namelen, char *buffer, int buflen); int pmdaRootContainerProcessID(int fd, char *name, int namelen); int pmdaRootContainerCGroupName(int fd, char *name, int namelen, char *buffer, int buflen); int pmdaRootProcessStart(int…
pmdaProfile – update instance profile for PMDA in preparation for the next fetch from PMCD C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaProfile(__pmProfile *prof, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaProfile is the default callback which handles the receipt of…
pmdaPMID – translate a dynamic performance metric name into a PMID C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaPMID(char *name, pmID *pmid, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaPMID is the generic callback for translating a dynamic metric name into…
pmdaOpenLog – redirect stderr to a logfile C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> void pmdaOpenLog(pmdaInterface * dispatch); cc … -lpcp_pmda -lpcp Description pmdaOpenLog redirects stderr to the logfile specified in the dispatch structure, set by the previous call to pmdaDaemon(3) or pmdaGetOpt(3). The first line of the log file will detail the name…
pmdaName – translate a PMID to a set of dynamic performance metric names C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaName(pmID pmid, char ***nameset, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaName is the generic callback for translating a pmid into…
pmdaInterfaceMoved – reset internal state of a pmdaInterface structure C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> void pmdaInterfaceMoved(pmdaInterface *dispatch) cc … -lpcp_pmda -lpcp Description After a call to either pmdaDaemon(3) or pmdaDSO(3) to initialize the pmdaInterface structure, if the caller needs to relocate or move the structure for any reason then pmdaInterfaceMoved needs to…
pmdaInstance – return instance descriptions for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaInstance(pmInDom indom, int inst, char *name, __pmInResult **result, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description pmdaInstance uses the standard PMDA(3) data structures to return information concerning the instance domain indom. The result structure is constructed by pmdaInstance and will contain…
pmdaInit, pmdaRehash, pmdaSetFlags – initialize a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> void pmdaInit(pmdaInterface *dispatch, pmdaIndom *indoms, int nindoms, pmdaMetric *metrics, int nmetrics); void pmdaRehash(pmdaExt *pmda, pmdaMetric *metrics, int nmetrics); void pmdaSetFlags(pmdaInterface *dispatch, int flags); cc … -lpcp_pmda -lpcp Description pmdaInit initializes a PMDA so that it is ready to receive PDUs from pmcd(1). The function expects…