1PMDUPCONTEXT(3)            Library Functions Manual            PMDUPCONTEXT(3)
2
3
4

NAME

6       pmDupContext - duplicate a PMAPI context
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10
11       int pmDupContext(void);
12
13       cc ... -lpcp
14

DESCRIPTION

16       An  application  using  the Performance Metrics Application Programming
17       Interface (PMAPI) may  manipulate  several  concurrent  contexts,  each
18       associated  with  a source of performance metrics, e.g. pmcd(1) on some
19       host, or an archive log of performance metrics  as  created  by  pmlog‐
20       ger(1).
21
22       Calling  pmDupContext will replicate the current PMAPI context, return‐
23       ing a handle for the new context that may be used with subsequent calls
24       to pmUseContext(3).
25
26       Once  created,  the  duplicated  context  and the original context have
27       independent existence, and so their instance  profiles  and  collection
28       time (relevant only for archive contexts) may be independently varied.
29
30       The newly replicated context becomes the current context.
31

SEE ALSO

33       PMAPI(3), pmNewContext(3) and pmUseContext(3).
34
35
36
37Performance Co-Pilot                  PCP                      PMDUPCONTEXT(3)
Impressum