1PMCD_WAIT(1) General Commands Manual PMCD_WAIT(1)
2
3
4
6 pmcd_wait - wait for PMCD to accept client connections
7
9 $PCP_BINADM_DIR/pmcd_wait [-v] [-h host] [-t timeout]
10
12 pmcd_wait waits for the Performance Metrics Collector Daemon (PMCD) to
13 be running and accepting client connections.
14
15 Unless directed to another host by the -h option, pmcd_wait will try to
16 contact pmcd(1) on the local host.
17
18 pmcd_wait will timeout and abandon the attempt to connect to pmcd after
19 60 seconds. This default timeout interval may be changed using the -t
20 option, where the interval argument follows the syntax described in
21 PCPIntro(1) and in the simplest form may be an unsigned integer (the
22 implied units in this case are seconds).
23
24 On successful connection to pmcd an exit status of zero is returned.
25
26 If an error or timeout occurs, then a non-zero exit status is returned
27 as described below.
28
30 The available command line options are:
31
32 -h host, --host=host
33 Connect pmcd(1) on host, rather than the one on the default local‐
34 host.
35
36 -t timeout, --interval=timeout
37 Timeout after timeout seconds if not connected. The default time‐
38 out value is 60 seconds.
39
40 -v, --verbose
41 This option turns the verbose mode on. With the verbose mode off
42 (which is the default), no output will be generated. With verbose
43 mode on, error messages will be output on stderr.
44
46 Error messages will be output to stderr only if the verbose mode is on.
47
48 The following exit status codes are returned:
49
50 0 pmcd_wait was able to successfully connect to pmcd within the
51 timeout period.
52
53 1 A usage error occurred, use -v for more details.
54
55 2 No connection was made in the timeout interval. This will hap‐
56 pen if pmcd is running but takes too long to complete the client
57 connection, or if pmcd is not running and all connection
58 attempts in the timeout interval failed with the error ECONNRE‐
59 FUSED.
60
61 3 A UNIX error occurred, use -v for more details.
62
63 4 A PCP error occurred, use -v for more details.
64
66 Environment variables with the prefix PCP_ are used to parameterize the
67 file and directory names used by PCP. On each installation, the file
68 /etc/pcp.conf contains the local values for these variables. The
69 $PCP_CONF variable may be used to specify an alternative configuration
70 file, as described in pcp.conf(5).
71
73 PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
74
75
76
77Performance Co-Pilot PCP PMCD_WAIT(1)