NAME
pmIDStr - convert a performance metric identifier into a
string
C SYNOPSIS
#include <pcp/pmapi.h>
const char *pmIDStr(pmID pmid)
cc ... -lpcp
DESCRIPTION
For use in error and diagnostic messages, return a `human
readable' version of the specified Performance Metric
Identifier (PMID).
Internally, a PMID is encoded as follows;
typedef struct {
int pad:2;
unsigned int domain:8;
unsigned int cluster:12;
unsigned int item:10;
} __pmID_int;
pmIDStr returns a string with each of the domain, cluster
and item subfields appearing as decimal numbers, separated
by periods.
The string value is held in a single static buffer, so the
returned value is only valid until the next call to pmID
Str.
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), pmInDomStr(3), pmLookupDesc(3),
pcp.conf(4) and pcp.env(4).
Man(1) output converted with
man2html