INTRODUCTION
============

The DNS Analyzer is a tool to gather statistics on DNS traffic from
tcpdump(8) files.  See dns-analyzer(1) for usage information.

The current release is 0.3.0.


PREREQUISITES
=============

The DNS Analyzer requires the following software:

    - A standard compliant ISO C++ compiler.
    - The libpcap library (http://www.tcpdump.org/).

Recommended is the cppunit (http://cppunit.sourceforge.net/) library
for running the built-in test code.  This is mainly required if you
wish to modify the software.


TESTED PLATFORMS
================

Version 0.3 was compiled and run on the following platforms:

- Fedora Code 1, GCC 3.3.2, libpcap 0.7.2, cppunit 1.8.0.
- Fedora Code 1, GCC 3.4.0, libpcap 0.7.2, cppunit 1.9.2.

Version 0.2 was compiled and run on the following platforms:

- RedHat 8.0, GCC 3.2, libpcap 0.6.2, cppunit 1.8.0.
- RedHat 8.0, Intel C++ Compiler 7.0, libpcap 0.6.2.
- Solaris 8, GCC 3.2, libpcap 0.6.2.
- FreeBSD 5.0, GCC 3.2.2, libpcap 0.7+multidlt.

The RedHat 8.0 with GCC 3.2 has been the most heavily tested platform.


INSTALLATION
============

First extract the package from the tar file:

    $ gtar xvzf dns-analyzer-0.3.0.tar.gz

This creates a new directory dns-analyzer-0.3.0.  Change to this
directory:

    $ cd dns-anayzer-0.3.0

The DNS Analyzer build process follows the standard GNU process using
configure:

    $ ./configure

You can use the --prefix option to change the root of the installation
directory.  The default installation root is /usr/local.

If you wish to pass flags to the compiler or linker for the
configuration process (or wish to use a different compiler) you can
override the following environment variables:

  CC        The C compiler command (used for some configuration tests).

  CXX       The C++ compiler command.
  CXXFLAGS  Flags for the compiler when compiling C++ source files.
  CPPFLAGS  Flags for the compiler when preprocessing C++ source files.
  LDFLAGS   Flags for the linker.

For example, if you wish to use the Intel C Compiler (icc). specify
the location of the pcap library, and wish to install the DNS Analyzer
in /opt/dns-analyzer, you can use the following command:

    $ CXX=icc CPPFLAGS='-I/opt/pcap/include' \
    > LDFLAGS='-L/opt/pcap/include' ./configure \
    > --prefix=/opt/dns-analyzer

When the configuration has successfully completed you can build the
software using GNU make:

    $ gmake

This will compile the software and run some test cases if you have the
CppUnit library installed.

After compilation is successful you can install the software using:

    $ gmake install

This will install the binaries into ${prefix}/bin and the manual pages
into ${prefix}/man.
