PMGETCONTEXTFD(3)
NAME
pmGetContextFD, pmGetContextTimeout - get file descriptor associated
with a PMAPI context
C SYNOPSIS
#include <pcp/pmapi.h>
int pmGetContextFD(int handle) int pmGetContextTimeout(int handle)
cc ... -lpcp
DESCRIPTION
An application using the Performance Metrics Application Programming
Interface (PMAPI) may manipulate several concurrent contexts to connect
to pmcd(1).
pmGetContextFD allows application to retrieve file descriptor used to
communicate to pmcd(1) and use it to implement some sort of input/output multiplexing scheme.
pmGetContextTimeout allows application to retrive a time in milliseconds which an application must wait for the reply from pmcd(1). Value
-1 means that there is no timeout and application must be prepared to
wait as long as it takes to receive a reply.
SEE ALSO
PMAPI(3), pmLoop(3), pmDestroyContext(3), pmDupContext(3), pmNewContext(3), pmContextConnectTo(3) and pmWhichContext(3).
DIAGNOSTICS
- PM_ERR_NOCONTEXT
- handle does not identify a valid PMAPI context.
- PM_ERR_NOTHOST
- The context is not associated with PMCD.
- PM_ERR_NOTCONN
- The connection to PMCD is not yet established.