pmwhichcontext(3) — Linux manual page


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 of performance metrics
       as created by pmlogger(1).

       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.

DIAGNOSTICS         top

              no current context

SEE ALSO         top

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

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 2023-12-22.
       (At that time, the date of the most recent commit that was found
       in the repository was 2023-12-16.)  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)