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  con­
       current contexts, each associated with a source of perfor­
       mance 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 con­
       text, 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 con­
       text 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).


Man(1) output converted with man2html