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
	 privileges, 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 relevant man pages for more
	 information on how to set up these files.
