Provided by: ucspi-tcp-ipv6_0.88-3_i386 bug

NAME

       tcpclient - create an outgoing TCP connection

SYNOPSIS

       tcpclient   [   -46hHrRdDqQv   ]  [  -ilocalip  ]  [  -plocalport  ]  [
       -Ttimeoutconn ] [ -llocalname ] [ -ttimeoutinfo ] [ -Iinterface ]  host
       port program [ arg ...  ]

DESCRIPTION

       tcpclient attempts to connect to a TCP server.  If it is successful, it
       runs program with the given arguments, with descriptor 6  reading  from
       the network and descriptor 7 writing to the network.

       The  server's  address  is  given  by  host  and  port.  host may be 0,
       referring to the local machine, or a dotted-decimal IP  address,  or  a
       host  name; if a host has several IP addresses, tcpclient tries each in
       turn.  port may be a numeric port number or a port name.

       tcpclient sets up several environment variables, as described  in  tcp-
       environ(5).

OPTIONS

       -ilocalip
              Use  localip  as  the  IP  address  for  the  local  side of the
              connection; quit if localip is not available.

       -plocalport
              Use localport as the port number  for  the  local  side  of  the
              connection; quit if localport is not available.

       -Iinterface
              Use  interface  as  the  local  network interface.  This is only
              defined for IPv6 sockets and needed if you use  link-local  IPv6
              addresses.

       -Ttimeoutconn
              Give  up  on  the  connection attempt after timeoutconn seconds.
              Default: 60.  This timeout applies to each IP address tried.

       -d     (Default.)  Delay sending  data  for  a  fraction  of  a  second
              whenever  the  remote  host is responding slowly, to make better
              use of the network.

       -D     Never  delay  sending  data;  enable   TCP_NODELAY.    This   is
              appropriate for interactive connections.

       -q     Quiet.  Do not print any messages.

       -Q     (Default.)  Print error messages.

       -v     Verbose.  Print all available messages.

DATA-GATHERING OPTIONS

       -h     (Default.)  Look up the remote host name for TCPREMOTEHOST.

       -H     Do not look up the remote host name; unset TCPREMOTEHOST.

       -llocalname
              Do   not  look  up  the  local  host  name;  use  localname  for
              TCPLOCALHOST.

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

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

       -ttimeoutinfo
              Give   up   on   the   TCPREMOTEINFO  connection  attempt  after
              timeoutinfo seconds. Default: 26.

       -4     Fall back to IPv4 sockets.  This  is  necessary  for  terminally
              broken  systems  like  OpenBSD  which  will not let IPv6 sockets
              connect to V4-mapped IPv6 addresses.  Please note that this also
              applies  to DNS lookups, so you will have to use an DNS resolver
              with an IPv6 address to connect to IPv6 systems.  Use DNSCACHEIP
              to set the DNS resolver IP dynamically.

       -6     Force  IPv6  mode  in UCSPI environment variables, even for IPv4
              connections.  This will set $PROTO to TCP6 and  put  IPv4-mapped
              IPv6 addresses in TCPLOCALIP and TCPREMOTEIP.

SEE ALSO

       date@(1),  finger@(1),  http@(1), mconnect(1), tcpcat(1), tcpserver(1),
       who@(1), tcp-environ(5)

                                                                  tcpclient(1)