X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/fbf20b5bd30e237c383ed290428261f28dfa5803..36b6fecc4670f4d351cd662a6772a5a196108ceb:/man/bres.3

diff --git a/man/bres.3 b/man/bres.3
index 9552656..917ab9c 100644
--- a/man/bres.3
+++ b/man/bres.3
@@ -85,12 +85,14 @@ The function
 cancels a running resolver job.  When it returns, the client structure
 is safe to discard.
 .PP
-The resolver is currently implemented using a pool of server processes.
-Incoming resolver jobs are passed to an available server, or a new
-server is started if all are busy.  There is a maximum number of
-servers, and jobs are queued once this limit is reached.  Old servers
-which have been idle for a period of time are killed off.  Servers are
-also killed if they start misbehaving or their jobs are aborted.
+There are two versions of 
+.BR bres .
+The standard one uses a pool of server processes.  Incoming resolver
+jobs are passed to an available server, or a new server is started if
+all are busy.  There is a maximum number of servers, and jobs are queued
+once this limit is reached.  Old servers which have been idle for a
+period of time are killed off.  Servers are also killed if they start
+misbehaving or their jobs are aborted.
 .PP
 By default, servers are started simply by calling
 .BR fork (2).
@@ -105,6 +107,18 @@ memory consumption.  The argument to
 is the full pathname of the server program, or null to accept the
 default set at library configuration time (which is usually correct).
 .PP
+The other implementation of
+.B bres
+uses the
+.B adns
+library to do asynchronous resolution.  It can cope with many more
+simultaneous resolver jobs, and doesn't use up external processes.  If
+you're using the
+.BR adns -based
+resolver, then the
+.B bres_exec
+function does nothing at all.
+.PP
 For security reasons, when an address is resolved, the hostname received
 is verified by performing a forward lookup.  If the forward lookup fails
 to return the expected IP address, an error is reported.
@@ -114,4 +128,4 @@ to return the expected IP address, an error is reported.
 .BR sel (3),
 .BR mLib (3).
 .SH "AUTHOR"
-Mark Wooding, <mdw@nsict.org>
+Mark Wooding, <mdw@distorted.org.uk>