PMGETCONTEXTFD

Section: C Library Functions (3) Updated: SGI Local index Up

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.

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.