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

DIAGNOSTICS

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

PCP ENVIRONMENT

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

SEE ALSO

73       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
74
75
76
77Performance Co-Pilot                  PCP                         PMCD_WAIT(1)
Impressum