User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |

---

   pmsemstr    ( 3 )

---

---

Имя (Name)

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

---

Синопсис C (C Synopsis)

#include <pcp/pmapi.h>

       const char *pmSemStr(int sem);
       char *pmSemStr_r(int sem, char *buf, int buflen);

       cc ... -lpcp

---

Описание (Description)

Given a performance metric semantic, pmSemStr produces a terse
       ASCII equivalent, appropriate for use in error and diagnostic
       messages.  The pmSemStr_r function does the same, but stores the
       result in a user-supplied buffer buf of length buflen, which
       should have room for at least 20 bytes.

       The value for sem is typically extracted from a pmDesc structure,
       following a call to pmLookupDesc(3) for a particular performance
       metric.

       Examples are counter (for sem equals PM_SEM_COUNTER), discrete
       (for sem equals PM_SEM_DISCRETE), instant (for sem equals
       PM_SEM_INSTANT), etc.

---

Примечание (Note)

Both of these routines are safe to call from threaded
       applications.

---

Смотри также (See also)

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

---