
Problems
========

If you have trouble, then subscribe and send mail to
dents-list@lists.mindspring.com. We are more than happy to help people
with compilation problems. Happy hacking!


Prerequisites
=============

You will need to install glib from the GNOME project (www.gnome.org).
If you would like to use the control facility, you will also need
ORBit (also from the GNOME project.)

The versions being used by some of the developers are:

  glib-1.2
  ORBit-0.4.3

but prior versions will also likely work.


Hacking code
============

If a .debug file exists in the top level directory when configure is run,
some useful things can happen:

o It will define DEBUG (-DDEBUG) which will include special debugging code
o It will default to bind()'ing on port 1053 instead of port 53. Useful
   for coding when not root
o Debug enables warnings and disables pthreads by default.
o It will also source the .debug file and special variables will control
   the default behaviour of the configure script:
    o pthreads=yes|no
    o warnings=yes|no
    o ctl=yes|no
    o ipv6=yes|no    (not used right now)
    o etcdir=<path>
    o debug=no       (turn off -DDEBUG again)

If you want to run GDB try "./libtool gdb src/dents".

Use "make TAGS" to generate etags.


Configure-options
=================

>  --enable-debug          Turn on debugging
>  --enable-warnings       Enable -Wall if using gcc
>  --disable-dns           Don't compile in DNS support
>  --disable-ipv6          Don't try to compile in IPv6

No effect right now.

>  --disable-ctl           Don't try to compile in the control facility

Requires libpthread and libORBit.

>  --without-pthreads      Don't use pthreads
>  --with-etcdir=PATH      Full path for main configfile
>  --with-static=MOD1 ...  Use these static driver-modules
>  --with-shared=MOD1 ...  Use these shared driver-modules

If you want static modules list all in the same commandline.

Example:  --with-static="mod_stddb mod_recursive"

Alternative: edit modules.conf


Testing
=======

I also use dig @localhost -p 1053 to use the higher port. dig also
does zone transfers, so I use it to test most things with dents. Just
make sure not to use -t axfr to do zone transfer as that will initiate
a UDP zone transfer (which both dents and BIND will ignore for DoS
reasons).


Patches
=======

Also, if you make any patches and would like to submit them, please
send a unified diff (diff -u) to dents-list@lists.mindspring.com or
johannes@sventech.com. If you would like to be in the CREDITS file,
just add yourself and submit that as part of the patch.

