Tree


Makefile.bsdcommits | blame
Makefile.linuxcommits | blame
Makefile.macosxcommits | blame
READMEcommits | blame
TODOcommits | blame
additional.ccommits | blame
configure*commits | blame
db.hcommits | blame
dns.hcommits | blame
endian.hcommits | blame
example1.confcommits | blame
example2.confcommits | blame
example3.confcommits | blame
example4.confcommits | blame
example7.confcommits | blame
include.hcommits | blame
main.ccommits | blame
parse.ccommits | blame
region.ccommits | blame
reply.ccommits | blame
wildcarddns.confcommits | blame
wildcarddnsd.8commits | blame
wildcarddnsd.cat8commits | blame

README

$Id: README,v 1.14 2010/03/28 16:01:54 pbug Exp $

1. README
2. WHY WILDCARDNS?
3. INSTALL HINTS
4. COMPATIBILITY
5. EXAMPLES
6. WHAT IT CAN'T DO
7. WARNING

1. README 
---------

Wildcarddns is a small authoritative nameserver.  It does not recurse nor 
search.  This program is written to a BSD Style License.  Sleepycat's 
BerkeleyDB is also used for the main in-memory database.

2. WHY WILDCARDDNS?
-------------------

DNS is simple.  Yet implementation of DNS servers is not so simple.
Wildcarddns is written for research into the DNS system so that perhaps one
day the author has a better understanding of it.  Comparing wildcarddns to
other DNS implementations is not fair since many of those implementation
fix Wildcarddns's faults on the Internet.  It is recommended that if this
daemon is used on the Internet that logging be turned on to learn from it
and the DNS system.  Understand what it means to use the -W flag and what
it means to a neighbouring DNS server if the -W flag is left off.  Use the
tool "dig" that comes with bind9 to debug Wildcarddns.  If you like to 
program, then you can fork Wildcarddns and make your own creation, or you
can send patches to the author who may implement them into the code.


3. INSTALL HINTS
----------------

To install, type sh ./configure on BSD and just ./configure on Linux.  This
will copy the proper Makefile to ./Makefile.  Then you would type make, 
followed by su'ing and make install.  Wildcarddnsd installs to /usr/local/sbin.
(In Linux make a user named "named" for the chroot to work, the pwd of named
is where the chroot is set).

Under OpenSuse 10.3 and Ubuntu I noticed the following files missing:
cvs, gcc development and sleepycat's berkeley db (4.5) development.  These
had to be install prior to making wildcarddnsd.  You basically know when you
need to install these, when make barfs with db.h missing (or in extreme cases
sys/param.h missing).

By default installation the configuration file is not installed you need to
do this manually.  Also by default the config file is specified as 
/etc/wildcarddns.conf this can be changed by adding the -f option to 
wildcarddnsd.

A sample config file exists with the sources.  example7.conf was a real life
config once (used with -W flag).


4. COMPATIBILITY
----------------

------------------+--------------------+---------------------+
Operating System: | makes and compiles | responds to queries |
------------------+--------------------+---------------------+
OpenSuse 10.3	  |        yes         |       yes           |
------------------+--------------------+---------------------+
FreeBSD 7.2	  |        yes	       |       yes           |
------------------+--------------------+---------------------+
NetBSD 5.1	  |        yes*        |       yes           |
------------------+--------------------+---------------------+
OpenBSD 4.6	  |        yes         |       yes           |
------------------+--------------------+---------------------+
Ubuntu 9.04       |        yes         |       yes           |
------------------+--------------------+---------------------+

* there was a period in time that NetBSD didn't compile

5. EXAMPLES
-----------

in the directory "examples" are a few examples from working configs.


6. WHAT IT CAN'T DO
-------------------

A lot it can't do.
[stay tuned]

7. WARNING
----------

Please read the following two hyperlinks:

http://queue.acm.org/detail.cfm?id=1647302

and

http://news.zdnet.co.uk/itmanagement/0,1000000308,39760362,00.htm?s_cid=260

Warning: WildcardDNS is research material and could cause problems when on 
the Internet. Understand the licensing if you plan to use it despite, I'm 
not liable and you've been warned.