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