NAME
pmWhichContext - identify the current PMAPI context
C SYNOPSIS
#include <pcp/pmapi.h>
int pmWhichContext(void)
cc ... -lpcp
DESCRIPTION
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
PMAPI(3), pmDestroyContext(3), pmDupContext(3), pmNewContext(3) and
pmUseContext(3).
DIAGNOSTICS
PM_ERR_NOCONTEXT
no current context