pmLookupInDom, pmRequestInDomInst, pmReceiveInDomInst - translate an
instance name into an instance identifier
int pmLookupInDom(pmInDom indom, const char *name)
int pmRequestInDomInst(int ctx, pmInDom indom, const char *name)
int pmReceiveInDomInst(int ctx)
cc ... -lpcp
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
Only the leading non-space characters of name will be used to identify
The value for the instance domain indom is typically extracted from a
pmDesc structure, following a call to pmLookupDesc(3) for a particular
pmLookupInDom will return a positive instance identifier on success.
pmRequestInDomInst and pmReceiveInDomInst are used by applications
which must communicate with the PMCD asynchronously. These functions
take explict context handle ctx which must refer to a host context
(i.e. created by passing PM_CONTEXT_HOST to pmNewContext).
pmRequestInDomInst sends request to translate external instance name to
internal instance identifier to PMCD and returns without waiting for
the response, pmReceiveInDomInst reads reply from PMCD. It is the
responsibility of the application to make sure the data are ready
before calling pmReceiveInDomInst to avoid blocking.
PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupDesc(3),
pmNameInDom(3), pcp.conf(4) and pcp.env(4).
indom is not a valid instance domain identifier
The external instance name is not known for the instance domain
indom in the current PMAPI context
Context is currently in use by another asynchronous call.