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  as‐
18       sociated  with  a  source  of performance metrics, e.g. pmcd(1) on some
19       host, or a set of archives 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 in‐
27       dependent existence, and so their instance profiles and collection time
28       (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