<html><head><title>adns - advanced, alternative, asynchronous resolver</title>
-<!--
- Note: this file is maintained in Ian Jackson's private CVS.
-
- It is served on the GNU site and also from my own system, under the
- URL http://www.chiark.greenend.org.uk/adns/ Please ensure that all
- links continine to be correct both for www.gnu.org and chiark.
-
- $Id$
- -->
<link rev="made" href="mailto:adns-maint@chiark.greenend.org.uk">
+<meta name="keywords" content="adns">
</head>
<body>
<h1>GNU adns</h1>
<strong>Advanced, easy to use, asynchronous-capable DNS client
library and utilities.</strong>
+<!-- Note: this file must contain portable HTML ! -->
+<!-- -->
+<!-- It is served on the GNU site and also from my own system, -->
+<!-- under the URL http://www.chiark.greenend.org.uk/adns/ -->
+<!-- Please ensure that all links continine to be correct -->
+<!-- both for www.gnu.org and chiark. -->
+<!-- -->
+<!-- $Id$ -->
+
<p>
adns is a resolver library for C (and C++) programs, and a collection
-of useful DNS resolver utilities. In contrast with the existing
-interfaces, gethostbyname et al and libresolv, it has the following
-features:
+of useful DNS resolver utilities.
+
+
+<h2>C library</h2>
+
+In contrast with the standard interfaces, gethostbyname et al and
+libresolv, it has the following features:
<ul>
scripts to do simple lookups. In a more advanced mode it can be used
as a general-purpose DNS helper program for scripting languages which
can invoke and communicate with subprocesses. See the
-<A href="http://www.chiark.greenend.org.uk/~ian/adns/usage/adnsresfilter_usage.text">usage
-message</A> for a summary of its capabilities.
+<A href="http://www.chiark.greenend.org.uk/~ian/adns/adnshost.txt">adnshost
+usage message</A> for a summary of its capabilities.
</ul>
-<h2>Technical note</h2>
+<h2>Forthcoming:</h2>
-adns requires a real nameserver like
-<A href="http://www.isc.org/view.cgi?/products/BIND/index.phtml">BIND</A>
-or
-<A href="http://www.dents.org/">Dents</A> running on
-the same system or a nearby one, which must be willing to provide
-`recursive service'. I.e., adns is a `stub resolver'. All properly
-configured UN*X and GNU systems will already have such nameserver(s);
-they are usually listed in /etc/resolv.conf.
+I hope that future versions may also have the following features:
+
+<ul>
+
+<li>The library should be useable by threads in a multithreaded
+program in a natural way. It should multiplex many threads' queries
+through a single query socket.
+
+<li>IPv6 support.
+
+<li>Some kind of awareness of DNSSEC.
+
+<li>Possibly some very limited caching behaviour.
+
+<li>There was, at one point, a draft native Perl interface from Tony Finch.
+
+</ul>
<h2>Documentation</h2>
I have set up mailinglists <code>adns-announce</code> and
<code>adns-discuss</code>. The announcements list is moderated and
-will contain only announcements of important bugs, new versions, &c.
+will contain only announcements of important bugs, new versions, etc.
The bug reports address mentioned above is also a mailing list; feel
free to subscribe to it.
<A href="http://www.chiark.greenend.org.uk/~ian/adns/">chiark.greenend.org.uk</A>
are:
<ul>
-<li>The <A href="http://www.chiark.greenend.org.uk/~ian/adns/adns.tar.gz">current beta version</A>
- as a gzipped tarfile.
+<li>The <A href="http://www.chiark.greenend.org.uk/~ian/adns/adns.tar.gz">current
+ release</A> as a gzipped tarfile.
<li><A href="http://www.chiark.greenend.org.uk/~ian/adns/adns.h.txt">adns.h</A>
- API header file with comments (currently there is no manual, sorry).
+ API header file with comments, and
+ <A href="http://www.chiark.greenend.org.uk/~ian/adns/adnshost.txt">usage
+ message for adnshost</A> (currently there is no manual, sorry).
<li>All versions released so far are also available via
<A href="ftp://ftp.chiark.greenend.org.uk/users/ian/adns/">anonymous
- FTP</A>.
-<li>A mirror of my CVS repository is available via rsync from
+ FTP</A> and <A href="http://www.chiark.greenend.org.uk/~ian/adns/ftp/">HTTP</A>.
+</ul>
+
+You can also access the project CVS repositories:
+<ul>
+<li>A mirror of the source code repository is available via rsync from
<code>rsync.chiark.greenend.org.uk::ftp/users/ian/cvs-pub/adns</code>
(use FTP first to find your way around), or via
<A href="http://www.chiark.greenend.org.uk/ucgi/~ijackson/cvsweb/adns/">cvsweb</A>.
+<li>This web page is maintained in
+ <A href="http://savannah.gnu.org/">Savannah</A>,
+ where you can browse the
+ <A href="http://savannah.gnu.org/cgi-bin/viewcvs/software/adns/?cvsroot=www.gnu.org">webpage CVS</A>.
</ul>
adns is also available from the
<A href="http://www.gnu.org/">GNU Project</A> FTP servers and their
<A href="http://www.gnu.org/order/ftp.html">mirrors</A>.
+<h2>Technical note</h2>
+
+adns requires a real nameserver like
+<A href="http://www.isc.org/view.cgi?/products/BIND/index.phtml">BIND</A>
+or
+<A href="http://www.dents.org/">Dents</A> running on
+the same system or a nearby one, which must be willing to provide
+`recursive service'. I.e., adns is a `stub resolver'. All properly
+configured UN*X and GNU systems will already have such nameserver(s);
+they are usually listed in /etc/resolv.conf.
+
+<h2>References and related projects</h2>
+
+<ul>
+<li><a href="http://code.google.com/p/adns-python">Python bindings</a>
+ by Andy Dustman.
+<li><a href="http://cryp.to/hsdns/">Haskell bindings</a>
+ by Peter Simons.
+<li><a href="http://liboop.ofb.net/ref">liboop event loop library</a>
+ (by Dan Egnor) has a built-in binding for adns.
+<li><a href="http://adns.jgaa.com/">port to MS Visual Studio 6 C++</a>
+ by Jarle Aase.
+</ul>
+
<h2>Copyright and licensing</h2>
-<kbd>adns</kbd> is Copyright 1997-2000 Ian Jackson, Copyright 1999
-Tony Finch, and Copyright (C) 1991 Massachusetts Institute of
-Technology.
+<kbd>adns</kbd> is Copyright 1997-2000,2003,2006 Ian Jackson,
+Copyright 1999-2000,2003,2006 Tony Finch, and Copyright (C) 1991
+Massachusetts Institute of Technology.
<p>
<A href="/">site or mirror home page</A>
<p>
-This web page is Copyright (C)1996-2000 Ian Jackson. See the
+This web page is Copyright (C)1996-2005 Ian Jackson. See the
<A href="http://www.chiark.greenend.org.uk/~ian/sw-www-copy.html">Copyright/acknowledgements</A>.
<p>
~ianmdlvl / adns.git / blobdiff