http://cr.yp.to/ucspi-tcp.html
http://cr.yp.to/ucspi-tcp/install.html
http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz

ucspi-tcp

The tcpserver program 
The tcprules program 
The tcprulescheck program 
The argv0 program 
The fixcrio program 
The recordio program 
The rblsmtpd program

The tcpclient program 
The who@ program 
The date@ program 
The finger@ program 
The http@ program 
The tcpcat program 
The mconnect program 
The addcr and delcr programs

TCP environment variables

What is it?

tcpserver waits for incoming connections and, for each connection, runs a program of your choice. Your program receives environment variables showing the local and remote host names, IP addresses, and port numbers.

tcpserver offers a concurrency limit to protect you from running out of processes and memory. When you are handling 40 (by default) simultaneous connections, tcpserver smoothly defers acceptance of new connections.

tcpserver also provides TCP access control features, similar to tcp-wrappers/tcpd's hosts.allow but much faster. Its access control rules are compiled into a hashed format with cdb, so it can easily deal with thousands of different hosts.

This package includes a recordio tool that monitors all the input and output of a server.

tcpclient makes a TCP connection and runs a program of your choice. It sets up the same environment variables as tcpserver.

This package includes several sample clients built on top of tcpclient: who@, date@, finger@, http@, tcpcat, and mconnect.

tcpserver and tcpclient conform to UCSPI, the UNIX Client-Server Program Interface, using the TCP protocol. UCSPI tools are available for several different networks.

Other command-line TCP tools

ucspi-tcp now competes with several other programs:

• inetd, a root-only TCP server supplied by all UNIX vendors;
• xinetd, a replacement for inetd;
• the mconnect client supplied as part of SunOS;
• the socket program;
• faucet and hose, part of the netpipes package; and
• the netcat program, which also supports UDP.

Many sites are replacing inetd with tcpserver, for several reasons:

• inetd is unreliable under high loads. It cuts off service for 10 minutes if it receives ``too many'' connections in 1 minute.
• inetd does not provide effective resource management. It will happily use up all your memory if you are running a popular service.
• inetd has trouble with sudden bursts of activity. Its listen() backlog is typically only 5 or 10 and cannot be raised.

How to install ucspi-tcp

System requirements

Installation

Unpack the ucspi-tcp package:

     gunzip ucspi-tcp-0.88.tar
     tar -xf ucspi-tcp-0.88.tar
     cd ucspi-tcp-0.88

Compile the ucspi-tcp programs:

     make

As root, install the ucspi-tcp programs under /usr/local:

     make setup check

To report success:

     ( echo 'First M. Last'; cat `cat SYSDEPS` ) \
     | mail djb-sysdeps@cr.yp.to 

Replace First M. Last with your name.