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

DIAGNOSTICS

32       PM_ERR_INDOM
33              indom is not a valid instance domain identifier
34
35       PM_ERR_INST
36              The instance identifier inst is not known for the  instance  do‐
37              main indom in the current PMAPI context
38

SEE ALSO

40       PMAPI(3),  pmGetConfig(3), pmGetInDom(3), pmLookupInDom(3), pmNameInDo‐
41       mArchive(3), pcp.conf(5) and pcp.env(5).
42
43
44
45Performance Co-Pilot                  PCP                       PMNAMEINDOM(3)
Impressum