SysTutorials Posts

pmdaGetOpt, pmdaGetOptions – get options from arguments, parsing generic PMDA options C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaGetOptions(int argc, char *const *argv, pmdaOptions *opts, pmdaInterface *dispatch); int pmdaGetOpt(int argc, char *const *argv, const char *optstring, pmdaInterface *dispatch, int *err); cc … -lpcp_pmda -lpcp Description These functions are wrappers for pmgetopt_r(3). The behavior of each function is…

pmdaMain, pmdaGetContext, pmdaSetResultCallBack, pmdaSetCheckCallBack, pmdaSetDoneCallBack, pmdaSetEndContextCallBack – generic PDU processing for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> cc … -lpcp_pmda -lpcp void pmdaMain(pmdaInterface *dispatch); void pmdaSetCheckCallBack(pmdaInterface *dispatch, pmdaCheckCallBack callback); void pmdaSetDoneCallBack(pmdaInterface *dispatch, pmdaDoneCallBack callback); void pmdaSetResultCallBack(pmdaInterface *dispatch, pmdaResultCallBack callback); void pmdaSetEndContextCallBack(pmdaInterface *dispatch, pmdaEndContextCallBack callback); int pmdaGetContext(void); Description For Performance Metric Domain Agents (PMDA(3)) using the…

pmdaFetch, pmdaSetFetchCallBack – fill a pmResult structure with the requested metric values C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaFetch(int numpmid, pmID *pmidlist, pmResult **resp, pmdaExt *pmda); void pmdaSetFetchCallBack(pmdaInterface *dispatch, pmdaFetchCallBack callback); cc … -lpcp_pmda -lpcp Description pmdaFetch is a generic callback used by a PMDA(3) to process a fetch request from pmcd(1). The request…

pmdaEventNewQueue, pmdaEventNewActiveQueue, pmdaEventQueueHandle, pmdaEventQueueAppend, pmdaEventQueueShutdown, pmdaEventQueueRecords, pmdaEventQueueClients, pmdaEventQueueCounter, pmdaEventQueueBytes, pmdaEventQueueMemory – utilities for PMDAs managing event queues C Synopsis #include <pcp/pmapi.h> #include <pcp/pmda.h> int pmdaEventNewQueue(const char *name, size_t maxmem); int pmdaEventNewActiveQueue(const char *name, size_t maxmem, int nclients); int pmdaEventQueueHandle(const char *name); int pmdaEventQueueAppend(int handle, void *buffer, size_t bytes, struct timeval *tv); int pmdaEventQueueShutdown(int handle); typedef…

pmdaEventNewClient, pmdaEventEndClient, pmdaEventClients – client context tracking interfaces for event queues C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaEventNewClient(int context); int pmdaEventEndClient(int context); int pmdaEventClients(pmAtomValue *avp); cc … -lpcp_pmda -lpcp Description A Performance Metrics Domain Agent (PMDA) that exports event records needs to track which clients are connected to it, in order that…

pmdaEventNewArray, pmdaEventResetArray, pmdaEventReleaseArray, pmdaEventAddRecord, pmdaEventAddMissedRecord, pmdaEventAddParam, pmdaEventGetAddr, pmdaEventNewHighResArray, pmdaEventResetHighResArray, pmdaEventReleaseHighResArray, pmdaEventAddHighResRecord, pmdaEventAddHighResMissedRecord, pmdaEventHighResAddParam, pmdaEventHighResGetAddr – utilities for PMDAs to build packed arrays of event records C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaEventNewArray(void); int pmdaEventResetArray(int idx); int pmdaEventReleaseArray(int idx); int pmdaEventAddRecord(int idx, struct timeval *tp, int flags); int pmdaEventAddMissedRecord(int idx, struct timeval *tp, int nmissed);…

pmdaDesc – get the description of a metric from a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaDesc(pmID pmid, pmDesc *desc, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description pmdaDesc uses the standard PMDA(3) data structures to return the pmDesc description in desc for the metric identified by pmid. Diagnostics If the pmid…

pmdaDaemon – initialize the PMDA to run as a daemon C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> void pmdaDaemon(pmdaInterface *dispatch, int interface, char *name, int domain, char *logfile, char *helptext); cc … -lpcp_pmda -lpcp Description pmdaDaemon initializes the pmdaInterface structure to use the interface extensions assuming the PMDA(3) is to be run as a daemon. The pmdaInterface structure…

pmdaDSO – initialize the PMDA to run as a DSO C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaDSO(pmdaInterface *dispatch, int interface, char *name, char *helptext); cc … -lpcp_pmda -lpcp Description pmdaDSO initializes the pmdaInterface structure to use the interface extensions, assuming the PMDA(3) is to be run as a DSO. The pmdaInterface structure is initialized…

pmdaConnect – establish a connection between a daemon PMDA and PMCD C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> void pmdaConnect(pmdaInterface *dispatch); cc … -lpcp_pmda -lpcp Description pmdaConnect initializes an IPC channel between a PMDA(3) and the pmcd(1) process on the local host. The type of the connection is dependent on the e_io field of…

pmdaOpenHelp, pmdaGetHelp, pmdaGetInDomHelp, pmdaCloseHelp – help text support for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaOpenHelp(char *fname); char *pmdaGetHelp(int handle, pmID pmid, int type); char *pmdaGetInDomHelp(int handle, pmInDom indom, int type); void pmdaCloseHelp(int handle); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see…

pmdaChildren – 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 pmdaChildren(char *name, int traverse, char ***offspring, int **status, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaChildren is the generic callback for returning dynamic metric…

pmdaCacheStore, pmdaCacheStoreKey, pmdaCacheLookup, pmdaCacheLookupName, pmdaCacheLookupKey, pmdaCacheOp, pmdaCachePurge, pmdaCacheResize – manage a cache of instance domain information for a PMDA C Synopsis #include <pcp/pmapi.h> #include <pcp/pmda.h> int pmdaCacheStore(pmInDom indom, int flags, const char *name, void *private); int pmdaCacheStoreKey(pmInDom indom, int flags, const char *name, int keylen, const void *key, void *private); int pmdaCacheLookup(pmInDom indom, int inst, char **name, void **private); int pmdaCacheLookupName(pmInDom indom,…

pmdaAttribute – informs a PMDA about client connection attributes C Synopsis #include <pcp/pmapi.h> #include <pcp/impl.h> #include <pcp/pmda.h> int pmdaAttribute(int context, int key, char *value, int length, pmdaExt *pmda); cc … -lpcp_pmda -lpcp Description As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), pmdaAttribute is the generic callback for responding to client connection…

rpc – library routines for remote procedure calls Synopsis And Description These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine to perform the requested…

rpc – library routines for remote procedure calls Synopsis And Description These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine to perform the requested…

rpc – library routines for remote procedure calls Synopsis And Description These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine to perform the requested…

rpc – library routines for remote procedure calls Synopsis And Description These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine to perform the requested…

rpc – library routines for remote procedure calls Synopsis And Description These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine to perform the requested…

pmWhichZone – return current reporting timezone C Synopsis #include <pcp/pmapi.h> int pmWhichZone(char **tz); cc … -lpcp Description The current reporting timezone effects the timezone used by pmCtime(3) and pmLocaltime(3). pmWhichZone returns the handle of the current timezone, as previously established by a call to pmNewZone(3) or pmNewContextZone(3). If the call is successful (i.e. there exists…