1PMDASENDERROR(3)           Library Functions Manual           PMDASENDERROR(3)
2
3
4

NAME

6       pmdaSendError - send an error PDU to PMCD
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/pmda.h>
11
12       void pmdaSendError(pmdaInterface *dispatch, int err);
13
14       cc ... -lpcp_pmda -lpcp
15

PYTHON SYNOPSIS

17       from pcp.pmda import PMDA
18       PMDA.pmda_notready()
19       PMDA.pmda_ready()
20

DESCRIPTION

22       As  part  of  the  Performance  Metrics  Domain  Agent  (PMDA) API (see
23       PMDA(3)), this routine allows a PMDA to send  an  error  PDU  to  PMCD.
24       There  is presently only one use for this - so the PMDA can inform PMCD
25       that it is ready (or not ready) to process requests.
26
27       The protocol details are described in pmcd(1) and  PMDA(3),  but  basi‐
28       cally  if  a  PMDA starts in the notready state (as may be specified in
29       pmcd.conf, see pmcd(1)) then PMCD will not send it any  requests  until
30       the PMDA sends an PM_ERR_PMDAREADY error PDU using this function.  This
31       is used by a PMDA that may have a long startup time, e.g. to process  a
32       large configuration file or similar.
33

SEE ALSO

35       PMAPI(3), PMDA(3), pmcd(1), and pmdaopenmetrics(1).
36
37
38
39Performance Co-Pilot                  PCP                     PMDASENDERROR(3)
Impressum