hsdns-1.0: README

An asynchronous DNS resolver for Haskell_
=========================================

:Latest Release: hsdns-1.0.tar.gz_
:Darcs:          darcs_ get http://cryp.to/hsdns/

Synopsis
--------

  This library provides an asynchronous DNS resolver on top of
  the `GNU ADNS library`_. Not all options are supported, but A,
  MX, and PTR lookups work fine. The code has been been tested
  with ADNS versions 1.0 to 1.4.

  The example program adns-reverse-lookup.hs_ demonstrates how
  the resolver is used. Given a list of host names on the command
  line, it performs an A/PTR double-lookup and checks whether the
  records are consistent. The output is printed in the order in
  which the DNS responses arrive::

    $ ./adns-reverse-lookup xyz.example.org ecrc.de www.example.com www.cryp.to
    OK: www.example.com <-> 208.77.188.166
    ERR: xyz.example.org: cannot resolve A
    FAIL: www.cryp.to -> 195.234.152.69 -> ["research.cryp.to"]
    FAIL: ecrc.de -> 127.0.0.1 -> ["localhost"]

Documentation
-------------

  `Reference Documentation`_
     Haddock-generated reference of all exported functions.

Copyleft
--------

  Copyright (c) 2007 Peter Simons <simons@cryp.to>. All rights
  reserved. This software is released under the terms of the `GNU
  Lesser General Public License
  <http://www.gnu.org/licenses/lgpl.html>`_.

-----------------------------------------------------------------

`[Homepage] <http://cryp.to/>`_

.. _Haskell: http://haskell.org/

.. _Cabal: http://haskell.org/cabal/

.. _darcs: http://abridgegame.org/darcs/

.. _GNU ADNS library: http://www.chiark.greenend.org.uk/~ian/adns/

.. _Reference Documentation: docs/index.html

.. _hsdns-1.0.tar.gz: http://cryp.to/hsdns/hsdns-1.0.tar.gz

.. _adns-reverse-lookup.hs: example/adns-reverse-lookup.hs