<HEAD>
<TITLE>Files in the MaraDNS source directory</TITLE>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
<DTWIDTH>4</DTWIDTH>
</HEAD>
<BODY>
This document describes each file or directory at the MaraDNS
source top-level directory.
<DL>
<DT>00README.FIRST
<DD>Legal disclaimer
<DT>0QuickStart
<DD>Quick start guide; geared for experienced UNIX admins
<DT>build/
<DD>Files used to compile, install, and make RPMs of MaraDNS. This will also
include patches and scripts that update a stable release of MaraDNS.
<DT>CHANGELOG
<DD>Link to an ASCII version of the changelog document
<DT>configure
<DD>Script which sets up the Makefile; uses uname to detect the system
being used. Non-autoconf because an autoconf-enabled system requires
the presence of non-BSD licensed code.
<DT>CREDITS
<DD>List of people who have helped with MaraDNS' development
<DT>dns/
<DD>Source code files with functions which manipulate the raw DNS data
<DT>doc/
<DD>Documentation
<DT>FAQ
<DD>Link to an ASCII version of the MaraDNS FAQ (Frequently Asked Questions)
<DT>libs/
<DD>The libraries for the overflow-resistant string functions, and to the
hashing core used by MaraDNS.
<DT>locale.de
<DD>Shell script which changes some of the messages which MaraDNS outputs
from English to German. This needs to be run <i>before</i> compiling
MaraDNS.
<DT>locale.en
<DD>Shell script which changes the language of MaraDNS' messages to English
(this is the default language). This needs ot be run <i>before</i>
compiling MaraDNS.
<DT>locale.es
<DD>Shell script which changes some of the messages which MaraDNS outputs
from English to Spanish. This needs to be run <i>before</i> compiling
MaraDNS.
<DT>Makefile
<DD>Starts off as a wrapper which runs configure to generate the makefile,
then runs 'make' on that Makefile.
<DT>MaraDNS.h
<DD>Header files which defines some of MaraDNS' structures; this file is
used by source files in many different MaraDNS directories.
<DT>maradns.gpg.key
<DD>The GPG key which is used to sign MaraDNS releases.
<DT>parse/
<DD>Routines which parse the mararc file and the csv1 zone files.
<DT>qual/
<DD>Y2038 compliant timestamp routines
<DT>rng/
<DD>Routines used by the secure random number generator
<DT>server/
<DD>The core maradns server
<DT>sqa/
<DD>Routines used for MaraDNS regression and stress testing; not compiled
by default
<DT>tcp/
<DD>The TCP domain zone and TCP server and the getzone domain zone client
<DT>test/
<DD>Routines used for testing some library routines in MaraDNS; not compiled
by default
<DT>tools/
<DD>askmara; the "ej" tools used for processing MaraDNS documentation; and
some other scripts I wrote for various MaraDNS-development related
purposes
<DT>utf8/
<DD>Some routines for 8859-1 to utf-8 conversion; currently unused by
MaraDNS
</DL>
</BODY>
