PMEVENTFLAGSSTR(3)         Library Functions Manual         PMEVENTFLAGSSTR(3)

NAME
       pmEventFlagsStr, pmEventFlagsStr_r - convert an event record flags
       value into a string

C SYNOPSIS
       #include <pcp/pmapi.h>

       const char *pmEventFlagsStr(int flags);
       char *pmEventFlagsStr_r(int flags, char *buf, int buflen);

       cc ... -lpcp

DESCRIPTION
       For use in error and diagnostic messages, pmEventFlagsStr returns a
       `human readable' version of the value flags, assuming this to be the
       er_flags field of a pmEventRecord or pmEventHighResRecord.  The
       pmEventFlagsStr_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 64 bytes.

       The string value result from pmEventFlagsStr is held in a single static
       buffer, so the returned value is only valid until the next call to
       pmEventFlagsStr.

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

SEE ALSO
       PMAPI(3) and pmdaEventAddRecord(3).

Performance Co-Pilot                  PCP                   PMEVENTFLAGSSTR(3)