This directory contains the 0.93 release of the lwres NSS module.

See the file NEWS for the user-visible changes from previous releases.

For general building and installation instructions, see the file INSTALL.

The lwres NSS module provides support for the lightweight resolver in
BIND 9 on systems that use the GNU C Library.  It is designed to
replace the DNS NSS module that use the BIND 4/BIND 8 resolver for
name server lookups.  For more information on NSS (Name Service
Switch), please consult the GNU C Library manual.

In order to use the module, you must make sure that the lightweight
resolver daemon `lwresd' is running, and add the `lwres' service to
your `/etc/nsswitch.conf'.  Currently the lwres module only supports
the `hosts' database.  So you'll want to edit the line that starts
with `hosts:' to look something like:

   hosts:	files lwres

Of course both BIND 9 and this module are still in development, so
perhaps you want to try:

   hosts:	files lwres [NOTFOUND=return] dns

instead.  This will fall back on the traditional DNS module if the
lwres service is unavailable (for example when lwresd crashed).
