pmgetpmnslocation3
Determine the location of the currently used pmns
Part of pmGetPMNSLocation(3).
C synopsis
#include <pcp/pmapi.h>
int pmGetPMNSLocation(void);
cc ... -lpcp
Overview
If an application needs to know where the Performance Metrics Name Space (PMNS) is coming from then pmGetPMNSLocation will return whether it is from an archive, PMNS_ARCHIVE, or from a local PMNS file, PMNS_LOCAL, or from a remote pmcd, PMNS_REMOTE.
This information may be useful in determining an appropriate error message depending on the PMNS' location.
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). Values for these variables may be obtained programmatically using the pmGetConfig(3) function.
Diagnostics
PM_ERR_NOPMNS-
If is not possible to determine where the location of the PMNS is. This could be due to problems with the current context or being unable to load a local PMNS.