NAME
pmGetPMNSLocation - determine the location of the cur
rently used PMNS
C SYNOPSIS
#include <pcp/pmapi.h>
int pmGetPMNSLocation(void)
cc ... -lpcp
DESCRIPTION
If an application needs to know where the Performance Met
rics Name Space (PMNS) is coming from then pmGetPMNSLoca
tion 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 appropri
ate 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(4). Values for these variables
may be obtained programatically using the pmGetConfig(3)
function.
SEE ALSO
PMAPI(3), pmGetConfig(3), pmLoadASCIINameSpace(3), pmLoad
NameSpace(3), pmTrimNameSpace(3), pcp.conf(4), pcp.env(4)
and pmns(4).
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.
Man(1) output converted with
man2html