Movatterモバイル変換

pmnameindomarchive(3) — Linux manual page

PMNAMEINDOMARCHIVE(3)    Library Functions ManualPMNAMEINDOMARCHIVE(3)

NAME        top

pmNameInDomArchive- translate an instance identifier into an       instance name

C SYNOPSIS        top

#include <pcp/pmapi.h>int pmNameInDomArchive(pmInDomindom, intinst, char **name);cc ... -lpcp

DESCRIPTION        top

       Provided that the current Performance Metrics Application Program‐       ming  Interface  (PMAPI)  context  is  associated  with  a  set of       archives,pmNameInDomArchivewill scan the union of  all  the  in‐       stance  domain  metadata for the instance domainindom, locate the       first instance with the internal instance identifier given byin‐st, and return the full external instance identification vianame.       This  routine  is  a specialized version of the more general PMAPI       routinepmNameInDom.       The value for the instance domainindom  is  typically  extracted       from apmDesc structure, following a call topmLookupDesc(3) for a       particular performance metric.       The  space  for  the value ofname will have been allocated inpm‐NameInDomArchivewithmalloc(3), and it is the  responsibility  of       the caller tofree(3) the space when it is no longer required.pmNameInDomArchivereturns zero on success.

DIAGNOSTICS        top

PM_ERR_NOTARCHIVE              the current PMAPI context is not associated with a set of              archivesPM_ERR_INDOM_LOGindom is not a defined instance domain identifier for the              set of archivesPM_ERR_INST_LOG              the instance identifierinst is not known for the instance              domainindom in the set of archives

SEE ALSO        top

PMAPI(3),pmGetConfig(3),pmGetInDomArchive(3),pmLookupInDomArchive(3),pmNameInDom(3),pcp.conf(5) andpcp.env(5).

COLOPHON        top

       This page is part of thePCP (Performance Co-Pilot) project.  In‐       formation about the project can be found at ⟨http://www.pcp.io/⟩.       If you have a bug report for this manual page, send it to       pcp@groups.io.  This page was obtained from the project's upstream       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩ on       2025-08-11.  (At that time, the date of the most recent commit       that was found in the repository was 2025-08-11.)  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 isnot part of the original manual page), send a       mail to man-pages@man7.orgPerformance Co-Pilot               PCPPMNAMEINDOMARCHIVE(3)

Pages that refer to this page:pcpintro(3), pmgetindomarchive(3), pmlookupindomarchive(3), pmnameindom(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.