NAME

       pmNameInDom  -  translate  an  instance identifier into an
       instance name


C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmNameInDom(pmInDom indom, int inst, char **name)

       cc ... -lpcp


DESCRIPTION

       For the instance domain indom, in the current  Performance
       Metrics Application Programming Interface (PMAPI) context,
       locate the instance with the internal instance  identifier
       given by inst, and return the full external instance iden­
       tification via name.

       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.

       The space for the value of name will have  been  allocated
       in pmNameInDom with malloc(3C), and it is the responsibil­
       ity of the caller to free(3C) the  space  when  it  is  no
       longer required.

       pmNameInDom returns zero on success.


SEE ALSO

       PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupInDom(3),
       pcp.conf(4) and pcp.env(4).


DIAGNOSTICS

       PM_ERR_INDOM
              indom is not a valid instance domain identifier

       PM_ERR_INST
              The instance identifier inst is not known  for  the
              instance domain indom in the current PMAPI context


Man(1) output converted with man2html