PMWHICHCONTEXT(3)         Library Functions Manual         PMWHICHCONTEXT(3)

NAME         top

       pmWhichContext - identify the current PMAPI context

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       int pmWhichContext(void);

       cc ... -lpcp

DESCRIPTION         top

       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

       pmWhichContext returns a handle for the current PMAPI context, that
       may be used in the associated PMAPI routines that require a handle to
       identify a PMAPI context.

SEE ALSO         top

       PMAPI(3), pmDestroyContext(3), pmDupContext(3), pmNewContext(3) and

DIAGNOSTICS         top

              no current context

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨⟩ on
       2018-02-02.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-02-02.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Performance Co-Pilot                 PCP                   PMWHICHCONTEXT(3)

Pages that refer to this page: pmaddprofile(3)pmapi(3)pmdelprofile(3)pmdestroycontext(3)pmfetch(3)pmnewcontext(3)pmusecontext(3)