1PMEVENTFLAGSSTR(3)         Library Functions Manual         PMEVENTFLAGSSTR(3)
2
3
4

NAME

6       pmEventFlagsStr,  pmEventFlagsStr_r  -  convert  an  event record flags
7       value into a string
8

C SYNOPSIS

10       #include <pcp/pmapi.h>
11
12       const char *pmEventFlagsStr(int flags);
13       char *pmEventFlagsStr_r(int flags, char *buf, int buflen);
14
15       cc ... -lpcp
16

DESCRIPTION

18       For use in error and diagnostic  messages,  pmEventFlagsStr  returns  a
19       `human  readable'  version  of the value flags, assuming this to be the
20       er_flags  field  of  a  pmEventRecord  or  pmEventHighResRecord.    The
21       pmEventFlagsStr_r  function  does  the same, but stores the result in a
22       user-supplied buffer buf of length buflen, which should have  room  for
23       at least 64 bytes.
24
25       The string value result from pmEventFlagsStr is held in a single static
26       buffer, so the returned value is only valid  until  the  next  call  to
27       pmEventFlagsStr.
28

NOTES

30       pmEventFlagsStr  returns  a pointer to a static buffer and hence is not
31       thread-safe.  Multi-threaded applications should use  pmEventFlagsStr_r
32       instead.
33

SEE ALSO

35       PMAPI(3) and pmdaEventAddRecord(3).
36
37
38
39Performance Co-Pilot                  PCP                   PMEVENTFLAGSSTR(3)