Movatterモバイル変換

pmindomstr(3) — Linux manual page

PMINDOMSTR(3)            Library Functions ManualPMINDOMSTR(3)

NAME        top

pmInDomStr,pmInDomStr_r- convert a performance metric instance       domain identifier into a string

C SYNOPSIS        top

#include <pcp/pmapi.h>const char *pmInDomStr(pmInDomindom);char *pmInDomStr_r(pmInDomindom, char *buf, intbuflen);cc ... -lpcp

DESCRIPTION        top

       For use in error and diagnostic messages,pmInDomStrreturn a 'hu‐       man readable' version of the specified instance domain identifier.       ThepmInDomStr_rfunction does the same, but stores the result in       a user-supplied bufferbuf of lengthbuflen,  which  should  have       room for at least 20 bytes.       The  value  for  the  instance domainindom is typically extracted       from apmDesc structure, following a call topmLookupDesc(3) for a       particular performance metric.       Internally, an instance domain  identifier  is  encoded  with  two       fields: domain and serial.pmInDomStrreturns  a string with each of the fields appearing as       decimal numbers, separated by periods.       The string value returned bypmInDomStris held in a single static       buffer, so the returned value is only valid until the next call topmInDomStr.

NOTES        top

pmInDomStrreturns a pointer to a static buffer and hence  is  not       thread-safe.   Multi-threaded applications should usepmInDomStr_r       instead.

PCP ENVIRONMENT        top

       Environment variables with the prefixPCP_are used to  parameter‐       ize  the  file and directory names used by PCP.  On each installa‐       tion, the file/etc/pcp.conf contains the local values  for  these       variables.   The$PCP_CONFvariable may be used to specify an al‐       ternative configuration file, as described inpcp.conf(5).  Values       for these variables may be  obtained  programmatically  using  thepmGetConfig(3) function.

SEE ALSO        top

PMAPI(3),pmGetConfig(3),pmIDStr(3),pmTypeStr(3),pmSemStr(3),pmUnitsStr(3),pmLookupDesc(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               PCPPMINDOMSTR(3)

Pages that refer to this page:pmidstr(3), pmindom_helper(3), pmsemstr(3), pmtypestr(3), pmunitsstr(3), pmwebapi(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.