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.

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.