haeredes.cabal

   1 name:           haeredes
   2 version:        0.5.2
   3 cabal-version:  >= 1.8
   4 author:         Michael Orlitzky
   5 maintainer:     Michael Orlitzky <michael@orlitzky.com>
   6 license:        AGPL-3
   7 license-file:   doc/LICENSE
   8 homepage:       http://michael.orlitzky.com/code/haeredes.xhtml
   9 bug-reports:    mailto:michael@orlitzky.com
  10 category:       DNS, Utils
  11 build-type:     Simple
  12 extra-source-files:
  13   doc/man1/haeredes.1
  14   test/shell/*.test
  15 synopsis:
  16   Confirm delegation of NS and MX records.
  17 description:
  18   Haeredes is primarily useful for ISP network administrators.
  19   Customers will occasionally decide to switch hosts without alerting
  20   the current host; this can cause two problems:
  21   .
  22     * With NS records, the previous host (at the very least) keeps
  23       hosting a DNS zone that does nothing. If that host uses their
  24       authoritative nameserver as a caching lookup server as well, it
  25       may return incorrect results to queries about the domain in
  26       question.
  27   .
  28     * For MX records, the situation is slightly worse. Most mail servers
  29       will immediately accept mail for which the server thinks it is the
  30       ultimate destination. If a mail server is configured as the
  31       destination for a domain, but it is not the MX for that domain,
  32       then mail submitted to that server may possibly be lost. It is
  33       therefore important to remove domains from the old mail host as
  34       soon as the MX record is changed.
  35   .
  36   Haeredes can alert administrators when NS/MX records are changed. More
  37   detail and usage examples can be found in the man page.
  38   .
  39   /Examples/:
  40   .
  41   Make sure example.com has the expected name servers,
  42   [ab].iana-servers.net:
  43   .
  44   @
  45   $ echo \"example.com\" | haeredes a.iana-servers.net b.iana-servers.net
  46   @
  47   .
  48   Check orlitzky.com against only one of the expected two nameservers:
  49   .
  50   @
  51   $ echo \"orlitzky.com\" | haeredes dns1.viabit.com
  52   Domain \"orlitzky.com.\" delegates somewhere else: \"dns2.viabit.com.\"
  53   @
  54   .
  55   Check a nonexistent domain (we provide no delegates, since we
  56   know .doesnt-exist will not be delegated):
  57   .
  58   @
  59   $ echo \"foo.doesnt-exist\" | haeredes
  60   Domain \"foo.doesnt-exist.\" not delegated.
  61   @
  62
  63 executable haeredes
  64   build-depends:
  65     base                        == 4.*,
  66     bytestring                  >= 0.10,
  67     cmdargs                     >= 0.10,
  68     dns                         >= 1.4,
  69     iproute                     >= 1.2,
  70     parallel-io                 >= 0.3
  71
  72   main-is:
  73     Main.hs
  74
  75   hs-source-dirs:
  76     src/
  77
  78   other-modules:
  79     CommandLine
  80     DNS
  81     ExitCodes
  82     -- WARNING: the Paths_haeredes module is automatically generated by
  83     -- Cabal itself. We don't want it included in the release tarballs,
  84     -- since we typically want the paths that the user has configured.
  85     -- Nevertheless, Cabal will complain if we don't include it here.
  86     Paths_haeredes
  87     Timeout
  88
  89
  90 test-suite doctests
  91   type: exitcode-stdio-1.0
  92   hs-source-dirs: test
  93   main-is: Doctests.hs
  94   build-depends:
  95     base      == 4.*,
  96     -- Additional test dependencies.
  97     doctest   >= 0.9,
  98     filemanip >= 0.3.6
  99
 100
 101 -- These won't work without shelltestrunner installed in your
 102 -- $PATH. Maybe there is some way to tell Cabal that.
 103 test-suite shelltests
 104   type: exitcode-stdio-1.0
 105   hs-source-dirs: test
 106   main-is: ShellTests.hs
 107
 108   build-depends:
 109     base                        == 4.*,
 110     process                     >= 1.1
 111
 112
 113 source-repository head
 114   type: git
 115   location: http://gitweb.michael.orlitzky.com/haeredes.git
 116   branch: master