NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS | 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 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
       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.

SEE ALSO         top

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

DIAGNOSTICS         top

       PM_ERR_NOCONTEXT
              no current context

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information 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@oss.sgi.com.  This page was obtained from the project's upstream
       Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05.  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)