1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
'\"macro stdmacro
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc. All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMCD_WAIT 1 "PCP" "Performance Co-Pilot"
.SH NAME
\f3pmcd_wait\f1 \- wait for PMCD to accept client connections
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH SYNOPSIS
\f3$PCP_BINADM_DIR/pmcd_wait\f1
[\f3-h\f1 \f2host\f1]
[\f3-t\f1 \f2interval\f1]
[\f3\-v\f1]
.SH DESCRIPTION
.B pmcd_wait
waits for the Performance
Metrics Collector Daemon (PMCD) to be running and accepting client connections.
.P
Unless directed to another host by the
.B \-h
option,
.B pmcd_wait
will try to contact
.BR pmcd (1)
on the local host.
.P
.B pmcd_wait
will timeout and abandon the attempt to connect to
.B pmcd
after 60 seconds. This default timeout interval
may be changed using the
.B \-t
option, where the
.I interval
argument follows the syntax described in
.BR PCPIntro (1)
and in the simplest form may be an unsigned integer (the implied
units in this case are seconds).
.P
On successful connection to
.B pmcd
an exit status of zero is returned.
.PP
If an error or timeout occurs, then a non-zero exit status is returned
as described below.
.PP
The other options are as follows:
.TP
.B \-v
This option turns the verbose mode on.
With the verbose mode off
(which is the default), no output will be generated.
With verbose mode on, error messages will be output on
.IR stderr .
.SH "PCP ENVIRONMENT"
Environment variables with the prefix
.B PCP_
are used to parameterize the file and directory names
used by PCP.
On each installation, the file
.I /etc/pcp.conf
contains the local values for these variables.
The
.B $PCP_CONF
variable may be used to specify an alternative
configuration file,
as described in
.BR pcp.conf (5).
.SH SEE ALSO
.BR PCPIntro (1),
.BR pmcd (1),
.BR pcp.conf (5)
and
.BR pcp.env (5).
.SH DIAGNOSTICS
Error messages will be output to
.I stderr
only if the verbose mode is on.
.P
The following exit status codes are returned:
.TP
.B 0
.B pmcd_wait
was able to successfully connect to
.B pmcd
within the timeout period.
.TP
.B 1
A usage error occurred, use
.B \-v
for more details.
.TP
.B 2
No connection was made in the timeout interval.
This will happen if
.B pmcd
is running but
takes too long to complete the client connection, or if
.B pmcd
is not running and all connection attempts in the timeout
interval failed with the error ECONNREFUSED.
.TP
.B 3
A U\s-2NIX\s+2 error occurred, use
.B \-v
for more details.
.TP
.B 4
A PCP error occurred, use
.B \-v
for more details.
|
