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. 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 pmEvent-
FlagsStr_r instead.
SEE ALSO
PMAPI(3) and pmdaEventAddRecord(3).
Performance Co-Pilot PCP PMEVENTFLAGSSTR(3)
