***********************
*** README for DNSD ***
***********************

Copyright (c) 2005/2006 by Norbert Freudemann
                            <nofreude@informatik.uni-tuebingen.de>
 For copyright information, see the file COPYING which comes with
 the distribution.


RUNNING THE NAMESERVER:
-----------------------

1) Install SCSH, SUnet and SUnterlib
   ---------------------------------

 For instructions see www.scsh.net


2) The configuration
   -----------------

 There is a folder etc/ containing the files

  dnsd-options.scm
  dnsd-zones.scm
  dnsd-pre.scm
  dnsd-post.scm

 and some additional masterfile-examples.

 You can copy this files to a directory of your liking
 or simply use the given path (from the SUnet-installation). 

 Either way, the path will be called <path-to-options>.


 You can customize the files:

  2.1) dnsd-options.scm

   Options for DNSD. Open the file for documentation.


  2.2) dnsd-zones.scm

   Add/remove zones to DNSD. Documentation is included in the file.


  2.3) dnsd-pre.scm / dnsd-post.scm

   You can customize the behaviour of query-processing within these
   two files.


3) Run SCSH:
   ---------

 Load the CML-API from SUnterlib and SUnet.

 > scsh -lel cml/load.scm -lel sunet/load.scm


4) SCSH-REPL:
   ----------

 >,in dnsd

 Start DNSD with

  dnsd> (dnsd-start) 

 if the current working-directory is <path-to-options> or else use

  dnsd> (dnsd-start <path-to-options>)


5) While running DNSD:
   -------------------

 * Reload the file dnsd-options.scm with the POSIX-signal USR1.
 * Reload the file dnsd-zones.scm with the POSIX-signal USR2.