Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   pmdestroycontext    ( 3 )

уничтожить контекст 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).