X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=adns.git;a=blobdiff_plain;f=README.html;h=07123cd49c010279e9e5b40af4858baeac8e712f;hp=e4707cd088bdb6c0ca6f85215416277e44385746;hb=fcf2b4e1faf22accb6184cca595aaee602839868;hpb=217cfd38966efba85badf9ebc56abd9c9a7707b9 diff --git a/README.html b/README.html index e4707cd..07123cd 100644 --- a/README.html +++ b/README.html @@ -15,7 +15,6 @@ library and utilities. -

@@ -37,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. @@ -52,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 @@ -86,36 +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 -adnshost +adnshost 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 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. @@ -126,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, etc. -The bug reports address mentioned above is also a mailing list; feel -free to subscribe to it.

    @@ -149,68 +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: -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 -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. +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

    - * Haskell bindings - by Peter Simons. - * port to MS Visual Studio 6 C++ +

    Copyright and licensing

    -adns is Copyright 1997-2005 Ian Jackson, Copyright -1999-2004 Tony Finch, and Copyright (C) 1991 Massachusetts Institute -of Technology. +adns is Copyright 1997-2000,2003,2006,2014-2016 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.

    @@ -219,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; @@ -245,12 +225,8 @@ software by me. site or mirror home page

    -This web page is Copyright (C)1996-2005 Ian Jackson. See the +This web page is Copyright (C)1996-2005,2014-2016 Ian Jackson. See the Copyright/acknowledgements. -

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