X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=adns.git;a=blobdiff_plain;f=README.html;h=760c2780411168d5bc9c82bf54156d3cc5db7d19;hp=7d44601a1a5fb8620de8338dbcf5ae748d1d48ec;hb=cada00d426ca67231d2f1a8acb3cdf91bc019895;hpb=630bf6981f8ce925697e3668346e9d5267f2800c diff --git a/README.html b/README.html index 7d44601..760c278 100644 --- a/README.html +++ b/README.html @@ -1,16 +1,6 @@ -adns - advanced, alternative, asynchronous resolver - + + +adns - advanced, alternative, asynchronous resolver @@ -19,11 +9,25 @@ 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. +adns.h header file, and the usage messages for the programs should +be sufficient.

    Feedback

    @@ -139,7 +117,7 @@ list, send it to adns-maint@chiark.greenend.org.uk. 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. +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. @@ -158,13 +136,15 @@ Available for download from chiark.greenend.org.uk are: