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.
                                                               ()
