PMDADAEMON(3)
NAME
pmdaDaemon - initialize the PMDA to run as a daemon
C SYNOPSIS
#include <pcp/pmapi.h>
#include <pcp/impl.h>
#include <pcp/pmda.h>
void pmdaDaemon(pmdaInterface *dispatch, int interface, char *name, int
domain, char *logfile, char *helptext);
cc ... -lpcp_pmda -lpcp
DESCRIPTION
pmdaDaemon initializes the pmdaInterface structure to use the interface
extensions assuming the PMDA(3) is to be run as a daemon. The pmdaInterface structure is initialized with:
name The name of the agent.
- domain The default domain number of the agent which uniquely
- identifies this PMDA from other running PMDAs. This may be subsequently changed by a command line option -d (see pmdaGetOpt(3)).
- logfile The default path to the log file. This may be replaced
- by the -l command line option if using pmdaGetOpt.
- helptext The default path to the help text (see pmdaText(3).
- This may be replaced by the -h command line option if using pmdaGetOpt(3). If no help text is installed, or you are not using pmdaText(3), then this should be set to NULL.
- The callbacks are initialized to pmdaProfile(3), pmdaFetch(3), pmdaDesc(3), pmdaText(3), pmdaInstance(3) and pmdaStore(3).
DIAGNOSTICS
- Unable to allocate memory for pmdaExt structure
- In addition, the dispatch->status field is set to a value less than zero.
- PMDA interface version interface not supported
- The interface version is not supported by pmdaDaemon.
CAVEAT
The PMDA must be using PMDA_INTERFACE_2 or later.