NAME
pmInDomStr - convert a performance metric instance domain
identifier into a string
C SYNOPSIS
#include <pcp/pmapi.h>
const char *pmInDomStr(pmInDom indom)
cc ... -lpcp
DESCRIPTION
For use in error and diagnostic messages, return a 'human
readable' version of the specified instance domain identi
fier.
The value for the instance domain indom is typically
extracted from a pmDesc structure, following a call to
pmLookupDesc(3) for a particular performance metric.
Internally, an instance domain identifier is encoded as
follows;
typedef struct {
int pad:2;
unsigned int domain:8; /* the administrative PMD */
unsigned int serial:22; /* unique within PMD */
} __pmInDom_int;
pmInDomStr returns a string with each of the domain and
serial 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 pmIn
DomStr.
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), pmIDStr(3), pmLookupDesc(3),
pcp.conf(4) and pcp.env(4).
Man(1) output converted with
man2html