X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=README.html;h=3d7c06efbea3fea8bfee01c4e13b4733163b6808;hb=1fe1c762360d2e902469df7c05967aa067972765;hp=7d44601a1a5fb8620de8338dbcf5ae748d1d48ec;hpb=630bf6981f8ce925697e3668346e9d5267f2800c;p=adns.git diff --git a/README.html b/README.html index 7d44601..3d7c06e 100644 --- a/README.html +++ b/README.html @@ -1,17 +1,6 @@ adns - advanced, alternative, asynchronous resolver - +

GNU adns

@@ -19,11 +8,24 @@ Advanced, easy to use, asynchronous-capable DNS client library and utilities. + + + + + + + +

-adns is a resolver library for C (and C++) programs. In contrast with -the existing interfaces, gethostbyname et al and libresolv, it has the -following features: +adns is a resolver library for C (and C++) programs, and a collection +of useful DNS resolver utilities. + + +

C library

+ +In contrast with the standard interfaces, gethostbyname et al and +libresolv, it has the following features: +

DNS utility programs

+ adns also comes with a number of utility programs for use from the command line and in scripts: @@ -77,50 +83,22 @@ unduly delaying the output. For example, you can usefully pipe the output of netstat -n, tcpdump -ln, and the like, into it.
  • adnshost is a general-purpose DNS lookup utility -which can be used easily in 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. +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 +adnshost +usage message for a summary of its capabilities. -

    Forthcoming:

    - -A native Perl interface is in the works, thanks to Tony Finch. - -

    - -I hope that future versions may also have the following features: - -

    - -(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 -adns.h header file. +commented +adns.h header file, and the usage messages for the programs should +be sufficient.

    Feedback

    @@ -129,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.

    @@ -152,40 +137,65 @@ containing the word `subscribe' to adns-announce-REQUEST@chiark.greenend.org.uk or adns-discuss-REQUEST@chiark.greenend.org.uk. -

    Download

    +

    Documentation

    -Available for download from -chiark.greenend.org.uk -are: + +

    Download and source code

    + + 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. + +

    References and related projects

    + + +

    Copyright and licensing

    -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.

    @@ -194,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.

    -Ian Jackson / -adns-maint@chiark.greenend.org.uk; -more free -software by me. +Ian Jackson / ijackson@chiark.greenend.org.uk.

    GNU home page; @@ -220,12 +225,8 @@ software by me. site or mirror home page

    -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. -

    - -Use any browser - -Campaign for a non-browser-specific WWW