PMLOOKUPINDOM

Section: C Library Functions (3)
Index Return to Main Contents

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), pmLookupInDomArchive (3), pmNameInDom (3), pcp.conf (5) and pcp.env (5).

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


Index

NAME
C SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS