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 pmGetProg‐
       name(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).

Performance Co-Pilot                                   PCP                                        PMNOTIFYERR(3)