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