  $Id: README,v 8.1 1996/10/25 04:57:11 vixie Exp $

--------------------------------------------------------------------------

			dnsparse kit, version 2.1

		 Copyright (c) 1990, 1991, Marion Hakanson

    This program 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 Software Foundation; either version 1, or (at your option)
    any later version.

    This program 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
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

--------------------------------------------------------------------------

In this directory are some tools for manipulating Domain Name System
master files, and for converting to /etc/hosts format.  There are also
a couple of tools (simphosts, sorthosts) for dealing with host tables.

To run dns2hosts, or anything which uses the dnsparse.pl library
(currently just dnstest and dnsmkptr), one must first compile
"dnslex.c" into a program "dnslex" in the current directory, as the
"dnsparse.pl" library will invoke it as "./dnslex".  Feel free to
modify the invocation path to suit your needs.  The "dnsparse.pl" file
must also be somewhere in the perl library search path, and perl must
be available.

Typically how one generates new host table(s) from the DNS zone files is
to have the zones and their master file pathnames in "zonelist", and
then use the enclosed "mkhosts" script to spit out zone-specific files.

NOTE: you may need to edit by hand to reorder multiply-homed hosts!

To Do:

Write some real documentation.  Manual pages, too.

The dnsmkptr program is really simplistic -- needs to produce split
zone files (net/subnet), rather than just a single output.

These things should really be more automated....

The dns2hosts output would be "more like the nameserver" if it also
simulated the "sortlist" functionality.  This would require another
option to specify the target network that queries are coming from,
and maybe also the home network.  Complicated, ugly, and at the least
it requires further study.

-- 
Marion Hakanson <hakanson@cse.ogi.edu>
