NAME

       pmFreeResult - release storage allocated for performance metrics values

C SYNOPSIS

       #include <pcp/pmapi.h>

       void pmFreeResult(pmResult *result);

       cc ... -lpcp

DESCRIPTION

       The variable sized results returned by pmFetch(3) are allocated below the Performance Metrics Application
       Programming  Interface (PMAPI) using a combination of dynamic (i.e. malloc(3)) and specialized allocation
       strategies.

       Applications should call pmFreeResult to release the storage  previously  allocated  for  result  by  pm‐
       Fetch(3), when the application no longer requires access to the pmResult structure.

       Under no circumstances should an application use free(result) to release storage previously allocated for
       a pmResult by pmFetch(3).

COMPATIBILITY

       Prior to PCP 7.0 the timestamp field in the pmResult struct was a struct timeval.  To support PMAPI tran‐
       sition,  the  old  interface  and  semantics can be used if applications are recompiled with -DPMAPI_VER‐
       SION=2.

       For a time in PCP 6.x there was a routine with the same semantics as the current pmFreeResult called  pm‐
       FreeHighResResult  although  this is now deprecated and compile-time support for pmFreeHighResResult will
       be removed in a future release.

SEE ALSO

       PMAPI(3), malloc(3) and pmFetch(3).

Performance Co-Pilot                                   PCP                                       PMFREERESULT(3)