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

GNU adns

@@ -9,14 +8,14 @@ Advanced, easy to use, asynchronous-capable DNS client library and utilities. - + - +

@@ -38,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. @@ -53,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 @@ -107,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.

    @@ -130,53 +138,67 @@ containing the word `subscribe' to adns-announce-REQUEST@chiark.greenend.org.uk or adns-discuss-REQUEST@chiark.greenend.org.uk. -

    Download

    +

    Documentation

    + + + +

    Download and source code

    -Available for download from -chiark.greenend.org.uk -are: 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

    + +

    Copyright and licensing

    -adns is Copyright 1997-2000 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.

    @@ -192,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; @@ -211,12 +228,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