NAME

       pmLookupInDom   -  translate  an  instance  name  into  an
       instance identifier


C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmLookupInDom(pmInDom indom, const 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 external identification given
       by name, and return the internal instance identifier.

       Only the leading non-space characters of name will be used
       to identify the instance.

       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.

       pmLookupInDom will return a positive  instance  identifier
       on success.


SEE ALSO

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


DIAGNOSTICS

       PM_ERR_INDOM
              indom is not a valid instance domain identifier

       PM_ERR_INST
              The external instance name is  not  known  for  the
              instance domain indom in the current PMAPI context


Man(1) output converted with man2html