tcpclient(1)                                         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-envi-
       ron(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 sec-
              onds. 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.





                                                                1





tcpclient(1)                                         tcpclient(1)


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

       -d     Delay sending data for a fraction of a second when-
              ever the remote host is responding 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 $TCPREMOTEHOST.

       -l localname
              Do not look up the local  host  name  in  DNS;  use
              localname  for  the environment variable $TCPLOCAL-
              HOST. 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















                                                                2