pmwhichcontext(3) — Linux manual page

NAME | C SYNOPSIS | DESCRIPTION | DIAGNOSTICS | SEE ALSO | COLOPHON

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 Program‐
       ming 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

       PM_ERR_NOCONTEXT
              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.  In‐
       formation about the project can be found at ⟨http://www.pcp.io/⟩.
       If you have a bug report for this manual page, send it to
       pcp@groups.io.  This page was obtained from the project's upstream
       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩ on
       2025-08-11.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-08-11.)  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 man-pages@man7.org

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)