X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=README.html;h=1eeee0bc1a3a2090604c86ecca0af5154663ab27;hb=ced2f0cf2a351f8d30b800c915eeee042658d235;hp=4cb547e60f86e768f4ff3ad5120fe36612108287;hpb=ea5ac6575a512bcec30e62ff04ad5888bc73195f;p=adns.git diff --git a/README.html b/README.html index 4cb547e..1eeee0b 100644 --- a/README.html +++ b/README.html @@ -1,6 +1,6 @@ adns - advanced, alternative, asynchronous resolver - +

GNU adns

@@ -37,10 +37,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. @@ -52,8 +54,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 @@ -91,26 +93,6 @@ usage message for a summary of its capabilities. -

    Forthcoming:

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

    Documentation

    I'm afraid there is no manual yet. However, competent C programmers @@ -126,19 +108,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, etc. -The bug reports address mentioned above is also a mailing list; feel -free to subscribe to it.

    @@ -149,70 +138,67 @@ 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: -You can also access the project CVS repositories: +

    Download and source code

    + adns is also available from the GNU Project FTP servers and their mirrors. -

    Technical note

    +

    Installation note

    adns requires a real nameserver like BIND -or -Dents running on +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. +`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

    -There is a port to MS Visual Studio 6 -C++ by Jarle Aase. +

    Copyright and licensing

    -adns is Copyright 1997-2001 Ian Jackson, Copyright -1999-2000 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.

    @@ -228,18 +214,13 @@ 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; @@ -247,12 +228,8 @@ software by me. site or mirror home page

    -This web page is Copyright (C)1996-2001 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