@@ -16,12 +8,24 @@
Advanced, easy to use, asynchronous-capable DNS client
library and utilities.
+
+
+
+
+
+
+
+
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.
+
+
+
C library
+
+In contrast with the standard interfaces, gethostbyname et al and
+libresolv, it has the following features:
@@ -32,10 +36,12 @@ to translate names to addresses, look up MX records, etc.
queries can be handled simultaneously.
Responses are decoded automatically into a natural representation
-for a C program - there is no need to deal with DNS packet formats.
+for a C program - there is no need to deal with DNS packet and RRDATA
+formats.
Sanity checking (eg, name syntax checking, reverse/forward
-correspondence, CNAME pointing to CNAME) is performed automatically.
+correspondence, CNAME pointing to CNAME) is performed automatically
+by default.
Time-to-live, CNAME and other similar information is returned in
an easy-to-use form, without getting in the way.
@@ -47,8 +53,8 @@ can have several instances of the resolver.
Errors are reported to the application in a way that distinguishes
the various causes of failure properly.
-
Understands conventional resolv.conf, but this can overridden by
-environment variables.
+
adns understands conventional resolv.conf, but this can overridden
+by environment variables.
Flexibility. For example, the application can tell adns to:
ignore environment variables (for setuid programs), disable hostname
@@ -81,27 +87,16 @@ which can be used easily in from the command line and from shell
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
-usage
-message for a summary of its capabilities.
+adnshost
+usage message for a summary of its capabilities.
-
Technical note
-
-adns requires a real nameserver like
-BIND
-or
-Dents 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.
-
Documentation
I'm afraid there is no manual yet. However, competent C programmers
should be able to use the library based on the
-commented
+commented
adns.h header file, and the usage messages for the programs should
be sufficient.
@@ -112,19 +107,26 @@ your project, and what you think of it.
-If you are subscribed to adns-discuss please send
-feedback, including bug reports, there; otherwise send mail to
-adns-bugreports@chiark.greenend.org.uk. If you'd prefer
-that your message wasn't forwarded to the adns-bugreports
-list, send it to adns-maint@chiark.greenend.org.uk.
+Bug reports should be reported to the
+GNU Debbugs. Send an email
+to submit@debbugs.gnu.org and at the top of your email,
+in a paragraph of its own, write the single line
+
+Package: adns
+
+Your bug report will be published via to the adns-discuss list.
+
+
+
+Feedback and discussion takes place on the adns-discuss
+list. You can mail me privately
+at ijackson@chiark.greenend.org.uk.
Mailinglists
I have set up mailinglists adns-announce and
adns-discuss. The announcements list is moderated and
-will contain only announcements of important bugs, new versions, &c.
-The bug reports address mentioned above is also a mailing list; feel
-free to subscribe to it.
+will contain only announcements of important bugs, new versions, etc.
@@ -135,40 +137,65 @@ containing the word `subscribe' to
adns-announce-REQUEST@chiark.greenend.org.uk or
adns-discuss-REQUEST@chiark.greenend.org.uk.
-
adns.h
- API header file with comments (currently there is no manual, sorry).
-
All versions released so far are also available via
- anonymous
- FTP.
-
A mirror of my CVS repository is available via rsync from
- rsync.chiark.greenend.org.uk::ftp/users/ian/cvs-pub/adns
- (use FTP first to find your way around), or via
- cvsweb.
+
adns is also available from the
GNU Project FTP servers and their
mirrors.
+
Installation note
+
+adns requires a real nameserver like BIND running on the same system
+or a nearby one, which must be willing to provide `recursive service'.
+I.e., adns is a `stub resolver'.
+
+
+adns requires that your real nameserver is on the same machine, or
+connected via a secure network, so that an attacker cannot fake the
+replies to adns's queries.
+
+
-adns is Copyright 1997-2000 Ian Jackson, Copyright 1999
-Tony Finch, and Copyright (C) 1991 Massachusetts Institute of
-Technology.
+adns is Copyright 1997-2000,2003,2006,2014 Ian Jackson,
+Copyright 2014 Mark Wooding, Copyright 1999-2000,2003,2006 Tony Finch,
+and Copyright (C) 1991 Massachusetts Institute of Technology.
adns is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or (at
+the Free Software Foundation; either version 3 of the License, or (at
your option) any later version.
@@ -177,25 +204,20 @@ This program and documentation is distributed in the hope that it will
be useful, but without any warranty; without even the implied
warranty of merchantability or fitness for a particular
purpose. See the
-GNU
+GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with adns, or one should be available above; if not,
-write to the
-Free Software Foundation,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA,
-or email adns-maint@chiark.greenend.org.uk.
+write to the Free Software Foundation
+or email ijackson@chiark.greenend.org.uk.
-This web page is Copyright (C)1996-2000 Ian Jackson. See the
+This web page is Copyright (C)1996-2005,2014 Ian Jackson. See the
Copyright/acknowledgements.
-