| PMFREEEVENTRESULT(3) | Library Functions Manual | PMFREEEVENTRESULT(3) |
NAME
pmFreeHighResEventResult, pmFreeEventResult - release storage allocated for unpacked event records
C SYNOPSIS
#include <pcp/pmapi.h>
void pmFreeHighResEventResult(pmResult **hrset);
void pmFreeEventResult(pmResult_v2 **rset);
cc ... -lpcp
DESCRIPTION
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.
SEE ALSO
| PCP | Performance Co-Pilot |