tcpclient - create an outgoing TCP connection
tcpclient [ -46hHrRdDqQv ] [ -i localip ] [ -p localport ] [ -T timeoutconn ] [ -l localname ] [ -t timeoutinfo ] [ -I ifname ] host port program [ arg ... ]
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, a compactified IPv6 address, or a dotted-decimal IPv4 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).
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 accept IPv6 connections. Use DNSCACHEIP to set the DNS resolver IP dynamically.
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.
- -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.
Never delay sending data; enable TCP_NODELAY. This is appropriate for interactive connections.
- -i localip
Use localip as the IP address for the local side of the connection; quit if localip is not available.
- -I ifname
Bind to the network interface ifname ("eth0" on Linux, for example). This is only defined and needed for IPv6 link-local addresses.
- -p localport
Use localport as the port number for the local side of the connection; quit if localport is not available.
Quiet. Do not print any messages.
- -Q (Default.)
Print error messages.
Verbose. Print all available messages.
- -h (Default.)
Look up the remote host name and set TCPREMOTEHOST.
Do not look up the remote host name.
- -l localname
Do not look up the local host name; use localname for TCPLOCALHOST.
Attempt to obtain TCPREMOTEINFO from the remote host.
- -R (Default.)
Do not attempt to obtain TCPREMOTEINFO from the remote host.
- -t timeout
Give up on the TCPREMOTEINFO connection attempt after timeout seconds. Default: 26.
argv0(1), fixcr(1), recordio(1), tcpserver(1), tcprules(1), listen(2), tcp-environ(5)