1PMLOOKUPINDOM(3)           Library Functions Manual           PMLOOKUPINDOM(3)
2
3
4

NAME

6       pmLookupInDom - translate an instance name into an instance identifier
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int pmLookupInDom(pmInDom indom, const char *name);
12
13       cc ... -lpcp
14

DESCRIPTION

16       For  the  instance  domain  indom,  in  the current Performance Metrics
17       Application Programming Interface (PMAPI) context, locate the  instance
18       with the external identification given by name, and return the internal
19       instance identifier.
20
21       Only the leading non-space characters of name will be used to  identify
22       the instance.
23
24       The  value  for the instance domain indom is typically extracted from a
25       pmDesc structure, following a call to pmLookupDesc(3) for a  particular
26       performance metric.
27
28       pmLookupInDom will return a positive instance identifier on success.
29

SEE ALSO

31       PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupDesc(3), pmLookupInDo‐
32       mArchive(3), pmNameInDom(3), pcp.conf(5) and pcp.env(5).
33

DIAGNOSTICS

35       PM_ERR_INDOM
36              indom is not a valid instance domain identifier
37
38       PM_ERR_INST
39              The external instance name is not known for the instance  domain
40              indom in the current PMAPI context
41
42
43
44Performance Co-Pilot                  PCP                     PMLOOKUPINDOM(3)
Impressum