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).