NAME
pmdaOpenLog - redirect stderr to a logfile
C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/impl.h>
#include <pcp/pmda.h>
void pmdaOpenLog(pmdaInterface * dispatch);
cc ... -lpcp_pmda -lpcp
DESCRIPTION
pmdaOpenLog redirects stderr to the logfile specified in
the dispatch structure, set by the previous call to
pmdaDaemon(3) or pmdaGetOpt(3). The first line of the log
file will detail the name of the calling process, the host
the process is running on, and the current time. In addi
tion, the log is appended with the exit time of the pro
cess by a routine registered with atexit(3C).
CAVEAT
The PMDA must be using PMDA_PROTOCOL_2 or later, as speci
fied in the call to pmdaDSO(3) or pmdaDaemon(3).
A PMDA(3) which uses at least one sproc(2) may dump core
on exit due to a race condition with atexit(2) in some
versions of IRIX. There is no known solution for this
problem at this time.
PCP ENVIRONMENT
Environment variables with the prefix PCP_ are used to
parameterize the file and directory names used by PCP. On
each installation, the file /etc/pcp.conf contains the
local values for these variables. The $PCP_CONF variable
may be used to specify an alternative configuration file,
as described in pcp.conf(4). Values for these variables
may be obtained programatically using the pmGetConfig(3)
function.
SEE ALSO
pmcd(1), atexit(2), PMAPI(3), PMDA(3), pmdaDaemon(3) and
pmdaGetOpt(3).
Man(1) output converted with
man2html