Movatterモバイル変換

pmsemstr(3) — Linux manual page

PMSEMSTR(3)              Library Functions ManualPMSEMSTR(3)

NAME        top

pmSemStr,pmSemStr_r- convert a performance metric semantic into       a string

C SYNOPSIS        top

#include <pcp/pmapi.h>const char *pmSemStr(intsem);char *pmSemStr_r(intsem, char *buf, intbuflen);cc ... -lpcp

DESCRIPTION        top

       Given  a  performance  metricsemantic,pmSemStrproduces a terse       ASCII equivalent, appropriate for use in error and diagnostic mes‐       sages.  ThepmSemStr_rfunction does the same, but stores the  re‐       sult  in a user-supplied bufferbuf of lengthbuflen, which should       have room for at least 20 bytes.       The value forsem is typically extracted from apmDesc  structure,       following  a  call topmLookupDesc(3) for a particular performance       metric.       Examples arecounter(forsem  equalsPM_SEM_COUNTER),discrete       (forsem   equalsPM_SEM_DISCRETE),instant(forsem  equalsPM_SEM_INSTANT), etc.

NOTES        top

       Both of these routines are safe to  call  from  threaded  applica‐       tions.

SEE ALSO        top

PMAPI(3),pmAtomStr(3),pmConvScale(3),pmExtractValue(3),pmLookupDesc(3),pmPrintValue(3),pmIDStr(3),pmInDomStr(3),pmTypeStr(3) andpmUnitsStr(3).

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               PCPPMSEMSTR(3)

Pages that refer to this page:pmidstr(3), pmindomstr(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.