pmGetPMNSLocation (3) - Linux Manuals

pmGetPMNSLocation: determine the location of the currently used PMNS

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.

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.