1PMCD_WAIT(1)                General Commands Manual               PMCD_WAIT(1)
2
3
4

NAME

6       pmcd_wait - wait for PMCD to accept client connections
7

SYNOPSIS

9       $PCP_BINADM_DIR/pmcd_wait [-v?]  [-h host] [-t timeout]
10

DESCRIPTION

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

OPTIONS

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
45       -?, --help
46            Display usage message and exit.
47

DIAGNOSTICS

49       Error messages will be output to stderr only if the verbose mode is on.
50
51       The following exit status codes are returned:
52
53       0      pmcd_wait was able to successfully connect to  pmcd  within  the
54              timeout period.
55
56       1      A usage error occurred, use -v for more details.
57
58       2      No  connection was made in the timeout interval.  This will hap‐
59              pen if pmcd is running but takes too long to complete the client
60              connection,  or  if  pmcd  is not running and all connection at‐
61              tempts in the timeout interval failed with  the  error  ECONNRE‐
62              FUSED.
63
64       3      A UNIX error occurred, use -v for more details.
65
66       4      A PCP error occurred, use -v for more details.
67

PCP ENVIRONMENT

69       Environment variables with the prefix PCP_ are used to parameterize the
70       file and directory names used by PCP.  On each installation,  the  file
71       /etc/pcp.conf  contains  the  local  values  for  these variables.  The
72       $PCP_CONF variable may be used to specify an alternative  configuration
73       file, as described in pcp.conf(5).
74

SEE ALSO

76       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
77
78
79
80Performance Co-Pilot                  PCP                         PMCD_WAIT(1)
Impressum