Man Linux: Main Page and Category List

NAME

       pmWhichContext - identify the current PMAPI context

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmWhichContext(void)

       cc ... -lpcp

DESCRIPTION

       An  application  using  the Performance Metrics Application Programming
       Interface (PMAPI) may  manipulate  several  concurrent  contexts,  each
       associated  with  a source of performance metrics, e.g. pmcd(1) on some
       host,  or  an  archive  log  of  performance  metrics  as  created   by
       pmlogger(1).

       pmWhichContext returns a handle for the current PMAPI context, that may
       be used in the associated PMAPI  routines  that  require  a  handle  to
       identify a PMAPI context.

SEE ALSO

       PMAPI(3),  pmDestroyContext(3),  pmDupContext(3),  pmNewContext(3)  and
       pmUseContext(3).

DIAGNOSTICS

       PM_ERR_NOCONTEXT
              no current context