SYNOPSIS
tcpclient [ -46hHrRdDqQv ] [ -ilocalip ] [ -plocalport ] [
-Ttimeoutconn ] [ -llocalname ] [ -ttimeoutinfo ] [ -Iifname ] 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, which
is identical to 127.0.0.1, or ::1 referring to the IPv6 loopback
address, a compactified IPv6 address, a dotted-decimal IPv4 address, or
a host name. If a host name is given, tcpclient facilitates a DNS
lookup and tries each address 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
-4 Fall back to IPv4 sockets.
-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.
-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.
-Iifname
Use ifname 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
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.
ENVIRONMENT VARIABLES READ
tcpclient reads the environment variable DNSCACHEIP which can be used
to specify the recursive DNS Resolver dynamically.
SEE ALSO
date@(1), finger@(1), http@(1), mconnect(1), tcpcat(1), tcpserver(1),
who@(1), tcp-environ(5)
tcpclient(1)
Man(1) output converted with
man2html