1PMFREELABELSETS(3)         Library Functions Manual         PMFREELABELSETS(3)
2
3
4

NAME

6       pmFreeLabelSets  -  release  storage  allocated  for performance metric
7       labels
8

C SYNOPSIS

10       #include <pcp/pmapi.h>
11
12       void pmFreeLabelSets(pmLabelSet *sets, int nsets);
13
14       cc ... -lpcp
15

DESCRIPTION

17       The array of label sets returned by pmLookupLabels(3) and related  APIs
18       are  allocated  below  the  Performance Metrics Application Programming
19       Interface (PMAPI) using a variety of calls to the system's dynamic mem‐
20       ory allocation (i.e. malloc(3)) interfaces.
21
22       Applications  should call pmFreeLabelSets to release the storage previ‐
23       ously allocated for the label sets array when access to  the  structure
24       is  no  longer  needed.  The return value from pmLookupLabels indicates
25       the number of elements in the label sets  array,  and  this  should  be
26       passed in using the nsets parameter.
27
28       Under  no  circumstances  should  an  application use free(labelset) to
29       release storage previously allocated for a  pmLabelSet  by  pmLookupLa‐
30       bels(3) or related APIs.
31

SEE ALSO

33       malloc(3), PMAPI(3) and pmLookupLabels(3).
34
35
36
37Performance Co-Pilot                  PCP                   PMFREELABELSETS(3)
Impressum