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

NAME

6       pmGetContextFD,  pmGetContextTimeout  -  get file descriptor associated
7       with a PMAPI context
8

C SYNOPSIS

10       #include <pcp/pmapi.h>
11
12       int pmGetContextFD(int handle)
13       int pmGetContextTimeout(int handle)
14
15       cc ... -lpcp
16

DESCRIPTION

18       An application using the Performance  Metrics  Application  Programming
19       Interface (PMAPI) may manipulate several concurrent contexts to connect
20       to pmcd(1).
21
22       pmGetContextFD allows application to retrieve file descriptor  used  to
23       communicate  to pmcd(1) and use it to implement some sort of input/out‐
24       put multiplexing scheme.
25
26       pmGetContextTimeout allows application to retrive a time  in  millisec‐
27       onds  which an application must wait for the reply from pmcd(1).  Value
28       -1 means that there is no timeout and application must be  prepared  to
29       wait as long as it takes to receive a reply.
30

SEE ALSO

32       PMAPI(3),  pmLoop(3),  pmDestroyContext(3),  pmDupContext(3), pmNewCon‐
33       text(3), pmContextConnectTo(3) and pmWhichContext(3).
34

DIAGNOSTICS

36       PM_ERR_NOCONTEXT
37              handle does not identify a valid PMAPI context.
38
39       PM_ERR_NOTHOST
40              The context is not associated with PMCD.
41
42       PM_ERR_NOTCONN
43              The connection to PMCD is not yet established.
44
45
46
47Performance Co-Pilot                  SGI                    PMGETCONTEXTFD(3)
Impressum