X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=adns.git;a=blobdiff_plain;f=README;h=00c81407f83b3cfd935272f06e9e793246c99661;hp=e159a8c08e22716ae3937e717dbb62d2753b161d;hb=4931cd3a4201190b159f27a68e3abbcebbbdab2f;hpb=239d2e4dfb6fcfc26fe3f740efae8f6944b99799 diff --git a/README b/README index e159a8c..00c8140 100644 --- a/README +++ b/README @@ -5,9 +5,12 @@ 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: * It is reasonably easy to use for simple programs which just want to translate names to addresses, look up MX records, etc. * It can be used in an asynchronous, non-blocking, manner. Many @@ -49,21 +52,25 @@ DNS utility programs 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 [1]usage - message for a summary of its capabilities. + can invoke and communicate with subprocesses. See the [1]adnshost + usage message for a summary of its capabilities. -Technical note +Forthcoming: - adns requires a real nameserver like [2]BIND or [3]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. - + I hope that future versions may also have the following features: + * The library should be useable by threads in a multithreaded + program in a natural way. It should multiplex many threads' + queries through a single query socket. + * IPv6 support. + * Some kind of awareness of DNSSEC. + * Possibly some very limited caching behaviour. + * There was, at one point, a draft native Perl interface from Tony + Finch. + Documentation I'm afraid there is no manual yet. However, competent C programmers - should be able to use the library based on the [4]commented adns.h + should be able to use the library based on the [2]commented adns.h header file, and the usage messages for the programs should be sufficient. @@ -82,33 +89,54 @@ 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 + important bugs, new versions, etc. The bug reports address mentioned above is also a mailing list; feel free to subscribe to it. - There are [5]archives and subscription web pages, or you can subscribe + There are [3]archives and subscription web pages, or you can subscribe by sending mail containing the word `subscribe' to adns-announce-REQUEST@chiark.greenend.org.uk or adns-discuss-REQUEST@chiark.greenend.org.uk. Download - Available for download from [6]chiark.greenend.org.uk are: - * The [7]current beta version as a gzipped tarfile. - * [8]adns.h API header file with comments (currently there is no - manual, sorry). - * All versions released so far are also available via [9]anonymous - FTP. - * A mirror of my CVS repository is available via rsync from + Available for download from [4]chiark.greenend.org.uk are: + * The [5]current release as a gzipped tarfile. + * [6]adns.h API header file with comments, and [7]usage message for + adnshost (currently there is no manual, sorry). + * All versions released so far are also available via [8]anonymous + FTP and [9]HTTP. + + You can also access the project CVS repositories: + * A mirror of the source code 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 [10]cvsweb. + * This web page is maintained in [11]Savannah, where you can browse + the [12]webpage CVS. - adns is also available from the [11]GNU Project FTP servers and their - [12]mirrors. + adns is also available from the [13]GNU Project FTP servers and their + [14]mirrors. +Technical note + + adns requires a real nameserver like [15]BIND or [16]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. + +References and related projects + + * [17]Python bindings by Andy Dustman. + * [18]Haskell bindings by Peter Simons. + * [19]liboop event loop library (by Dan Egnor) has a built-in + binding for adns. + * [20]port to MS Visual Studio 6 C++ by Jarle Aase. + 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 Ian Jackson, 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 @@ -118,45 +146,53 @@ Copyright and licensing 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 - [13]GNU General Public License for more details. + [21]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 [14]Free Software Foundation, 59 Temple Place - Suite 330, Boston, + the [22]Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA, or email adns-maint@chiark.greenend.org.uk. _________________________________________________________________ - [15]Ian Jackson / [16]adns-maint@chiark.greenend.org.uk; more [17]free + [23]Ian Jackson / [24]adns-maint@chiark.greenend.org.uk; more [25]free software by me. - [18]GNU home page; [19]chiark home page; [20]site or mirror home page + [26]GNU home page; [27]chiark home page; [28]site or mirror home page - This web page is Copyright (C)1996-2000 Ian Jackson. See the - [21]Copyright/acknowledgements. + This web page is Copyright (C)1996-2005 Ian Jackson. See the + [29]Copyright/acknowledgements. - Use any browser - [22]Campaign for a non-browser-specific WWW + Use any browser - [30]Campaign for a non-browser-specific WWW References - 1. http://www.chiark.greenend.org.uk/~ian/adns/usage/adnsresfilter_usage.text - 2. http://www.isc.org/view.cgi?/products/BIND/index.phtml - 3. http://www.dents.org/ - 4. http://www.chiark.greenend.org.uk/~ian/adns/adns.h.txt - 5. http://www.chiark.greenend.org.uk/mailman/listinfo - 6. http://www.chiark.greenend.org.uk/~ian/adns/ - 7. http://www.chiark.greenend.org.uk/~ian/adns/adns.tar.gz - 8. http://www.chiark.greenend.org.uk/~ian/adns/adns.h.txt - 9. ftp://ftp.chiark.greenend.org.uk/users/ian/adns/ + 1. http://www.chiark.greenend.org.uk/~ian/adns/adnshost.txt + 2. http://www.chiark.greenend.org.uk/~ian/adns/adns.h.txt + 3. http://www.chiark.greenend.org.uk/mailman/listinfo + 4. http://www.chiark.greenend.org.uk/~ian/adns/ + 5. http://www.chiark.greenend.org.uk/~ian/adns/adns.tar.gz + 6. http://www.chiark.greenend.org.uk/~ian/adns/adns.h.txt + 7. http://www.chiark.greenend.org.uk/~ian/adns/adnshost.txt + 8. ftp://ftp.chiark.greenend.org.uk/users/ian/adns/ + 9. http://www.chiark.greenend.org.uk/~ian/adns/ftp/ 10. http://www.chiark.greenend.org.uk/ucgi/~ijackson/cvsweb/adns/ - 11. http://www.gnu.org/ - 12. http://www.gnu.org/order/ftp.html - 13. http://www.chiark.greenend.org.uk/~ian/COPYING.txt - 14. http://www.fsf.org/ - 15. http://www.chiark.greenend.org.uk/ - 16. mailto:adns-maint@chiark.greenend.org.uk - 17. http://www.chiark.greenend.org.uk/~ian/software/ - 18. http://www.gnu.org/ - 19. http://www.chiark.greenend.org.uk/ - 20. file://localhost/ - 21. http://www.chiark.greenend.org.uk/~ian/sw-www-copy.html - 22. http://www.anybrowser.org/campaign/ + 11. http://savannah.gnu.org/ + 12. http://savannah.gnu.org/cgi-bin/viewcvs/software/adns/?cvsroot=www.gnu.org + 13. http://www.gnu.org/ + 14. http://www.gnu.org/order/ftp.html + 15. http://www.isc.org/view.cgi?/products/BIND/index.phtml + 16. http://www.dents.org/ + 17. http://dustman.net/andy/python/adns-python + 18. http://cryp.to/hsdns/ + 19. http://liboop.ofb.net/ref + 20. http://adns.jgaa.com/ + 21. http://www.chiark.greenend.org.uk/~ian/COPYING.txt + 22. http://www.fsf.org/ + 23. http://www.chiark.greenend.org.uk/ + 24. mailto:adns-maint@chiark.greenend.org.uk + 25. http://www.chiark.greenend.org.uk/~ian/software/ + 26. http://www.gnu.org/ + 27. http://www.chiark.greenend.org.uk/ + 28. file://localhost/ + 29. http://www.chiark.greenend.org.uk/~ian/sw-www-copy.html + 30. http://www.anybrowser.org/campaign/