The installation procedure for ucspi-tcp is the familiar make setup check.

First, obtain the source distribution for the package. Right click on the link above; use ftp, wget, curl; whatever works for you. The installation procedure described below assumes the package will be available on your system in /usr/local/djb/dist/ucspi-tcp-0.88.tar.gz.

Verify the MD5 checksum:

# cd /usr/local/djb/dist
# md5 ucspi-tcp-0.88.tar.gz
MD5 (ucspi-tcp-0.88.tar.gz) = 39b619147db54687c4a583a7a94c9163

If the reported checksum doesn't agree, the package has been altered or corrupted. Delete the package and download it again from a trusted source.

Unpack the archive into your build directory:

# cd /usr/local/djb/build
# tar -xzvf ../dist/ucspi-tcp-0.88.tar.gz

You should now find a new directory in /usr/local/djb/build named ucspi-tcp-0.88. Change into this directory:

# cd ucspi-tcp-0.88

Apply patches as necessary. The errno patch is for GNU glibc systems as described in the appendix errno patches. The nobase patch fixes up a problem in the rblsmtpd program, removing the URL for the default black hole list no longer freely available. The a_record patch also affects the rblsmtpd program, allowing you to specify the error to return for zones with only A records. The rblsmtpd program will be reviewed later in the section on qmail and spam; for now, just proceed with these patches:

# patch -p1 < ../../patches/ucspi-tcp-0.88.errno.patch
# patch -p1 < ../../patches/ucspi-tcp-0.88.nobase.patch
# patch -p1 < ../../patches/ucspi-tcp-0.88.a_record.patch

Then continue with the build/install:

# make setup check

Now we can set up /etc/tcprules:

# mkdir /etc/tcprules

Download/copy this Makefile into /etc/tcprules/Makefile, and MAKEALL.sh into /etc/tcprules/MAKEALL.sh. (We'll describe the purpose of these later.)

All done? Yes! Let Bernstein know how everything worked out, substituting your own name in the following:

# (echo 'Hillary Clinton'; cat `cat SYSDEPS`) | mail djb-sysdeps@cr.yp.to 

We are now ready for some fun! The next section describes how to say Howdy! with ucspi-tcp.