To view MaraDNS in action, do the following:

* Compile MaraDNS.  Type in './configure; make' in this directory (the 
  top-level MaraDNS directory.)
  Note: No need to compile if you downloaded a binary RPM or Debian package.

* Install the MaraDNS package.  As root:

	make install

  This will install both the binaries and the man pages for 'maradns',
  'askmara', 'getzone', and 'zoneserver'.  In addition, this will (if
  the files are not already present), install an example /etc/mararc,
  make the /etc/maradns directory, and place an example zone file
  (db.example.com) in /etc/maradns.  Finally, this will place MaraDNS
  documentation in /usr/local/doc.  

* Run the maradns program as root.  After changing the root directory, 
  binding to UDP port 53, and dropping root privledges, the program will 
  run.  Note that the program does not become a daemon.

* If MaraDNS is being tested as an authoritative nameserver, test this 
  program with one of the following invocations:

	dig @127.0.0.3 example.com
	nslookup example.com 127.0.0.3
	./tools/askmara Aexample.com. 127.0.0.3

* To test MaraDNS as a recursive server, copy over 
  doc/examples/example_recursive_mararc over to /etc/mararc.  Next,
  stop (if applicable) then restart maradns

* If MaraDNS is being tested as an recursive nameserver, try one of 
  the following:

	dig @127.0.0.3 google.com
	./tools/askmara Agoogle.com. 127.0.0.3

Note that this program does not need to run as root if you have 
hacked the kernel to allow non-root programs to bind to UDP port 53.  
However, when run as a non-root user, the directory is not chrooted, 
requiring the paths in the csv1 key fields to be absolute paths.

Look in doc or read the relevent man pages for more information on how 
to set up these files.

