D. J. Bernstein
Internet publication
DNScache

How to install DNScache

Like any other piece of software (and information generally), DNScache comes with NO WARRANTY.

Exception: See the DNScache security guarantee.

System requirements

DNScache works only under UNIX.

DNScache uses daemontools to start, monitor, and control the DNS services. Before running DNScache you need to install daemontools 0.61 or above. Make sure that the daemontools programs are in your system's default path.

You will also need to install ucspi-tcp if you want to use axfrdns or axfr-get.

Installation

Download the DNScache package. The latest published DNScache package is dnscache-1.00.tar.gz.

Unpack the DNScache package:

     gunzip dnscache-1.00.tar
     tar -xf dnscache-1.00.tar
     cd dnscache-1.00

Compile the DNScache programs:

     make

As root, install the DNScache programs under /usr/local:

     make setup check

Now you can configure a local cache, an external cache, and a DNS server. If you're not familiar with DNScache, you should start by reviewing the standard configuration and, if you're behind a firewall, the standard firewall configuration. If you're not familiar with the Domain Name System, you should start by learning how DNS works.

To report success:

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

Installing documentation

To install a local copy of these web pages under /doc, download doc.tar.gz, and unpack it in the / directory:
     gunzip < doc.tar.gz | (cd /; tar -xf -)
     cd /doc
     sort -ft'>' +1 merge/*/packages.html > packages.html.new
     mv packages.html.new packages.html
     sort -ft'>' +1 merge/*/commands.html > commands.html.new
     mv commands.html.new commands.html
     sort -ft'>' +1 merge/*/libraries.html > libraries.html.new
     mv libraries.html.new libraries.html