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 Ap‐
17       plication 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

DIAGNOSTICS

31       PM_ERR_INDOM
32              indom is not a valid instance domain identifier
33
34       PM_ERR_INST
35              The  external instance name is not known for the instance domain
36              indom in the current PMAPI context
37

SEE ALSO

39       PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupDesc(3), pmLookupInDo‐
40       mArchive(3), pmNameInDom(3), pcp.conf(5) and pcp.env(5).
41
42
43
44Performance Co-Pilot                  PCP                     PMLOOKUPINDOM(3)
Impressum