PMFREEEVENTRESULT

Section: C Library Functions (3)
Index Return to Main Contents

NAME

pmFreeEventResult , pmFreeHighResEventResult - release storage allocated for unpacked event records

C SYNOPSIS

#include < pcp/pmapi.h >

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

cc ... -lpcp

DESCRIPTION

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

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

Similarly, pmFreeHighResEventResult may be used to free the pmHighResResult structures and array returned from the pmUnpackHighResEventRecords routine when using PM_TYPE_HIGHRES_EVENT metrics.

SEE ALSO

PMAPI (3) and pmUnpackEventRecords (3).


Index

NAME
C SYNOPSIS
DESCRIPTION
SEE ALSO