NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON |
|
|
PMFREERESULT(3) Library Functions Manual PMFREERESULT(3)
pmFreeResult, pmFreeHighResResult, - release storage allocated for performance metrics values
#include <pcp/pmapi.h> void pmFreeResult(pmResult *result); void pmFreeHighResResult(pmHighResResult *result); cc ... -lpcp
The variable sized results returned by pmFetch(3) and pmFetchHighRes(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 pmFetch(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). Similarly, memory allocated for the high resolution timestamped result structure returned from pmFetchHighRes(3) should be released by a call to pmFreeHighResResult.
malloc(3), PMAPI(3), pmFetch(3) and pmFetchHighRes(3).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
(At that time, the date of the most recent commit that was found
in the repository was 2024-06-14.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
Performance Co-Pilot PCP PMFREERESULT(3)
Pages that refer to this page: pmapi(3), pmfetch(3), pmfetcharchive(3)