table of contents
PMLOCALPMDA(3) | Library Functions Manual | PMLOCALPMDA(3) |
NAME¶
__pmLocalPMDA - change the table of DSO PMDAs for PM_CONTEXT_LOCAL contextsC SYNOPSIS¶
#include <pcp/pmapi.h>int __pmLocalPMDA(int op, int domain, const char *name, const char * init);
cc ... -lpcp
DESCRIPTION¶
PCP contexts of type PM_CONTEXT_LOCAL are used by clients that wish to fetch metrics directly from one or more PMDAs on the local host without involving pmcd(1). A PMDA that is to be used in this way must have been built as a Dynamic Shared Object (DSO). Historically the table of PMDAs available for use with PM_CONTEXT_LOCAL was hardcoded to the following:- *
- The PMDA (or PMDAs) that export the operating system performance data and data about process activity.
- *
- The mmv PMDA.
- *
- The sample PMDA provided $PCP_LITE_SAMPLE or $PMDA_LOCAL_SAMPLE is set in the environment - used mostly for QA and testing.
- PM_LOCAL_ADD
- Append an entry to the table for the PMDA with a Performance Metrics Domain (PMD) of domain, the path to the DSO PMDA is given by path and the PMDA's initialization routine is init.
- PM_LOCAL_DEL
- Removes all entries in the table where the domain matches, or the path matches. Setting the arguments domain to -1 or path to NULL to force matching on the other argument. The init argument is ignored.
- PM_LOCAL_CLEAR
- Remove all entries from the table. All the other arguments are ignored in this case.
RETURN VALUE¶
In most cases, __pmLocalPMDA returns 0 to indicate success. If op is invalid, then the return value is PM_ERR_CONV else if there is no matching table entry found for a PM_LOCAL_DEL operation, PM_ERR_INDOM is returned.SEE ALSO¶
pmcd(1), PMAPI(3), pmNewContext(3) and __pmSpecLocalPMDA(3).Performance Co-Pilot |