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