NAME¶
pmGetPMNSLocation - determine the location of the currently used PMNS
C SYNOPSIS¶
#include <pcp/pmapi.h>
int pmGetPMNSLocation(void);
cc ... -lpcp
DESCRIPTION¶
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.
SEE ALSO¶
PMAPI(3),
pmGetConfig(3),
pmLoadASCIINameSpace(3),
pmLoadNameSpace(3),
pmTrimNameSpace(3),
pcp.conf(5),
pcp.env(5) and
pmns(5).
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.
