|PMDASENDERROR(3)||Library Functions Manual||PMDASENDERROR(3)|
NAME¶pmdaSendError - send an error PDU to PMCD
C SYNOPSIS¶#include <pcp/pmapi.h>
void pmdaSendError(pmdaInterface *dispatch, int err);
cc ... -lpcp_pmda -lpcp
PYTHON SYNOPSIS¶from pcp.pmda import PMDA
DESCRIPTION¶As part of the Performance Metrics Domain Agent (PMDA) API (see PMDA(3)), this routine allows a PMDA to send an error PDU to PMCD. There is presently only one use for this - so the PMDA can inform PMCD that it is ready (or not ready) to process requests.
The protocol details are described in pmcd(1) and PMDA(3), but basically if a PMDA starts in the notready state (as may be specified in pmcd.conf, see pmcd(1)) then PMCD will not send it any requests until the PMDA sends an PM_ERR_PMDAREADY error PDU using this function. This is used by a PMDA that may have a long startup time, e.g. to process a large configuration file or similar.
SEE ALSO¶PMAPI(3), PMDA(3), pmcd(1), and pmdaopenmetrics(1).