уничтожить контекст PMAPI (destroy a PMAPI context)
Имя (Name)
pmDestroyContext - destroy a PMAPI context
Синопсис C (C Synopsis)
#include <pcp/pmapi.h>
int pmDestroyContext(int handle);
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).
pmDestroyContext destroys the PMAPI context identified by handle.
Typically this would imply some termination of a connection to a
PMCD or closing an archive log file, and orderly clean-up.
The context must have been previously created using
pmNewContext(3) or pmDupContext(3).
On success, pmDestroyContext returns zero. If handle was the
current PMAPI context, then the current context becomes
undefined. This means the application must explicitly re-
establish a valid PMAPI context with pmUseContext(3), or create a
new context with pmNewContext(3) or pmDupContext(3), before the
next PMAPI operation that requires a PMAPI context.
Диагностика (Diagnostic)
PM_ERR_NOCONTEXT
handle does not identify a valid PMAPI context
Смотри также (See also)
PMAPI(3), pmDupContext(3), pmNewContext(3), pmUseContext(3) and
pmWhichContext(3).
