NAME

       pmNameAll - translate a PMID to a set of performance metric names

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmNameAll(pmID pmid, char ***nameset);

       cc ... -lpcp

DESCRIPTION

       Given  a  Performance  Metric  Identifier (PMID) via pmid, pmNameAll will determine all the corresponding
       metric names, if any, in the Performance Metrics Name Space (PMNS), and return these via nameset.

       The resulting list of pointers nameset and the values (the relative names) that  the  pointers  reference
       will  have  been  allocated by pmNameAll with a single call to malloc(3), and it is the responsibility of
       the pmNameAll caller to use free(nameset) to release the space when it is no longer required.

       In the absence of errors, pmNameAll returns the number of names in nameset.

       For many examples of a PMNS, there will be a 1:1 mapping between a name  and  a  PMID,  and  under  these
       circumstances,  pmNameID(3) provides a slightly simpler interface in the absence of duplicate names for a
       particular PMID.

SEE ALSO

       PMAPI(3),    pmGetChildren(3),    pmGetChildrenStatus(3),    pmGetConfig(3),     pmLoadASCIINameSpace(3),
       pmLoadNameSpace(3), pmLookupName(3), pmNameID(3), pmNewContext(3), pcp.conf(5), pcp.env(5) and PMNS(5).

DIAGNOSTICS

       PM_ERR_NOPMNS
              Failed  to  access  a  PMNS  for  operation.   Note that if the application hasn't a priori called
              pmLoadNameSpace(3) and wants to use the distributed PMNS, then a call to pmNameAll  must  be  made
              after the creation of a context (see pmNewContext(3)).

       PM_ERR_PMID
              pmid does not correspond to a defined PMID in the PMNS.

       PM_ERR_*
              Other diagnostics are for protocol failures when accessing the distributed PMNS.