centos man page for pmdupcontext

PMDUPCONTEXT(3) 					     Library Functions Manual						   PMDUPCONTEXT(3)

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  pmlog-
       ger(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).

Performance Co-Pilot							PCP							   PMDUPCONTEXT(3)