external/bsd/bind/dist/bin/tests/system/README

   1 Copyright (C) 2004, 2010, 2011, 2013, 2015  Internet Systems Consortium, Inc. ("ISC")
   2 Copyright (C) 2000, 2001  Internet Software Consortium.
   3 See COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
   4
   5 This is a simple test environment for running bind9 system tests
   6 involving multiple name servers.
   7
   8 There are multiple test suites, each in a separate subdirectory and
   9 involving a different DNS setup.  They are:
  10
  11   dnssec/       DNSSEC tests
  12   forward/      Forwarding tests
  13   glue/         Glue handling tests
  14   limits/       Tests of handling of large data (close to server limits)
  15   lwresd/       Tests of the lightweight resolver library and daemon
  16   notify/       More NOTIFY tests
  17   nsupdate/     Dynamic update and IXFR tests
  18   resolver/     Regression tests for resolver bugs that have been fixed
  19                 (not a complete resolver test suite)
  20   rrl/          query rate limiting
  21   rpz/          Tests of response policy zone (RPZ) rewriting
  22   rpzrecurse/   Another set of RPZ tests to check recursion behavior
  23   stub/         Tests of stub zone functionality
  24   unknown/      Unknown type and class tests
  25   upforwd/      Update forwarding tests
  26   views/        Tests of the "views" statement
  27   xfer/         Zone transfer tests
  28   xferquota/    Zone transfer quota tests
  29
  30 Typically each test suite sets up 2-5 name servers and then performs
  31 one or more tests against them.  Within the test suite subdirectory,
  32 each name server has a separate subdirectory containing its
  33 configuration data.  By convention, these subdirectories are named
  34 "ns1", "ns2", etc.
  35
  36 The tests are completely self-contained and do not require access to
  37 the real DNS.  Generally, one of the test servers (ns1) is set up as a
  38 root name server and is listed in the hints file of the others.
  39
  40 To enable all servers to run on the same machine, they bind to
  41 separate virtual IP address on the loopback interface.  ns1 runs on
  42 10.53.0.1, ns2 on 10.53.0.2, etc.  Before running any tests, you must
  43 set up these addresses by running "ifconfig.sh up" as root.
  44
  45 Mac OS X:
  46 If you wish to make the interfaces survive across reboots
  47 copy org.isc.bind.system and org.isc.bind.system to
  48 /Library/LaunchDaemons then run
  49 "launchctl load /Library/LaunchDaemons/org.isc.bind.system.plist" as
  50 root.
  51
  52 The servers use port 5300 instead of the usual port 53, so they can be
  53 run without root privileges once the interfaces have been set up.
  54
  55 The tests can be run individually like this:
  56
  57   sh run.sh xfer
  58   sh run.sh notify
  59   etc.
  60
  61 To run all the tests, just type "make test".
  62
  63 Id: README,v 1.16 2011/01/13 04:59:24 tbox Exp