Poster of Linux kernelThe best gift for a Linux geek
PMGETPMNSLOCATION

PMGETPMNSLOCATION

Section: C Library Functions (3) Updated: SGI
Local index Up
 

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(4). Values for these variables may be obtained programatically using the pmGetConfig(3) function.  

SEE ALSO

PMAPI(3), pmGetConfig(3), pmLoadASCIINameSpace(3), pmLoadNameSpace(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.


 

Index

NAME
C SYNOPSIS
DESCRIPTION
PCP ENVIRONMENT
SEE ALSO
DIAGNOSTICS

This document was created by man2html, using the manual pages.
Time: 21:52:38 GMT, April 16, 2011