MaraDNS Quick Start guide

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
  >     	./tools/askmara Aexample.com. 127.0.0.3

- To test MaraDNS as a recursive server, copy over doc/en/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.