pmGetContextFD(3)

pmGetContextFD3

Get file descriptor associated with a pmapi context

C synopsis

#include <pcp/pmapi.h>

int pmGetContextFD(int handle)
int pmGetContextTimeout(int handle)

cc ... -lpcp

Overview

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.

Releases

2 releases since Debian 5.0 (Lenny); the text changed 1 time.

  1. 5.0
  2. 6.0

From libpcp3-dev 3.3.3-squeeze3 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.