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.