TELNET-PROBE(1) 					      General Commands Manual						   TELNET-PROBE(1)

NAME

       telnet-probe - lightweight telnet-like port probe

SYNOPSIS

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

DESCRIPTION

       telnet-probe  allows  the  pmdashping(1)  daemons  to establish connections to arbitrary local and remote service-providing daemons so that
       response time and service availability information can be obtained.

       The required host and port number arguments have the same meaning as their telnet(1) equivalents.

       The -c option causes telnet-probe to perform a connect(2) only.	This skips the read(2) and write(2) exercise that would otherwise be  done
       after connecting (see below).

       The -v option causes telnet-probe to be verbose while operating.

       Once the telnet connection has been established, telnet-probe reads from stdin until end-of-file, and writes all the input data to the tel-
       net connection.	Next, telnet-probe will read from the telnet connection until end-of-file, discarding whatever	data  it  receives.   Then
       telnet-probe exits.

       To  operate  successfully,  the input passed via telnet-probe to the remote service must be sufficient to cause the remote service to close
       the connection when the last line of input has been processed, e.g. ending with ``quit'' when probing SMTP on port 25.

       By default telnet-probe will not produce any output, unless there is an error in which case a diagnostic message can be displayed (in  ver-
       bose mode only) and the exit status will be non-zero indicating a failure.

PCP ENVIRONMENT

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

DIAGNOSTICS

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

SEE ALSO

       PCPintro(1), pmdashping(1), pmie(1), telnet(1), connect(2), read(2) and write(2).

Performance Co-Pilot							PCP							   TELNET-PROBE(1)