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

NAME

6       pmNameInDom,  pmRequestInDomName,  pmReceiveInDomName  -  translate  an
7       instance identifier into an instance name
8

C SYNOPSIS

10       #include <pcp/pmapi.h>
11
12       int pmNameInDom(pmInDom indom, int inst, char **name)
13       int pmRequestInDomName(int ctx, pmInDom indom, int inst)
14       int pmReceiveInDomName(int ctx, char **name)
15
16       cc ... -lpcp
17

DESCRIPTION

19       For the instance domain  indom,  in  the  current  Performance  Metrics
20       Application  Programming Interface (PMAPI) context, locate the instance
21       with the internal instance identifier given by  inst,  and  return  the
22       full external instance identification via name.
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       The space for the value of name will have been allocated in pmNameInDom
29       with malloc(3C), and it is the responsibility of the caller to free(3C)
30       the space when it is no longer required.
31
32       pmNameInDom returns zero on success.
33
34       pmRequestInDomName  and  pmReceiveInDomName  are  used  by applications
35       which must  communicate with the PMCD asynchornously.  These  functions
36       take  explict  context  handle  ctx  which must refer to a host context
37       (i.e. creared by passing PM_CONTEXT_HOST to pmNewContext). pmRequestIn‐
38       DomName  sends  request  to  translate  internal instance identifier to
39       external instance name to PMCD and returns immediately, pmReceiveInDom‐
40       Name reads reply from PMCD without waiting, it is the responsibility of
41       the application to make sure the data are ready  before  calling  pmRe‐
42       ceiveInDomName.
43

SEE ALSO

45       PMAPI(3),  pmGetConfig(3), pmGetInDom(3), pmLookupInDom(3), pcp.conf(4)
46       and pcp.env(4).
47

DIAGNOSTICS

49       PM_ERR_INDOM
50              indom is not a valid instance domain identifier
51
52       PM_ERR_INST
53              The instance identifier inst  is  not  known  for  the  instance
54              domain indom in the current PMAPI context
55
56       PM_ERR_CTXBUSY
57              Context is currently in use by another asynchronous call
58
59
60
61Performance Co-Pilot                  SGI                       PMNAMEINDOM(3)
Impressum