1TELNET-PROBE(1)             General Commands Manual            TELNET-PROBE(1)
2
3
4

NAME

6       telnet-probe - lightweight telnet-like port probe
7

SYNOPSIS

9       $PCP_BINADM_DIR/telnet-probe [-c] [-v] host port
10

DESCRIPTION

12       telnet-probe  allows the pmdashping(1) daemons to establish connections
13       to  arbitrary  local  and  remote  service-providing  daemons  so  that
14       response time and service availability information can be obtained.
15
16       The  required  host  and port number arguments have the same meaning as
17       their telnet(1) equivalents.
18
19       The -c option causes telnet-probe to perform a connect(2)  only.   This
20       skips  the  read(2)  and write(2) exercise that would otherwise be done
21       after connecting (see below).
22
23       The -v option causes telnet-probe to be verbose while operating.
24
25       Once the telnet connection has  been  established,  telnet-probe  reads
26       from stdin until end-of-file, and writes all the input data to the tel‐
27       net connection.  Next, telnet-probe will read from the  telnet  connec‐
28       tion  until  end-of-file,  discarding  whatever data it receives.  Then
29       telnet-probe exits.
30
31       To operate successfully, the  input  passed  via  telnet-probe  to  the
32       remote  service must be sufficient to cause the remote service to close
33       the connection when the last line of input  has  been  processed,  e.g.
34       ending with ``quit'' when probing SMTP on port 25.
35
36       By default telnet-probe will not produce any output, unless there is an
37       error in which case a diagnostic message can be displayed  (in  verbose
38       mode only) and the exit status will be non-zero indicating a failure.
39

PCP ENVIRONMENT

41       Environment variables with the prefix PCP_ are used to parameterize the
42       file and directory names used by PCP.  On each installation,  the  file
43       /etc/pcp.conf  contains  the  local  values  for  these variables.  The
44       $PCP_CONF variable may be used to specify an alternative  configuration
45       file, as described in pcp.conf(5).
46

DIAGNOSTICS

48       If  telnet-probe  succeeds, then 0 will be returned.  If the attempt to
49       establish a connection fails or is terminated,  then  a  non-zero  exit
50       status is returned.
51

SEE ALSO

53       PCPintro(1), pmdashping(1), pmie(1), telnet(1), connect(2), read(2) and
54       write(2).
55
56
57
58Performance Co-Pilot                  PCP                      TELNET-PROBE(1)
Impressum