User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |

---

   pmfreelabelsets    ( 3 )

---

---

Имя (Name)

pmFreeLabelSets - release storage allocated for performance
       metric labels

---

Синопсис C (C Synopsis)

#include <pcp/pmapi.h>

       void pmFreeLabelSets(pmLabelSet *sets, int nsets);

       cc ... -lpcp

---

Описание (Description)

The array of label sets returned by pmLookupLabels(3) and related
       APIs are allocated below the Performance Metrics Application
       Programming Interface (PMAPI) using a variety of calls to the
       system's dynamic memory allocation (i.e. malloc(3)) interfaces.

       Applications should call pmFreeLabelSets to release the storage
       previously allocated for the label sets array when access to the
       structure is no longer needed.  The return value from
       pmLookupLabels indicates the number of elements in the label sets
       array, and this should be passed in using the nsets parameter.

       Under no circumstances should an application use free(labelset)
       to release storage previously allocated for a pmLabelSet by
       pmLookupLabels(3) or related APIs.

       To simplify error handling, if sets is NULL then pmFreeLabelSets
       simply returns without freeing any storage.

---

Смотри также (See also)

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

---