NAME

       pmNotifyErr, pmSyslog - standard handling of error messages

C SYNOPSIS

       #include <pcp/pmapi.h>

       void pmNotifyErr(int priority, const char *message, ...);
       void pmSyslog(int onoff);

       cc ... -lpcp

DESCRIPTION

       These  routines  provide standard handling for error messages from within the internals of
       Performance Co-Pilot (PCP) daemons and Performance Metric Domain Agents (PMDAs).

       pmNotifyErr is a printf(3) style function that will format  message  (and  any  subsequent
       arguments)  with  a prefix that includes the current date and time from ctime(3), the name
       of the application  from  pmGetProgname(3),  the  process's  id  from  getpid(2)  and  the
       priority.

       priority  should  be  one  of the level LOG_ macros defined for syslog(3).  Most typically
       this would be LOG_INFO, LOG_WARNING or LOG_ERR.

       pmNotifyErr writes to standard error, which for daemons and PMDAs  has  most  likely  been
       redirected  to  a  log  file using pmOpenLog(3).  Additionally message (and any subsequent
       arguments) may be sent forwarded to syslog(3) if pmSyslog has previously been called  with
       onoff having a non-zero value.

       Forwarding  to syslog(3) can be disabled at any time by calling pmSyslog with onoff having
       a zero value, and this is the starting state for each PCP application.

       In the style of syslog(3) message need not include a terminating  newline  character  (one
       will be added if required).

SEE ALSO

       getpid(2), ctime(3), PMAPI(3), pmGetProgname(3), pmOpenLog(3), printf(3) and syslog(3).