 /*
 * Copyright (C) 2002 Stichting NLnet, Netherlands, stichting@nlnet.nl.
 * 
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the
 * above copyright notice and this permission notice appear in all
 * copies.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS" AND STICHTING NLNET
 * DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
 * STICHTING NLNET BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
 * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE
 * USE OR PERFORMANCE OF THIS SOFTWARE.
 * 
 * The development of Dynamically Loadable Zones (DLZ) for Bind 9 was
 * Conceived and contributed by Rob Butler.
 * 
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the
 * above copyright notice and this permission notice appear in all
 * copies.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS" AND ROB BUTLER
 * DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
 * ROB BUTLER BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
 * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE
 * USE OR PERFORMANCE OF THIS SOFTWARE.
 */

DLZ Stub Driver

The DLZ stub driver is included only for testing the functionality of the 
new (S)DLZ API.  It should NOT be used in a production environment.

Be sure to specify --with-dlz-stub when running configure so that the stub
driver is built with Bind.  By default DLZ and its drivers are not built.
When you specify a DLZ driver the DLZ core is automatically built too.  

To use the DLZ stub driver, add syntax similar to the following to your 
named.conf file.
 
dlz "dlz_stub_zone" {
	database "dlz_stub example2.com web 10.5.5.6";
};

Here's the breakdown of the syntax:

dlz           - indicates to Bind that you wish to use a (S)DLZ driver in 
                this view.
      
dlz_stub_zone - is the name displayed if an error occurs while named.conf 
                is parsed.
                
database      - Required.  It is a required DLZ option.  Everything 
                enclosed in double quotes is the DLZ command line.  This 
                is parsed and passed to the driver.

dlz_stub      - The name of the driver to use.  In this case, we are 
                using the DLZ stub driver.
           
example2.com  - The first parameter after the driver name.  The DLZ stub 
                driver expects a zone name here.
               
web           - The second parameter after the driver name.  The DLZ stub 
                driver expects an "A" record name here.
                
10.5.5.6      - The last parameter.  The DLZ stub driver expects an IPV4 IP 
                address here.

The DLZ stub driver is very simple and does not perform any parameter 
checking, so be sure to use it properly.  It is not intended for production 
use.  (I mean really, production use of this driver would be really 
silly!)  It is only meant to demonstrate the use of and exercise the 
(S)DLZ API.

Once you have added this to your named.conf file, Bind will answer queries 
for "web.example2.com" with "10.5.5.6".

Have fun. :)
           


