pmFreeEventResult(3)

pmFreeEventResult3

Release storage allocated for unpacked event records

C synopsis

#include <pcp/pmapi.h>

void pmFreeHighResEventResult(pmResult **hrset);
void pmFreeEventResult(pmResult_v2 **rset);

cc ... -lpcp

Overview

When processing event records, if pmUnpackHighResEventRecords(3) is used to unpack event records from a metric within a pmResult structure with a value of type PM_TYPE_HIGHRES_EVENT then the structure returned from pmUnpackHighResEventRecords(3) is a NULL pointer terminated array of pointers to pmResult structures, one for each event record.

pmFreeHighResEventResult is a convenience method that frees all of the pmResult structures and the array of pointers (hrset).

Similarly, pmFreeEventResult may be used to free the pmResult_v2 structures and array returned from the pmUnpackEventRecords routine when using PM_TYPE_EVENT metrics.

Releases

6 releases since Debian 8 (Jessie); the text changed 3 times.

  1. 8–10
  2. 11–12
  3. 13
  4. Arch

From pcp 7.2.2-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.