tcpclient(1)                         General Commands Manual                         tcpclient(1)



NAME
       tcpclient - creates an outgoing TCP connection.

SYNOPSIS
       tcpclient [ opts ] host port prog

DESCRIPTION
       opts  is  a  series of getopt-style options.  host is one argument.  port is one argument.
       prog consists of one or more arguments.

       tcpclient attempts to connect to a TCP server. If it is successful,  it  runs  prog,  with
       descriptor  6  reading  from  the network and descriptor 7 writing to the network. It also
       sets up several environment variables (see tcp-environ(5) ).

       The server's address is given by host and port.  port may be a name from /etc/services  or
       a  number.  host may be 0, referring to the local machine, or a dotted-decimal IP address,
       or a host name; it is fed through qualification using dns_ip4_qualify.

       If the server has several IP addresses, tcpclient tries each address in turn.

OPTIONS
       General options:

       -q     Quiet. Do not print error messages.

       -Q     (Default.) Print error messages.

       -v     Verbose. Print error messages and status messages.

       Connection options:

       -T x+y Give up on the connection attempt after x+y seconds. Default: 2+58. When a host has
              several  IP  addresses, tcpclient tries to connect to the first IP address, waits x
              seconds, tries to connect to the second IP address, waits x seconds, etc.; then  it
              retries each address that timed out, waiting y seconds per address. You may omit +y
              to skip the second try. Before version 0.88, tcpclient(1) will use only x (default:
              60).

       -i localip
              Use localip as the IP address for the local side of the connection; quit if localip
              is not available. Normally tcpclient lets the operating system choose an address.

       -p localport
              Use localport as the TCP port for the local side of the connection; quit if  local‐
              port is not available. Normally tcpclient lets the operating system choose a port.

       -d     Delay  sending data for a fraction of a second whenever the remote host is respond‐
              ing slowly. This is currently the default, but it may not be in the future; if  you
              want it, set it explicitly.

       -D     Never delay sending data; enable TCP_NODELAY.

       Data-gathering options:

       -h     (Default.)  Look  up  the  remote  host name in DNS to set the environment variable
              $TCPREMOTEHOST.

       -H     Do not look up the remote host name in DNS; remove the environment variable $TCPRE‐
              MOTEHOST.

       -l localname
              Do  not look up the local host name in DNS; use localname for the environment vari‐
              able $TCPLOCALHOST. A common choice for localname is 0.

       -r     (Default.) Attempt to obtain $TCPREMOTEINFO from the remote host.

       -R     Do not attempt to obtain $TCPREMOTEINFO from the remote host.

       -t n   Give up on the $TCPREMOTEINFO connection attempt after n seconds. Default: 26.

SEE ALSO
       tcpserver(1),   tcprules(1),   tcprulescheck(1),   argv0(1),   fixcrio(1),    recordio(1),
       rblsmtpd(1),  who@(1),  date@(1),  finger@(1), http@(1), tcpcat(1), mconnect(1), tcp-envi‐
       ron(5)

       http://cr.yp.to/ucspi-tcp.html



                                                                                     tcpclient(1)