int pmNameInDomArchive(pmInDom indom, int inst, char **name)
cc ... -lpcp
DESCRIPTION
Provided that the current
Performance Metrics Application Programming Interface (PMAPI)
context is associated with an archive log,
pmNameInDomArchive
will scan the union of all the instance domain metadata
for the instance domain
indom,
locate the first instance with the internal instance identifier given
by
inst,
and return the full external instance identification via
name.
This routine is a specialized version of the more general PMAPI
routine
pmNameInDom.
The value for the instance domain
indom
is typically extracted from a
pmDesc
structure, following a call to
pmLookupDesc(3)
for a particular performance metric.
The space for the value of
name
will have been allocated in
pmNameInDomArchive
with
malloc(3C),
and it is the responsibility of the caller to
free(3C)
the space when it is no longer required.