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

NAME

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

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int pmNameInDom(pmInDom indom, int inst, 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  internal  instance  identifier given by inst, and return the
19       full external instance identification via name.
20
21       The value for the instance domain indom is typically extracted  from  a
22       pmDesc  structure, following a call to pmLookupDesc(3) for a particular
23       performance metric.
24
25       The space for the value of name will have been allocated in pmNameInDom
26       with  malloc(3),  and it is the responsibility of the caller to free(3)
27       the space when it is no longer required.
28
29       pmNameInDom returns zero on success.
30

SEE ALSO

32       PMAPI(3), pmGetConfig(3), pmGetInDom(3), pmLookupInDom(3),  pmNameInDo‐
33       mArchive(3), pcp.conf(5) and pcp.env(5).
34

DIAGNOSTICS

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