Man Linux: Main Page and Category List

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.