table of contents
PMDADAEMON(3) | Library Functions Manual | PMDADAEMON(3) |
NAME¶
pmdaDaemon - initialize the PMDA to run as a daemonC SYNOPSIS¶
#include <pcp/pmapi.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.
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.SEE ALSO¶
PMAPI(3), PMDA(3), pmdaDSO(3), pmdaGetOpt(3) and pmdaText(3).PCP | Performance Co-Pilot |