Man Linux: Main Page and Category List

NAME

       pmDupContext - duplicate a PMAPI context

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmDupContext(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).

       Calling   pmDupContext   will  replicate  the  current  PMAPI  context,
       returning a handle for the new context that may be used with subsequent
       calls to pmUseContext(3).

       Once  created,  the  duplicated  context  and the original context have
       independent existence, and so their instance  profiles  and  collection
       time  (relevant only for archive contexts) may be independently varied.

       The newly replicated context becomes the current context.

SEE ALSO

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